Private Einbettung

Neben der öffentlichen Einbettung können Sie Looks, Explores und Dashboards auch privat einbetten. Mit der privaten Einbettung können Sie festlegen, dass sich ein Nutzer mit einem Looker-Log-in, Google OAuth oder OpenID Connect authentifizieren muss. Wenn ein Nutzer nicht authentifiziert ist, können Sie sich eine Fehlermeldung oder einen Anmeldebildschirm anzeigen lassen.

Nutzer, die angemeldet sind und auf privat eingebettete Inhalte zugreifen, unterliegen den Einstellungen im Administratorbereich . Darin wird festgelegt, wie lange sie angemeldet bleiben können, ob sie sich über mehrere Browser anmelden können und ob sie nach einer bestimmten Zeit der Inaktivität abgemeldet werden.

Wenn Sie eine erweiterte oder anpassungsfähigere Lösung für Einbettungen benötigen, besuchen Sie unsere Dokumentationsseite zur signierten Einbettung.

Einbettungs-URL generieren

Wenn Sie eine private Einbettungs-URL für ein Dashboard, einen Look oder eine Explore-Visualisierung generieren und kopieren möchten, wählen Sie im Dreipunkt-Menü eines Dashboards oder im Zahnrad-Menü für Explore-Aktionen in einem Explore oder Look die Option Einbettungs-URL abrufen aus.

Der Bildschirm Private Einbettung enthält die folgenden Elemente:

  1. Im Feld Content-URL wird die vollständige private Einbettungs-URL angezeigt.
  2. Im Feld Design auf Dashboard-URL anwenden können Sie ein Design auswählen, das der Einbettungs-URL hinzugefügt werden soll, wenn Sie ein Dashboard oder eine Einbettungs-URL für Explores generieren und für Ihre Instanz benutzerdefinierte Designs aktiviert sind. Das Design wird angewendet, wenn das eingebettete Dashboard oder Explore aufgerufen wird.
  3. Mit dem Schalter Aktuelle Parameter in URL aufnehmen können Sie festlegen, ob aktuelle Parameter, z. B. Filterwerte, auf die Einbettungs-URL angewendet werden sollen. Wenn diese Option aktiviert ist, werden diese Parameter angewendet, wenn die eingebetteten Inhalte angesehen werden.
  4. Klicken Sie auf die Schaltfläche Copy Link (Link kopieren), um die vollständige Einbettungs-URL in die Zwischenablage zu kopieren.

Nachdem Sie die Einbettungs-URL erstellt und kopiert haben, können Sie sie in ein neues Browserfenster oder einen neuen Tab einfügen, um den eingebetteten Inhalt in der Vorschau anzuzeigen. Du kannst diese URL auch verwenden, um die Inhalte in einen iFrame einzubetten.

Vorschau des eingebetteten Inhalts

Fügen Sie die Einbettungs-URL in Ihren Browser ein, um eine Vorschau des Verhaltens und des Erscheinungsbildes der eingebetteten Inhalte zu erhalten.

Eingebetteten Inhalt in einem iFrame ansehen

Platzieren Sie die Einbettungs-URL in einem iFrame. Beispiel:

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Betten Sie dann den iFrame nach Bedarf ein.

Darstellung der Einbettung eines Dashboards ändern

Wenn Sie sich ein Dashboard mit /embed in der URL ansehen, sehen Sie, wie das Dashboard nach der Einbettung angezeigt wird.

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

  • Sie können für jede Art von Dashboard in der Einbettungs-URL einen anderen Designnamen angeben, um das Design des Dashboards zu ändern.
  • Mit dem URL-Argument _theme können Sie für jeden Dashboardtyp einzelne Elemente des Dashboard-Designs ändern.
  • Bei einem LookML-Dashboard können Sie die Darstellung des eingebetteten Dashboards auch über den Parameter embed_style ändern.

Wenn Sie das URL-Argument theme, die Option Einbettungseinstellungen bearbeiten oder den Parameter embed_style verwenden, werden Änderungen nur am Dashboard vorgenommen, auf das das Argument, die Option oder der Parameter angewendet wird. Wenn Sie die Visualisierung mehrerer eingebetteter Dashboards anpassen möchten, verwenden Sie stattdessen ein Thema.

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

Anmeldebildschirm für private Einbettungen aktivieren

Du kannst den Parameter allow_login_screen=true zu deiner Einbettungs-URL hinzufügen, wenn du Nutzern, die noch nicht angemeldet sind, einen Anmeldebildschirm anzeigen möchtest. Beispiel:

<iframe src="https://instance_name.cloud.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.