Einrichten der Tableau-App für Microsoft 365
Mit der Tableau-App für Microsoft 365 können Ihre Benutzer ihre Daten ansehen und verstehen, ohne ihren Workflow zu verlassen. Mit der Teams-App können Ihre Benutzer mit Tableau-Ansichten (Visualisierungen) und Metriken interagieren. Mit den Word- und PowerPoint-Add-Ins können Ihre Benutzer ihren Dokumenten und Folien Momentaufnahmen von Ansichten und Metriken hinzufügen und diese Momentaufnahmen aktualisieren, um sie auf dem neuesten Stand zu halten.
Als Tableau-Administrator installieren und konfigurieren Sie die App, um Ihre vorhandene Tableau-Site mit Ihrer Microsoft 365-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 365 finden Sie unter Zugriff auf Tableau-Inhalte in Microsoft 365. In diesem Artikel geht es um das Einrichten der App.
Siehe auch
- Häufig gestellte Fragen zur Tableau-App auf GitHub(Link wird in neuem Fenster geöffnet)
- Versionshinweise auf GitHub(Link wird in neuem Fenster geöffnet)
- Tutorial zu den ersten Schritten auf Youtube(Link wird in neuem Fenster geöffnet)
Voraussetzungen
Zum Einrichten der Tableau-App für Microsoft 365 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, Word und PowerPoint
- Ein Microsoft 365-Administratorkonto
- Benutzerlizenzen für Tableau und Microsoft 365, die basierend auf einem der Benutzerzuordnungsattribute einander zugeordnet werden
Benutzerzuordnungsattribute
Um SSO mit Tableau zu ermöglichen, ordnen Sie die Benutzerkonten in Microsoft 365 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
| Attribut | Beschreibung |
|---|---|
| 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
| Attribut | Beschreibung |
|---|---|
| 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 365.
- Wenn Benutzer für den Zugriff auf Microsoft 365 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 365 zugreifen können, muss Tableau Server über das öffentliche Internet zugänglich sein.
- Wenn Benutzer über mobile Apps auf Microsoft 365 zugreifen können, muss Tableau Server von mobilen Geräten aus zugänglich sein.
Installieren der App für Tableau Server
Um die App für Tableau Server zu installieren, bearbeiten Sie zunächst das App-Manifest, um den Hostnamen anzupassen. Anschließend können Sie die Microsoft Teams-App, die Word- und PowerPoint-Add-Ins oder beides installieren. Informationen zur Installation der App für Tableau Cloud finden Sie im Tableau Cloud-Einrichtungshandbuch.
Herunterladen und Bearbeiten des App-Manifests
- Laden Sie das App-Manifest von GitHub herunter.
Extrahieren Sie die Dateien aus der Manifestdatei
tableau-server-app-for-teams.zip.Öffnen Sie die Datei
manifest.jsonin einem Texteditor.Suchen Sie in
manifest.jsonnach*.online.tableau.com, und ersetzen Sie diese Domäne mit dem Hostnamen Ihrer Tableau Server-Umgebung. Wenn Ihre Tableau Server-URLhttps://analytics.company.comlautet, wäreanalytics.company.comder Hostname.Speichern Sie Ihre Änderungen in
manifest.json.Komprimieren Sie die Dateien im Ordner
tableau-app-for-teams-server, um eine ZIP-Datei zu erstellen, die Ihre Änderungen enthält.
Bereitstellen der Teams-App
Hochladen des App-Manifests in Microsoft Teams
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.
Öffnen Sie das Microsoft Teams Admin Center(Link wird in neuem Fenster geöffnet).
Wählen Sie im Navigationsbereich Teams-Apps > Apps verwalten aus.
Wählen Sie Aktionen > Neue App hochladen aus.
Laden Sie die Datei
tableau-server-app-for-teams.ziphoch, die Sie geändert haben. Sie erhalten eine Bestätigungsnachricht mit einem Link, über den Sie die App verwalten können.
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.
Öffnen Sie das Microsoft Teams Admin Center(Link wird in neuem Fenster geöffnet).
Wählen Sie im Navigationsbereich Teams-Apps > Setup-Richtlinien aus.
Wählen Sie unter Installierte Apps den Punkt Apps hinzufügen aus, und fügen Sie dann die Tableau-App hinzu.
Optional: Wählen Sie unter Angeheftete Apps den Punkt Apps hinzufügen aus, und fügen Sie dann die Tableau-App hinzu.
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.
Installieren der Add-Ins für Word und PowerPoint
Beim Installieren der App für Microsoft Teams werden die Add-Ins für Word und PowerPoint nicht automatisch installiert. Sie installieren die Add-Ins separat im Microsoft 365 Admin Center.
Öffnen Sie das Microsoft 365 Admin Center(Link wird in neuem Fenster geöffnet).
Wählen Sie im Navigationsbereich Agenten > Alle Agenten aus.
Wählen Sie Benutzerdefinierten Agent hochladen aus.
Laden Sie die Datei
tableau-server-app-for-teams.ziphoch, die Sie geändert haben.Wählen Sie aus, ob die App für alle oder nur für bestimmte Benutzer veröffentlicht und ob die App vorinstalliert werden soll.
Akzeptieren Sie die Berechtigungen.
Überprüfen und beenden Sie die Bereitstellung.
Nachdem Sie die Bereitstellung abgeschlossen haben, kann es bis zu 72 Stunden dauern, bis die Add-Ins für Ihre Benutzer verfügbar sind.
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 365 verwendet eine verbundene App, um Benutzer mit SSO zu authentifizieren. Diese verbundene App erstellen Sie in Tableau Cloud oder Tableau Server.
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.netteams.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.
- 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.
Aktivieren Sie die verbundene App.
Generieren Sie ein Geheimnis für die verbundene App.
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 365 konfigurieren.
2. Hinzufügen Ihrer Site-Konfiguration zur Tableau-App
Wenn Sie die Tableau-App in Microsoft Teams öffnen und sie noch nicht konfiguriert haben, wird ein Bildschirm zum Einrichten der App angezeigt. Um auf Site-Konfigurationsoptionen in Word und PowerPoint zuzugreifen, wählen Sie unten im Add-In-Bereich die Schaltfläche „Einstellungen“ aus.
Geben Sie als Beschriftungeinen Namen für die Site. Dieser Name wird Benutzern der Microsoft 365-App angezeigt. Wenn Sie keine Beschriftung eingeben, zeigt die App den Site-Namen an. Dieses Feld ist optional.
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/homelauten, müssten Siemysitenameeingeben. Wenn Sie die App mit Tableau Server verbinden und die Standard-Site verwenden möchten, lassen Sie dieses Feld leer.Geben Sie als Basis-URL den Teil der Site-URL ein, der mit
tableau.comendet (z. Bhttps://us-west-2b.online.tableau.com).Wählen Sie als Benutzerzuordnungsattribut das Microsoft Entra-Attribut aus, das zum Authentifizieren des Benutzers mit SSO verwendet wird.
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.
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.
Wählen Sie in der Tableau-App für Microsoft Teams die Registerkarte Konfiguration aus. Alternativ können Sie im Add-In-Bereich in Word oder PowerPoint die Schaltfläche Einstellungen auswählen.
Wählen Sie unter „Konfiguration“ die Registerkarte Tableau-Site-Konfiguration aus. Nur Tableau-Administratoren können auf die Einstellungen auf dieser Registerkarte zugreifen.
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.
