אירועי JavaScript מוטמעים

אחרי שיוצרים הטמעה – שאפשר לעשות באופן ציבורי, באופן פרטי, באמצעות הטמעה עם חתימה או דרך API – אפשר ליצור אינטראקציה עם ה-iframe האלה באמצעות JavaScript. אתם יכולים להפוך את הדף לדינמי יותר על סמך הסטטוס של הפריט המוטמע, ואפילו לבצע שינויים בפריט המוטמע מתוך דף האינטרנט.

חשוב לדעת ש-Looker לא שולט בסדר שבו הדפדפנים שולחים אירועים לאפליקציות אינטרנט. המשמעות היא שסדר האירועים לא מובטח בדפדפנים או בפלטפורמות שונות. חשוב לכתוב את ה-JavaScript בצורה מתאימה כדי להתחשב בטיפול באירועים בדפדפנים שונים.

אפשר להשתמש ב-JavaScript באחת מהדרכים הבאות לתוכן מוטמע ב-Looker:

הכנה

כדי ליצור אינטראקציה עם ה-iframe המוטמע, צריך לבצע את השלבים הבאים:

הוספת מזהה ל-iframe

בהמשך, כשמאחזרים נתונים מה-iframe, צריך לוודא שהמידע שאתם עובדים איתו הגיע באמת מה-iframe של Looker. כדי לעשות את זה, צריך להוסיף מזהה ל-iframe, אם עדיין לא עשיתם את זה. בדוגמה הבאה, המזהה מוגדר ל-looker על ידי הוספת id="looker" ל-iframe:

<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>

הוספת הדומיין להטמעה למאפיין src של ה-iframe

במאפיין src של ה-iframe, מציינים את הדומיין שבו נעשה שימוש ב-iframe. בדוגמה הבאה, אפשר לציין את myownpersonaldomain.com כדומיין על ידי הוספת ?embed_domain=https://myownpersonaldomain.com" לסוף כתובת ה-URL במאפיין src:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>

אם אתם משתמשים בהטמעה חתומה, הקפידו להוסיף את הפרמטר embed_domain לכתובת ה-URL להטמעה.

אם אתם משתמשים ב-Embed SDK, מוסיפים sdk=3 בסוף כתובת ה-URL להטמעה. הפרמטר sdk=3 מציין ש-SDK קיים ושאפשר להשתמש ב-Looker בתכונות נוספות ש-SDK מספק, כמו העברת אירועי JavaScript בין ה-iframe של Looker לבין הדומיין שלכם. ה-SDK לא יכול להוסיף את הפרמטר הזה בעצמו כי הוא חלק מכתובת ה-URL החתומה. לדוגמה:

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>

הוספת הדומיין של ההטמעה לרשימת ההיתרים

בסוף, צריך להוסיף את הדומיין שבו נעשה שימוש ב-iframe לרשימת ההיתרים בדף הטמעה של לוח הניהול של Looker. כדי לעשות את זה:

  1. בשדה Embedded Domain Allowlist (רשימת דומיינים מורשים להטמעה), מזינים את הדומיין שבו נעשה שימוש ב-iframe, ואז מקישים על מקש Tab כדי שהדומיין יופיע בתיבה בתוך השדה.

  2. לוחצים על עדכון.

אתם יכולים להשתמש בתו הכללי לחיפוש * ברשימת ההיתרים כדי ליצור תבנית דומיין. לדוגמה, https://*.myownpersonaldomain.com יאפשר גם את https://analytics.myownpersonaldomain.com וגם את https://data.myownpersonaldomain.com.

אם אתם משתמשים בהטמעה ללא קובצי Cookie ב-Looker 23.8 ואילך, אפשר לציין את דומיין ההטמעה כשמקבלים את הסשן ללא קובצי Cookie. זוהי חלופה להוספת הדומיין להטמעה לרשימת ההיתרים באמצעות החלונית ניהול > הטמעה. אם אתם רוצים להשתמש בתכונה הזו, כדאי לעיין בשיטות המומלצות לשיפור האבטחה.

אחזור נתונים ממסגרת ה-iframe

אחרי שמבצעים את שלבי ההכנה, אפשר לגשת לאירועים שמועברים בין ה-iframe של Looker לבין הדומיין שלכם על ידי האזנה לאירועים מסוג postMessage.

ה-iframe המוטמע יכול ליצור כמה סוגי אירועים, כמו שמתואר בקטע הפניה לסוגי אירועים בדף הזה.

גישה לאירועים ב-JavaScript

הנה דוגמה להאזנה לאירועים האלה ב-JavaScript, ולאחר מכן לרישום האירועים במסוף:

window.addEventListener("message", function(event) {
  if (event.source === document.getElementById("looker").contentWindow) {
    if (event.origin === "https://instance_name.looker.com") {
      console.log(JSON.parse(event.data));
    }
  }
});

הנה דוגמה להאזנה לאירועים האלה ב-jQuery, ואז לרישום שלהם במסוף:

$(window).on("message", function(event) {
  if (event.originalEvent.source === $("#looker")[0].contentWindow) {
    if (event.origin === "https://instance_name.looker.com") {
      console.log(JSON.parse(event.data));
    }
  }
});

טבלת סיכום של סוג האירוע

בטבלה הבאה מפורטים סוגי האירועים. בוחרים סוג אירוע כדי לראות את הפרטים שלו.

