Eingebettete JavaScript-Ereignisse

Nachdem Sie eine Einbettung erstellt haben, kann dies öffentlich, privat, mit der Einmalanmeldung (SSO) oder über die API erfolgen. Dann können Sie über JavaScript mit diesen iFrames interagieren. Sie können Ihre Seite je nach Status des eingebetteten Elements dynamischer gestalten oder auch Änderungen am eingebetteten Element über Ihre Webseite vornehmen.

Beachten Sie, dass Looker nicht die Reihenfolge steuert, in der Browser Ereignisse an Webanwendungen senden. Das bedeutet, dass die Reihenfolge der Ereignisse nicht in allen Browsern oder auf allen Plattformen garantiert ist. Achten Sie darauf, Ihren JavaScript-Code richtig zu schreiben, um die Ereignisverarbeitung verschiedener Browser zu berücksichtigen.

Für eingebettete Looker-Inhalte gibt es zwei Möglichkeiten:

• Verwendung des Looker-Software Development Kit (SDK), das auf der Dokumentationsseite zum Einbetten des SDKs beschrieben wird
• JavaScript-Ereignisse verwenden, die im Abschnitt Auf Ereignisse in JavaScript zugreifen auf dieser Seite beschrieben werden

Vorbereitung

Sie müssen einige Aktionen ausführen, bevor Sie mit dem eingebetteten iFrame interagieren können:

• ID zum iFrame hinzufügen
• Eingebetteten Domain im iFrame-Attribut src hinzufügen
• Domain auf die Zulassungsliste setzen

Dem iFrame eine ID hinzufügen

Sie müssen nun überprüfen, ob die Informationen, mit denen Sie arbeiten, tatsächlich aus dem iFrame von Looker stammen. Fügen Sie dazu dem iFrame eine ID hinzu, sofern noch nicht geschehen. Im folgenden Beispiel wurde id="looker" hinzugefügt:

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

Eingebettete Domain dem iFrame-Attribut src hinzufügen

Fügen Sie im src des iFrames die Domain hinzu, in der der iFrame verwendet wird. Im folgenden Beispiel wurde ?embed_domain=https://mywebsite.com" hinzugefügt:

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

Wenn Sie SSO-Einbettung verwenden, müssen Sie embed_domain in die Einbettungs-URL einfügen.

Geben Sie im embed_domain keinen Schrägstrich (/) ein.

Eingebettete Domain auf die Zulassungsliste setzen

Abschließend müssen Sie die Domain, in der der iFrame verwendet wird, auf der Seite Einbetten des Admin-Steuerfelds von Looker der Zulassungsliste hinzufügen:

1. Geben Sie die Domain ein, in der der iFrame verwendet wird. Drücken Sie nach der Eingabe die Tabulatortaste, damit die Domain in einem Feld angezeigt wird. Fügen Sie in der Domain-URL keinen Schrägstrich (/) ein.
2. Klicken Sie auf die Schaltfläche Aktualisieren.

Sie können den Platzhalter * in der Zulassungsliste verwenden, um ein Domainmuster zu erstellen. Für https://*.mycompany.com wären beispielsweise sowohl https://analytics.mycompany.com als auch https://data.mycompany.com zulässig.

Daten aus dem iFrame abrufen

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

Prüfen Sie, ob die Ereignisse aus dem Looker-iFrame und der Looker-Domain stammen, um schädliche Nachrichten zu vermeiden.

Mit dem eingebetteten iFrame können mehrere Ereignistypen erstellt werden, wie auf dieser Seite im Abschnitt Referenz zum Ereignistyp beschrieben.

Ereignisse in JavaScript aufrufen

Hier ist ein Beispiel für die Überwachung dieser Ereignisse im nativen JavaScript und anschließendes Logging in der Konsole:

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 für das Warten auf diese Ereignisse in jQuery und das anschließende Logging in der Konsole:

