Private Einbettung

Neben dem öffentlichen Einbetten können Sie auch Look, Explores und Dashboards privat einbetten, sodass eine Authentifizierung mit Looker-Anmeldung, Google OAuth oder OpenID Connect erforderlich ist. Wenn ein Nutzer nicht authentifiziert ist, können Sie eine Fehlermeldung oder einen Anmeldebildschirm anzeigen.

Für Nutzer, die angemeldet sind und auf privat eingebettete Inhalte zugreifen, gelten die Einstellungen im Bereich Sitzungen Admin. Diese legen fest, wie lange sie angemeldet bleiben, ob sie sich über mehrere Browser anmelden können und ob sie nach einer bestimmten Zeit abgemeldet werden.

Wenn Sie eine komplexere oder personalisierbare eingebettete Lösung benötigen, lesen Sie unsere Dokumentation zur Einmalanmeldung (SSO).

Eingebetteter Inhalt spiegelt immer die Produktionsversion des Inhalts wider. Im Entwicklungsmodus vorgenommene Änderungen, die sich auf den Inhalt auswirken und noch nicht in der Produktionsumgebung bereitgestellt wurden, werden nicht in einer Einbettung angezeigt.

Looks einbetten

So binden Sie eine Visualisierung ein:

  1. Öffnen Sie einen gespeicherten Look.
  2. Kopieren Sie die URL.
  3. Ändern Sie /looks/ in /embed/looks/. Beispiel:

    https://instance_name.looker.com/looks/4
    

    wird geändert zu:

    https://instance_name.looker.com/embed/looks/4
    
  4. Platzieren Sie die neue URL in einem iFrame. Beispiel:

      <iframe
          src="https://instance_name.looker.com/embed/looks/4"
          width="600"
          height="300"
          frameborder="0">
      </iframe>
    
  5. Betten Sie den iFrame nach Bedarf ein.

Explores einbetten

So binden Sie eine Visualisierung ein:

  1. Wählen Sie in einem gespeicherten Look Entdecken von hier aus oder rufen Sie die Seite Erkunden auf und erstellen Sie die gewünschte Visualisierung.
  2. Kopieren Sie die URL auf der Seite „Explore“. Wenn Sie URL-Parameter ändern oder hinzufügen möchten, wählen Sie im Zahnradsymbol rechts oben Teilen aus und kopieren Sie dann die erweiterte URL.
  3. Ändern Sie /explore/ in /embed/explore/. Beispiel:

    https://instance_name.looker.com/explore/my_model/my_explore?...
    

    wird geändert zu:

    https://instance_name.looker.com/embed/explore/my_model/my_explore?...
    
  4. Platzieren Sie die neue URL in einem iFrame. Beispiel:

      <iframe
          src="https://instance_name.looker.com/embed/explore/my_model/my_explore?..."
          width="1000"
          height="1000"
          frameborder="0">
      </iframe>
    
  5. Betten Sie den iFrame nach Bedarf ein.

Dashboards einbetten

Führen Sie diese Schritte aus, um ein Dashboard einzubetten:

  1. Öffnen Sie ein gespeichertes Dashboard.
  2. Kopieren Sie die URL.
  3. Für ein Dashboard, das die neue Dashboard-Oberfläche verwendet, ändern Sie /dashboards/ in /embed/dashboards/ in der URL. Für ein altes Dashboard ändern Sie /dashboards-legacy/ in /embed/dashboards-legacy/. Beispiel:

    https://instance_name.looker.com/dashboards/1
    

    wird geändert zu:

    https://instance_name.looker.com/embed/dashboards/1
    
  4. Platzieren Sie die neue URL in einem iFrame. Beispiel:

      <iframe
          src="https://instance_name.looker.com/embed/dashboards/1"
          width="1000"
          height="2000"
          frameborder="0">
      </iframe>
    
  5. Betten Sie den iFrame nach Bedarf ein.

Darstellung der Einbettung eines Dashboards ändern

Wenn Sie ein Dashboard mit /embed in der URL aufrufen, sehen Sie, wie das Dashboard angezeigt wird, wenn es eingebettet ist. Wenn Sie ein altes Dashboard verwenden, können Sie auch im Zahnradmenü des Dashboards die Option Vorschau-Dashboard auswählen, um zu sehen, wie Ihr Dashboard nach dem Einbetten angezeigt wird.

