Configurare l’app Tableau per Microsoft Teams
L’app Tableau per Microsoft Teams consente agli utenti di interagire con le viste (visualizzazioni) e le metriche di Tableau senza uscire dal flusso di lavoro. In qualità di amministratore di Tableau, devi installare e configurare l’app per connettere il sito Tableau esistente alla tua distribuzione di Microsoft Teams. Puoi installare l’app per Tableau Cloud direttamente dal marketplace delle app Microsoft. Per installare l’app per Tableau Server, scarica l’app ed eseguine il sideloading.
Per informazioni sull’utilizzo dell’app Tableau per Microsoft Teams, consulta Accedere ai contenuti di Tableau in Microsoft Teams. Questo articolo illustra la configurazione dell’app Tableau.
Vedi anche
- Domande frequenti sull’app Tableau su GitHub(Il collegamento viene aperto in una nuova finestra)
- Note sulla versione su GitHub(Il collegamento viene aperto in una nuova finestra)
- Esercitazione introduttiva su Youtube(Il collegamento viene aperto in una nuova finestra)
Prerequisiti
Per configurare l’app Tableau per Microsoft Teams, sono necessari le app e gli account seguenti.
- Tableau Cloud oppure Tableau Server 2023.1 o versione successiva
- Un account amministratore del sito per Tableau Cloud o un account amministratore del server per Tableau Server
- Un abbonamento a Microsoft 365 per le aziende
- Microsoft Teams
- Un account amministratore di Microsoft 365, se i criteri dell’organizzazione richiedono un account amministratore per installare le app
- Licenze utente sia per Tableau che per Microsoft Teams che siano mappate tra loro in base a uno degli attributi di mapping degli utenti
Attributi di mapping degli utenti
Per consentire l’accesso Single Sign-On con Tableau, devi mappare gli account utente di Microsoft Teams agli account utente di Tableau. Puoi configurare questo mapping utilizzando gli attributi di Microsoft Teams SDK o del profilo Microsoft Entra di un utente.
Attributi di Microsoft Teams SDK
| Attributo | Descrizione |
|---|---|
| Preferred_Username(Il collegamento viene aperto in una nuova finestra) | Indirizzo e-mail dell’utente di Microsoft Teams. In alcuni casi, questo valore è diverso dall’indirizzo e-mail definito in Microsoft Entra. |
| User Principal Name(Il collegamento viene aperto in una nuova finestra) | Modalità principale utilizzata dagli utenti per accedere a Microsoft Entra. |
Attributi del profilo di Microsoft Entra
| Attributo | Descrizione |
|---|---|
| Primary Email(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.mail e rappresenta l’indirizzo e-mail dell’utente. |
| Mail Nickname(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.mailNickname e rappresenta un alias per l’utente. |
| Employee ID(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.employeeId e rappresenta un identificatore del dipendente assegnato dall’organizzazione. |
| On-Premise Distinguished Name(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.onPremiseDistinguishedName e rappresenta il nome distinto (DN) sincronizzato da un ambiente Active Directory locale. |
| On-Premise User Principal Name(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.onPremiseUserPrincipalName e rappresenta l’attributo userPrincipalName sincronizzato da un’istanza di Active Directory locale. |
| On-premise SAM Account Name(Il collegamento viene aperto in una nuova finestra) | Corrisponde all’attributo user.onPremiseSamAccountName e rappresenta l’attributo samAccountName sincronizzato da un’istanza di Active Directory locale. |
| Extension Attribute X(Il collegamento viene aperto in una nuova finestra) | Microsoft Entra consente di aggiungere fino a 15 attributi aggiuntivi al profilo Entra di un utente. Se il nome utente Tableau non esiste in Microsoft Entra, utilizza un attributo di estensione per memorizzare il nome utente Tableau per ogni utente Entra. |
Installare l’app Tableau per Tableau Cloud
Installa l’app Tableau per Tableau Cloud direttamente dal marketplace delle app Microsoft. I criteri dell’organizzazione determinano se gli utenti possono installare l’app da soli o se un amministratore deve installarla per loro.
- Per informazioni su come installare un’app come amministratore, consulta Preinstall apps for your users(Il collegamento viene aperto in una nuova finestra) nella documentazione di Microsoft Teams.
- Per informazioni su come installare un’app come utente, consulta Add an app to Microsoft teams(Il collegamento viene aperto in una nuova finestra) nella documentazione di Microsoft Teams.
Per installare l’app Tableau per Tableau Server, consulta la Guida alla configurazione di Tableau Server.
Configurare l’app Tableau
Dopo aver installato l’app Tableau, Microsoft Teams ti chiede di configurare l’app. Puoi configurare le informazioni del sito per connettere l’app al tuo sito Tableau.
1. Creare un’app connessa
L’app Tableau per Microsoft Teams utilizza un’app connessa per autenticare gli utenti con l’accesso Single Sign-On. Puoi creare questa app connessa in Tableau Cloud o Tableau Server.
In Tableau Cloud o Tableau Server crea un’app connessa con trust diretto. Per maggiori informazioni, consulta Configurare le app connesse con trust diretto per Tableau Cloud o Configurare le app connesse con trust diretto per Tableau Server(Il collegamento viene aperto in una nuova finestra).
- Se limiti l’elenco consentiti dei domini per l’app connessa solo ai domini specificati, aggiungi i seguenti domini all’elenco consentiti.
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- Se gli utenti accederanno all’app da altre piattaforme Microsoft, aggiungi altri domini dall’elenco di URL di Microsoft 365(Il collegamento viene aperto in una nuova finestra).
- Se limiti l’elenco consentiti dei domini per l’app connessa solo ai domini specificati, aggiungi i seguenti domini all’elenco consentiti.
Abilita l’app connessa.
Genera un segreto dell’app connessa.
Copia l’ID client, l’ID segreto e il valore del segreto dell’app connessa. Salva questi valori. Saranno necessari durante la configurazione del sito Tableau in Microsoft Teams.
2. Aggiungere la configurazione del sito all’app Tableau
Quando apri l’app Tableau e non l’hai ancora configurata, viene visualizzata una schermata di configurazione.
Per Etichetta, assegna un nome al sito. Questo nome viene visualizzato dagli utenti dell’app per Microsoft Teams. Se non immetti un’etichetta, l’app visualizza il nome del sito. Questo campo è facoltativo.
Per Nome del sito Tableau immetti il nome così come appare nell’URL del sito. Ad esempio, per l’URL
https://us-west-2b.online.tableau.com/#/site/mysitename/home, immetteraimysitename. Se connetti l’app a Tableau Server e desideri utilizzare il sito predefinito, lascia vuoto questo campo.Per URL di base, immetti la parte dell’URL del sito che termina con
tableau.com, ad esempiohttps://us-west-2b.online.tableau.com.Per Attributo di mapping degli utenti, seleziona l’attributo di Microsoft Entra utilizzato per autenticare l’utente con l’accesso Single Sign-On.
Per ID app connessa, ID segreto app connessa e Valore segreto app connessa, incolla i valori che hai copiato quando hai creato l’app connessa.
Seleziona Aggiungi configurazione sito.
L’app Tableau testa la connessione prima di salvare i dettagli della configurazione. La configurazione del sito non verrà aggiunta se l’app non riesce a connettersi a Tableau. Questo errore potrebbe dipendere dal fatto che l’app connessa non riesce a eseguire l’autenticazione, l’app connessa non è abilitata, le informazioni sul sito non sono corrette o l’account utilizzato non è un account amministratore di Tableau. Potrebbe anche significare che l’app non riesce a raggiungere Tableau Server perché è protetto da un firewall.
Aggiungere o eliminare configurazioni di siti
Dopo aver aggiunto una configurazione di sito, puoi aggiungere altri siti o eliminarne una esistente.
Nell’app Tableau per Microsoft Teams seleziona la scheda Configurazione.
In Configurazione seleziona la scheda Configurazione del sito Tableau. Solo gli amministratori di Tableau possono accedere alle impostazioni di questa scheda.
Per aggiungere un sito, seleziona Aggiungi dettagli sito. In alternativa, per rimuovere un sito, seleziona l’icona di eliminazione per tale sito.