Einrichten der Tableau-App für Microsoft Teams

Anwendungsbereich: Tableau Cloud, Tableau Server

Mit der Tableau-App für Microsoft Teams können Ihre Benutzer mit Tableau-Ansichten (Visualisierungen) und Metriken interagieren, ohne ihren Workflow zu verlassen. Als Tableau-Administrator installieren und konfigurieren Sie die App, um Ihre vorhandene Tableau-Site mit Ihrer Microsoft Teams-Bereitstellung zu verbinden. Sie können die App für Tableau Cloud direkt vom Microsoft Apps Marketplace aus installieren. Um die App für Tableau Server zu installieren, laden Sie die App herunter und starten sie sie per „Sideload“.

Informationen über die Tableau-App für Microsoft Teams finden Sie unter Zugriff auf Tableau-Inhalte in Microsoft Teams. In diesem Artikel geht es um das Einrichten der Tableau-App.

Siehe auch

Voraussetzungen

Zum Einrichten der Tableau-App für Microsoft Teams benötigen Sie die folgenden Apps und Konten.

  • Tableau Cloud oder Tableau Server, Versionen 2023.1 oder höher
  • Ein Site-Administratorkonto für Tableau Cloud oder ein Serveradministratorkonto für Tableau Server
  • Ein Microsoft 365 für Enterprise-Abonnement
  • Microsoft Teams
  • Ein Microsoft 365-Administratorkonto, wenn die Richtlinien Ihrer Organisation ein Administratorkonto zum Installieren von Apps erfordern
  • Benutzerlizenzen für Tableau und Microsoft Teams, die basierend auf einem der Benutzerzuordnungsattribute einander zugeordnet werden

Benutzerzuordnungsattribute

Um SSO mit Tableau zu ermöglichen, ordnen Sie die Benutzerkonten in Microsoft Teams den Benutzerkonten in Tableau zu. Sie können diese Zuordnung mithilfe von Attributen aus dem Microsoft Teams-SDK oder aus dem Microsoft Entra-Profil eines Benutzers einrichten.

Microsoft Teams-SDK-Attribute

AttributBeschreibung
Preferred_Username(Link wird in neuem Fenster geöffnet)Die E-Mail-Adresse des Microsoft Teams-Benutzers. In einigen Fällen kann dieser Wert anders lauten als die in Microsoft Entra definierte E-Mail-Adresse.
User Principal Name(Link wird in neuem Fenster geöffnet)Die primäre Methode, über die sich Benutzer bei Microsoft Entra anmelden.

Microsoft Entra-Profil-Attribute

AttributBeschreibung
Primary Email(Link wird in neuem Fenster geöffnet)Entspricht dem user.mail-Attribut und stellt die E-Mail-Adresse des Benutzers dar.
Mail Nickname(Link wird in neuem Fenster geöffnet)Entspricht dem user.mailNickname-Attribut und stellt einen Alias für den Benutzer dar.
Employee ID(Link wird in neuem Fenster geöffnet)Entspricht dem user.employeeId-Attribut und stellt eine von der Organisation zugewiesene Mitarbeiterkennung dar.
On-Premise Distinguished Name(Link wird in neuem Fenster geöffnet)Entspricht dem user.onPremiseDistinguishedName-Attribut und stellt den definierten Namen (Distinguished Name, DN) dar, der aus einem lokalen Active Directory synchronisiert wird.
On-Premise User Principal Name(Link wird in neuem Fenster geöffnet)Entspricht dem user.onPremiseUserPrincipalName-Attribut und stellt den Benutzerprincipalnamen (UPN) dar, der aus einem lokalen Active Directory synchronisiert wird.
On-premise SAM Account Name(Link wird in neuem Fenster geöffnet)Entspricht dem user.onPremiseSamAccountName-Attribut und stellt den samAccountName dar, der aus einem lokalen Active Directory synchronisiert wird.
Extension Attribute X(Link wird in neuem Fenster geöffnet)Microsoft Entra erlaubt es Ihnen, dem Entra-Profil eines Benutzers bis zu 15 zusätzliche Attribute hinzufügen. Wenn der Tableau-Benutzername in Microsoft Entra nicht vorhanden ist, verwenden Sie ein Erweiterungsattribut, um den Tableau-Benutzernamen für jeden Entra-Benutzer zu speichern.

Zusätzliche Voraussetzungen für Tableau Server

