De Tableau-app instellen voor Microsoft Teams

Is van toepassing op: Tableau Cloud, Tableau Server

Met de Tableau-app voor Microsoft Teams kunnen uw gebruikers werken met Tableau-weergaven (visualisaties) en -statistieken zonder hun werk te verlaten. Als Tableau-beheerder installeert en configureert u de app om uw bestaande Tableau-site te verbinden met uw Microsoft Teams-implementatie. U kunt de app voor Tableau Cloud rechtstreeks vanuit Microsoft Apps Marketplace installeren. Als u de app voor Tableau Server wilt installeren, moet u de app downloaden en sideloaden.

Zie Toegang tot Tableau-inhoud in Microsoft Teams voor informatie over het gebruik van de Tableau-app voor Microsoft Teams. Dit artikel gaat over het instellen van de Tableau-app.

Zie ook

Vereisten

Om de Tableau-app voor Microsoft Teams in te stellen, hebt u de volgende apps en accounts nodig.

  • Tableau Cloud of Tableau Server versies 2023.1 of hoger
  • Een sitebeheerdersaccount voor Tableau Cloud, of een serverbeheerdersaccount voor Tableau Server
  • Een Microsoft 365 voor Enterprise-abonnement
  • Microsoft Teams
  • Een Microsoft 365-beheerdersaccount, als het beleid van uw organisatie een beheerdersaccount vereist om apps te installeren
  • Gebruikerslicenties voor zowel Tableau als Microsoft Teams die aan elkaar zijn gekoppeld op basis van een van de gebruikerstoewijzingskenmerken

Gebruikerstoewijzingskenmerken

Om eenmalige aanmelding met Tableau mogelijk te maken, koppelt u de gebruikersaccounts in Microsoft Teams aan de gebruikersaccounts in Tableau. U kunt deze toewijzing instellen met behulp van kenmerken uit de Microsoft Teams SDK of uit het Microsoft Entra-profiel van een gebruiker.

Kenmerken van de Microsoft Teams SDK

KenmerkBeschrijving
Preferred_Username(Link wordt in een nieuw venster geopend)Het e-mailadres van de Microsoft Teams-gebruiker. In sommige gevallen verschilt deze waarde van het e-mailadres dat is gedefinieerd in Microsoft Entra.
User Principal Name(Link wordt in een nieuw venster geopend)De primaire manier waarop gebruikers zich aanmelden bij Microsoft Entra.

Microsoft Entra-profielkenmerken

