בדף הזה נסביר איך להגדיר הטמעה פרטית. כדי להשתמש באפשרות ההטמעה הפרטית, צריך לנהל את רכיב ה-HTML <iframe> ישירות כדי להטמיע את התוכן של Looker, והמשתמש צריך להתחבר ל-Looker בנפרד מהאפליקציה המארחת.
אנחנו נסביר את הדוגמה הזו של קוד הטמעה פרטי:
<iframe
src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
width="600"
height="300"
frameborder="0">
</iframe>
1. יצירת כתובת ה-URL של התוכן המוטמע
לדוגמה, תוכן ב-Looker בכתובת ה-URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. מכתובת ה-URL הזו של התוכן ב-Looker, ניצור את כתובת ה-URL של התוכן המוטמע ונגדיר את המאפיין src של ה-iframe בהתאם. אתם יכולים להשתמש בכתובת URL של תוכן Looker משלכם בזמן שאתם מבצעים את השלבים האלה.
כתובת ה-URL של התוכן המוטמע מדוגמת הקוד שלמעלה היא:
כתובת ה-URL של התוכן המוטמע מורכבת משלושה חלקים:
- Hostname: שם המארח של המופע ב-Looker
- נתיב: נתיב כתובת ה-URL של התוכן ב-Looker עם הקידומת
/embed(עם שלבים נוספים להצגה חזותית של שאילתות) - פרמטרים: פרמטרים של כתובת URL שמציינים מסננים ועיצוב
הפרוטוקול חייב להיות תמיד https://. בדוגמה הזו נבנה כל חלק בפירוט.
חלק 1: שם המארח
- עוברים לתוכן ב-Looker. לפי כתובת ה-URL לדוגמה של התוכן ב-Looker:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. - שם המארח של כתובת ה-URL של התוכן המוטמע הוא
instance.looker.com.
חלק 2: נתיב
נתיב כתובת ה-URL של התוכן המוטמע תלוי בתוכן של Looker שאתם מטמיעים.
הטמעה של כל התוכן ב-Looker, חוץ מתצוגות חזותיות של שאילתות
- עוברים לתוכן ב-Looker. לפי כתובת ה-URL לדוגמה של התוכן ב-Looker:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day - מזהים את הנתיב של כתובת ה-URL של התוכן ב-Looker:
/dashboards/4. - מוסיפים את הקידומת
/embedלנתיב של כתובת ה-URL של התוכן ב-Looker. הנתיב של כתובת ה-URL של התוכן המוטמע הוא/embed/dashboards/4.
הטמעת תצוגה חזותית של שאילתה
- עוברים לתצוגה החזותית של השאילתה. כתובת URL לדוגמה:
instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12 - מזהים את מזהה הלקוח של השאילתה. הפרמטר
qid:1234567890abcdefghij12הוא מזהה הלקוח של השאילתה שמייצג את השאילתה ואת הגדרות התצוגה החזותית. - נתיב כתובת ה-URL של התוכן המוטמע הוא
/embed/query-visualization/, בתוספת מזהה הלקוח של השאילתה. הנתיב של כתובת ה-URL של התוכן המוטמע לדוגמה הוא/embed/query-visualization/1234567890abcdefghij12
חלק 3: פרמטרים
הפרמטרים של כתובת ה-URL של התוכן המוטמע קובעים את המסננים ואת העיצוב של התוכן המוטמע.
מסננים
- עוברים לכתובת ה-URL של התוכן ב-Looker.
- משנים ידנית את מסנני התוכן לפי הצורך. בדוגמה הזו, כתובת ה-URL של התוכן ב-Looker היא:
https://instance.looker.com/dashboards/4?Timeframe=14+day - הפרמטרים של כתובת ה-URL של התוכן המוטמע הם הפרמטרים של כתובת ה-URL של התוכן ב-Looker, לדוגמה,
Timeframe=14+day
בדוגמה הזו, הפרמטר Timeframe=14+day מגדיר את הערך של המסנן Timeframe בלוח הבקרה.
ניהול עיצובים
במדריך העיצוב מוסבר איך לשלוט במראה של התוכן המוטמע.
2. בדיקת כתובת ה-URL של התוכן המוטמע
כדי לראות תצוגה מקדימה של ההתנהגות והמראה של התוכן המוטמע, פותחים את כתובת ה-URL של התוכן המוטמע בדפדפן.

3. יצירת iframe
- יוצרים את רכיב ה-iframe באפליקציה המארחת.
- מגדירים את המאפיין
srcלכתובת ה-URL של התוכן המוטמע. - מגדירים את המאפיינים
width,heightומאפיינים אחרים לפי מה שצריך כדי להציג בצורה הטובה ביותר את תוכן Looker המוטמע.
4. בעיות בהרשאות הגישה של משתמשים
המשתמש חייב להיות מחובר ל-Looker כדי לצפות בתוכן המוטמע. אם המשתמש לא מחובר, ב-iframe יוצג דף שגיאה 401.
אפשרויות התחברות של משתמשים
המשתמש יכול להתחבר ל-Looker באחת משתי דרכים:
1. מתחברים ל-Looker לפני כן
המשתמש צריך להתחבר ל-Looker באותו דפדפן כדי שיוכל לראות את התוכן המוטמע.
2. הפעלת מסך התחברות אופציונלי להטמעה של Looker
כדי להציג מסך כניסה ל-Looker ב-iframe אם המשתמש לא מחובר, מוסיפים את allow_login_screen=true לפרמטרים של כתובת ה-URL של התוכן המוטמע. כתובת ה-URL של התוכן המוטמע בדוגמה שלנו תהיה: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true
חשוב לזכור שתי נקודות:
- כדי להפעיל את מסך ההתחברות של Looker בהטמעת iframe, צריך להשבית את ההגדרה "הגנות על מקור זהה בדפי ההתחברות של Looker".
- אם מופע Looker שלכם מאמת משתמשים באמצעות כניסה יחידה (SSO) עם ספק זהויות, יכול להיות שספק הזהויות יחסום את מסך ההתחברות בתוך ה-iframe. במקרה כזה, תצטרכו להשתמש באפשרות 1.
המדיניות בנושא קובצי Cookie בדפדפן של המשתמש
מערכת Looker משתמשת בקובצי Cookie לאימות משתמשים ולאחסון סשנים. אם המשתמשים ניגשים לכתובת ה-URL של התוכן המוטמע במופע של Looker, ושם המארח של כתובת ה-URL נמצא בדומיין אחר מזה של האפליקציה המארחת, הדפדפן של המשתמשים צריך לאפשר קובצי Cookie של צד שלישי.
בדפדפנים מסוימים, כמו Firefox ו-Safari, מדיניות ברירת המחדל לגבי קובצי Cookie חוסמת קובצי Cookie של צד שלישי. אם הדפדפן של המשתמש לא מאפשר קובצי Cookie של צד שלישי, אתם יכולים להוסיף דומיין בהתאמה אישית למכונה של Looker כדי שהאפליקציה המארחת ושם המארח של כתובת ה-URL של התוכן המוטמע במכונה של Looker יהיו באותו דומיין.
5. אינטראקציה עם ה-iframe
איך מתחילים להשתמש בהעברת הודעות מוטמעות ב-iframe של Looker
השלבים הבאים
כאן מוסבר איך מתחילים להשתמש בהטמעה חתומה באמצעות Embed SDK, וכאן אפשר לראות דוגמאות למה שאפשר לעשות עם הטמעה של Looker.