Erste Schritte mit privaten Einbettungen

<ph type="x-smartling-placeholder">

</ph> Wissenstest:Auf dieser Seite wird davon ausgegangen, dass du mit den Grundlagen von Inline-Frame <iframe> vertraut bist. HTML-Elemente, Uniform Resource Locators (URLs) und Cookies von Drittanbietern Sehen Sie sich die MDN-Webdokumentation zu iFrames an, um sich mit den Grundlagen vertraut zu machen.

Auf dieser Seite erfahren Sie, wie Sie private Einbettungen einrichten. Bei der Option zum privaten Einbetten musst du das <iframe>-Element verwalten, das du als privat gekennzeichnet hast. HTML-Element direkt zum Einbetten Ihrer Looker-Inhalte und erfordert, dass sich der Benutzer getrennt von der Host-Anwendung in Looker anmeldet.

Sehen wir uns dieses Codebeispiel für eine private Einbettung genauer an:

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

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

Die Inhalts-URL zum Einbetten aus dem vorherigen Codebeispiel lautet:

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

Die URL zum Einbetten von Inhalten besteht aus drei Teilen:

• Hostname: der 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. Lassen Sie uns die einzelnen Teile im Detail erstellen.

Hinweis: Als Kurzform können Sie sich die Inhalts-URL zum Einbetten als Ihre vollständige Looker-Inhalts-URL mit dem Präfix embed/ vorstellen (es sei denn, Sie einbetten Abfragevisualisierungen).

Teil 1: Hostname

1. Gehen Sie zu Ihrem Looker-Inhalt. Anhand des Beispiels für die 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 außer Abfragevisualisierungen einbetten

1. Gehen Sie zu Ihrem Looker-Inhalt. Orientieren Sie sich an der Looker-Inhalts-URL im Beispiel: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
2. Ermitteln Sie den Pfad der Looker-Inhalts-URL: /dashboards/4.
3. Stellen Sie dem Pfad der Looker-Inhalts-URL das Präfix /embed voran. Der Pfad der URL für eingebettete Inhalte lautet /embed/dashboards/4.

Abfragevisualisierung einbetten

1. Rufen Sie Ihre 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 qid-Parameter 1234567890abcdefghij12 ist die Client-ID Ihrer Abfrage, die für die Abfrage- und Visualisierungseinstellungen steht.
3. Der Pfad für die URL zum Einbetten von Inhalten lautet /embed/query-visualization/, gefolgt von der Client-ID für die Abfrage. 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 der Inhalte manuell nach Bedarf 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.

Themen

Im Leitfaden zu Themen erfahren Sie, wie Sie die Darstellung Ihrer eingebetteten Inhalte steuern können.

2. URL für eingebettete Inhalte testen

Öffnen Sie die URL für eingebettete Inhalte in Ihrem Browser, um eine Vorschau des Verhaltens und der Darstellung des eingebetteten Inhalts zu sehen.

3. iFrame erstellen

1. Erstellen Sie das iFrame-Element in der Hostanwendung.
2. Lege für das Attribut src deine URL für eingebettete Inhalte 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 eine 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 Nutzer muss sich im selben Browser in Looker anmelden, bevor er die eingebetteten Inhalte ansehen 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 Beispiel-URL für eingebettete Inhalte lautet: 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.

Einige Browser wie Firefox und Safari verwenden standardmäßig eine Cookie-Richtlinie, die Cookies von Drittanbietern blockiert. Wenn im Browser des Nutzers keine Drittanbieter-Cookies zulässig sind, können Sie Ihrer Looker-Instanz eine benutzerdefinierte Domain hinzufügen. Dadurch befinden sich die Hostanwendung und die Looker-Instanz des Hostnamens der Inhalts-URL in derselben Domain.

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