סוג האירוע הסיבה לאירוע
dashboard:loaded בדאשבורדים שבהם המשבצות לא מוגדרות להפעלה אוטומטית, הדאשבורד והרכיבים שלו נטענו אבל השאילתות עדיין לא פועלות.
dashboard:run:start לוח הבקרה מתחיל להיטען, והמשבצות שלו מתחילות להיטען ולשאול שאילתות לגבי נתונים.
dashboard:run:complete ההפעלה של לוח הבקרה הסתיימה, וגם הטעינה והשאילתות של כל המשבצות.
dashboard:download הורדה של קובץ PDF של לוח הבקרה התחילה.
dashboard:edit:start Added 22.20 מרכז בקרה עבר למצב עריכה. האירוע dashboard:save:complete יופעל כשהמרכז לשליטה נשמר בהצלחה.
dashboard:edit:cancel נוספה 22.20 יצאתם ממצב עריכה של מרכז בקרה בלי לשמור.
dashboard:save:complete מרכז בקרה נערך ונשמר.
dashboard:delete:complete מרכז בקרה נמחק.
dashboard:tile:start הטעינה של משבצת התחילה או שהתחילה שאילתה לאחזור נתונים.
dashboard:tile:complete הריצת השאילתה של המשבצת הסתיימה.
dashboard:tile:download ההורדה של הנתונים של המשבצת התחילה.
dashboard:tile:explore משתמש לחץ על האפשרות הצגת נתונים נוספים במשבצת בלוח הבקרה.
dashboard:tile:merge Added 25.14 משתמש לחץ על הלחצן או על פריט התפריט 'עריכת שאילתה ממוזגת'.
dashboard:tile:view משתמש לחץ על האפשרות View Original Look (הצגת ה-Look המקורי) במשבצת של מרכז בקרה.
dashboard:filters:changed המסננים של לוח הבקרה הופעלו או שונו.
look:ready התחילה טעינה של נתוני שאילתה ב-Look, בין אם השאילתה תופעל ובין אם לא.
look:run:start התחילה טעינה של נתוני שאילתה ב-Look והשאילתה התחילה לפעול.
look:run:complete ההרצה של השאילתה ב-Look הסתיימה.
look:edit:start נוסף 25.10 טבלת Look הועברה למצב עריכה. האירוע look:save:complete יופעל כשהתצוגה המקדימה תישמר.
look:edit:cancel נוסף ב-25.10 בוצעה יציאה ממצב עריכה של תבנית עיצוב בלי לשמור.
look:save:complete בוצעו עריכה ושמירה של Look.
look:delete:complete העברתם Look לתיקיית האשפה.
drillmenu:click משתמש לחץ על תפריט פירוט בדאשבורד שנוצר באמצעות link פרמטר LookML.
drillmodal:download משתמש פתח תיבת דו-שיח של ניתוח מעמיק מתוך משבצת בלוח בקרה ולחץ על האפשרות הורדה.
drillmodal:explore משתמש לחץ על האפשרות הצגת נתונים נוספים בתיבת דו-שיח של פירוט.
explore:ready תהליך הטעינה של נתוני השאילתה בניתוח התחיל, בלי קשר לשאלה אם השאילתה תופעל או לא.
explore:run:start התחיל תהליך טעינה של נתוני שאילתה ב-Explore, והשאילתה התחילה לפעול.
explore:run:complete ניתוח ב-Explore סיים להריץ את השאילתה.
explore:state:changed כתובת ה-URL של דף החיפוש השתנתה כתוצאה מהפעולות של המשתמש.
page:changed משתמש עבר לדף חדש בתוך ה-iframe.
page:properties:changed הגובה של iframe של לוח בקרה השתנה.
session:tokens כדי להמשיך, לקוח Looker צריך טוקנים.
session:expired נוסף ב-25.10 פג התוקף של הסשן של המשתמש.
session:status שליחת מידע על סטטוס הסשן.
env:client:dialog נפתחה תיבת דו-שיח שאולי לא מוצגת במלואה, כמו תיבת דו-שיח של פירוט. האירוע הזה מאפשר לאפליקציה המארחת לגלול את תיבת הדו-שיח לתצוגה.

מידע על סוגי אירועים

ה-iframe המוטמע יכול ליצור סוגים רבים ושונים של אירועים:

dashboard:loaded

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


