איך מתחילים להטמיע באופן פרטי

בדף הזה נסביר איך להגדיר הטמעה פרטית. כדי להשתמש באפשרות ההטמעה הפרטית, צריך לנהל את רכיב ה-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 של התוכן המוטמע מדוגמת הקוד שלמעלה היא:

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+day

כתובת ה-URL של התוכן המוטמע מורכבת משלושה חלקים:

  • ‫Hostname: שם המארח של המופע ב-Looker
  • נתיב: נתיב כתובת ה-URL של התוכן ב-Looker עם הקידומת /embed (עם שלבים נוספים להצגה חזותית של שאילתות)
  • פרמטרים: פרמטרים של כתובת URL שמציינים מסננים ועיצוב

הפרוטוקול חייב להיות תמיד https://. בדוגמה הזו נבנה כל חלק בפירוט.

חלק 1: שם המארח

  1. עוברים לתוכן ב-Looker. לפי כתובת ה-URL לדוגמה של התוכן ב-Looker: ‏https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
  2. שם המארח של כתובת ה-URL של התוכן המוטמע הוא instance.looker.com.

חלק 2: נתיב

נתיב כתובת ה-URL של התוכן המוטמע תלוי בתוכן של Looker שאתם מטמיעים.

הטמעה של כל התוכן ב-Looker, חוץ מתצוגות חזותיות של שאילתות

  1. עוברים לתוכן ב-Looker. לפי כתובת ה-URL לדוגמה של התוכן ב-Looker: ‏https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
  2. מזהים את הנתיב של כתובת ה-URL של התוכן ב-Looker: /dashboards/4.
  3. מוסיפים את הקידומת /embed לנתיב של כתובת ה-URL של התוכן ב-Looker. הנתיב של כתובת ה-URL של התוכן המוטמע הוא /embed/dashboards/4.

הטמעת תצוגה חזותית של שאילתה

  1. עוברים לתצוגה החזותית של השאילתה. כתובת URL לדוגמה: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
  2. מזהים את מזהה הלקוח של השאילתה. הפרמטר qid: 1234567890abcdefghij12 הוא מזהה הלקוח של השאילתה שמייצג את השאילתה ואת הגדרות התצוגה החזותית.
  3. נתיב כתובת ה-URL של התוכן המוטמע הוא /embed/query-visualization/, בתוספת מזהה הלקוח של השאילתה. הנתיב של כתובת ה-URL של התוכן המוטמע לדוגמה הוא /embed/query-visualization/1234567890abcdefghij12

חלק 3: פרמטרים

הפרמטרים של כתובת ה-URL של התוכן המוטמע קובעים את המסננים ואת העיצוב של התוכן המוטמע.

מסננים

  1. עוברים לכתובת ה-URL של התוכן ב-Looker.
  2. משנים ידנית את מסנני התוכן לפי הצורך. בדוגמה הזו, כתובת ה-URL של התוכן ב-Looker היא: https://instance.looker.com/dashboards/4?Timeframe=14+day
  3. הפרמטרים של כתובת ה-URL של התוכן המוטמע הם הפרמטרים של כתובת ה-URL של התוכן ב-Looker, לדוגמה, Timeframe=14+day

בדוגמה הזו, הפרמטר Timeframe=14+day מגדיר את הערך של המסנן Timeframe בלוח הבקרה.

ניהול עיצובים

במדריך העיצוב מוסבר איך לשלוט במראה של התוכן המוטמע.

2. בדיקת כתובת ה-URL של התוכן המוטמע

כדי לראות תצוגה מקדימה של ההתנהגות והמראה של התוכן המוטמע, פותחים את כתובת ה-URL של התוכן המוטמע בדפדפן.

3. יצירת iframe

  1. יוצרים את רכיב ה-iframe באפליקציה המארחת.
  2. מגדירים את המאפיין src לכתובת ה-URL של התוכן המוטמע.
  3. מגדירים את המאפיינים 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 משתמשת בקובצי Cookie לאימות משתמשים ולאחסון סשנים. אם המשתמשים ניגשים לכתובת ה-URL של התוכן המוטמע במופע של Looker, ושם המארח של כתובת ה-URL נמצא בדומיין אחר מזה של האפליקציה המארחת, הדפדפן של המשתמשים צריך לאפשר קובצי Cookie של צד שלישי.

בדפדפנים מסוימים, כמו Firefox ו-Safari, מדיניות ברירת המחדל לגבי קובצי Cookie חוסמת קובצי Cookie של צד שלישי. אם הדפדפן של המשתמש לא מאפשר קובצי Cookie של צד שלישי, אתם יכולים להוסיף דומיין בהתאמה אישית למכונה של Looker כדי שהאפליקציה המארחת ושם המארח של כתובת ה-URL של התוכן המוטמע במכונה של Looker יהיו באותו דומיין.

5. אינטראקציה עם ה-iframe

איך מתחילים להשתמש בהעברת הודעות מוטמעות ב-iframe של Looker

השלבים הבאים

כאן מוסבר איך מתחילים להשתמש בהטמעה חתומה באמצעות Embed SDK, וכאן אפשר לראות דוגמאות למה שאפשר לעשות עם הטמעה של Looker.