$(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 der Übersicht über den Ereignistyp

In der folgenden Tabelle werden Ereignistypen zusammengefasst. Klicken Sie auf einen Ereignistyp, um die zugehörigen Details aufzurufen.

Ereignistyp	Ursache des Ereignisses
dashboard:loaded	Auf Dashboards, auf denen die Kacheln nicht auf „Automatisch“ eingestellt sind, wurden ein Dashboard und dessen Elemente geladen, aber die Abfragen werden noch nicht ausgeführt.
dashboard:run:start	Ein Dashboard hat mit dem Laden begonnen und seine Kacheln haben begonnen, Daten zu laden und abzufragen.
dashboard:run:complete	Das Dashboard wurde ausgeführt und alle Kacheln wurden vollständig geladen und abgefragt.
dashboard:download	Ein PDF des Dashboards wird heruntergeladen.
dashboard:edit:start	22.20 ADDED Ein Dashboard wurde in den Bearbeitungsmodus gewechselt. Das Ereignis dashboard:save:complete wird ausgelöst, wenn das Dashboard erfolgreich gespeichert wurde. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard:edit:cancel	Hinzugefügt am 22.20. Ein Dashboard im Bearbeitungsmodus wurde ohne Speichern beendet. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard:save:complete	Ein Dashboard wurde bearbeitet und gespeichert.
dashboard:delete:complete	Ein Dashboard wurde gelöscht.
dashboard:tile:start	Eine Kachel hat mit dem Laden oder Abfragen von Daten begonnen.
dashboard:tile:complete	Die Ausführung der Abfrage ist mit einer Kachel abgeschlossen.
dashboard:tile:download	Der Download der Daten einer Kachel wird gestartet.
dashboard:tile:explore	Ein Nutzer hat auf der Dashboard-Kachel auf die Option Erkunden von hier geklickt.
dashboard:tile:view	Ein Nutzer hat in einer Dashboard-Kachel auf die Option Originallook ansehen geklickt.
dashboard:filters:changed	Die Filter eines Dashboards wurden angewendet oder geändert.
look:ready	Ein Looker hat mit dem Laden von Abfragedaten begonnen, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
look:run:start	Für einen Look wurde mit dem Laden von Abfragedaten und der Ausführung der Abfrage begonnen.
look:run:complete	Ein Looker hat die Ausführung der Abfrage abgeschlossen.
look:save:complete	Ein Look wurde bearbeitet und gespeichert.
look:delete:complete	Ein Ordner wurde in den Ordner Papierkorb verschoben.
drillmenu:click	Ein Nutzer hat in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü geklickt.
drillmodal:download	Ein Nutzer hat auf einer Dashboard-Kachel ein Dialogfeld mit den Optionen zum Bohren geöffnet und auf die Option Herunterladen geklickt.
drillmodal:explore	Ein Nutzer hat in einem Dialogfeld zum Bohren auf die Option Erkunden von hier geklickt.
explore:ready	Mit einem explorativen Analysetool wurden damit begonnen, Abfragedaten zu laden, unabhängig davon, ob die Abfrage ausgeführt wird oder nicht.
explore:run:start	Eine explorative Datenanalyse hat begonnen, Abfragedaten zu laden, und die Abfrage wurde ausgeführt.
explore:run:complete	Die Abfrage wird durch ein Explore-Objekt abgeschlossen.
explore:state:changed	Die URL einer Seite „Erkunden“ hat sich aufgrund der Aktionen des Nutzers geändert.
page:changed	Ein Nutzer hat im iFrame eine neue Seite aufgerufen.
page:properties:changed	Die Höhe eines Dashboard-iFrames hat sich geändert.
session:tokens	Zum Fortfahren sind für den Looker-Client Tokens erforderlich.
session:status	Sendet Informationen über den Status einer Sitzung.

Ereignistypreferenz

Mit dem eingebetteten iFrame können viele verschiedene Ereignistypen erstellt werden:

dashboard:loaded

In Dashboards, bei denen die Kacheln nicht auf „automatisch“ eingestellt sind, wird dieses Ereignis erstellt, nachdem ein Dashboard mit den zugehörigen Elementen geladen wurde, aber bevor Abfragen ausgeführt werden.

Das Attribut options ist in alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.options	Objekt	Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden. Diese Option ist auf alten Dashboards nicht verfügbar.

dashboard:run:start

Dieses Ereignis wird erstellt, wenn ein Dashboard mit dem Laden begonnen hat, die entsprechenden Kacheln geladen werden und Daten abgefragt werden.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:run:complete

Dieses Ereignis wird erstellt, wenn ein Dashboard abgeschlossen ist und alle Kacheln geladen und abgefragt wurden. Dieses Ereignis wird unabhängig davon erstellt, ob alle Kacheln erfolgreich geladen wurden oder nicht.

Die Attribute options und tileStatuses sind auf alten Dashboards nicht verfügbar.

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" und andernfalls status den Wert "error" zurück. Wenn das ausgeführte Dashboard über die Benutzeroberfläche oder mit der Aktion dashboard:stop beendet wurde, gibt status den Wert "stopped" zurück.
dashboard.id	Zahl/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options	Objekt	Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im options-Objekt zurückgegebenen Attributen können über die Aktion dashboard:options:set aktualisierte Werte zugewiesen werden. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.tileStatuses	Objektarray	Ein Array mit Objekten, die Kachelstatus bereitstellen. Objektattribute sind: tileId: Die ID-Nummer der Kachel. status: Wenn die Kachelabfrage erfolgreich ausgeführt wurde, gibt status "complete" zurück. Andernfalls gibt status "error" zurück. errors: Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, einer ausführlicheren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat. Diese Option ist auf alten Dashboards nicht verfügbar.

dashboard:download

Dieses Ereignis wird erstellt, wenn der Download eines Dashboards im PDF-Format 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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
fileFormat	String	Das Format des heruntergeladenen Dashboards (derzeit nur "pdf").

dashboard:edit:start

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

Dieses Ereignis ist auf alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:edit:cancel

22.20 ADDED Dieses Ereignis wird erstellt, wenn ein Dashboard, das sich im Bearbeitungsmodus befindet, im Bearbeitungsmodus beendet wird, ohne zu speichern.

Dieses Ereignis ist auf alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das 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.

Dieses Ereignis ist auf alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.options	Objekt	Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

dashboard:delete:complete

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

Dieses Ereignis ist auf alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.options	Objekt	Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden.

dashboard:tile:start

Dieses Ereignis wird erstellt, wenn eine Kachel 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/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id	Integer	Die ID des Ereignisses, nicht die Kachel.
tile.title	String	Der Titel der Kachel wie oben angezeigt
tile.listen	Objekt	Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Dieses Ereignis wird erstellt, wenn die Ausführung der Abfrage für eine Kachel abgeschlossen ist.

Das Attribut errors ist in alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
status	String	Gibt an, ob die Kachelabfrage erfolgreich abgeschlossen wurde. Mögliche Werte sind "complete" und "error".
truncated	Boolesch	Gibt an, ob die Ergebnisse der Kachelabfrage abgeschnitten wurden, da die Abfrage mehr Zeilen zurückgegeben hat als das Limit der Abfragezeile. Das Zeilenlimit kann entweder ein benutzerdefiniertes Zeilenlimit oder das Looker-Standardzeilenlimit von 5.000 sein.
tile.id	Integer	Die ID des Ereignisses, nicht die Kachel.
tile.title	String	Der Titel der Kachel wie oben angezeigt
tile.listen	Objekt	Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}
tile.errors	Objektarray	Wird ausgefüllt, wenn das Attribut status den Wert "error" hat. Ein Array von Objekten mit Details zum Fehler, einschließlich des Texts der Fehlermeldung, einer ausführlicheren Beschreibung des Fehlers und der SQL-Abfrage der Kachel, die den Fehler verursacht hat. Diese Option ist auf alten Dashboards nicht verfügbar.