type: "dashboard:loaded",
status: "complete",
dashboard: {
  id: 1,
  title: "Business Pulse",
  canEdit: true,
  dashboard_filters: {
    "date": "Last 6 Years",
    "state": ""
  },
  absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
מאפיין פורמט תיאור
status String מציין אם לוח הבקרה והאלמנטים שלו נטענו בהצלחה.
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.options אובייקט המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב בלוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set.

dashboard:run:start

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

type: "dashboard:run:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

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

type: "dashboard:run:complete",
status: "complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://my.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
מאפיין פורמט תיאור
status String מציין אם לוח הבקרה והאלמנטים שלו הופעלו בהצלחה. אם הפעלת לוח הבקרה והרכיבים שלו הסתיימה בהצלחה, הפונקציה status מחזירה "complete". אחרת, היא מחזירה "error".status אם לוח הבקרה הפעיל הופסק, דרך ממשק המשתמש או באמצעות הפעולה dashboard:stop, הפונקציה status תחזיר "stopped".
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options אובייקט המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב בלוח הבקרה. אפשר לעדכן את הערכים של כל המאפיינים שמוחזרים באובייקט options באמצעות הפעולה dashboard:options:set.
dashboard.tileStatuses מערך אובייקטים מערך של אובייקטים שמספקים את הסטטוסים של המשבצות. מאפייני האובייקט הם:

  • ‫tileId – מספר המזהה של המשבצת.
  • ‫status – אם השאילתה של המשבצת הופעלה בהצלחה, הפונקציה status מחזירה "complete". אחרת, הפונקציה status מחזירה "error".
  • ‫errors — מאוכלס כשהמאפיין status הוא "error". מערך של אובייקטים שמספקים פרטים על השגיאה, כולל טקסט הודעת השגיאה, תיאור מפורט יותר של השגיאה ושאילתת ה-SQL של המשבצת שיצרה את השגיאה.

dashboard:download

האירוע הזה נוצר כשהורדה של PDF של לוח בקרה מתחילה.

type: "dashboard:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
fileFormat: "pdf"
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat String הפורמט של מרכז הבקרה שהורד (רק "pdf" בשלב הזה).

dashboard:edit:start

נוסף 22.20 האירוע הזה נוצר כשעוברים למצב עריכה בלוח בקרה.

type: "dashboard:edit:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

Added 22.20 האירוע הזה נוצר כשיוצאים ממצב עריכה של לוח בקרה בלי לשמור.

type: "dashboard:edit:cancel",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:save:complete

האירוע הזה נוצר כשעורכים לוח בקרה ואז שומרים אותו.

type: "dashboard:save:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.options אובייקט המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב בלוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set.

dashboard:delete:complete

האירוע הזה נוצר כשלוח בקרה נמחק.

type: "dashboard:delete:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  url: "/embed/dashboards/...",
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.options אובייקט המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב בלוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set.

dashboard:tile:start

האירוע הזה נוצר כשמתחילה טעינה של משבצת או כשמתבצעת שאילתה לגבי נתונים.

type: "dashboard:tile:start",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id מספר שלם מספר המזהה של האירוע, לא של המשבצת.
tile.title String הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת.
tile.listen אובייקט המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

האירוע הזה נוצר כשמשבצת מסיימת להריץ את השאילתה.

type: "dashboard:tile:complete",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
status: "complete",
truncated: false,
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status String האם השאילתה של המשבצת הושלמה בהצלחה. הערכים האפשריים הם "complete" או "error".
truncated בוליאני האם תוצאות השאילתה של המשבצת נחתכו כי השאילתה החזירה יותר שורות ממגבלת השורות של השאילתה. מגבלת השורות יכולה להיות מגבלת שורות שהמשתמש הגדיר או מגבלת השורות שמוגדרת כברירת מחדל ב-Looker, שהיא 5,000.
tile.id מספר שלם מספר המזהה של האירוע, לא של המשבצת.
tile.title String הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת.
tile.listen אובייקט המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...}
tile.errors מערך אובייקטים השדה הזה מאוכלס כשהמאפיין status הוא "error". מערך של אובייקטים שמספקים פרטים על השגיאה, כולל טקסט הודעת השגיאה, תיאור מפורט יותר של השגיאה ושאילתת ה-SQL של המשבצת שיצרה את השגיאה.

dashboard:tile:download

האירוע הזה נוצר כשההורדה של הנתונים של משבצת מתחילה.

type: "dashboard:tile:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales"
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
fileFormat: "pdf"
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id מספר שלם מספר המזהה של האירוע, לא של המשבצת.
tile.title String הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת.
tile.listen אובייקט המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...}
fileFormat String הפורמט של המשבצת שהורדתם (רק "pdf" בשלב הזה).

dashboard:tile:explore

האירוע הזה נוצר כשמשתמש לוחץ על האפשרות הצגת נתונים נוספים במשבצת במרכז הבקרה.

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.

type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
מאפיין פורמט תיאור
label String תווית הכפתור.
url String כתובת ה-URL היחסית (רק הנתיב) של הניתוח שרוצים להציג.
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id מספר שלם מספר המזהה של האירוע, לא של המשבצת.
tile.title String הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת.
tile.listen אובייקט המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...}

dashboard:tile:view

האירוע הזה נוצר כשמשתמש לוחץ על האפשרות הצגת המראה המקורי במשבצת של לוח בקרה.

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.

type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
tile: {
  id: 123,
  title: "Quarterly Sales",
  listen: {
    "Date": "order.date",
    "Total Orders": "order.count"
  }
}
מאפיין פורמט תיאור
label String תווית הכפתור.
url String כתובת ה-URL היחסית (רק הנתיב) של טבלת ה-Look שרוצים להציג.
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id מספר שלם מספר המזהה של האירוע, לא של המשבצת.
tile.title String הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת.
tile.listen אובייקט המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...}

dashboard:tile:merge

Added 25.14 האירוע הזה נוצר כשהמשתמש לוחץ על הלחצן עריכת השאילתה הממוזגת או על פריט התפריט עריכת השאילתה הממוזגת. התנהגות ברירת המחדל של הלחצן הזה היא פתיחת חלון חדש ברמה העליונה שמאפשר לערוך את שאילתת המיזוג.

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה. האירוע הזה מאפשר לאפליקציה המטמיעה לפתוח את עריכת שאילתת המיזוג ב-iframe ולא בחלון ברמה העליונה. האפליקציה להטמעה לא צריכה לנסות לטעון את כתובת ה-URL ב-iframe שהפעיל את האירוע. במקום זאת, צריך ליצור iframe חדש.

