Configurare l’app Tableau per Microsoft 365

Applicabile a: Tableau Cloud, Tableau Server

L’app Tableau per Microsoft 365 consente agli utenti di osservare e comprendere i dati senza uscire dal flusso di lavoro. Con l’app Teams, gli utenti possono interagire con le viste (visualizzazioni) e le metriche di Tableau. Con gli add-on Word e PowerPoint, gli utenti possono aggiungere snapshot di viste e metriche ai propri documenti e diapositive e aggiornare tali snapshot per includere i dati più recenti.

In qualità di amministratore di Tableau, devi installare e configurare l’app per connettere il sito Tableau esistente alla tua distribuzione di Microsoft 365. 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 365, consulta Accedere ai contenuti di Tableau in Microsoft 365. Questo articolo illustra la configurazione dell’app.

Vedi anche

Prerequisiti

Per configurare l’app Tableau per Microsoft 365, 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, Word e PowerPoint
  • Un account amministratore di Microsoft 365
  • Licenze utente sia per Tableau che per Microsoft 365 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 365 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 365.
    • Se gli utenti devono utilizzare una VPN per accedere a Microsoft 365, Tableau Server deve essere accessibile dalla stessa VPN.
    • Se gli utenti possono accedere a Microsoft 365 dalla rete Internet pubblica, Tableau Server deve essere accessibile dalla rete Internet pubblica.
    • Se gli utenti possono accedere a Microsoft 365 tramite app per dispositivi mobili, Tableau Server deve essere accessibile dai dispositivi mobili.

Installare l’app per Tableau Server

Per installare l’app per Tableau Server, devi innanzitutto modificare il manifest dell’app per personalizzare il nome host. Quindi puoi scegliere di installare l’app Microsoft Teams, gli add-on Word e PowerPoint o entrambi. Per installare l’app per Tableau Cloud, consulta la Guida alla configurazione di Tableau Cloud.

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.

Distribuire l’app Teams

Caricare il manifest dell’app in Microsoft Teams

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.

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.

Installare gli add-on Word e PowerPoint

L’installazione dell’app per Microsoft Teams non comporta l’installazione degli add-on Word e PowerPoint. Gli add-on vengono installati separatamente nell’interfaccia di amministrazione di Microsoft 365.

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

  2. Dal riquadro di navigazione, seleziona Agents (Agenti) > All agents (Tutti gli agenti).

  3. Seleziona Upload custom agent (Carica agente personalizzato).

  4. Carica il file tableau-server-app-for-teams.zip che hai modificato.

  5. Scegli se pubblicare l’app per tutti gli utenti o per utenti specifici e se preinstallare l’app.

  6. Accetta le autorizzazioni.

  7. Esamina e completa la distribuzione.

Dopo aver terminato la distribuzione, potrebbero essere necessarie fino a 72 ore prima che gli add-on siano disponibili 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 365 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 per configurare il sito Tableau in Microsoft 365.

2. Aggiungere la configurazione del sito all’app Tableau

Quando apri l’app Tableau in Microsoft Teams, se non l’hai ancora configurata, viene visualizzata una schermata di configurazione. Per accedere alle opzioni di configurazione del sito in Word e PowerPoint, seleziona il pulsante Impostazioni nella parte inferiore del riquadro dell’add-on.

  1. Per Etichetta, assegna un nome al sito. Questo nome viene visualizzato dagli utenti dell’app per Microsoft 365. 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. In alternativa, nel riquadro dell’add-on Word o PowerPoint, seleziona il pulsante Settings (Impostazioni).

  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!