KenmerkBeschrijving
Primary Email(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.mail en vertegenwoordigt het e-mailadres van de gebruiker.
Mail Nickname(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.mailNickname en vertegenwoordigt een alias voor de gebruiker.
Employee ID(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.employeeId en vertegenwoordigt een werknemers-id die door de organisatie is toegewezen.
On-Premise Distinguished Name(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.onPremiseDistinguishedName en vertegenwoordigt de onderscheidende naam (DN) die is gesynchroniseerd vanuit een on-premises Active Directory.
On-Premise User Principal Name(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.onPremiseUserPrincipalName en vertegenwoordigt de userPrincipalName die is gesynchroniseerd vanuit een on-premises Active Directory.
On-premise SAM Account Name(Link wordt in een nieuw venster geopend)Komt overeen met het kenmerk user.onPremiseSamAccountName en vertegenwoordigt de samAccountName die is gesynchroniseerd vanuit een on-premises Active Directory.
Extension Attribute X(Link wordt in een nieuw venster geopend)Met Microsoft Entra kunt u maximaal 15 extra kenmerken toevoegen aan het Entra-profiel van een gebruiker. Als de Tableau-gebruikersnaam niet bestaat in Microsoft Entra, gebruikt u een uitbreidingskenmerk om de Tableau-gebruikersnaam voor elke Entra-gebruiker op te slaan.

Aanvullende vereisten voor Tableau Server

De Tableau-app gebruikt API-aanroepen om te communiceren met Tableau Server en om interactieve inhoud in te sluiten. Deze aanroepen moeten Tableau Server kunnen bereiken.

  • Als Tableau Server zich achter een firewall bevindt, moet u inkomende HTTP-aanvragen met de IP-bereiken 4.152.0.0/15 en 20.2.0.0/16 toestaan.
  • Zorg ervoor dat gebruikers op dezelfde manier toegang hebben tot Tableau Server als tot Microsoft Teams.
    • Als gebruikers een VPN nodig hebben om toegang te krijgen tot Microsoft Teams, moet Tableau Server via dezelfde VPN toegankelijk zijn.
    • Als gebruikers via het openbare internet toegang hebben tot Microsoft Teams, dan moet Tableau Server ook via het openbare internet toegankelijk zijn.
    • Als gebruikers via mobiele apps toegang hebben tot Microsoft Teams, moet Tableau Server ook toegankelijk zijn vanaf mobiele apparaten.

De Tableau-app voor Tableau Server installeren

Om de Tableau-app voor Tableau Server te installeren, bewerkt u het app-manifest om de hostnaam aan te passen. Vervolgens uploadt u het app-manifest naar Microsoft Teams.

Zie de Handleiding voor de installatie van Tableau Cloud voor het installeren van de Tableau-app voor Tableau Cloud.

1. Download en bewerk het app-manifest

  1. Ga naar GitHub en download het app-manifest.

  2. Extraheer de bestanden uit het manifestbestand tableau-server-app-for-teams.zip.

  3. Open het bestand manifest.json in een teksteditor.

  4. Zoek in manifest.json naar *.online.tableau.com en vervang dat domein door de hostnaam van uw Tableau Server-omgeving. Als uw Tableau Server-URL https://analytics.company.com is, dan is de hostnaam analytics.company.com.

  5. Sla uw wijzigingen op naar manifest.json.

  6. Comprimeer de bestanden in de map tableau-app-for-teams-server om een zip-bestand te maken waarin uw wijzigingen zijn opgenomen.

2. Upload het app-manifest

Het app-beleid van uw organisatie bepaalt of u Microsoft Teams-apps kunt installeren. Voor het installeren van apps is mogelijk een Microsoft 365-beheerdersaccount vereist.

  1. Open het Microsoft Teams-beheercentrum(Link wordt in een nieuw venster geopend).

  2. Ga naar het navigatiedeelvenster en selecteer Teams-apps > Apps beheren.

  3. Selecteer Acties > Nieuwe app uploaden.

  4. Upload het bestand tableau-server-app-for-teams.zip dat u hebt bewerkt. U ontvangt een bevestigingsbericht met een link om de app te beheren.

3. Installeer en pin de app vast voor uw gebruikers

U kunt de app installeren om deze beschikbaar te maken voor al uw gebruikers of een deel daarvan. U kunt de app ook vastzetten, zodat deze in de app-balk wordt weergegeven voor uw gebruikers.

  1. Open het Microsoft Teams-beheercentrum(Link wordt in een nieuw venster geopend).

  2. Ga naar het navigatiedeelvenster en selecteer Teams-apps > Beleidsinstellingen.

  3. Onder Geïnstalleerde apps selecteert u Apps toevoegen. Voeg vervolgens de Tableau-app toe.

  4. Desgewenst (optioneel) kunt u onder Vastgezette apps de optie Apps toevoegen selecteren en vervolgens de Tableau-app toevoegen.

  5. Sla uw wijzigingen op.

Nadat u de Tableau-app hebt toegevoegd, kan het tot 24 uur duren voordat de app beschikbaar is voor uw gebruikers.

De Tableau-app configureren

Nadat u de Tableau-app hebt geïnstalleerd, vraagt Microsoft Teams u om de app in te stellen. U moet uw sitedata configureren om de app te verbinden met uw Tableau-site.

1. Een verbonden app maken

De Tableau-app voor Microsoft Teams gebruikt een verbonden app om gebruikers te verifiëren met eenmalige aanmelding. U maakt deze verbonden app in Tableau Cloud of Tableau Server.

  1. Maak een app in Tableau Cloud of Tableau Server die met een directe vertrouwensrelatie is verbonden. Zie Verbonden apps configureren met een directe vertrouwensrelatie voor Tableau Cloud of Verbonden apps configureren met een directe vertrouwensrelatie voor Tableau Server(Link wordt in een nieuw venster geopend) voor meer informatie.

    • Als u de toelatingslijst met domeinen voor de verbonden app beperkt tot alleen opgegeven domeinen, voegt u de volgende domeinen toe aan de toelatingslijst.
      • tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net
      • teams.microsoft.com
      • *.teams.microsoft.com
    • Als uw gebruikers de app vanaf andere Microsoft-platforms willen openen, voegt u extra domeinen toe uit de lijst met Microsoft 365-URL's(Link wordt in een nieuw venster geopend).

  2. Schakel de verbonden app in.

  3. Genereer een geheim voor een verbonden app.

  4. Kopieer de client-ID, geheim-ID en geheime waarde van de verbonden app. Bewaar deze waarden. U hebt ze nodig wanneer u uw Tableau-site in Microsoft Teams configureert.

2. Uw siteconfiguratie toevoegen aan de Tableau-app

Wanneer u de Tableau-app opent en de app nog niet hebt geconfigureerd, ziet u een configuratiescherm.

  1. Voer bij Label een naam in voor de site. Deze naam wordt weergegeven aan gebruikers van de Microsoft Teams-app. Als u geen label invoert, geeft de app de sitenaam weer. Dit veld is optioneel.

  2. Bij Tableau-sitenaam voert u de sitenaam in zoals deze in de URL voor uw site wordt weergegeven. Voor de URL https://us-west-2b.online.tableau.com/#/site/mysitename/home bijvoorbeeld voert u het volgende in: mysitename. Als u de app verbindt met Tableau Server en de standaardsite wilt gebruiken, laat u dit veld leeg.

  3. Voor de Basis-URL voert u het gedeelte van de site-URL in dat eindigt op tableau.com, bijvoorbeeld, https://us-west-2b.online.tableau.com.

  4. Bij Gebruikerstoewijzingskenmerk selecteert u het Microsoft Entra-kenmerk dat wordt gebruikt om de gebruiker te verifiëren met eenmalige aanmelding.

  5. Bij Verbonden-app-ID, Geheim-ID van verbonden app en Geheime waarde van de verbonden app, plakt u de waarden die u hebt gekopieerd toen u de verbonden app maakte.

  6. Selecteer Siteconfiguratie toevoegen.

De Tableau-app test de verbinding voordat de configuratiedata worden opgeslagen. De siteconfiguratie wordt niet toegevoegd als de app geen verbinding kan maken met Tableau. Deze fout kan worden veroorzaakt doordat de verbonden app niet kan verifiëren of niet is ingeschakeld, doordat de sitedata onjuist zijn of omdat het account dat u gebruikt geen Tableau-beheerdersaccount is. Het kan ook betekenen dat de app geen verbinding kan maken met Tableau Server omdat deze zich achter een firewall bevindt.

Sitesconfiguraties toevoegen of verwijderen

Nadat u een siteconfiguratie hebt toegevoegd, kunt u extra sites toevoegen of een bestaande siteconfiguratie verwijderen.

  1. Selecteer in de Tableau-app voor Microsoft Teams het tabblad Configuratie.

  2. Selecteer onder Configuratie het tabblad Tableau-siteconfiguratie. Alleen Tableau-beheerders hebben toegang tot de instellingen op dit tabblad.

  3. Als u een site wilt toevoegen, selecteert u Sitedetails toevoegen. Als u een site wilt verwijderen, selecteert u het verwijderpictogram voor de site.

Terug naar boven
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.