Configurar o aplicativo Tableau para Microsoft 365

O aplicativo Tableau para Microsoft 365 permite que seus usuários visualizem e compreendam seus dados sem interromper o fluxo de trabalho. Com o aplicativo Teams, seus usuários podem interagir com exibições (visualizações) e métricas do Tableau. Com os suplementos do Word e do PowerPoint, os usuários podem adicionar instantâneos de imagens de exibições e métricas a seus documentos e slides e atualizar esses instantâneos.

Como administrador do Tableau, você instala e configura o aplicativo para conectar seu site do Tableau existente à sua implantação do Microsoft 365. Você pode instalar o aplicativo para o Tableau Cloud diretamente do marketplace de aplicativos da Microsoft. Para instalar o aplicativo para o Tableau Server, você deve baixá-lo e fazer o carregamento lateral.

Para obter informações sobre como usar o aplicativo Tableau para Microsoft 365, consulte Acessar o conteúdo do Tableau no Microsoft 365. Este artigo trata da configuração do aplicativo.

Consulte também

Pré-requisitos

Para configurar o aplicativo Tableau para Microsoft 365, você precisa dos aplicativos e das contas a seguir.

  • Tableau Cloud ou Tableau Server versão 2023.1 ou posterior
  • Uma conta de administrador de site para o Tableau Cloud ou uma conta de administrador de servidor para o Tableau Server
  • Uma assinatura do Microsoft 365 para empresas
  • Microsoft Teams, Word e PowerPoint
  • Uma conta de administrador do Microsoft 365
  • Licenças de usuário para o Tableau e o Microsoft 365 que são mapeadas entre si com base em um dos atributos de mapeamento de usuário

Atributos de mapeamento de usuário

Para permitir o logon único com o Tableau, mapeie as contas de usuário no Microsoft 365 para as contas de usuário no Tableau. Você pode configurar esse mapeamento usando atributos do SDK do Microsoft Teams ou do perfil do Microsoft Entra de um usuário.

Atributos do SDK do Microsoft Teams

AtributoDescrição
Preferred_Username(O link abre em nova janela)O endereço de e-mail do usuário do Microsoft Teams. Em alguns casos, esse valor difere do e-mail definido no Microsoft Entra.
User Principal Name(O link abre em nova janela)A principal forma como os usuários fazem logon no Microsoft Entra.

Atributos de perfil do Microsoft Entra

AtributoDescrição
Primary Email(O link abre em nova janela)Corresponde ao atributo user.mail e representa o endereço de e-mail do usuário.
Mail Nickname(O link abre em nova janela)Corresponde ao atributo user.mailNickname e representa um alias do usuário.
Employee ID(O link abre em nova janela)Corresponde ao atributo user.employeeId e representa um identificador de funcionário atribuído pela organização.
On-Premise Distinguished Name(O link abre em nova janela)Corresponde ao atributo user.onPremiseDistinguishedName e representa o nome diferenciado (DN) sincronizado de um Active Directory local.
On-Premise User Principal Name(O link abre em nova janela)Corresponde ao atributo user.onPremiseUserPrincipalName e representa o userPrincipalName sincronizado de um Active Directory local.
On-premise SAM Account Name(O link abre em nova janela)Corresponde ao atributo user.onPremiseSamAccountName e representa o samAccountName sincronizado de um Active Directory local.
Extension Attribute X(O link abre em nova janela)O Microsoft Entra permite adicionar até 15 atributos extras ao perfil do Entra de um usuário. Se o nome de usuário do Tableau não existir no Microsoft Entra, use um atributo de extensão para armazenar o nome de usuário do Tableau para cada usuário do Entra.

Pré-requisitos adicionais do Tableau Server