Standardmäßig wird ein eingebettetes Dashboard mit dem Standarddesign für Ihre Looker-Instanz angezeigt. Sie können die Darstellung des eingebetteten Dashboards je nach Typ des verwendeten Dashboards auf mehrere Arten ändern:

  • Für jede Art von Dashboard können Sie in der eingebetteten URL einen anderen Designnamen angeben, um das zum Anzeigen des Dashboards verwendete Design zu ändern.
  • Mit dem URL-Argument _theme können Sie für jedes Dashboard-Typ einzelne Dashboard-Designelemente ändern.
  • Bei einem alten Dashboard können Sie die eingebettete Darstellung eines Dashboards auch ändern, indem Sie im Zahnrad-Dashboard die Option Einstellungen zum Einbetten bearbeiten auswählen.
  • Bei einem LookML-Dashboard können Sie die eingebettete Darstellung eines Dashboards auch über den Parameter embed_style ändern.

Mit dem URL-Argument theme, der Option Einstellungen für die Einbettung bearbeiten oder dem Parameter embed_style werden nur Änderungen am Dashboard vorgenommen, auf die das Argument, die Option oder der Parameter angewendet wird. Wenn Sie das Erscheinungsbild mehrerer eingebetteter Dashboards anpassen möchten, verwenden Sie stattdessen ein Design.

Einige Anzeigeeinstellungen setzen andere außer Kraft. Weitere Informationen finden Sie auf der Dokumentationsseite Designs für eingebettete Dashboards und explorative Datenanalysen erstellen und anwenden.

Einbettungseinstellungen bei älteren Dashboards

Die Einbettungseinstellungen für ein altes Dashboard werden durch jedes nicht standardmäßige Design, das in der Einbettungs-URL des Dashboards angegeben ist, oder durch einzelne Designelemente, die in der URL angegeben sind überschrieben.

So konfigurieren Sie, wie ein altes Dashboard angezeigt wird, wenn es eingebettet ist:

  1. Klicken Sie auf das Zahnrad-Dashboard und wählen Sie Einstellungen für eingebettete Inhalte bearbeiten aus. Daraufhin wird ein Bereich mit Einstellungen zum Einbetten geöffnet:

  2. Legen Sie fest, ob der Titel oder die Filter im Dashboard angezeigt oder ausgeblendet werden sollen.
  3. Klicken Sie auf die Farbfelder, um die Farbe der Dashboard-Elemente anzupassen.
  4. Optional können Sie auf Änderungen rückgängig machen klicken, um zu den zuletzt gespeicherten Einbettungseinstellungen für das Dashboard zurückzukehren, oder auf Auf Standardeinstellungen zurücksetzen, um alle Einstellungen auf die Standardeinstellungen zurückzusetzen, die für alle eingebetteten Dashboards auf Ihrer Looker-Instanz verwendet werden.
  5. Klicken Sie auf Speichern, um die Änderungen zu speichern, oder auf Abbrechen, um das Fenster zu schließen, ohne die Änderungen zu speichern.

Einbettungseinstellungen für ein älteres Dashboard entfernen

Gehen Sie wie folgt vor, um die spezifischen Einbettungseinstellungen für ein älteres Dashboard zu entfernen:

  1. Klicke auf das Zahnrad-Dashboard und wähle Einstellungen für eingebettete Inhalte bearbeiten aus.
  2. Klicken Sie auf Auf Standardeinstellungen zurücksetzen.
  3. Klicken Sie auf Speichern.

Anmeldebildschirm für private Einbettungen aktivieren

Sie können den Parameter allow_login_screen=true zu Ihrer eingebetteten URL hinzufügen, wenn Sie einen Anmeldebildschirm für Nutzer einblenden möchten, die sich noch nicht angemeldet haben. Beispiel:

<iframe src="https://instance_name.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Wenn Sie diesen Parameter nicht hinzufügen, wird Benutzern, die noch nicht angemeldet sind, die Fehlermeldung 401 angezeigt.

Wenn Sie für Ihre Looker-Anmeldeseiten Same-Origin-Schutzmaßnahmen verwenden, können Sie den Anmeldebildschirm für private Einbettungen möglicherweise nicht aktivieren.