dashboard:tile:download

Dieses Ereignis wird erstellt, sobald die Daten einer Kachel heruntergeladen werden.

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/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id	Integer	Die ID des Ereignisses, nicht die Kachel.
tile.title	String	Der Titel der Kachel wie oben angezeigt
tile.listen	Objekt	Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das 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 Erkunden von hier 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	Das Label der Schaltfläche.
url	String	Die relative URL (nur der Pfad) des Explore, das angezeigt werden soll.
dashboard.id	Zahl/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id	Integer	Die ID des Ereignisses, nicht die Kachel.
tile.title	String	Der Titel der Kachel wie oben angezeigt
tile.listen	Objekt	Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Dieses Ereignis wird erstellt, wenn ein Nutzer in einer Dashboard-Kachel auf die Option Original-Look ansehen 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	Das Label der Schaltfläche.
url	String	Die relative URL (nur der Pfad) des sichtbaren Designs.
dashboard.id	Zahl/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id	Integer	Die ID des Ereignisses, nicht die Kachel.
tile.title	String	Der Titel der Kachel wie oben angezeigt
tile.listen	Objekt	Das globale Dashboard filtert, welche Kachel überwacht wird. Dieses Objekt hat das Format {"Filter Label": "Filter Field", ...}

dashboard:filters:changed

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

