Erste Schritte mit privaten Einbettungen

Wissenstest: Auf dieser Seite wird davon ausgegangen, dass Sie die Grundlagen von Inline Frame-HTML-Elementen (<iframe>), Uniform Resource Locators (URLs) und Drittanbieter-Cookies kennen. In der MDN Web Docs-Dokumentation zu Iframes finden Sie die Grundlagen.

Auf dieser Seite erfährst du, wie du die Funktion für das private Einbetten einrichtest. Bei der privaten Einbettung müssen Sie das HTML-Element <iframe> direkt verwalten, um Ihre Looker-Inhalte einzubetten. Außerdem muss sich der Nutzer separat von der Hostanwendung in Looker anmelden.

Hier ein Beispiel für den Code für die private Einbettung:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

Hinweis: Die folgenden Anweisungen gelten für alle integrierbaren Looker-Inhalte: Dashboards, LookML-Dashboards, Explores, Looks, Abfragevisualisierungen und Erweiterungen.

1. URL für eingebettete Inhalte erstellen

Hinweis :Auf dieser Seite wird beschrieben, wie Sie die URL für eingebettete Inhalte manuell erstellen. Sie können auch über ein Looker-Dashboard, einen Look oder ein Explore eine Einbettungs-URL generieren.

Betrachten wir ein Beispiel für Looker-Inhalte unter der URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Aus dieser Looker-Inhalts-URL erstellen wir die URL des eingebetteten Inhalts und setzen das src-Attribut des iFrames darauf. Sie können beim Durcharbeiten dieser Schritte gerne Ihre eigene Looker-Inhalts-URL verwenden.

Die URL für eingebettete Inhalte aus dem vorherigen Codebeispiel lautet:

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

Die URL für eingebettete Inhalte besteht aus drei Teilen:

• Hostname: Hostname Ihrer Looker-Instanz
• Pfad: Looker-Inhalts-URL-Pfad mit dem Präfix /embed (mit zusätzlichen Schritten für Abfragevisualisierungen)
• Parameter: URL-Parameter, die Filter und Themen angeben

Das Protokoll muss immer https:// sein. Sehen wir uns die einzelnen Teile genauer an.

Hinweis: Die URL für eingebettete Inhalte ist im Grunde die vollständige URL für Looker-Inhalte mit dem Präfix embed/ vor dem Pfad (es sei denn, Sie binden Abfragevisualisierungen ein).

Teil 1: Hostname

1. Gehen Sie zu Ihrem Looker-Inhalt. Beispiel für eine Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
2. Der Hostname der URL für eingebettete Inhalte lautet instance.looker.com.

Hinweis: Der Hostname enthält die Portnummer, falls vorhanden, z.B. instance.looker.com:9999.

Teil 2: Pfad

Ihr URL-Pfad für eingebettete Inhalte hängt von den eingebetteten Looker-Inhalten ab.

Alle Looker-Inhalte einbetten, mit Ausnahme von Abfragevisualisierungen

1. Gehen Sie zu Ihrem Looker-Inhalt. Beispiel für eine Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
2. Ermitteln Sie den Pfad der URL Ihrer Looker-Inhalte: /dashboards/4.
3. Fügen Sie der URL des Looker-Inhalts das Präfix /embed hinzu. Der Pfad der URL für eingebettete Inhalte lautet /embed/dashboards/4.

Abfragevisualisierung einbetten

1. Rufen Sie die Abfragevisualisierung auf. Beispiel-URL: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
2. Ermitteln Sie die Client-ID für die Abfrage. Der Parameter qid: 1234567890abcdefghij12 ist die Client-ID Ihrer Abfrage, die die Abfrage und die Visualisierungseinstellungen darstellt.
3. Der URL-Pfad des eingebetteten Inhalts wird an /embed/query-visualization/ angehängt und mit der Client-ID der Abfrage ergänzt. Der Pfad der Beispiel-URL für eingebettete Inhalte lautet /embed/query-visualization/1234567890abcdefghij12.

Hinweis: Sie finden die Client-ID für die Abfrage auch mit der Looker API-Methode Get Query als client_id-Feld des Objekts Query.

Teil 3: Parameter

Mit den URL-Parametern für eingebettete Inhalte werden die Filter und das Thema des eingebetteten Inhalts gesteuert.

Filter

