Eingebettete JavaScript-Ereignisse

Nachdem du eine Einbettung erstellt hast, was öffentlich, privat mit signierter Einbettung oder über die API möglich ist, kannst du über JavaScript mit diesen iFrames interagieren. Je nach Status des eingebetteten Elements können Sie Ihre Seite dynamischer gestalten. Sie können sogar Änderungen am eingebetteten Element auf Ihrer Webseite vornehmen.

Beachten Sie, dass Looker nicht die Reihenfolge steuert, in der Browser Ereignisse an Webanwendungen senden. Das bedeutet, dass die Reihenfolge der Ereignisse für alle Browser und Plattformen nicht garantiert werden kann. Achten Sie darauf, dass Sie Ihren JavaScript-Code richtig schreiben, um die Ereignisverarbeitung verschiedener Browser zu berücksichtigen.

Sie können JavaScript auf eine der folgenden Arten für eingebettete Inhalte in Looker verwenden:

  • Mit dem eingebetteten Software Development Kit (SDK) von Looker, wie auf der Dokumentationsseite zum Embed SDK beschrieben
  • JavaScript-Ereignisse verwenden, wie im Abschnitt In JavaScript auf Ereignisse zugreifen auf dieser Seite beschrieben

Vorbereitung

Bevor Sie mit dem eingebetteten iFrame interagieren können, müssen Sie die folgenden Schritte ausführen:

ID zum iFrame hinzufügen

Wenn Sie später Daten aus dem iFrame abrufen, müssen Sie prüfen, ob die Informationen, mit denen Sie arbeiten, tatsächlich aus dem iFrame von Looker stammen. Fügen Sie Ihrem iFrame eine ID hinzu, falls Sie dies noch nicht getan haben. Im folgenden Beispiel setzen Sie die ID auf looker, indem Sie id="looker" in den iFrame einfügen:

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

Einbettungsdomain dem iFrame-Attribut src hinzufügen

Geben Sie im Attribut src des iFrames die Domain an, in der der iFrame verwendet wird. Im folgenden Beispiel können Sie myownpersonaldomain.com als Domain angeben, indem Sie ?embed_domain=https://myownpersonaldomain.com" am Ende der URL im Attribut src hinzufügen:

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

Wenn du signierte Einbettung verwendest, musst du der Einbettungs-URL die embed_domain hinzufügen.

Wenn du das Embed SDK verwendest, füge sdk=2 am Ende der Einbettungs-URL hinzu. Der Parameter sdk=2 gibt an, dass das SDK vorhanden ist und dass Looker die zusätzlichen Funktionen des SDK nutzen kann, z. B. die Übergabe von JavaScript-Ereignissen zwischen dem Looker-iFrame und Ihrer Domain. Das SDK kann diesen Parameter nicht selbst hinzufügen, da er Teil der signierten URL ist. Beispiel:

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

Einbettungsdomain der Zulassungsliste hinzufügen

Abschließend müssen Sie die Domain, in der der iFrame verwendet wird, auf der Seite Einbetten im Admin-Bereich von Looker auf die Zulassungsliste setzen. Gehen Sie dazu so vor:

  1. Geben Sie im Feld Zulassungsliste für eingebettete Domains die Domain ein, in der der iFrame verwendet wird. Drücken Sie dann die Tabulatortaste, damit die Domain in einem Feld innerhalb des Felds angezeigt wird.

  2. Klicken Sie auf Aktualisieren.

Sie können den Platzhalter * in der Zulassungsliste verwenden, um ein Domainmuster zu erstellen. https://*.myownpersonaldomain.com lässt beispielsweise sowohl https://analytics.myownpersonaldomain.com als auch https://data.myownpersonaldomain.com zu.

Wenn Sie eine Einbettung ohne Cookies mit Looker 23.8 oder höher verwenden, kann die Einbettungsdomain angegeben werden, wenn die Sitzung ohne Cookies abgerufen wird. Das ist eine Alternative, um die Domain eingebetteter Inhalte über den Bereich Verwaltung > Einbetten auf die Zulassungsliste zu setzen. Lesen Sie die Best Practices für die Sicherheit, wenn Sie diese Funktion nutzen möchten.

Daten aus dem iFrame werden abgerufen

Nachdem Sie die Vorbereitung abgeschlossen haben, können Sie auf die Ereignisse zugreifen, die zwischen dem Looker-iFrame und Ihrer Domain übergeben werden. Warten Sie dazu auf postMessage-Ereignisse.