Das Attribut options ist in alten Dashboards nicht verfügbar.

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/String	Die ID des Dashboards.
dashboard.title	String	Der Titel, wie oben im Dashboard angezeigt.
dashboard.canEdit	Boolesch	22.20 ADDED Wenn true, kann der Nutzer das Dashboard bearbeiten. Diese Option ist auf alten Dashboards nicht verfügbar.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad).
dashboard.absoluteUrl	String	Vollständige Dashboard-URL.
dashboard.dashboard_filters	Objekt	Die auf das Dashboard angewendeten Filter. Dieses Objekt hat das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
dashboard.options	Objekt	Die Attribute und Werte des Dashboard-Layouts, der Dashboard-Layoutkomponente und des Dashboard-Elements. Allen im Objekt options zurückgegebenen Attributen können über das Ereignis dashboard:options:set aktualisierte Werte zugewiesen werden. Diese Option ist auf alten Dashboards nicht verfügbar.

look:ready

Dieses Ereignis wird erstellt, wenn ein Look beginnt, Abfragedaten zu laden, 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	Vollständige Look-URL

look:run:start

Dieses Ereignis wird erstellt, wenn ein Look damit beginnt, Abfragedaten zu laden, und die Abfrage startet.

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	Vollständige Look-URL

look:run:complete

Dieses Ereignis wird erstellt, wenn ein Ausführen der Abfrage durch einen Look abgeschlossen ist.

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	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:

• Klicken Sie auf die Schaltfläche Bearbeiten, um das Design zu bearbeiten, und dann auf Speichern.
• Ein Looker wird mit der Menüoption Speichern > Speichern unter... gespeichert.
• Ein Look wird von einem Ordner in einen anderen verschoben

Dieses Ereignis wird nicht erstellt, wenn das Design mit der 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/...",
  spaceId: 123
  }
}

Attribut	Format	Beschreibung
look.url	String	Die relative Look-URL (nur der Pfad)
look.absoluteUrl	String	Vollständige Look-URL
look.spaceID	Integer	Die Ordner-ID, in der der Look gespeichert wird

look:delete:complete

Dieses Ereignis wird erstellt, wenn ein Look in den 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	Vollständige Look-URL

drillmenu:click

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Dashboard, das mit dem LookML-Parameter link erstellt wurde, auf ein Aufschlüsselungsmenü klickt. Im folgenden LookML wird beispielsweise ein Aufschlüsselungsmenü erstellt, in dem ein Nutzer Daten aufrufen kann, die nach der Dimension state gefiltert sind:

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	Linklabel wie im Drilldown-Menü angezeigt
link_type	String	Der Objekttyp am Linkziel
modal	Boolesch	Ob das Dialogfeld für die Aufschlüsselung statt der Browsernavigation verwendet wird
target	String	Ist _self, wenn das Linkziel durch den Link-Ziel ersetzt wird, _blank, wenn das Linkziel in einem neuen Fenster geöffnet wird
url	String	Die URL des Linkziels
context	String	Internes Attribut, das von einigen Visualisierungstypen verwendet wird

Das Sandboxing des iFrames verhindert, dass Klicks auf das Drilldown-Menü in einem neuen Fenster geöffnet werden. Beachten Sie die folgenden Sandbox-Werte im iFrame-Tag:

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

drillmodal:download

Dieses Ereignis wird erstellt, wenn ein Nutzer ein Dialogfeld für die Aufschlüsselung über eine Dashboard-Kachel ö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/String	Die ID des Dashboards, zu dem die Kachel gehört.
dashboard.title	String	Der Dashboard-Titel, wie oben im Dashboard angezeigt, zu dem die Kachel gehört.
dashboard.url	String	Die relative Dashboard-URL (nur der Pfad), zu der die Kachel gehört.
dashboard.absoluteUrl	String	Die vollständige Dashboard-URL, zu der die Kachel gehört.
dashboard.dashboard_filters	Objekt	Die Filter, die auf das Dashboard angewendet wurden, zu dem die Kachel gehört. Dieses Objekt hat das 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 des Datendownloads.

drillmodal:explore

