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 eine Fehlermeldung oder einen Anmeldebildschirm anzeigen.

Nutzer, die angemeldet sind und auf privat eingebettete Inhalte zugreifen, unterliegen den Einstellungen im Admin-Bereich Sitzungen. Dort legen Sie fest, 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 anpassbare eingebettete Lösung benötigen, lesen Sie die Dokumentationsseite Signierte Einbettungen.

Einbettungs-URL generieren

Um eine private Einbettungs-URL für ein Dashboard, einen Look oder eine Explore-Visualisierung zu generieren und zu kopieren, wählen Sie im Drei-Punkte-Menü eines Dashboards oder in einem Explore- oder Look aus dem Zahnrad-Menü der Explore-Aktion 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 Explore-Einbettungs-URL generieren und für Ihre Instanz benutzerdefinierte Designs aktiviert sind. Das Design wird angewendet, wenn das eingebettete Dashboard oder Explore angezeigt wird.
  3. Mit dem Schalter Aktuelle Parameter in URL einbeziehen 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 beim Ansehen der eingebetteten Inhalte angewendet.
  4. Wähle die Schaltfläche Link kopieren aus, um die vollständige Einbettungs-URL in die Zwischenablage zu kopieren.

Nachdem du die Einbettungs-URL generiert und kopiert hast, kannst du sie in ein neues Browserfenster oder einen neuen Tab einfügen, um dir eine Vorschau der eingebetteten Inhalte anzusehen. Außerdem können Sie diese URL verwenden, um den Content in einen iFrame einzubetten.

Vorschau der eingebetteten Inhalte

Füge die Einbettungs-URL in deinen Browser ein, um dir eine Vorschau des Verhaltens und des Aussehens deiner eingebetteten Inhalte anzusehen.

Eingebettete Inhalte 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>

Anschließend 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 nach der Einbettung aussieht.

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:

  • Sie können für jede Art von Dashboard einen anderen Designnamen in der Einbettungs-URL angeben, um das zur Anzeige des Dashboards verwendete Design zu ändern.
  • Sie können für jeden Dashboard-Typ das URL-Argument _theme verwenden, um einzelne Dashboard-Designelemente zu ändern.
  • Für ein LookML-Dashboard können Sie die eingebettete Darstellung eines Dashboards auch über den Parameter embed_style ändern.

Mit dem URL-Argument theme, der Option Einbettungseinstellungen bearbeiten oder dem Parameter embed_style werden nur Änderungen am Dashboard vorgenommen, auf das das Argument, die Option oder der Parameter angewendet wird. Wenn Sie die Darstellung 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 Explores erstellen und anwenden.

Anmeldebildschirm für private Einbettungen aktivieren

Du kannst deiner Einbettungs-URL den Parameter allow_login_screen=true hinzufügen, wenn Nutzern, die sich noch nicht angemeldet haben, ein Anmeldebildschirm angezeigt werden soll. 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.