Mit dem eingebetteten iFrame lassen sich einige Ereignistypen erstellen, wie im Abschnitt Referenz zu Ereignistypen auf dieser Seite beschrieben.

Ereignisse in JavaScript aufrufen

Im Folgenden finden Sie ein Beispiel dafür, wie diese Ereignisse im nativen JavaScript überwacht und dann in der Konsole protokolliert werden:

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));
    }
  }
});

Hier ist ein Beispiel, wie Sie diese Ereignisse in jQuery überwachen und dann in der Konsole protokollieren:

$(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));
    }
  }
});

Tabelle mit Zusammenfassung der Ereignistypen

In der folgenden Tabelle sind die Ereignistypen zusammengefasst. Wählen Sie einen Ereignistyp aus, um die Details zu diesem Termin aufzurufen.

Ereignistyp Ursache des Ereignisses
dashboard:loaded In Dashboards, in denen die Tiles nicht auf die automatische Ausführung eingestellt sind, wurden ein Dashboard und seine Elemente geladen, aber es werden noch keine Abfragen ausgeführt.
dashboard:run:start Ein Dashboard hat mit dem Laden begonnen, und seine Tiles haben mit dem Laden und Abfragen von Daten begonnen.
dashboard:run:complete Ein Dashboard wurde ausgeführt und alle Tiles wurden geladen und abgefragt.
dashboard:download Der Download einer PDF-Datei eines Dashboards wurde gestartet.
dashboard:edit:start ADDED 22.20 Ein Dashboard wurde in den Bearbeitungsmodus gewechselt. Das dashboard:save:complete-Ereignis wird ausgelöst, wenn das Dashboard erfolgreich gespeichert wurde.
dashboard:edit:cancel ADDED 22.20 Bei einem Dashboard, das sich im Bearbeitungsmodus befindet, wurde der Bearbeitungsmodus ohne Speichern beendet.
dashboard:save:complete Ein Dashboard wurde bearbeitet und gespeichert.
dashboard:delete:complete Ein Dashboard wurde gelöscht.
dashboard:tile:start Eine Tile hat mit dem Laden oder Abfragen von Daten begonnen.
dashboard:tile:complete Eine Tile hat die Ausführung der Abfrage beendet.
dashboard:tile:download Der Download der Daten einer Kachel wurde gestartet.
dashboard:tile:explore Ein Nutzer hat in einer Dashboard-Kachel auf die Option Explore From Here geklickt.
dashboard:tile:view Ein Nutzer hat in einer Dashboard-Tile auf die Option Ursprünglichen Look anzeigen geklickt.
dashboard:filters:changed Die Filter eines Dashboards wurden angewendet oder geändert.
look:ready Ein Look hat begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
look:run:start Ein Look hat begonnen, Abfragedaten zu laden, und die Abfrage hat begonnen, die Abfrage auszuführen.
look:run:complete Ein Look hat die Ausführung der Abfrage beendet.
look:save:complete Ein Look wurde bearbeitet und gespeichert.
look:delete:complete Ein Look wurde in den Papierkorb verschoben.
drillmenu:click Ein Nutzer hat auf ein Aufschlüsselungsmenü in einem Dashboard geklickt, das mit dem LookML-Parameter link erstellt wurde.
drillmodal:download Ein Nutzer hat über eine Dashboardkachel ein Dialogfeld zur Aufschlüsselung geöffnet und auf die Option Herunterladen geklickt.
drillmodal:explore Ein Nutzer hat in einem Aufschlüsselungsdialogfeld auf die Option Explore From Here geklickt.
explore:ready Ein Explore hat begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
explore:run:start Ein Explore hat begonnen, Abfragedaten zu laden, und die Abfrage hat begonnen, die Abfrage auszuführen.
explore:run:complete Ein Explore hat die Ausführung der Abfrage abgeschlossen.
explore:state:changed Die URL einer Explore-Seite hat sich aufgrund der Aktionen des Nutzers geändert.
page:changed Ein Nutzer hat eine neue Seite im iFrame aufgerufen.
page:properties:changed Die Höhe eines Dashboard-iFrames hat sich geändert.
session:tokens Der Looker-Client benötigt Tokens, um fortzufahren.
session:status Sendet Informationen zum Status einer Sitzung.
env:client:dialog Ein Dialogfeld wurde geöffnet, das teilweise nicht zu sehen ist, z. B. ein Drilldown-Dialogfeld. Dieses Ereignis ermöglicht der Hosting-Anwendung, das Dialogfeld sichtbar zu machen.

Ereignistypreferenz

Der eingebettete iFrame kann viele verschiedene Arten von Ereignissen erstellen:

