Configurare l’app Tableau per Microsoft Teams

Applicabile a: Tableau Cloud, Tableau Server

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

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

AttributoDescrizione
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

AttributoDescrizione
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.

Prerequisiti aggiuntivi per Tableau Server

L’app Tableau utilizza le chiamate API per comunicare con Tableau Server e incorporare contenuto interattivo. Queste chiamate devono essere in grado di raggiungere Tableau Server.

  • Se Tableau Server è protetto da un firewall, consenti le richieste HTTP in ingresso provenienti dagli intervalli IP 4.152.0.0/15 e 20.2.0.0/16.
  • Assicurati che gli utenti possano accedere a Tableau Server nello stesso modo in cui accedono a Microsoft Teams.
    • Se gli utenti devono utilizzare una VPN per accedere a Microsoft Teams, Tableau Server deve essere accessibile dalla stessa VPN.
    • Se gli utenti possono accedere a Microsoft Teams dalla rete Internet pubblica, Tableau Server deve essere accessibile dalla rete Internet pubblica.
    • Se gli utenti possono accedere a Microsoft Teams tramite app per dispositivi mobili, Tableau Server deve essere accessibile dai dispositivi mobili.

Installare l’app Tableau per Tableau Server

Per installare l’app Tableau per Tableau Server, modifica il manifesto dell’app per personalizzare il nome host, quindi carica il manifesto dell’app in Microsoft Teams.

Per installare l’app Tableau per Tableau Cloud, consulta la Guida alla configurazione di Tableau Cloud.

1. Scaricare e modificare il manifest dell’app

  1. Da GitHub scarica il manifest dell’app.

  2. Estrai i file dal file manifest tableau-server-app-for-teams.zip.

  3. Apri il file manifest.json in un’editor di testo.

  4. Cerca *.online.tableau.com in manifest.json e sostituisci il dominio con il nome host del tuo ambiente Tableau Server. Se l’URL di Tableau Server è https://analytics.company.com, il nome host sarà analytics.company.com.

  5. Salva le modifiche apportate a manifest.json.

  6. Comprimi i file nella cartella tableau-app-for-teams-server per creare un file zip che includa le modifiche.

2. Caricare il manifest dell’app

I criteri delle app dell’organizzazione determinano se sei autorizzato a installare le app di Microsoft Teams. Per installare le app, potrebbe essere necessario un account amministratore di Microsoft 365.

  1. Apri l’interfaccia di amministrazione di Microsoft Teams(Il collegamento viene aperto in una nuova finestra).

  2. Dal pannello di navigazione seleziona Teams apps > Manage apps.

  3. Seleziona Actions > Upload new app.

  4. Carica il file tableau-server-app-for-teams.zip che hai modificato. Riceverai un messaggio di conferma con un collegamento per gestire l’app.

3. Installare e aggiungere l’app per gli utenti

Puoi installare l’app per renderla disponibile a tutti gli utenti o a un sottoinsieme di essi. Puoi anche aggiungere l’app in modo che venga visualizzata nella barra dell’app per i tuoi utenti.

  1. Apri l’interfaccia di amministrazione di Microsoft Teams(Il collegamento viene aperto in una nuova finestra).

  2. Dal pannello di navigazione seleziona Teams apps > Setup policies.

  3. In Installed apps seleziona Add apps, quindi aggiungi l’app Tableau.

  4. Facoltativamente, in Pinned apps, seleziona Add apps, quindi aggiungi l’app Tableau.

  5. Salva le modifiche.

Dopo aver aggiunto l’app Tableau, potrebbero essere necessarie fino a 24 ore prima che l’app sia disponibile per gli utenti.

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.

  1. 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.net
      • teams.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).

  2. Abilita l’app connessa.

  3. Genera un segreto dell’app connessa.

  4. 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.

  1. 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.

  2. 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, immetterai mysitename. Se connetti l’app a Tableau Server e desideri utilizzare il sito predefinito, lascia vuoto questo campo.

  3. Per URL di base, immetti la parte dell’URL del sito che termina con tableau.com, ad esempio https://us-west-2b.online.tableau.com.

  4. Per Attributo di mapping degli utenti, seleziona l’attributo di Microsoft Entra utilizzato per autenticare l’utente con l’accesso Single Sign-On.

  5. 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.

  6. 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.

  1. Nell’app Tableau per Microsoft Teams seleziona la scheda Configurazione.

  2. In Configurazione seleziona la scheda Configurazione del sito Tableau. Solo gli amministratori di Tableau possono accedere alle impostazioni di questa scheda.

  3. Per aggiungere un sito, seleziona Aggiungi dettagli sito. In alternativa, per rimuovere un sito, seleziona l’icona di eliminazione per tale sito.

Torna in alto
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!