Lieferungen an die Slack-Integration planen

Sie können die Looker-App in Ihrem Slack-Workspace installieren, um Datenlieferungen direkt an öffentliche und private Slack-Kanäle zu senden oder zu planen. Damit die Installation der Looker App aktiviert werden kann, muss der Inhaber des Slack-Arbeitsbereichs möglicherweise die Installationseinstellungen für die Slack-Arbeitsbereiche anpassen.

Die Slack-Integration wird für vom Kunden gehostete Instanzen nicht unterstützt.
Die Slack-Integration ist für von Looker gehostete Bereitstellungen verfügbar, die diese Bedingungen erfüllen:

  • Die Looker-Instanz hat Version 6.24 oder höher.
  • Die Funktion IP-Zulassungsliste ist für die Looker-Instanz nicht aktiviert.

Die Integration von Slack-Anhängen (API-Token) kann weiterhin verwendet werden.

Integration im Looker Action Hub aktivieren

Wenn Ihre Looker-Instanz die erforderlichen Bedingungen erfüllt, muss Ihr Looker-Administrator die Slack-Integration im Looker Action Hub für jede Looker-Instanz aktivieren, damit Nutzer Daten mit der Slack-Integration bereitstellen können.

  1. Rufen Sie im Bereich Admin unter Plattform die Seite Aktionen auf.
  2. Klicken Sie auf die Schaltfläche Aktivieren, um die Slack-Integration im Looker Action Hub zu aktivieren.

  3. Klicken Sie auf der Aktionsseite Slack auf Verbinden, um eine Verbindung zu Ihrem Slack-Arbeitsbereich herzustellen.

    Looker fordert Zugriff auf den Slack-Workspace an, der im Dropdown-Menü oben rechts auf der Seite angegeben ist. Wenn Sie mehrere Slack-Arbeitsbereiche mit einer einzelnen Looker-Instanz verbinden möchten, klicken Sie auf den Link + Mit Slack-Arbeitsbereich verbinden.

  4. Klicken Sie auf Allow (Zulassen) und kehren Sie zur Aktionsseite Slack zurück.

  5. Klicken Sie auf den Schalter Aktivieren und dann auf Speichern.

Slack-Workspace-Verbindungen zu Looker verwalten

Sie können die Slack-Arbeitsbereich-Verbindungen der Instanz über die Aktionsseite Slack verwalten. Klicken Sie auf der Seite Aktionen im Steuerfeld Admin neben der Slack-Integration auf die Schaltfläche Einstellungen.

Administratoren können für jede Verbindung mit dem Slack-Arbeitsbereich die folgenden Vorgänge ausführen: Verbinden, Trennen und Zurücksetzen.

  • Klicken Sie auf den Link + Mit Slack-Arbeitsbereich verbinden, um weitere Slack-Arbeitsbereiche mit der Looker-Instanz zu verbinden.

  • Wenn Sie eine bestehende Verbindung mit dem Slack-Arbeitsbereich trennen möchten, klicken Sie auf die Schaltfläche Verbindung trennen und dann in der Pop-up-Warnung auf OK. Sie müssen auf der Aktionsseite Slack nicht auf Speichern klicken, um diese Einstellungen zu speichern. Die Aktion wird auch dann als Aktiviert angezeigt, wenn kein Slack-Arbeitsbereich verbunden ist.

  • Wenn Sie die Verbindung mit dem Slack-Arbeitsbereich aktualisieren möchten, ohne die Verbindung zu trennen und wieder herzustellen, klicken Sie auf die Schaltfläche Zurücksetzen.

Authentifizierung bei Ihrem Slack-Workspace

Benutzer müssen sich bei dem Slack-Workspace authentifizieren, den der Looker-Administrator mit Looker verbunden hat. Außerdem müssen Benutzer bestehende Mitglieder des Workspace sein, bevor sie sich aus Looker dabei authentifizieren können.

Optionen zur erstmaligen Authentifizierung bei einem Slack-Workspace:

Sie erhalten eine Slack-Bestätigungsmeldung, wenn Sie sich erfolgreich von Looker bei Slack authentifiziert haben.