dashboard:loaded

In Dashboards, in denen die Tiles nicht auf die automatische Ausführung eingestellt sind, wird dieses Ereignis erstellt, nachdem ein Dashboard und seine Elemente geladen wurden, aber bevor Abfragen ausgeführt werden.


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"
        }
      }
    }
  }
}
Attribut Format Beschreibung
status String Gibt an, ob das Dashboard und seine Elemente erfolgreich geladen wurden.
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.options Objekt Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options-Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set-Ereignis aktualisierte Werte erhalten.

dashboard:run:start

Dieses Ereignis wird erstellt, wenn ein Dashboard mit dem Laden begonnen hat, wenn seine Tiles mit dem Laden und der Abfrage von Daten beginnen.

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"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard ausgeführt wurde und alle Tiles geladen und abgefragt wurden. Dieses Ereignis wird unabhängig davon erstellt, ob alle Kacheln erfolgreich geladen wurden oder nicht.

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"
        }
      }
    }
  }
}
Attribut Format Beschreibung
status String Gibt an, ob das Dashboard und seine Elemente erfolgreich ausgeführt wurden. Wenn das Dashboard und seine Elemente erfolgreich ausgeführt wurden, gibt status den Wert "complete" zurück. Andernfalls gibt status den Wert "error" zurück. Wenn das ausgeführte Dashboard entweder über die Benutzeroberfläche oder mit der Aktion dashboard:stop beendet wurde, gibt status den Wert "stopped" zurück.
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objekt Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options-Objekt zurückgegebenen Eigenschaften können mit der Aktion dashboard:options:set aktualisierte Werte erhalten.
dashboard.tileStatuses Objektarray Ein Array von Objekten, die Kachelstatus angeben. Objekteigenschaften sind:

  • tileId: die ID-Nummer der Kachel.
  • status: Wenn die Kachelabfrage erfolgreich ausgeführt wurde, gibt status den Wert "complete" zurück. Andernfalls gibt status den Wert "error" zurück.
  • errors: Wird ausgefüllt, wenn die Eigenschaft status den Wert "error" hat. Ein Array von Objekten, die Details zum Fehler angeben, einschließlich des Fehlermeldungstextes, einer detaillierteren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat.

dashboard:download

Dieses Ereignis wird erstellt, wenn der Download einer PDF-Datei eines Dashboards gestartet wurde.

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"
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat String Das Format des heruntergeladenen Dashboards (derzeit nur "pdf").

dashboard:edit:start

ADDED 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard in den Bearbeitungsmodus wechselt.

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"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

ADDED 22.20 Dieses Ereignis wird erstellt, wenn ein Dashboard im Bearbeitungsmodus ohne Speichern den Bearbeitungsmodus beendet wird.

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"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:save:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard bearbeitet und dann gespeichert wird.

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"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.options Objekt Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options-Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set-Ereignis aktualisierte Werte erhalten.

dashboard:delete:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard gelöscht wird.

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"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.options Objekt Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options-Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set-Ereignis aktualisierte Werte erhalten.

dashboard:tile:start

Dieses Ereignis wird erstellt, wenn eine Tile mit dem Laden oder Abfragen von Daten beginnt.

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"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID-Nummer des Ereignisses, nicht die Kachel.
tile.title String Der Kacheltitel, wie er oben in der Tile angezeigt wird.
tile.listen Objekt Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Dieses Ereignis wird erstellt, wenn eine Tile die Ausführung der Abfrage abgeschlossen hat.

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"
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status String Gibt an, ob die Tile-Abfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error".
truncated Boolesch Gibt an, ob die Tile-Abfrageergebnisse abgeschnitten wurden, weil die Abfrage mehr Zeilen als das Zeilenlimit der Abfrage zurückgegeben hat. Das Zeilenlimit kann entweder ein benutzerdefiniertes Zeilenlimit oder das Looker-Standardzeilenlimit von 5.000 sein.
tile.id Integer Die ID-Nummer des Ereignisses, nicht die Kachel.
tile.title String Der Kacheltitel, wie er oben in der Tile angezeigt wird.
tile.listen Objekt Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}
tile.errors Objektarray Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten, die Details zum Fehler angeben, einschließlich des Fehlermeldungstextes, einer detaillierteren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat.

dashboard:tile:download

Dieses Ereignis wird erstellt, wenn der Download der Daten einer Kachel gestartet wurde.

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"
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID-Nummer des Ereignisses, nicht die Kachel.
tile.title String Der Kacheltitel, wie er oben in der Tile angezeigt wird.
tile.listen Objekt Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}
fileFormat String Das Format der heruntergeladenen Kachel (derzeit nur "pdf").