Dieses Ereignis wird erstellt, wenn ein Nutzer in einem Drill Dialogfeld auf die Option Erkunden von hier klickt.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."

Attribut	Format	Beschreibung
label	String	Beschriftung der Schaltfläche, wie im Menü „Details“ angezeigt
url	String	Die relative Erkundungs-URL (nur der Pfad), die angezeigt werden soll

explore:ready

Dieses Ereignis wird erstellt, wenn ein Explore-Ereignis 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 URL zum Erkunden (nur der Pfad)
explore.absoluteUrl	String	Die vollständige URL zum Erkunden

explore:run:start

Dieses Ereignis wird erstellt, wenn das explorative Analysetool mit dem Laden von Abfragedaten beginnt und mit der Ausführung der Abfrage beginnt.

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}

Attribut	Format	Beschreibung
explore.url	String	Die relative URL zum Erkunden (nur der Pfad)
explore.absoluteUrl	String	Die vollständige URL zum Erkunden

explore:run:complete

Dieses Ereignis wird erstellt, wenn die Abfrage in einer explorativen Datenanalyse abgeschlossen ist.

type: "explore:run:complete",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}

Attribut	Format	Beschreibung
explore.url	String	Die relative URL zum Erkunden (nur der Pfad)
explore.absoluteUrl	String	Die vollständige URL zum Erkunden

explore:state:changed

Dieses Ereignis wird erstellt, wenn sich die URL einer Seite „Erkunden“ aufgrund von Nutzeraktionen ä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 URL zum Erkunden (nur der Pfad)
explore.absoluteUrl	String	Die vollständige URL zum Erkunden

page:changed

Dieses Ereignis wird erstellt, wenn ein Nutzer eine neue Seite im iFrame aufruft.

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, die gerade aufgerufen wurde
page.absoluteUrl	String	Die vollständige URL der Seite, zu der gerade navigiert wurde

page:properties:changed

Dieses Ereignis wird erstellt, wenn sich die Höhe eines iFrame-Dashboards ändert. Sie ist nicht für „Ansehen“ oder „Erkunden“ verfügbar, weil ihre Höhe automatisch an die Größe des iFrames angepasst wird.

type: "page:properties:changed",
height: 1000

Attribut	Format	Beschreibung
height	Integer	Höhe des iFrame-Dashboards in Pixeln

session:tokens

Dieses Ereignis gibt an, dass für den Looker-Client Tokens erforderlich sind, um fortzufahren. Dieses Ereignis wird direkt beim Erstellen des iFrames und 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. Wird beim Erstellen des iFrames eingefügt. Nicht enthalten in einer Antwort auf eine Anfrage zum Generieren von Tokens oder wenn die Sitzung abgelaufen ist.
authentication_token_ttl	Zahl	Gültigkeitsdauer des Authentifizierungstokens in Sekunden. Wird beim Erstellen des iFrames eingefügt. Nicht enthalten in einer Antwort auf eine Anfrage zum Generieren von Tokens oder wenn die Sitzung abgelaufen ist.
api_token	String	API-Token Nicht enthalten, wenn die Sitzung abgelaufen ist.
api_token_ttl	Zahl	Gültigkeitsdauer des API-Tokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token	String	Navigationstoken Nicht enthalten, wenn die Sitzung abgelaufen ist.
navigation_token_ttl	Zahl	Lebensdauer des Navigationstokens in Sekunden. Nicht enthalten, wenn die Sitzung abgelaufen ist.
session_references_token_ttl	Zahl	Sitzungsdauer in Sekunden. Der Wert ist 0, wenn die Sitzung abgelaufen ist. Zur Wiederherstellung muss die eingebettete Anwendung eine neue Sitzung erwerben.

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	Zahl	Sitzungsdauer in Sekunden.
expired	Boolesch	Wenn true, ist die Sitzung abgelaufen.
interrupted	Boolesch	Wenn true, bedeutet das, dass eine Anfrage nach Sitzungstokens nicht beantwortet wurde. Dies kann darauf hindeuten, dass ein Server vorübergehend nicht verfügbar ist.
recoverable	Boolesch	true wird nur bei Unterbrechungen ausgefüllt. Gibt an, ob die Sitzung wiederhergestellt werden kann. Der Wert false bedeutet wahrscheinlich, dass ein Problem mit der eingebetteten Anwendung vorliegt.

Änderungen am iFrame vornehmen