javascript type: dashboard:tile:merge, label: 'Edit Merged Query', dashboard_id: '13', dashboard_modified: false, tile_id: '218', tile_title: 'Untitled', url: '/embed/merge/edit?did=218&dbnx=1', absoluteUrl: 'https://.../embed/merge/edit?did=218&dbnx=1', target: '_blank',
מאפיין פורמט תיאור
label מחרוזת תווית הכפתור.
dashboard_id מחרוזת המזהה של לוח הבקרה שאליו משויכת משבצת השאילתה הממוזגת.
dashboard_modified בוליאני אם הערך הוא true, המאפיין הזה מציין שהייתה עריכה בלוח הבקרה. אם תמשיכו לערוך את שאילתת המיזוג, יכול להיות שהעדכונים בלוח הבקרה יאבדו. אפליקציית ההטמעה יכולה לבטל את העריכה של שאילתת המיזוג או להזהיר את המשתמש שאולי יש שינויים שלא נשמרו אם הוא ימשיך.
tile_id מחרוזת המזהה של משבצת השאילתה הממוזגת.
tile_title מחרוזת השם של המשבצת.
url מחרוזת כתובת ה-URL של השאילתה הממוזגת. אפשר להשתמש במאפיין הזה עם SDK להטמעה כדי ליצור iframe חדש לשאילתה הממוזגת.
absoluteUrl מחרוזת כתובת ה-URL המלאה של השאילתה הממוזגת. אפשר להשתמש במאפיין הזה בתור src של רכיב ה-iframe. יהיה צורך במאפיינים נוספים.
target מחרוזת המזהה שישמש לשם החלון שייפתח.

dashboard:filters:changed

האירוע הזה נוצר כשמחילים או משנים את המסננים של לוח הבקרה.

type: "dashboard:filters:changed",
dashboard: {
  id: 23,
  title: "My Dashboard",
  canEdit: true,
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
  options: {
    layouts: [
      {
        id: 1,
        dashboard_id: 1,
        type: "newspaper",
        active: true,
        column_width: null,
        width: null,
        deleted: false,
        dashboard_layout_components: [
          {
            id: 1,
            dashboard_layout_id: 1,
            dashboard_element_id: 1,
            row: 0,
            column: 0,
            width: 8,
            height: 4,
            deleted: false
          },
          {
            id: 2,
            dashboard_layout_id: 1,
            dashboard_element_id: 2,
            row: 0,
            column: 8,
            width: 8,
            height: 4,
            deleted: false
          }
        ]
      }
    ],
    elements: {
      1: {
        title: "Total Orders",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          font_size: "medium",
          title: "Total Orders"
        }
      },
      2: {
        title: "Average Order Profit",
        title_hidden: false,
        vis_config: {
          type: "single_value",
          title: "Average Order Profit"
        }
      }
    }
  }
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה.
dashboard.title String הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה.
dashboard.canEdit בוליאני נוסף בגרסה 22.20 אם true, המשתמש יכול לערוך את לוח הבקרה.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב).
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options אובייקט המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב בלוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set.

look:ready

האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Look, בין אם השאילתה מופעלת ובין אם לא.

type: "look:ready",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
מאפיין פורמט תיאור
look.url String כתובת ה-URL היחסית של ה-Look (רק הנתיב)
look.absoluteUrl String כתובת ה-URL המלאה של טבלת Look

look:run:start

האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Look והשאילתה מתחילה לפעול.

type: "look:run:start",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
מאפיין פורמט תיאור
look.url String כתובת ה-URL היחסית של ה-Look (רק הנתיב)
look.absoluteUrl String כתובת ה-URL המלאה של טבלת Look

look:run:complete

האירוע הזה נוצר כששאילתה של Look מסתיימת.

type: look:run:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
מאפיין פורמט תיאור
look.url String כתובת ה-URL היחסית של ה-Look (רק הנתיב)
look.absoluteUrl String כתובת ה-URL המלאה של טבלת Look

look:edit:start

נוסף ב-25.10 האירוע הזה מופעל כשמבצעים מעבר של תצוגה למצב עריכה.