dashboard:tile:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel auf die Option Explore From Here klickt.

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"
  }
}
Attribut Format Beschreibung
label String Die Beschriftung der Schaltfläche.
url String Die relative URL (nur der Pfad) des anzuzeigenden Explores.
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID-Nummer des Ereignisses, nicht die Kachel.
tile.title String Der Kacheltitel, wie er oben in der Tile angezeigt wird.
tile.listen Objekt Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel auf die Option Ursprünglichen Look anzeigen klickt.

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"
  }
}
Attribut Format Beschreibung
label String Die Beschriftung der Schaltfläche.
url String Die relative URL (nur der Pfad) des anzuzeigenden Looks.
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Integer Die ID-Nummer des Ereignisses, nicht die Kachel.
tile.title String Der Kacheltitel, wie er oben in der Tile angezeigt wird.
tile.listen Objekt Im globalen Dashboard werden Filter angewendet, die diese Kachel überwacht. Dieses Objekt hat folgendes Format: {"Filter Label": "Filter Field", ...}

dashboard:filters:changed

Dieses Ereignis wird erstellt, wenn die Filter eines Dashboards angewendet oder geändert wurden.

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"
        }
      }
    }
  }
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards.
dashboard.title String Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit Boolesch ADDED 22.20 Wenn true festgelegt ist, kann der Nutzer das Dashboard bearbeiten.
dashboard.url String Die relative Dashboard-URL (nur der Pfad)
dashboard.absoluteUrl String Die vollständige Dashboard-URL.
dashboard.dashboard_filters Objekt Die auf das Dashboard angewendeten Filter. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options Objekt Das Dashboard-Layout, die Komponente für das Dashboard-Layout und die Eigenschaften und Werte von Dashboard-Elementen. Alle im options-Objekt zurückgegebenen Eigenschaften können mit dem dashboard:options:set-Ereignis aktualisierte Werte erhalten.

look:ready

Dieses Ereignis wird erstellt, wenn ein Look mit dem Laden von Abfragedaten beginnt, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.

type: "look:ready",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL

look:run:start

Dieses Ereignis wird erstellt, wenn ein Look mit dem Laden von Abfragedaten beginnt und die Abfrage ausgeführt wird.

type: "look:run:start",
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL

look:run:complete

Dieses Ereignis wird erstellt, wenn ein Look die Abfrage abgeschlossen hat.

type: look:run:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL

look:save:complete

Dieses Ereignis wird erstellt, wenn ein Look bearbeitet und gespeichert wird. Dieses Ereignis wird erstellt, wenn ein Nutzer eine der folgenden Aufgaben ausführt:

Dieses Ereignis wird nicht erstellt, wenn der Look über die Menüoption Speichern > In vorhandenem Dashboard oder Einstellungen bearbeiten gespeichert wird.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  folderid: 123
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL
look.folderid Integer Die ID des Ordners, in dem der Look gespeichert ist

look:delete:complete

Dieses Ereignis wird erstellt, wenn ein Look in den Ordner Papierkorb verschoben wird.

type: look:delete:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  }
}
Attribut Format Beschreibung
look.url String Die relative Look-URL (nur der Pfad)
look.absoluteUrl String Die vollständige Look-URL

drillmenu:click

Dieses Ereignis wird erstellt, wenn ein Nutzer auf ein Aufschlüsselungsmenü in einem Dashboard klickt, das mit dem LookML-Parameter link erstellt wurde. Mit dem folgenden LookML-Code wird beispielsweise ein Aufschlüsselungsmenü erstellt, in dem ein Nutzer nach der Dimension state gefilterte Daten ansehen kann:


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"
  }
}

Wenn der Filter state auf Illinois gesetzt ist, gibt das Ereignis drillmenu:click Folgendes an den Host des iFrames zurück:

type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Attribut Format Beschreibung
label String Das Linklabel, wie es im Aufschlüsselungsmenü angezeigt wird
link_type String Der Objekttyp am Ziel des Links
modal Boolesch Legt fest, ob das Dialogfeld zur Aufschlüsselung anstelle der Browsernavigation verwendet wird
target String Ist _self, wenn das Linkziel den aktuellen iFrame ersetzt, und _blank, wenn durch das Linkziel ein neues Fenster geöffnet wird
url String Die URL des Linkziels
context String Internes Attribut, das von einigen Visualisierungstypen verwendet wird