Authentifizierung bei einem Slack-Workspace über die Seite „Konto“

  1. Klicken Sie in Looker oben rechts auf Ihr Nutzerprofilsymbol und wählen Sie Konto aus.
  2. Alle für Ihre Instanz aktivierten Integrationen werden unter Integrationen angezeigt. Wenn Ihr Looker-Administrator mindestens einen Slack-Arbeitsbereich aktiviert hat, wird eine Schaltfläche zum Anmelden mit Slack angezeigt. Wenn Ihr Looker-Administrator mehrere Slack-Arbeitsbereiche mit Ihrer Looker-Instanz verbunden hat, wird eine Liste von Arbeitsbereichen mit Optionen zur Anmeldung in jedem einzelnen angezeigt.
  3. Looker fordert Zugriff auf den Slack-Workspace an. Wenn Ihr Looker-Administrator mehrere Slack-Workspaces mit Ihrer Looker-Instanz verbunden hat, wird ein Dropdown-Menü oben rechts auf der OAuth-Seite angezeigt. Wählen Sie den Slack-Workspace im Dropdown-Menü aus. Klicken Sie auf Zulassen.
  4. Wenn Sie zur Seite Konto zurückkehren, haben Sie jetzt die Möglichkeit, Ihre Slack-Anmeldedaten für alle Arbeitsbereiche zu widerrufen, mit denen Sie verbunden sind.

Achten Sie darauf, Ihr Slack-Token nicht zu widerrufen. Andernfalls schlagen alle von Ihnen erstellten Zeitpläne fehl.

Nach der Authentifizierung können Sie Dashboards, Looks und explorative Datenanalysen senden oder planen. Weitere Informationen finden Sie auf dieser Seite im Abschnitt Daten an Slack übermitteln.

Authentifizierung bei einem Slack-Workspace über das Fenster „Senden“ oder „Planen“

  1. Rufen Sie in Looker den zu sendenden Inhalt auf, klicken Sie auf das Zahnradsymbol und dann auf Senden oder Planen.
  2. Wählen Sie im Fenster Senden oder Planen unter Wo sollen diese Daten gespeichert werden? die Aktion Slack als Ziel für die Zustellung aus.
  3. Klicken Sie neben Slack auf Log in (Anmelden).
  4. Looker fordert Zugriff auf den Slack-Workspace an. Wenn Ihr Looker-Administrator mehrere Slack-Workspaces mit Ihrer Looker-Instanz verbunden hat, wird ein Dropdown-Menü oben rechts auf der OAuth-Seite angezeigt. Wählen Sie den Slack-Workspace im Dropdown-Menü aus. Klicken Sie auf Zulassen.
  5. Im Fenster Senden oder Planen werden jetzt Ihre Slack-Übermittlungsoptionen angezeigt, einschließlich der öffentlichen und privaten Kanäle in Ihrem Slack-Arbeitsbereich. 

Daten an Slack liefern

Zum Bereitstellen von Daten für die Slack-Integration muss ein Looker-Administrator Nutzern zuerst die Berechtigung send_to_integration erteilen und die Slack-Integration im Looker Action Hub aktivieren. Benutzer müssen sich zudem bei demselben Slack-Workspace oder den Workspaces authentifizieren, die der Administrator mit Looker verbunden hat.

Sie können Inhalt an einen von mehreren Slack-Workspaces liefern. Nachdem ein Looker-Administrator die Arbeitsbereichsverbindungen eingerichtet hat, können Sie sich auf der Seite Konto des Nutzers bei den einzelnen Nutzern anmelden. Anschließend können Sie einen Zielarbeitsbereich aus dem Drop-down-Menü Arbeitsbereiche des Pop-up-Fensters Senden oder Planen auswählen.

Das Beispiel unten zeigt Formatierungsoptionen für die Lieferung eines Dashboards, einschließlich:

  • PDF
  • Visualization (PNG)
  • CSV-ZIP-Datei

Beim Senden oder Planen eines Looks oder Explores sind andere Formatierungsoptionen verfügbar, darunter:

  • CSV
  • XLSX
  • JSON: Einfach: In diesem Format verwendet Looker anstelle des Labels eines Felds den Namen einer Dimension oder eines Messwerts als gerenderten Wert.
  • JSON: Label: In diesem Format verwendet Looker das Feld labels als gerenderten Wert in der JSON-Ausgabe.
  • JSON – Inline: In diesem Format verwendet Looker anstelle des Labels des Felds den Dimensionsnamen einer Dimension oder eines Messwerts als gerenderten Wert.
  • JSON – Detailliert, Inline: In diesem Format verwendet Looker anstelle des Labels des Felds den Feldnamen einer Dimension oder eines Messwerts als gerenderten Wert.
  • Text
  • HTML