Die Tableau App verwendet API-Aufrufe, um mit Tableau Server zu kommunizieren und interaktive Inhalte einzubetten. Diese Aufrufe müssen Tableau Server erreichen können.

  • Wenn sich Tableau Server hinter einer Firewall befindet, lassen Sie eingehende HTTP-Anforderungen aus den IP-Bereichen 4.152.0.0/15 und 20.2.0.0/16 zu.
  • Stellen Sie sicher, dass Benutzer auf die gleiche Weise auf Tableau Server zugreifen können wie auf Microsoft Teams.
    • Wenn Benutzer für den Zugriff auf Microsoft Teams ein VPN verwenden müssen, muss der Zugriff auf Tableau Server über dasselbe VPN möglich sein.
    • Wenn Benutzer über das öffentliche Internet auf Microsoft Teams zugreifen können, muss Tableau Server über das öffentliche Internet zugänglich sein.
    • Wenn Benutzer über mobile Apps auf Microsoft Teams zugreifen können, muss Tableau Server von mobilen Geräten aus zugänglich sein.

Installieren der Tableau-App für Tableau Server

Um die Tableau-App für Tableau Server zu installieren, bearbeiten Sie das App-Manifest, um den Hostnamen anzupassen, und laden dann das App-Manifest in Microsoft Teams hoch.

Informationen zur Installation der Tableau-App für Tableau Cloud finden Sie im Tableau Cloud-Einrichtungshandbuch.

1. Herunterladen und Bearbeiten des App-Manifests

  1. Laden Sie das App-Manifest von GitHub herunter.

  2. Extrahieren Sie die Dateien aus der Manifestdatei tableau-server-app-for-teams.zip.

  3. Öffnen Sie die Datei manifest.json in einem Texteditor.

  4. Suchen Sie in manifest.json nach *.online.tableau.com, und ersetzen Sie diese Domäne mit dem Hostnamen Ihrer Tableau Server-Umgebung. Wenn Ihre Tableau Server-URL https://analytics.company.com lautet, wäre analytics.company.com der Hostname.

  5. Speichern Sie Ihre Änderungen in manifest.json.

  6. Komprimieren Sie die Dateien im Ordner tableau-app-for-teams-server, um eine ZIP-Datei zu erstellen, die Ihre Änderungen enthält.

2. Hochladen des App-Manifests

Ob Sie Microsoft Teams-Apps installieren können, hängt von den App-Richtlinien Ihrer Organisation ab. Zum Installieren von Apps kann ein Microsoft 365-Administratorkonto erforderlich sein.

  1. Öffnen Sie das Microsoft Teams Admin Center(Link wird in neuem Fenster geöffnet).

  2. Wählen Sie im Navigationsbereich Teams-Apps > Apps verwalten aus.

  3. Wählen Sie Aktionen > Neue App hochladen aus.

  4. Laden Sie die Datei tableau-server-app-for-teams.zip hoch, die Sie geändert haben. Sie erhalten eine Bestätigungsnachricht mit einem Link, über den Sie die App verwalten können.

3. Installieren und Anheften der App für Ihre Benutzer

Sie können die App installieren, um sie für alle oder nur für einen Teil Ihrer Benutzer verfügbar zu machen. Sie können die App auch anheften, sodass sie Ihren Benutzern in der App-Leiste angezeigt wird.

  1. Öffnen Sie das Microsoft Teams Admin Center(Link wird in neuem Fenster geöffnet).

  2. Wählen Sie im Navigationsbereich Teams-Apps > Setup-Richtlinien aus.

  3. Wählen Sie unter Installierte Apps den Punkt Apps hinzufügen aus, und fügen Sie dann die Tableau-App hinzu.

  4. Optional: Wählen Sie unter Angeheftete Apps den Punkt Apps hinzufügen aus, und fügen Sie dann die Tableau-App hinzu.

  5. Speichern Sie Ihre Änderungen.

Nachdem Sie die Tableau-App hinzugefügt haben, kann es bis zu 24 Stunden dauern, bis die App für Ihre Benutzer verfügbar ist.

Konfigurieren der Tableau-App

Nachdem Sie die Tableau-App installiert haben, werden Sie von Microsoft Teams aufgefordert, die App einzurichten. Sie konfigurieren Ihre Site-Informationen, um die App mit Ihrer Tableau-Site zu verbinden.

1. Erstellen einer verbundenen App