Durch Sandbox des iFrames werden Klicks auf Drilldown-Menüs nicht in einem neuen Fenster geöffnet. Verwenden Sie diese Sandbox-Werte innerhalb des iFrame-Tags:

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

drillmodal:download

Dieses Ereignis wird erstellt, wenn ein Nutzer ein Aufschlüsselungsdialogfeld über eine Dashboardkachel öffnet und auf die Option Herunterladen klickt.

{
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"
}
Attribut Format Beschreibung
dashboard.id Zahl/Zeichenfolge Die ID des Dashboards, zu dem die Tile gehört.
dashboard.title String Der Dashboard-Titel, wie er oben in dem Dashboard angezeigt wird, zu dem die Tile gehört.
dashboard.url String Die relative Dashboard-URL (nur der Pfad), zu der die Tile gehört.
dashboard.absoluteUrl String Die vollständige Dashboard-URL, zu der die Tile gehört.
dashboard.dashboard_filters Objekt Die Filter, die auf das Dashboard angewendet wurden, zu dem die Tile gehört. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl String Die relative Explore-URL (nur der Pfad), die heruntergeladen werden soll.
fileFormat String Das Dateiformat der heruntergeladenen Daten.

drillmodal:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Aufschlüsselungsdialogfeld auf die Option Von hier erkunden klickt.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Attribut Format Beschreibung
label String Die Bezeichnung der Schaltfläche, wie sie im Aufschlüsselungsmenü angezeigt wird
url String Die relative Explore-URL (nur der Pfad), die angezeigt werden soll

explore:ready

Dieses Ereignis wird erstellt, wenn ein Explore mit dem Laden von Abfragedaten beginnt, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.

type: "explore:ready",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Attribut Format Beschreibung
explore.url String Die relative Explore-URL (nur der Pfad)
explore.absoluteUrl String Die vollständige Explore-URL

explore:run:start

Dieses Ereignis wird erstellt, wenn ein Explore mit dem Laden von Abfragedaten beginnt und die Abfrage ausgeführt wird.

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Attribut Format Beschreibung
explore.url String Die relative Explore-URL (nur der Pfad)
explore.absoluteUrl String Die vollständige Explore-URL

explore:run:complete

Dieses Ereignis wird erstellt, wenn ein Explore die Ausführung der Abfrage abgeschlossen hat.

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Attribut Format Beschreibung
explore.url String Die relative Explore-URL (nur der Pfad)
explore.absoluteUrl String Die vollständige Explore-URL

explore:state:changed

Dieses Ereignis wird erstellt, wenn sich die URL einer Explore-Seite infolge der Aktionen des Nutzers ändert.

type: "explore:state:changed",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Attribut Format Beschreibung
explore.url String Die relative Explore-URL (nur der Pfad)
explore.absoluteUrl String Die vollständige Explore-URL

page:changed

Dieses Ereignis wird erstellt, wenn ein Nutzer zu einer neuen Seite innerhalb des iFrames navigiert.