O aplicativo Tableau usa chamadas de API para se comunicar com o Tableau Server e incorporar conteúdo interativo. Essas chamadas devem acessar o Tableau Server.

  • Se o Tableau Server estiver protegido por um firewall, permita solicitações HTTP de entrada dos intervalos de IP 4.152.0.0/15 e 20.2.0.0/16.
  • Certifique-se de que os usuários possam acessar o Tableau Server da mesma forma que acessam o Microsoft 365.
    • Se os usuários precisarem de uma VPN para acessar o Microsoft 365, o Tableau Server deverá estar acessível na mesma VPN.
    • Se os usuários conseguirem acessar o Microsoft 365 na Internet pública, o Tableau Server deverá estar acessível na Internet pública.
    • Se os usuários conseguirem acessar o Microsoft 365 por meio de aplicativos móveis, o Tableau Server deverá estar acessível em dispositivos móveis.

Instalar o aplicativo para o Tableau Server

Para instalar o aplicativo para o Tableau Server, primeiro edite o manifesto do aplicativo para personalizar o nome do host. Em seguida, você pode optar por instalar o aplicativo Microsoft Teams, os suplementos do Word e do PowerPoint ou ambos. Para instalar o aplicativo para o Tableau Cloud, consulte o guia de configuração do Tableau Cloud.

Baixar e editar o manifesto do aplicativo

  1. No GitHub, baixe o manifesto do aplicativo.
  2. Extraia os arquivos do arquivo de manifesto tableau-server-app-for-teams.zip.

  3. Abra o arquivo manifest.json em um editor de texto.

  4. Procure manifest.json para *.online.tableau.com e substitua esse domínio pelo nome do host do seu ambiente do Tableau Server. Se a URL do seu Tableau Server for https://analytics.company.com, o nome do host será analytics.company.com.

  5. Salve as alterações em manifest.json.

  6. Compacte os arquivos na pasta tableau-app-for-teams-server para criar um arquivo zip que inclua suas alterações.

Implantar o aplicativo Teams

Carregar o manifesto do aplicativo para o Microsoft Teams

As políticas de aplicativos da sua organização determinam se você pode instalar os aplicativos do Microsoft Teams. Pode ser necessária uma conta de administrador do Microsoft 365 para instalar aplicativos.

  1. Abra o centro de administração d Microsoft Teams(O link abre em nova janela).

  2. No painel de navegação, selecione Aplicativos do Teams > Gerenciar aplicativos.

  3. Selecione Ações > Carregar novo aplicativo.

  4. Carregue o arquivo tableau-server-app-for-teams.zip que você editou. Você receberá uma mensagem de confirmação com um link para gerenciar o aplicativo.

Instalar e fixar o aplicativo para seus usuários

Você pode instalar o aplicativo para disponibilizá-lo a todos ou a um subconjunto de seus usuários. Também é possível fixar o aplicativo para que ele apareça na barra de aplicativos para seus usuários.

  1. Abra o centro de administração d Microsoft Teams(O link abre em nova janela).

  2. No painel de navegação, selecione Aplicativos do Teams > Políticas de configuração.

  3. Em Aplicativos instalados, selecione Adicionar aplicativos e adicione o aplicativo Tableau.

  4. Opcionalmente, em Aplicativos fixados, selecione Adicionar aplicativos e adicione o aplicativo Tableau.

  5. Salve as alterações.

Depois de adicionar o aplicativo Tableau, pode levar até 24 horas para que ele fique disponível para seus usuários.

Instalar os suplementos do Word e do PowerPoint

A instalação do aplicativo para o Microsoft Teams não instala os suplementos do Word e do PowerPoint. Instale os suplementos separadamente no centro de administração do Microsoft 365.

  1. Abra o centro de administração d Microsoft 365(O link abre em nova janela).

  2. No painel de navegação, selecione Agentes > Todos os agentes.

  3. Selecione Carregar agente personalizado.

  4. Carregue o arquivo tableau-server-app-for-teams.zip que você editou.

  5. Escolha se deseja publicar o aplicativo para todos os usuários ou usuários específicos e se deseja pré-instalar o aplicativo.

  6. Aceite as permissões.

  7. Revise e conclua a implantação.