Die Tableau-App für Microsoft Teams verwendet eine verbundene App, um Benutzer mit SSO zu authentifizieren. Diese verbundene App erstellen Sie in Tableau Cloud oder Tableau Server.

  1. Erstellen Sie in Tableau Cloud oder Tableau Server eine verbundene App mit direkter Vertrauensstellung. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit direkter Vertrauensstellung für Tableau Cloud oder Konfigurieren von verbundenen Apps mit direkter Vertrauensstellung für Tableau Server(Link wird in neuem Fenster geöffnet).

    • Wenn Sie die Domänenzulassungsliste für die verbundene App auf nur spezifische Domänen einschränken, müssen Sie der Zulassungsliste die folgenden Domänen hinzufügen.
      • tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net
      • teams.microsoft.com
      • *.teams.microsoft.com
    • Wenn Ihre Benutzer von anderen Microsoft-Plattformen aus auf die App zugreifen werden, müssen Sie weitere Domänen aus der Liste der Microsoft 365-URLs(Link wird in neuem Fenster geöffnet) hinzufügen.

  2. Aktivieren Sie die verbundene App.

  3. Generieren Sie ein Geheimnis für die verbundene App.

  4. Kopieren Sie die Client-ID, die Geheimnis-ID und den Geheimniswert der verbundenen App. Speichern Sie diese Werte. Sie werden diese benötigen, wenn Sie Ihre Tableau-Site in Microsoft Teams konfigurieren.

2. Hinzufügen Ihrer Site-Konfiguration zur Tableau-App

Wenn Sie die Tableau-App öffnen und die App noch nicht konfiguriert haben, wird ein Bildschirm zum Einrichten der App angezeigt.

  1. Geben Sie als Beschriftungeinen Namen für die Site. Dieser Name wird Benutzern der Microsoft Teams-App angezeigt. Wenn Sie keine Beschriftung eingeben, zeigt die App den Site-Namen an. Dieses Feld ist optional.

  2. Geben Sie als Tableau-Site-Name den Site-Namen ohne Leerzeichen ein, wie er in der URL angezeigt wird. Beispiel: Würde die URL https://us-west-2b.online.tableau.com/#/site/mysitename/home lauten, müssten Sie mysitename eingeben. Wenn Sie die App mit Tableau Server verbinden und die Standard-Site verwenden möchten, lassen Sie dieses Feld leer.

  3. Geben Sie als Basis-URL den Teil der Site-URL ein, der mit tableau.com endet (z. B https://us-west-2b.online.tableau.com).

  4. Wählen Sie als Benutzerzuordnungsattribut das Microsoft Entra-Attribut aus, das zum Authentifizieren des Benutzers mit SSO verwendet wird.

  5. Fügen Sie bei ID der verbundenen App, Geheimnis-ID der verbundenen App und Geheimniswert der verbundenen App die Werte ein, die Sie beim Erstellen der verbundenen App kopiert haben.

  6. Wählen Sie Site-Konfiguration hinzufügen aus.

Die Tableau-App testet die Verbindung, bevor die Konfigurationsdetails gespeichert werden. Wenn die App keine Verbindung zu Tableau herstellen kann, wird die Site-Konfiguration nicht hinzugefügt. Dies könnte daran liegen, dass die verbundene App nicht authentifiziert werden kann, die verbundene App nicht aktiviert ist, die Site-Informationen falsch sind oder dass das von Ihnen verwendete Konto kein Tableau-Administratorkonto ist. Es könnte auch bedeuten, dass die App nicht in der Lage ist, Tableau Server zu erreichen, weil sie sich hinter einer Firewall befindet.

Hinzufügen oder Löschen von Site-Konfiguration

Nachdem Sie eine Site-Konfiguration hinzugefügt haben, können Sie weitere Sites hinzufügen oder vorhandene Site-Konfigurationen löschen.

  1. Wählen Sie in der Tableau-App für Microsoft Teams die Registerkarte Konfiguration aus.

  2. Wählen Sie unter „Konfiguration“ die Registerkarte Tableau-Site-Konfiguration aus. Nur Tableau-Administratoren können auf die Einstellungen auf dieser Registerkarte zugreifen.

  3. Um eine Site hinzuzufügen, wählen Sie Site-Details hinzufügenaus. Oder, um eine Site zu entfernen, klicken Sie auf das Löschsymbol für diese Site.

Zurück zum Anfang
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.