Configurar o aplicativo Tableau para Microsoft Teams

Aplica-se a: Tableau Cloud, Tableau Server

O aplicativo Tableau para Microsoft Teams permite que seus usuários interajam com as exibições (visualizações) e métricas do Tableau sem interromper seu fluxo de trabalho. Como administrador do Tableau, você instala e configura o aplicativo para conectar seu site do Tableau existente à sua implantação do Microsoft Teams. 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 Teams, consulte Acessar o conteúdo do Tableau no Microsoft Teams. Este artigo trata da configuração do aplicativo Tableau.

Consulte também

Pré-requisitos

Para configurar o aplicativo Tableau para Microsoft Teams, 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
  • Uma conta de administrador do Microsoft 365, se as políticas da sua organização exigirem uma conta de administrador para instalar aplicativos
  • Licenças de usuário para o Tableau e o Microsoft Teams 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 Teams 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 Teams.
    • Se os usuários precisarem estar em uma VPN para acessar o Microsoft Teams, o Tableau Server deverá estar acessível da mesma VPN.
    • Se os usuários conseguirem acessar o Microsoft Teams da Internet pública, o Tableau Server deverá estar acessível da Internet pública.
    • Se os usuários conseguirem acessar o Microsoft Teams por meio de aplicativos móveis, o Tableau Server deverá estar acessível de dispositivos móveis.

Instalar o aplicativo Tableau para o Tableau Server

Para instalar o aplicativo Tableau para o Tableau Server, edite o manifesto do aplicativo para personalizar o nome do host e, em seguida, carregue o manifesto do aplicativo no Microsoft Teams.

Para instalar o aplicativo Tableau para Tableau Cloud, consulte o guia de configuração do Tableau Cloud.

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

2. Carregar o manifesto do aplicativo

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.

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

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 Teams 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ê precisará deles ao configurar seu site do Tableau no Microsoft Teams.

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

Ao abrir o aplicativo Tableau, se você ainda não tiver configurado o aplicativo, será exibida uma tela de configuração.

  1. No Rótulo, nomeie o site. Esse nome aparece para os usuários do aplicativo Microsoft Teams. 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.

  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.

Voltar para o topo
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!