Um ein Explore im PDF- oder PNG-Format zu senden, speichern Sie den Look in einem Dashboard, und planen Sie das Dashboard im gewünschten Format. Um ein Explore zu planen, müssen Sie es zunächst als Look speichern.

Um einen Look im PDF- oder PNG-Format zu senden oder zu planen, speichern Sie den Look in einem Dashboard und planen Sie das Dashboard im gewünschten Format.

Um ein benutzerdefiniertes Dashboard, ein LookML-Dashboard, einen Look oder ein Explore zu liefern, navigieren Sie zum Inhalt und führen Sie dann die folgenden Schritte aus:

  1. Klicken Sie auf das Zahnradsymbol und dann auf Senden oder Planen. (Bei Explores steht keine Option zum Planen zur Verfügung.)
  2. Wählen Sie im Fenster Senden oder Zeitplan die Slack-Integration als Übermittlungsziel unter Wo sollen diese Daten gespeichert werden? aus. Wenn Sie die Slack-Integration zum ersten Mal verwenden, müssen Sie sich zuerst im Slack-Arbeitsbereich authentifizieren.
  3. Anschließend zeigt Looker spezielle Lieferoptionen für den Slack-Workspace oder die Workspaces an, die mit dieser Looker-Instanz verbunden sind.
    • Geben Sie im Feld Teilen in den Namen des Slack-Kanals ein, in den Sie die Daten übertragen möchten. Sie können Direktnachrichten oder Nachrichten an öffentliche oder private Kanäle senden. Fügen Sie das vorangestellte #-Zeichen ein, z. B. #Verkäufe.
    • Geben Sie in das Feld Kommentar einen Text ein, der enthalten sein soll.
      • Wenn Sie einen Nutzer erwähnen möchten, fügen Sie <@user_ID> hinzu. Klicken Sie dazu im Slack-Nutzerprofil auf die Schaltfläche ....
      • Wenn Sie eine Gruppe erwähnen möchten, fügen Sie <@group_ID> ein. Sie können sie aus der Browser-URL kopieren, wenn Sie sich im Gruppenprofil befinden.
      • Wenn du einen bestimmten Kanal erwähnen möchtest, füge <#channel_ID> hinzu, den du aus der Browser-URL kopieren kannst, wenn du im Kanal bist.
      • Für andere besondere Erwähnungen können Sie <!here>, <!channel> oder <!everyone> verwenden.
    • Geben Sie im Feld Dateiname einen Namen für die Anhangsdatei ein.
  4. Wenn Sie eine Datenübertragung planen möchten, klicken Sie auf Alle speichern. Ihre Abfrage oder Ihr Dashboard wird planmäßig an Slack geliefert. Wenn Sie die Daten senden möchten, klicken Sie auf Senden. Die Daten werden an den Slack-Kanal geliefert.

Von Slack auf Looker zugreifen

Sie können wie folgt aus Slack auf Looker-Daten zugreifen:

Links zu Looker-Inhalt in Slack teilen

Sie können Links zu SQL-Runner-Visualisierungen, benutzerdefinierten Dashboards (einschließlich Legacy-Dashboards), LookML-Dashboards, Looks (aber nicht öffentlich eingebetteten Looks) oder explorativen Datenanalysen in Slack teilen.

Die Verknüpfung des Links in Slack wird aufgehoben, um den Titel und einige Metadaten des Inhalts anzuzeigen. Diese sind nur für Nutzer sichtbar, die Zugriff auf den zugrunde liegenden Inhalt haben. Nach Anzeigen des Links können Sie oder andere Benutzer:

  • Posten Sie einen Link zurück zu den Inhalten in Looker und eine Übersicht über die Inhalte im Kanal: Klicken Sie auf Auf diesem Kanal posten. Nachdem die Inhalte auf dem Kanal gepostet wurden, kann jeder im Kanal die Inhaltsübersicht und den Titel sehen, auch wenn er keinen Zugriff auf die zugrunde liegenden Inhalte in Looker hat.
  • Fügen Sie den Inhalt einem Looker-Ordner Favoriten hinzu. Klicken Sie dazu auf Zu Favoriten hinzufügen. Nachdem Sie dem Ordner Favoriten Inhalte hinzugefügt haben, zeigt die Looker App in Slack eine Nachricht in Slack mit einem Link für den Zugriff auf den Ordner Favoriten in Looker an.

Wenn mehrere Looker-Instanzen mit dem Arbeitsbereich verbunden sind, müssen Sie die Standardinstanz festlegen, die der Looker-Instanz entspricht, von der Sie den Link freigeben.