Nachdem Sie den iFrame auf den Datenabruf vorbereitet haben, können Sie ihn folgendermaßen ändern:

1. Verfassen Sie Ihre Anfrage im JSON-Format.
2. Senden Sie die Anfrage an die Datei contentWindow des iFrames.

Anfrage im JSON-Format schreiben

Sie können mehrere Änderungen am iFrame vornehmen, die Sie dann im JSON-Formular einreichen. Die verfügbaren Optionen werden im Abschnitt Aktionsreferenz auf dieser Seite beschrieben. Vergessen Sie nicht, JSON.stringify zu verwenden, um Ihre Aktion in JSON umzuwandeln. Beispiel:

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

Anfrage in der contentWindow-Property des iFrames veröffentlichen

Zum Schluss senden Sie Ihre Nachricht an die contentWindow des iFrames:

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

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

Tabelle mit der Aktionsübersicht

In der folgenden Tabelle werden Aktionen zusammengefasst. Klicken Sie auf eine Aktion, um Details dazu aufzurufen.

Aktion	Aktionsbeschreibung
dashboard:load	Lädt ein neues Dashboard im iFrame, das ein vorhandenes Dashboard ersetzt.
dashboard:run	Führt das Dashboard im iFrame aus.
dashboard:edit	22.20 ADDED Das Dashboard wechselt in den Bearbeitungsmodus. Diese Aktion ist auf alten Dashboards nicht verfügbar.
dashboard:filters:update	Aktualisiert einen bestehenden Dashboard-Filter im iFrame
dashboard:options:set	Neue Werte werden für das Dashboard-Layout und die Dashboard-Elementeigenschaften geschrieben.
dashboard:schedule_modal:open	Der Planer wird geöffnet, sodass Nutzer Looker-Inhalte an verschiedene Ziele senden können.
dashboard:stop	Beendet ein Dashboard, auf dem Daten ausgeführt werden oder neu geladen werden
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 Reaktion auf ein session:tokens:request-Ereignis.

Aktionsreferenz

Folgende Aktionen können im eingebetteten iFrame gepostet werden:

dashboard:load

Diese Aktion ist auf alten Dashboards nicht verfügbar.

Verwenden Sie diese Aktion, um ein neues Dashboard im 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	Mit dem Typ dashboard:load wird angegeben, dass Sie ein neues Dashboard in den iFrame laden möchten.
id	String	Die ID des zu ladenden Dashboards.
pushHistory	Boolesch	Wenn true aktiviert ist, wird im Dashboard ein neuer Eintrag im Browserverlauf erstellt. 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 dorthin zurückzukehren.

dashboard:run

Führen Sie diese Aktion aus, um das Dashboard im iFrame auszuführen. Dies funktioniert genauso wie die Schaltfläche Ausführen oder Daten neu laden im Dashboard.

{
  type: "dashboard:run"
}

Attribut	Format	Beschreibung
type	String	Wenn Sie den Typ dashboard:run verwenden, geben Sie an, dass Sie das Dashboard ausführen möchten.

dashboard:edit

22.20 ADDED Verwenden Sie diese Aktion, um ein vorhandenes Dashboard im iFrame in den Bearbeitungsmodus zu wechseln. Dies entspricht der Auswahl von Dashboard bearbeiten im Dashboard-Menü.

Diese Aktion ist auf alten Dashboards nicht verfügbar.

{
  type: "dashboard:edit"
}

Attribut	Format	Beschreibung
type	String	Mit dem Typ dashboard:edit wird angegeben, dass Sie das Dashboard in den Bearbeitungsmodus wechseln möchten.

dashboard:filters:update

Mit dieser Aktion können Sie einen bestehenden 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	Mit dem Typ dashboard:filters:update wird angegeben, 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 das Format {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}

dashboard:options:set

Diese Aktion ist nach dem Ereignis dashboard:run:complete verfügbar und auf alten Dashboards nicht verfügbar.