Depois de você concluir a implantação, pode levar até 72 horas para que o suplemento fique disponível para seus usuários.

Configurar o aplicativo Tableau

Após instalar o aplicativo Tableau, o Microsoft Teams solicitará que você configure o aplicativo. Configure as informações do seu site para conectar o aplicativo ao seu site do Tableau.

1. Criar um aplicativo conectado

O aplicativo Tableau para Microsoft 365 usa um aplicativo conectado para autenticar usuários com logon único. Crie esse aplicativo conectado no Tableau Cloud ou Tableau Server.

  1. No Tableau Cloud ou Tableau Server, crie um aplicativo conectado com confiança direta. Para obter mais informações, consulte Configurar aplicativos conectados com confiança direta para Tableau Cloud ou Configurar aplicativos conectados com confiança direta para Tableau Server(O link abre em nova janela).

    • Se você limitar a lista de permissões de domínio para o aplicativo conectado apenas a domínios específicos, adicione os seguintes domínios à lista de permissões.
      • tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net
      • teams.microsoft.com
      • *.teams.microsoft.com
    • Se os seus usuários acessarem o aplicativo de outras plataformas da Microsoft, adicione domínios adicionais da lista de URLs do Microsoft 365(O link abre em nova janela).
  2. Habilite o aplicativo conectado.

  3. Gere um segredo de aplicativo conectado.

  4. Copie a ID do cliente do aplicativo conectado, a ID do segredo e o valor do segredo. Salve esses valores. Você precisa deles para configurar seu site do Tableau no Microsoft 365.

2. Adicionar a configuração do site ao aplicativo Tableau

Ao abrir o aplicativo Tableau no Microsoft Teams, se você ainda não tiver configurado o aplicativo, será exibida uma tela de configuração. Para acessar as opções de configuração do site no Word e no PowerPoint, selecione o botão Configurações na parte inferior do painel do suplemento.

  1. No Rótulo, nomeie o site. Esse nome aparece para os usuários do aplicativo Microsoft 365. Se você não inserir um rótulo, o aplicativo exibirá o nome do site. Este campo é opcional.

  2. No Nome do site do Tableau, insira o nome conforme aparece na URL do site. Por exemplo, para a URL https://us-west-2b.online.tableau.com/#/site/mysitename/home, você insere mysitename. Se você estiver conectando o aplicativo ao Tableau Server e quiser usar o site padrão, deixe este campo em branco.

  3. Na URL base, insira a parte da URL do site que termina com tableau.com, por exemplo, https://us-west-2b.online.tableau.com.

  4. No Atributos de mapeamento de usuário, selecione o atributo do Microsoft Entra usado para autenticar o usuário com logon único.

  5. Na ID de aplicativo conectado, ID de segredo de aplicativo conectado e Valor de segredo de aplicativo conectado, cole os valores que você copiou quando criou o aplicativo conectado.

  6. Selecione Adicionar configuração de site.

O aplicativo Tableau testa a conexão antes de salvar os detalhes da configuração. A configuração do site não será adicionada se o aplicativo não conseguir se conectar ao Tableau. Essa falha pode ocorrer porque o aplicativo conectado não consegue se autenticar, o aplicativo conectado não está habilitado, as informações do site estão incorretas ou porque a conta que você está usando não é uma conta de administrador do Tableau. Isso também pode significar que o aplicativo não consegue acessar o Tableau Server porque está atrás de um firewall.

Adicionar ou excluir configurações de site

Depois de adicionar uma configuração de site, você pode adicionar sites adicionais ou excluir uma configuração de site existente.

  1. No aplicativo Tableau para Microsoft Teams, selecione a guia Configuração. Ou, no painel do suplemento do Word ou PowerPoint, selecione o botão Configurações.

  2. Em Configuração, selecione a guia Configuração de site do Tableau. Somente administradores do Tableau podem acessar as configurações nesta guia.

  3. Para adicionar um site, selecione Adicionar detalhes do site. Para remover um site, selecione o ícone Excluir desse site.

Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!