type: "page:changed",
page: {
  type: "dashboard",
  url: "/embed/dashboards/...",
  absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Attribut Format Beschreibung
page.type String Der Typ der Seite, die gerade aufgerufen wurde, z. B. "dashboard", "look" oder "explore"
page.url String Die relative URL (nur der Pfad) der Seite, zu der gerade navigiert wurde
page.absoluteUrl String Die vollständige URL der Seite, die gerade aufgerufen wurde

page:properties:changed

Dieses Ereignis wird erstellt, wenn sich die Höhe eines Dashboard-iFrames ändert. Sie ist nicht für Looks oder Explores verfügbar, da ihre Höhe automatisch an die Größe des iFrame angepasst wird.

type: "page:properties:changed",
height: 1000
Attribut Format Beschreibung
height Integer Die Höhe des Dashboard-iFrame in Pixeln

session:tokens

Dieses Ereignis zeigt an, dass der Looker-Client Tokens benötigt, um fortzufahren. Dieses Ereignis wird sofort nach der Erstellung des iFrames und danach regelmäßig für die Dauer der Sitzung erstellt.

{
  "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
}
Attribut Format Beschreibung
authentication_token String Authentifizierungstoken Enthalten, wenn der iFrame erstellt wird. Nicht in einer Antwort auf eine Anfrage zum Generieren von Tokens enthalten oder wenn die Sitzung abgelaufen ist.
authentication_token_ttl Nummer Gültigkeitsdauer des Authentifizierungstokens in Sekunden. Enthalten, wenn der iFrame erstellt wird. Nicht in einer Antwort auf eine Anfrage zum Generieren von Tokens enthalten oder wenn die Sitzung abgelaufen ist.
api_token String API-Token Nicht enthalten, wenn die Sitzung abgelaufen ist.
api_token_ttl Nummer Gültigkeitsdauer des API-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token String Navigations-Token. Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token_ttl Nummer Gültigkeitsdauer von Navigationstokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
session_references_token_ttl Nummer Sitzungsdauer in Sekunden. Nach Ablauf der Sitzung ist der Wert 0. Zur Wiederherstellung muss die Einbettungsanwendung eine neue Sitzung abrufen.

session:status

Das Ereignis wird generiert, wenn die eingebettete Looker-Anwendung Anfragen für Sitzungstokens verarbeitet.

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
Attribut Format Beschreibung
session_ttl Nummer Sitzungsdauer in Sekunden.
expired Boolesch Wenn true, bedeutet dies, dass die Sitzung abgelaufen ist.
interrupted Boolesch Gibt bei true an, dass auf eine Anfrage nach Sitzungstokens nicht geantwortet wurde. Dies könnte darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist.
recoverable Boolesch Wird nur ausgefüllt, wenn es unterbrochen wird: true. Gibt an, ob die Sitzung wiederhergestellt werden kann. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der Einbettungsanwendung vorliegt.

env:client:dialog

Das Ereignis wird generiert, wenn ein Dialogfeld geöffnet wurde, das teilweise nicht zu sehen ist, z. B. ein Drilldown-Dialogfeld. Dadurch kann die Hosting-App das Dialogfeld mit der Aktion env:host:scroll sichtbar machen.

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
Attribut Format Beschreibung
type String env:client:dialog gibt an, dass ein Dialogfeld geöffnet oder geschlossen wurde. Derzeit wird nur das Dialogfeld zum Drilldown-Vorgang unterstützt. In Zukunft werden möglicherweise weitere Dialogfelder hinzugefügt. Möglicherweise ist der obere Bereich des Dialogfelds für die Aufschlüsselung nicht zu sehen, da das Dialogfeld den iFrame-Darstellungsbereich verdeckt. Dieses Ereignis ermöglicht der Host-Anwendung, den oberen Rand des Dialogfelds in den sichtbaren Bereich zu scrollen.
dialogType String Der Typ des Dialogfelds. Derzeit wird dieses Ereignis nur durch das Öffnen oder Schließen des Dialogfeldtyps „Bohren“ ausgelöst.
placement String Die Position des Dialogfelds. In Dialogfeldern vom Typ „Bohren“ wird immer als placement „Cover“ verwendet.
open Boolesch Gibt an, ob das Dialogfeld geöffnet oder gescrollt wird.

Änderungen am iFrame vornehmen

Nachdem Sie den iFrame für den Datenabruf vorbereitet haben, können Sie ihn so ändern:

  1. Schreiben Sie Ihre Anfrage im JSON-Format.
  2. Posten Sie die Anfrage im contentWindow-Element des iFrames.

Anfrage in JSON schreiben

Sie können mehrere Änderungen am iFrame vornehmen, den Sie dann im JSON-Format senden. Die verfügbaren Optionen werden im Abschnitt Aktionsreferenz auf dieser Seite beschrieben. Vergessen Sie nicht, Ihre Aktion mit JSON.stringify in ein JSON-Format umzuwandeln:

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

Anfrage im Attribut contentWindow des iFrames posten

Posten Sie Ihre Nachricht schließlich wie folgt im contentWindow des iFrames:

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

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

Tabelle mit Aktionsübersicht

In der folgenden Tabelle sind die Aktionen zusammengefasst. Wählen Sie eine Aktion aus, um die zugehörigen Details aufzurufen.

Vorgang Aktionsbeschreibung
dashboard:load Lädt ein neues Dashboard im iFrame, sodass ein vorhandenes Dashboard ersetzt wird.
dashboard:run Führt das Dashboard im iFrame aus.
dashboard:edit ADDED 22.20 Versetzt das Dashboard in den Bearbeitungsmodus.
dashboard:filters:update Aktualisiert einen vorhandenen Dashboard-Filter im iFrame.
dashboard:options:set Schreibt neue Werte in Dashboard-Layout- und Dashboard-Elementeigenschaften.
dashboard:schedule_modal:open Öffnet das Planungsprogramm, mit dem Benutzer Looker-Inhalte an verschiedene Ziele liefern können.
dashboard:stop Beendet ein Dashboard, das ausgeführt wird oder Daten neu lädt.
look:run Führt den Look im iFrame aus.
look:filters:update Aktualisiert einen vorhandenen Look-Filter im iFrame.
explore:run Führt das Explore im iFrame aus.
explore:filters:update Aktualisiert oder entfernt einen vorhandenen Explore-Filter im iFrame.
session:tokens:request Sendet Tokens als Antwort auf ein session:tokens:request-Ereignis.
env:host:scroll Sendet Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung.

Aktionsreferenz

Folgende Aktionen können Sie an den eingebetteten iFrame senden:

dashboard:load

Verwenden Sie diese Aktion, um ein neues Dashboard in den iFrame zu laden und ein vorhandenes Dashboard zu ersetzen. Das neue Dashboard beginnt mit der Ausführung von Abfragen, als ob eine neue Dashboard-Seite geöffnet worden wäre.

{
  type: "dashboard:load",
  id: "101",
  pushHistory: false
}
Attribut Format Beschreibung
type String Wenn Sie den Typ dashboard:load verwenden, bedeutet das, dass Sie ein neues Dashboard in den iFrame laden möchten.
id String Die ID des zu ladenden Dashboards.
pushHistory Boolesch Wenn true, erstellt das geladene Dashboard einen neuen Eintrag im Browserverlauf und der Nutzer kann über die Schaltfläche „Zurück“ des Browsers zum vorherigen Dashboard zurückkehren. Wenn false, wird das aktuelle Dashboard ersetzt und die Browsernavigation kann nicht verwendet werden, um zum Dashboard zurückzukehren.

dashboard:run

Mit dieser Aktion können Sie das Dashboard im iFrame ausführen. Dies entspricht dem Klicken auf die Schaltfläche Ausführen oder Daten neu laden auf dem Dashboard.

{
  type: "dashboard:run"
}
Attribut Format Beschreibung
type String Die Verwendung des Typs dashboard:run gibt an, dass Sie das Dashboard ausführen möchten.

dashboard:edit

ADDED 22.20 Mit dieser Aktion können Sie ein vorhandenes Dashboard im iFrame in den Bearbeitungsmodus versetzen. Dies entspricht der Auswahl von Dashboard bearbeiten im Dashboard-Menü.

{
  type: "dashboard:edit"
}
Attribut Format Beschreibung
type String Der Typ dashboard:edit bedeutet, dass Sie das Dashboard in den Bearbeitungsmodus versetzen möchten.

dashboard:filters:update

Mit dieser Aktion können Sie einen vorhandenen Dashboard-Filter im iFrame aktualisieren. Mit dieser Methode können Sie dem Dashboard keinen neuen Filter hinzufügen.

{
  type: "dashboard:filters:update",
  filters: {
    "Sale date": "Last 28 days",
    "Sale amount": "Greater than 100"
  }
}
Attribut Format Beschreibung
type String Der Typ dashboard:filters:update gibt an, dass Sie die vom Dashboard verwendeten Filter aktualisieren möchten.
filters Objekt Die neuen Filter, die Sie auf das Dashboard anwenden möchten. Dieses Objekt hat folgendes Format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

Diese Aktion ist verfügbar, nachdem das Ereignis dashboard:run:complete eingetreten ist.

Der Einbettungscode erstellt die Nachricht und sendet sie an den iFrame, aber das Dashboard antwortet erst nach dashboard:run:complete. Die Aktion dashboard:options:set schreibt neue Werte in das Dashboard-Layout und in die Dashboard-Elementeigenschaften. Nur Eigenschaften, die im Attribut options des Ereignisses dashboard:run:complete zurückgegeben wurden, können mit dashboard:options:set aktualisiert werden. Alle festgelegten Eigenschaften, die noch nicht durch das Attribut options des Ereignisses dashboard:run:complete zurückgegeben wurden, werden ignoriert.

{
  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"
      }
    }
  }
}
Attribut Format Beschreibung
type String Die Verwendung des Typs dashboard:options:set gibt an, dass Sie neue Werte in die Attribute des Dashboard-Layouts und der Dashboard-Elemente schreiben möchten.
layouts Objekt Die Eigenschaften des Dashboard-Layouts, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein ähnliches Format wie das:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components Objekt Ein oder mehrere Dashboard-Layout-Komponenten, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein ähnliches Format wie das:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements Objekt Ein oder mehrere Dashboard-Element-Objekte, die vom Attribut options im Ereignis dashboard:run:complete zurückgegeben werden. Sie haben ein ähnliches Format wie das:

id: {

  title: "string",

  title_hidden: boolean,

  vis_config: {

    type: "string", title: "string"

  }

}

dashboard:schedule_modal:open

Verwenden Sie diese Aktion, um das Planungsprogramm zu öffnen, mit dem Nutzer Looker-Inhalte an verschiedene Ziele senden können.

{
  type: "dashboard:schedule_modal:open"
}
Attribut Format Beschreibung
type String Wenn Sie den Typ dashboard:schedule_modal:open verwenden, geben Sie an, dass Sie das Dialogfeld Zeitplan öffnen möchten.

dashboard:stop

Verwenden Sie diese Aktion, um ein ausgeführtes Dashboard zu beenden oder Daten neu zu laden. Dies entspricht dem Klick auf die Schaltfläche Abbrechen auf dem Dashboard. Ein Dashboard, das dashboard:stop nicht mehr verwendet, sendet ein dashboard:run:complete-Ereignis, wobei status: auf "stopped" gesetzt ist.

{
  type: "dashboard:stop"
}
Attribut Format Beschreibung
type String Die Verwendung des Typs dashboard:stop gibt an, dass Sie das ausgeführte Dashboard beenden möchten.

look:run

Verwenden Sie diese Aktion, um die Abfrage auszuführen, auf der der Look im iFrame basiert. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Look, mit der Ausnahme, dass look:run die Datenbank immer direkt abfragt und keine Daten aus dem Looker-Cache abruft.