Die Einbettung erstellt die Nachricht und sendet sie an den iFrame. Das Dashboard reagiert aber erst, nachdem dashboard:run:complete eingegangen ist. Die Aktion dashboard:options:set schreibt neue Werte in das Dashboard-Layout und die Dashboard-Elementeigenschaften. Nur Attribute, die im options-Attribut des dashboard:run:complete-Ereignisses zurückgegeben wurden, können mit dashboard:options:set aktualisiert werden. Alle festgelegten Attribute, die zuvor nicht vom options-Attribut des dashboard:run:complete-Ereignisses 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	Mit dem Typ dashboard:options:set wird angegeben, dass Sie neue Werte in die Eigenschaften des Dashboard-Layouts und des Dashboard-Elements schreiben möchten.
layouts	Objekt	Die Dashboard-Layouteigenschaften, die vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben werden. Verwenden Sie dazu ein Format wie dieses: id: "string", dashboard_id: "string", type: "newspaper", active: boolean, column_width: number, width: number
layouts.dashboard_layout_components	Objekt	Mindestens ein Objekt der Dashboard-Layoutkomponente, das vom options-Attribut im dashboard:run:complete-Ereignis zurückgegeben wird. Verwenden Sie dazu ein Format wie dieses: id: "string", dashboard_layout_id: "string", dashboard_element_id: "string", row: number, column: number, width: number, height: number, deleted: boolean,
elements	Objekt	Mindestens ein Dashboard-Element, das im dashboard:run:complete-Ereignis vom Attribut options zurückgegeben wird. Verwenden Sie dazu ein Format wie dieses: id: {   title: "string"

dashboard:schedule_modal:open

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

Diese Aktion ist auf alten Dashboards nicht verfügbar.

{
  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 Planen öffnen möchten.

dashboard:stop

Mit dieser Aktion können Sie ein Dashboard beenden, auf dem Daten ausgeführt werden oder neu geladen werden. Dies funktioniert genauso wie das Klicken auf die Schaltfläche Abbrechen im Dashboard. Ein Dashboard, in dem dashboard:stop nicht mehr verwendet wird, sendet ein dashboard:run:complete-Ereignis, bei dem status: auf "stopped" festgelegt ist.

Diese Aktion ist auf alten Dashboards nicht verfügbar.

{
  type: "dashboard:stop"
}

Attribut	Format	Beschreibung
type	String	Mit dem Typ dashboard:stop wird angegeben, dass Sie das laufende Dashboard beenden möchten.

look:run

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

{
  type: "look:run"
}

Attribut	Format	Beschreibung
type	String	Mit dem Typ look:run geben Sie 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	Mit dem Typ look:filters:update wird angegeben, 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 das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}

explore:run

Führen Sie diese Aktion aus, um die Option „Erkunden“ im iFrame auszuführen. Dies ähnelt der Schaltfläche Ausführen auf dem Tab „Erkunden“ mit der Ausnahme, dass explore:run immer direkt die Datenbank abfragt und keine Daten aus dem Looker-Cache abruft.

{
  type: "explore:run"
}

Attribut	Format	Beschreibung
type	String	Wenn Sie den Typ explore:run verwenden, geben Sie an, dass Sie die Funktion „Erkunden“ ausführen möchten.

explore:filters:update

Mit dieser Aktion kannst du einen vorhandenen Explore-Filter im iFrame aktualisieren oder entfernen. Wenn Sie einen neuen Filter einschließen, der auf ein gültiges Feld verweist, wird er der Auswertung hinzugefügt.

{
  type: "explore:filters:update",
  filters: {
    "orders.created_at": "90 days",
    "orders.status": "complete"
  }
  deleteFilters:  ["products.department"]
}

Attribut	Format	Beschreibung
type	String	Wenn Sie den Typ explore:filters:update verwenden, möchten Sie die Filter auf dem Tab „Erkunden“ aktualisieren.
filters	Objekt	Die neuen Filter, die Sie auf das explorative Analysetool anwenden möchten. Wenn filters einen Filter enthält, der derzeit nicht in der explorativen Datenanalyse vorhanden ist, aber auf ein gültiges Feld verweist, wird er der Auswertung hinzugefügt. Dieses Objekt hat das Format {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters	Array	Die vorhandenen Filter, die Sie aus dem Tab „Erkunden“ entfernen möchten. Das Array hat das Format ["view_name.field_name_1", "view_name.field_name_2", ...].

session:tokens:request

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

{
  type: "session:tokens:request",
}

Attribut	Format	Beschreibung
type	String	Wenn Sie den Typ session:tokens:request verwenden, geben Sie an, dass Sie Tokens als Reaktion auf ein session:tokens:request-Ereignis senden möchten.