Looker-Informationen in Slack mit Slash-Befehlen abrufen

Wenn Sie außerdem Lookerbot aktiviert haben, müssen Sie möglicherweise einige Slash-Befehle umbenennen. Benutzerdefinierte Slack-Befehle sind nicht für die Slack-Integration verfügbar. Sie können aber benutzerdefinierte Befehle in Lookerbot konfigurieren. Achten Sie darauf, dass Sie die Lookerbot-Version 0.0.16 oder höher verwenden. Führen Sie dazu im GitHub-Repository von Lookerbot eine Aktualisierung durch, wie im Abschnitt Lookerbot-App aktualisieren des Hilfeartikels Lookerbot für Slack verwenden beschrieben.

Mit den folgenden Slash-Befehlen können Sie Informationen von Looker abrufen und in Slack veröffentlichen:

  • /looker und /looker whoami: Die Looker-App in Slack begrüßt Sie mit ihrem Namen, gibt die Looker-Instanz an, mit der Sie verbunden sind, und stellt Links zu Ihrem Looker-Favoriten-Ordner, zu Ihrem persönlichen Ordner und zu Hilfe bereit.
  • /looker help: Die Looker-App in Slack listet die unterstützten Slash-Befehle auf.
  • /looker favorites: Die Looker-App in Slack listet die Inhalte aus Ihrem Looker-Ordner Favoriten auf. Klicken Sie auf die drei Punkte (...) neben den einzelnen Inhalten, um ein Menü aufzurufen, aus dem Sie In diesem Kanal posten oder Aus Favoriten entfernen auswählen können.
  • /looker folder: Die Looker-App in Slack listet die Inhalte aus Ihrem persönlichen Looker-Ordner auf. Klicken Sie auf die drei Punkte (...) neben den einzelnen Inhalten, um ein Menü aufzurufen, über das Sie In diesem Kanal posten oder Aus Favoriten entfernen können, falls sich die Inhalte auch im Ordner Favoriten befinden.
  • /looker select: Die Looker-Anwendung in Slack listet die Instanz oder die Instanzen auf, die mit diesem Slack-Arbeitsbereich verbunden sind. Um eine Standardinstanz für Ihren Slack-Workspace festzulegen, klicken Sie in dieser Liste auf die Instanz. Alle instanzspezifischen Slash-Befehle würden für die Standard-Looker-Instanz gelten.

Start-Registerkarte der Looker-App in Slack anzeigen

Klicken Sie auf den Tab Startseite in der Looker App, um eine Liste Ihrer bevorzugten Looker-Inhalte und -Ordner in Slack aufzurufen.

Wenn Sie eine Standard-Looker-Instanz für den Slack-Arbeitsbereich festlegen, werden nur Inhalte aus dieser Instanz auf dem Tab Startseite der Looker App angezeigt.

Standard-Looker-Instanz für Ihren Slack-Workspace festlegen

Wenn der Looker-Administrator nur eine Looker-Instanz mit Ihrem Slack-Workspace verbunden hat, ist diese Instanz die Standardinstanz.

Wenn der Looker-Administrator mehrere Looker-Instanzen mit Ihrem Slack-Workspace verbunden hat, können Sie eine der Instanzen als Standard-Looker-Instanz festlegen. Alle instanzspezifischen Slash-Befehle – die meisten Befehle außer /looker help – und die Link-Entfaltung gelten für die Standardinstanz.

  1. Führen Sie in Slack den Slash-Befehl /looker select aus, um eine Liste der Looker-Instanzen aufzurufen, die mit Ihrem Slack-Arbeitsbereich verbunden sind.

  2. Die Looker-App fragt Welche Instanz möchten Sie als Standard festlegen? Klicken Sie auf die Schaltfläche für den Namen der Looker-Instanz, um diese Instanz als Standard festzulegen.

    Die Auswahl wird von der Looker-App bestätigt.

Führen Sie /looker select noch einmal aus und wählen Sie eine andere Looker-Instanz aus, um zu Ihrer Standard-Looker-Instanz zu wechseln. Sie müssen die Standardinstanzen wechseln, wenn Sie Links von einer Looker-Instanz entpacken, die nicht die Standardinstanz ist. Wenn Sie die Instanz nicht wechseln und versuchen, einen Link von einer nicht standardmäßigen Looker-Instanz zu öffnen, werden Sie aufgefordert, sich bei dieser Looker-Instanz anzumelden.