{
  type: "look:run"
}
Attribut Format Beschreibung
type String Die Verwendung des Typs look:run gibt an, dass Sie den Look ausführen möchten.

look:filters:update

Mit dieser Aktion können Sie einen vorhandenen Look-Filter im iFrame aktualisieren. Mit dieser Methode können Sie dem Look keinen neuen Filter hinzufügen.

{
  type: "look:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "products.department": "sweaters"
  }
}
Attribut Format Beschreibung
type String Die Verwendung des Typs look:filters:update gibt an, dass Sie die vom Look verwendeten Filter aktualisieren möchten.
filters Objekt Die neuen Filter, die Sie auf den Look anwenden möchten. Dieses Objekt hat folgendes Format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

Verwenden Sie diese Aktion, um das Explore im iFrame auszuführen. Diese Aktion ähnelt dem Klicken auf die Schaltfläche Ausführen im Explore, mit der Ausnahme, dass explore:run die Datenbank immer direkt abfragt und keine Daten aus dem Looker-Cache abruft.

{
  type: "explore:run"
}
Attribut Format Beschreibung
type String Die Verwendung des Typs explore:run gibt an, dass Sie das Explore ausführen möchten.

explore:filters:update

Mit dieser Aktion können Sie einen vorhandenen Explore-Filter im iFrame aktualisieren oder entfernen. Wenn Sie einen neuen Filter einfügen, der auf ein gültiges Feld verweist, wird der neue Filter dem Explore hinzugefügt.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}
Attribut Format Beschreibung
type String Der Typ explore:filters:update gibt an, dass Sie die vom Explore verwendeten Filter aktualisieren möchten.
filters Objekt Die neuen Filter, die Sie auf das Explore anwenden möchten. Wenn filters einen Filter enthält, der derzeit nicht im Explore vorhanden ist, aber auf ein gültiges Feld verweist, wird dieser Filter dem Explore hinzugefügt. Dieses Objekt hat folgendes Format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters Array Die vorhandenen Filter, die Sie aus dem Explore entfernen möchten. Das Array hat folgendes Format: ["view_name.field_name_1", "view_name.field_name_2", ...]

session:tokens:request

Mit dieser Aktion können Sie Tokens als Antwort auf eine session:tokens:request-Anfrage senden.

{
  type: "session:tokens:request",
}
Attribut Format Beschreibung
type String Die Verwendung des Typs session:tokens:request gibt an, dass Sie Tokens als Antwort auf ein session:tokens:request-Ereignis senden möchten.

env:host:scroll

Verwenden Sie diese Aktion, um Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung zu senden.

{
  type: "env:host:scroll",
  offsetTop: 10,
  offsetLeft: 10,
  scrollX: 5,
  scrollY: 5
}
Attribut Format Beschreibung
type String Wenn Sie den Typ env:host:scroll verwenden, geben Sie an, dass Sie Informationen zur aktuellen Scrollposition des Host-iFrames an die eingebettete Looker-Anwendung senden möchten.
offsetTop Nummer Entspricht dem oberen Rand des iFrames.
offsetLeft Nummer Der Versatz links vom iFrame.
scrollX Nummer Die ScrollX-Position des Anwendungshosts.
scrollY Nummer Die Scrolly-Position des Anwendungshosts.