type: "look:edit:start",
look: {
  id: 46,
  title: "My Look",
  url: "/embed/looks/46",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
מאפיין פורמט תיאור
look.id String המזהה של טבלת ה-Look.
look.title String הכותרת של ה-Look.
url String כתובת ה-URL היחסית של ה-Look (רק הנתיב).
absoluteUrl String כתובת ה-URL המלאה של טבלת Look.

look:edit:cancel

Added 25.10 האירוע הזה מופעל כשיוצאים ממצב עריכה של תצוגה בלי לשמור אותה.

type: "look:edit:cancel",
look: {
  id: 46,
  title: "My Look",
  url: "/embed/looks/46",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
מאפיין פורמט תיאור
look.id String המזהה של טבלת ה-Look.
look.title String הכותרת של ה-Look.
url String כתובת ה-URL היחסית של ה-Look (רק הנתיב).
absoluteUrl String כתובת ה-URL המלאה של טבלת Look.

look:save:complete

האירוע הזה נוצר כשעורכים ושומרים טבלת Look. האירוע הזה נוצר כשמשתמש מבצע אחת מהמשימות הבאות:

האירוע הזה לא נוצר אם שומרים את טבלת Look באמצעות האפשרות שמירה > ללוח בקרה קיים או עריכת ההגדרות בתפריט.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
מאפיין פורמט תיאור
look.url String כתובת ה-URL היחסית של ה-Look (רק הנתיב)
look.absoluteUrl String כתובת ה-URL המלאה של טבלת Look
look.folderid מספר שלם מזהה התיקייה שבה שמור ה-Look

look:delete:complete

האירוע הזה נוצר כשמעבירים טבלת Look לתיקיית האשפה.

type: look:delete:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
מאפיין פורמט תיאור
look.url String כתובת ה-URL היחסית של ה-Look (רק הנתיב)
look.absoluteUrl String כתובת ה-URL המלאה של טבלת Look

drillmenu:click

האירוע הזה נוצר כשמשתמש לוחץ על תפריט פירוט בלוח בקרה שנוצר באמצעות הפרמטר link LookML. לדוגמה, קוד ה-LookML הבא יוצר תפריט של פירוט נתונים שבו משתמש יכול להציג נתונים שמסוננים לפי המאפיין state:


dimension: state {
  type: string
  sql: ${TABLE}.state ;;
  link: {
    label: "Filter by {{ state | encode_uri }}"
    url: "filter::q={{ state | encode_uri }}"
    icon_url: "https://google.com/favicon.ico"
  }
}

כשמסנן state מוגדר לערך Illinois, האירוע drillmenu:click מחזיר את הערכים הבאים למארח של ה-iframe:

type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.

מאפיין פורמט תיאור
label String התווית של הקישור כפי שהיא מוצגת בתפריט ההסתעפות
link_type String סוג האובייקט ביעד הקישור
modal בוליאני אם תיבת הדו-שיח של ההסתעפות תהיה בשימוש במקום הניווט בדפדפן
target String ‫Is _self אם יעד הקישור יחליף את ה-iframe הנוכחי, _blank אם יעד הקישור יפתח חלון חדש
url String כתובת היעד של הקישור
context String מאפיין פנימי שמשמש חלק מסוגי ההדמיות

הוספת ארגז חול ל-iframe תמנע פתיחה של לחיצות על תפריט ההסתעפות בחלון חדש. משתמשים בערכי הארגז חול האלה בתוך תג ה-iframe:

sandbox = "allow-same-origin allow-scripts"

drillmodal:download

האירוע הזה נוצר כשמשתמש פותח תיבת דו-שיח של הסתעפות מפרט בלוח בקרה ולוחץ על האפשרות הורדה.

{
type: "drillmodal:download",
dashboard: {
  id: 23,
  title: "My Dashboard",
  url: "/embed/dashboards/…",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
  dashboard_filters: {
    "Date": "Last 28 days",
    "Total Orders": "Greater than 100"
  }
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
מאפיין פורמט תיאור
dashboard.id מספר/מחרוזת המזהה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.title String הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת.
dashboard.url String כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת.
dashboard.absoluteUrl String כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת.
dashboard.dashboard_filters אובייקט המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl String כתובת ה-URL היחסית של התצוגה המקדימה (רק הנתיב) להורדה.
fileFormat String פורמט הקובץ של הנתונים להורדה.

drillmodal:explore

האירוע הזה נוצר כשמשתמש לוחץ על האפשרות Explore From Here (המשך החיפוש מכאן) בתיבת דו-שיח של פירוט.

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
מאפיין פורמט תיאור
label String תווית הלחצן כפי שהיא מוצגת בתפריט ההסתעפות
url String כתובת ה-URL היחסית של הדף 'ניתוח נתונים' (רק הנתיב) שרוצים להציג

explore:ready

האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה בניתוח, בין אם השאילתה מופעלת ובין אם לא.

type: "explore:ready",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
מאפיין פורמט תיאור
explore.url String כתובת ה-URL היחסית של התכונה 'חיפוש ויזואלי' (רק הנתיב)
explore.absoluteUrl String כתובת ה-URL המלאה של התכונה 'חיפוש'

explore:run:start

האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Explore והשאילתה מתחילה לפעול.

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
מאפיין פורמט תיאור
explore.url String כתובת ה-URL היחסית של התכונה 'חיפוש ויזואלי' (רק הנתיב)
explore.absoluteUrl String כתובת ה-URL המלאה של התכונה 'חיפוש'

explore:run:complete

האירוע הזה נוצר כשניתוח מסוג Explore מסיים להריץ את השאילתה.

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
מאפיין פורמט תיאור
explore.url String כתובת ה-URL היחסית של התכונה 'חיפוש ויזואלי' (רק הנתיב)
explore.absoluteUrl String כתובת ה-URL המלאה של התכונה 'חיפוש'

explore:state:changed

האירוע הזה נוצר כשכתובת ה-URL של דף החיפוש משתנה כתוצאה מהפעולות של המשתמש.

type: "explore:state:changed",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
מאפיין פורמט תיאור
explore.url String כתובת ה-URL היחסית של התכונה 'חיפוש ויזואלי' (רק הנתיב)
explore.absoluteUrl String כתובת ה-URL המלאה של התכונה 'חיפוש'

page:changed

האירוע הזה נוצר כשמשתמש מנווט לדף חדש בתוך ה-iframe.

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
מאפיין פורמט תיאור
page.type String סוג הדף שאליו בוצעה הניווט, כמו "dashboard",‏ "look" או "explore"
page.url String כתובת ה-URL היחסית (רק הנתיב) של הדף שאליו בוצעה הניווט
page.absoluteUrl String כתובת ה-URL המלאה של הדף שאליו עברו הרגע

page:properties:changed

האירוע הזה נוצר כשגובה ה-iframe של לוח הבקרה משתנה. האפשרות הזו לא זמינה ב-Looks או ב-Explores כי הגובה של הפריטים האלה מותאם אוטומטית לגודל של ה-iframe.

type: "page:properties:changed",
height: 1000
מאפיין פורמט תיאור
height מספר שלם הגובה של ה-iframe של לוח הבקרה בפיקסלים

session:tokens

האירוע הזה מציין שלקוח Looker צריך אסימונים כדי להמשיך. האירוע הזה נוצר מיד עם יצירת ה-iframe, ומעכשיו הוא יחזור על עצמו מעת לעת למשך הסשן.

{
  "type": "session:tokens",
  "api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
  "api_token_ttl": 463,
  "navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
  "navigation_token_ttl": 463,
  "session_reference_token_ttl": 2924
}
מאפיין פורמט תיאור
authentication_token String טוקן אימות. הפרמטר הזה נכלל כשה-iframe נוצר. לא נכלל בתשובה לבקשה ליצירת טוקנים או אם תוקף הסשן פג.
authentication_token_ttl מספר אורך חיים (TTL) של טוקן האימות בשניות. הפרמטר הזה נכלל כשה-iframe נוצר. לא נכלל בתשובה לבקשה ליצירת טוקנים או אם תוקף הסשן פג.
api_token String טוקן API. לא נכלל אם תוקף הסשן פג.
api_token_ttl מספר אורך חיים (TTL) של אסימון ה-API בשניות. לא נכלל אם תוקף הסשן פג.
navigation_token String טוקן ניווט. לא נכלל אם תוקף הסשן פג.
navigation_token_ttl מספר אורך חיים (TTL) של אסימון הניווט בשניות. לא נכלל אם תוקף הסשן פג.
session_references_token_ttl מספר אורך חיים (TTL) של הסשן בשניות. הערך יהיה 0 כשתוקף הסשן יפוג. כדי לשחזר את הגישה, אפליקציית ההטמעה צריכה לקבל סשן חדש.

session:expired

Added 25.10 האירוע הזה מופעל כשפג תוקף הסשן של המשתמש שמוטמע.

type: "session:expired",

לאירוע הזה אין מטען ייעודי (payload).

session:status

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

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
מאפיין פורמט תיאור
session_ttl מספר אורך חיים (TTL) של הסשן בשניות.
expired בוליאני כשמופיע true, זה אומר שתוקף הסשן פג.
interrupted בוליאני כשמופיע true, זה מציין שלא הייתה תגובה לבקשה של טוקנים לסשן. יכול להיות שהמשמעות היא שהשרת לא זמין באופן זמני.
recoverable בוליאני השדה הזה מאוכלס רק אם הערך של interrupted הוא true. מציין אם אפשר לשחזר את הסשן או לא. ערך של false כנראה מצביע על בעיה באפליקציה להטמעה.

env:client:dialog

האירוע נוצר כשנפתחה תיבת דו-שיח שאולי לא מוצגת במלואה, כמו תיבת דו-שיח של התעמקות בנתונים. האירוע הזה מאפשר לאפליקציה המארחת לגלול את תיבת הדו-שיח לתצוגה באמצעות הפעולה env:host:scroll.

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
מאפיין פורמט תיאור
type String ‫env:client:dialog מציין שתיבת דו-שיח נפתחה או נסגרה. רק תיבת הדו-שיח של הפירוט נתמכת, אבל יכול להיות שבעתיד יתווספו עוד תיבות דו-שיח. יכול להיות שהחלק העליון של תיבת הדו-שיח של הניתוח לא מוצג כי תיבת הדו-שיח מכסה את אזור התצוגה של ה-iframe. האירוע הזה מאפשר לאפליקציית המארח לגלול את החלק העליון של תיבת הדו-שיח לתצוגה.
dialogType String סוג תיבת הדו-שיח. האירוע הזה מופעל רק כשפותחים או סוגרים את תיבת הדו-שיח מסוג 'הסתעפות'.
placement String המיקום של תיבת הדו-שיח. תיבות דו-שיח מסוג 'הסתעפות' תמיד משתמשות בערך placement cover.
open בוליאני מציין אם תיבת הדו-שיח נפתחה או שהמשתמש גלל בה.

ביצוע שינויים ב-iframe

אחרי ההכנה של ה-iframe לאחזור נתונים, אפשר לבצע שינויים ב-iframe באופן הבא:

  1. כותבים את הבקשה ב-JSON.
  2. פרסום הבקשה ב-iframe של contentWindow.

כתיבת הבקשה ב-JSON

אפשר לבצע כמה שינויים ב-iframe, ואז לשלוח אותו בפורמט JSON. האפשרויות הזמינות מתוארות בקטע הפניה לפעולות בדף הזה. אל תשכחו להשתמש ב-JSON.stringify כדי להפוך את הפעולה ל-JSON, כמו בדוגמה הבאה:

var my_request = JSON.stringify(
  {
    type: "dashboard:run"
  }
);

פרסום הבקשה במאפיין contentWindow של ה-iframe

לבסוף, מפרסמים את ההודעה ב-iframe contentWindow, כך:

var my_iframe = document.getElementById("my_iframe_id");

my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');

טבלת סיכום הפעולות

בטבלה הבאה מפורטות הפעולות. בוחרים פעולה כדי לראות את הפרטים שלה.

פעולה תיאור הפעולה
page:load טוען דף חדש ב-iframe, ומחליף את הדף הקיים.
dashboard:load טוען לוח בקרה חדש ב-iframe, ומחליף לוח בקרה קיים.
dashboard:run הפעלת מרכז הבקרה ב-iframe.
dashboard:edit ‫Added 22.20 מעבר של מרכז הבקרה אל מצב עריכה.
dashboard:filters:update עדכון של מסנן קיים בלוח הבקרה ב-iframe.
dashboard:options:set כתיבת ערכים חדשים לפריסת לוח הבקרה ולמאפיינים של רכיבי לוח הבקרה.
dashboard:schedule_modal:open פותח את הכלי לתזמון, שמאפשר למשתמשים לשלוח תוכן של Looker ליעדים שונים.
dashboard:stop הפעולה הזו מפסיקה את הפעלת מרכז הבקרה או את טעינת הנתונים שלו.
look:run מריצה את ה-Look ב-iframe.
look:filters:update מעדכן מסנן Look קיים ב-iframe.
explore:run הפעלת התכונה 'אפשרויות נוספות' ב-iframe.
explore:filters:update מעדכן או מסיר מסנן קיים של ניתוח ב-iframe.
session:tokens:request שולח טוקנים בתגובה לאירוע session:tokens:request.
env:host:scroll שולח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת.

מידע על פעולות

אלה הפעולות הזמינות שאפשר לפרסם ב-iframe המוטמע:

page:load

אפשר להשתמש בפעולה הזו כדי לנווט לתוכן חדש בתוך ה-iframe, במקום התוכן הקיים. הפעולה הזו דומה לפעולה dashboard:load, אבל היא גמישה יותר כי אפשר לציין פרמטרים נוספים בכתובת ה-URL.

יש הבדלים בהתנהגות שצריך לקחת בחשבון לפני שמשתמשים ב-page:load. אם מרכז הבקרה הנוכחי נמצא בעריכה, dashboard:load ימנע את הניווט. ‫page:load לא מונע את הניווט. אפליקציית המארח יכולה לקבוע אם מתבצעת עריכה של מרכז בקרה או של Look על ידי מעקב אחרי dashboard:edit:start, look:edit:start ואירועי סיום העריכה התואמים. לכן, מומלץ להשתמש ב-SDK להטמעה. ה-SDK להטמעה עוקב אחרי עריכה של מרכז בקרה או של Look, ולכן אפשר לשלוח שאילתה לחיבור כדי לראות אם התוכן נערך לפני הניווט.

{
    type: 'page:load',
    url: '/embed/dashboard/32?state=california,
    pushHistory: false
}
מאפיין פורמט תיאור
type String שימוש בסוג page:load מציין שרוצים לטעון תוכן חדש לתוך ה-iframe.
url String כתובת ה-URL של התוכן לטעינה.
pushHistory בוליאני אם true, התוכן שנטען יוצר רשומה חדשה בהיסטוריית הדפדפן, והמשתמש יכול להשתמש בלחצן 'הקודם' בדפדפן כדי לחזור לתוכן הקודם. אם בוחרים באפשרות false, התוכן הנוכחי יוחלף ולא ניתן יהיה להשתמש בניווט בדפדפן כדי לחזור אליו.

dashboard:load

משתמשים בפעולה הזו כדי לטעון לוח בקרה חדש ב-iframe, במקום לוח בקרה קיים. לוח הבקרה החדש יתחיל להריץ שאילתות כאילו נפתח דף חדש של לוח הבקרה.

{
  type: "dashboard:load",
  id: "101",
  pushHistory: false
}
מאפיין פורמט תיאור
type String השימוש בסוג dashboard:load מציין שרוצים לטעון ל-iframe לוח בקרה חדש.
id String המזהה של לוח הבקרה שרוצים לטעון.
pushHistory בוליאני אם true, מרכז הבקרה שנטען יוצר רשומה חדשה בהיסטוריית הדפדפן, והמשתמש יכול להשתמש בכפתור 'הקודם' בדפדפן כדי לחזור למרכז הבקרה הקודם. אם false, מרכז הבקרה הנוכחי מוחלף ואי אפשר להשתמש בניווט בדפדפן כדי לחזור אליו.

dashboard:run

אפשר להשתמש בפעולה הזו כדי להריץ את לוח הבקרה ב-iframe. זו אותה פעולה כמו לחיצה על הכפתור הפעלה או טעינה מחדש של הנתונים בלוח הבקרה.

{
  type: "dashboard:run"
}
מאפיין פורמט תיאור
type String שימוש בסוג dashboard:run מציין שרוצים להפעיל את לוח הבקרה.

dashboard:edit

Added 22.20 משתמשים בפעולה הזו כדי להעביר מרכז בקרה קיים ב-iframe למצב עריכה. זו אותה פעולה כמו בחירה באפשרות עריכת לוח הבקרה בתפריט לוח הבקרה.

{
  type: "dashboard:edit"
}
מאפיין פורמט תיאור
type String השימוש בסוג dashboard:edit מציין שרוצים להעביר את מרכז הבקרה למצב עריכה.

dashboard:filters:update

משתמשים בפעולה הזו כדי לעדכן מסנן קיים של לוח בקרה ב-iframe. אי אפשר להוסיף מסנן חדש ללוח הבקרה באמצעות השיטה הזו.

{
  type: "dashboard:filters:update",
  filters: {
    "Sale date": "Last 28 days",
    "Sale amount": "Greater than 100"
  }
}
מאפיין פורמט תיאור
type String השימוש בסוג dashboard:filters:update מציין שרוצים לעדכן את המסננים שבהם נעשה שימוש בלוח הבקרה.
filters אובייקט המסננים החדשים שרוצים להחיל על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

הפעולה הזו זמינה אחרי שהאירוע dashboard:run:complete מתרחש.

הקוד להטמעה יוצר את ההודעה ושולח אותה ל-iframe, אבל לוח הבקרה לא מגיב עד שמתרחש dashboard:run:complete. הפעולה dashboard:options:set כותבת ערכים חדשים לפריסת לוח הבקרה ולמאפיינים של רכיבים בלוח הבקרה. אפשר לעדכן באמצעות dashboard:options:set רק נכסים שהוחזרו במאפיין options של אירוע dashboard:run:complete. מערכת Analytics מתעלמת מכל מאפיין שהוגדר ולא הוחזר קודם לכן על ידי מאפיין options של האירוע dashboard:run:complete.

{
  type: "dashboard:options:set",
  layouts: [
    {
      id: 1,
      dashboard_id: 1,
      type: "newspaper",
      active: true,
      column_width: null,
      width: null,
      deleted: false,
      dashboard_layout_components: [
        {
          id: 1,
          dashboard_layout_id: 1,
          dashboard_element_id: 1,
          row: 0,
          column: 0,
          width: 8,
          height: 4,
          deleted: false
        },
        {
          id: 2,
          dashboard_layout_id: 1,
          dashboard_element_id: 2,
          row: 0,
          column: 8,
          width: 8,
          height: 4,
          deleted: false
        }
      ]
    }
  ],
  elements: {
    1: {
      title: "Total Orders",
      title_hidden: false,
      vis_config: {
        type: "single_value",
        font_size: "medium",
        title: "Total Orders"
      }
    },
    2: {
      title: "Average Order Profit",
      title_hidden: false,
      vis_config: {
        type: "single_value",
        title: "Average Order Profit"
      }
    }
  }
}
מאפיין פורמט תיאור
type String השימוש בסוג dashboard:options:set מציין שרוצים לכתוב ערכים חדשים לפריסות של לוחות בקרה ולמאפיינים של רכיבים בלוחות בקרה.
layouts אובייקט מאפייני פריסת מרכז הבקרה שמוחזרים על ידי המאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components אובייקט אובייקט אחד או יותר של רכיב פריסת לוח הבקרה שמוחזר על ידי מאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements אובייקט אובייקט אחד או יותר של רכיב בלוח הבקרה שהוחזר על ידי המאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:

id: {

  title: "string",

  title_hidden: boolean,

  vis_config: {

    type: "string", title: "string"

  }

}

dashboard:schedule_modal:open

הפעולה הזו מאפשרת לפתוח את הכלי לתזמון, שבו המשתמשים יכולים לשלוח תוכן מ-Looker ליעדים שונים.

{
  type: "dashboard:schedule_modal:open"
}
מאפיין פורמט תיאור
type String השימוש בסוג dashboard:schedule_modal:open מציין שרוצים לפתוח את תיבת הדו-שיח תזמון.

dashboard:stop

משתמשים בפעולה הזו כדי לעצור לוח בקרה שפועל או טוען מחדש נתונים. זו אותה פעולה כמו לחיצה על הלחצן ביטול בלוח הבקרה. כשמפסיקים להשתמש בלוח בקרה , נשלח אירוע עם הערך  בפרמטר .dashboard:stopdashboard:run:completestatus:"stopped"

{
  type: "dashboard:stop"
}
מאפיין פורמט תיאור
type String שימוש בסוג dashboard:stop מציין שרוצים להפסיק את הפעלת מרכז הבקרה.

look:run

אפשר להשתמש בפעולה הזו כדי להריץ את השאילתה שעליה מבוסס ה-Look ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן הפעלה ב-Look, אבל ההבדל הוא ש-look:run תמיד שולפת נתונים ישירות ממסד הנתונים ולא מאחזרת נתונים ממטמון Looker.

{
  type: "look:run"
}
מאפיין פורמט תיאור
type String שימוש בסוג look:run מציין שרוצים להריץ את ה-Look.

look:filters:update

משתמשים בפעולה הזו כדי לעדכן מסנן Look קיים ב-iframe. אי אפשר להוסיף מסנן חדש ל-Look באמצעות השיטה הזו.

{
  type: "look:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "products.department": "sweaters"
  }
}
מאפיין פורמט תיאור
type String שימוש בסוג look:filters:update מציין שרוצים לעדכן את המסננים שבהם נעשה שימוש ב-Look.
filters אובייקט המסננים החדשים שרוצים להחיל על ה-Look. הפורמט של האובייקט הזה הוא: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

משתמשים בפעולה הזו כדי להריץ את הניתוח ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן הפעלה בכלי הניתוחים, אבל explore:run תמיד שולחת שאילתות ישירות למסד הנתונים ולא מאחזרת נתונים ממטמון Looker.

{
  type: "explore:run"
}
מאפיין פורמט תיאור
type String השימוש בסוג explore:run מציין שרוצים להריץ את התכונה 'מה יש באזור'.

explore:filters:update

משתמשים בפעולה הזו כדי לעדכן או להסיר מסנן קיים של ניתוח ב-iframe. אם כוללים מסנן חדש שמפנה לשדה תקין, המסנן החדש יתווסף לניתוח.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
מאפיין פורמט תיאור
type String השימוש בסוג explore:filters:update מציין שרוצים לעדכן את המסננים שמשמשים את התכונה 'חיפוש מתקדם'.
filters אובייקט המסננים החדשים שרוצים להחיל על הניתוח. אם filters כולל מסנן שלא קיים בכלי הניתוחים אבל מפנה לשדה תקין, המסנן הזה יתווסף לכלי הניתוחים. האובייקט הזה הוא בפורמט {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}.
deleteFilters מערך המסננים הקיימים שרוצים להסיר מהניתוח. המערך הוא בפורמט: ["view_name.field_name_1", "view_name.field_name_2", ...]

session:tokens:request

משתמשים בפעולה הזו כדי לשלוח אסימונים בתגובה לבקשת session:tokens:request.

{
  type: "session:tokens:request",
}
מאפיין פורמט תיאור
type String שימוש בסוג session:tokens:request מציין שרוצים לשלוח טוקנים בתגובה לאירוע session:tokens:request.

env:host:scroll

משתמשים בפעולה הזו כדי לשלוח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת.

{
  type: "env:host:scroll",
  offsetTop: 10,
  offsetLeft: 10,
  scrollX: 5,
  scrollY: 5
}
מאפיין פורמט תיאור
type String השימוש בסוג env:host:scroll מציין שאתם רוצים לשלוח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת.
offsetTop מספר ההיסט העליון של ה-iframe.
offsetLeft מספר ההיסט שמאלה של ה-iframe.
scrollX מספר מיקום scrollX של מארח האפליקציה.
scrollY מספר המיקום של מארח האפליקציה בציר Y של הגלילה.