1. Rufen Sie die Looker-Inhalts-URL auf.
2. Passen Sie die Filter für die Inhalte manuell an. In diesem Beispiel lautet die entsprechende Looker-Inhalts-URL: https://instance.looker.com/dashboards/4?Timeframe=14+day
3. Die URL-Parameter für eingebettete Inhalte sind die URL-Parameter für Looker-Inhalte, z. B. Timeframe=14+day.

In diesem Beispiel wird mit dem Parameter Timeframe=14+day der Wert des Timeframe-Filters des Dashboards festgelegt.

Hinweis: Der Filterparameter erstellt den Filter nicht. Er muss zuvor im Dashboard vorhanden sein.

Designs

Im Leitfaden zu Designs erfahren Sie, wie Sie das Aussehen Ihrer eingebetteten Inhalte steuern.

2. URL für eingebettete Inhalte testen

Öffne die URL der eingebetteten Inhalte in deinem Browser, um eine Vorschau des Verhaltens und des Erscheinungsbildes der eingebetteten Inhalte zu sehen.

3. iFrame erstellen

1. Erstelle das iFrame-Element in deiner Hostanwendung.
2. Lege für das src-Attribut die URL des eingebetteten Inhalts fest.
3. Definieren Sie die Attribute width, height und andere entsprechend den Anforderungen, die Sie zur Darstellung Ihrer eingebetteten Looker-Inhalte benötigen.

4. Probleme beim Nutzerzugriff berücksichtigen

Der Benutzer muss bei Looker angemeldet sein, um Ihre eingebetteten Inhalte anzeigen zu können. Wenn der Nutzer nicht angemeldet ist, wird im Iframe die Fehlerseite 401 angezeigt.

Optionen für die Nutzeranmeldung

Ihr Benutzer kann sich auf zwei Arten bei Looker anmelden:

1. Melden Sie sich vorher bei Looker an.

Ihr Benutzer muss sich im selben Browser bei Looker anmelden, bevor er die eingebetteten Inhalte anzeigen kann.

2. Optionalen eingebetteten Looker-Anmeldebildschirm aktivieren

Fügen Sie den URL-Parametern für eingebettete Inhalte allow_login_screen=true hinzu, damit im iFrame ein Looker-Anmeldebildschirm angezeigt wird, wenn der Nutzer nicht angemeldet ist. Die URL für eingebettete Inhalte in unserem Beispiel lautet dann: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true

Beachten Sie zwei Vorbehalte:

• Sie müssen die Einstellung „Same-Origin-Schutzmaßnahmen für Looker-Anmeldeseiten“ deaktivieren, um den Looker-Anmeldebildschirm in der iFrame-Einbettung zu aktivieren.
• Wenn Ihre Looker-Instanz Nutzer mithilfe der Einmalanmeldung (SSO) mit einem Identitätsanbieter authentifiziert, blockiert Ihr Identitätsanbieter möglicherweise den Anmeldebildschirm innerhalb Ihres iFrames. In diesem Fall müssen Sie Option 1 verwenden.

Cookie-Richtlinie für Browser des Nutzers

Looker verwendet Cookies für die Benutzerauthentifizierung und Sitzungsspeicherung. Der Browser Ihres Benutzers muss Drittanbieter-Cookies aktivieren, wenn Ihr Benutzer auf Ihre Looker-Instanz zugreift, die den Hostname der Inhalts-URL zum Einbetten unter einer anderen Domain befindet als Ihre Hostanwendung.

In einigen Browsern wie Firefox und Safari ist standardmäßig eine Cookie-Richtlinie aktiviert, die Drittanbieter-Cookies blockiert. Wenn der Browser des Nutzers keine Drittanbieter-Cookies zulassen kann, können Sie Ihrer Looker-Instanz eine benutzerdefinierte Domain hinzufügen, damit die Hostanwendung und der Hostname der eingebetteten Inhalts-URL der Looker-Instanz sich auf derselben Domain befinden.

Hinweis: Eine Liste der von Looker verwendeten Cookies finden Sie auf der Dokumentationsseite Looker-Cookie-Liste.

5. Mit dem iFrame interagieren

Erste Schritte mit dem Einbetten von iFrame-Post-Messaging in Looker

Nächste Schritte

Erste Schritte mit signierter Einbettung mit unserem Embed SDK und Beispiele für die Einbettung in Looker