Com o conector do Tableau®, você pode usar os comandos em uma cadeia para interagir com o Tableau. Por exemplo, com esse conector, você pode:
- Adicionar usuários a grupos ou sites do Tableau
- Criar dados e hiperextratos do Tableau
- Excluir ou atualizar permissões em massa no Tableau
- Criar e gerenciar projetos, grupos e sites do Tableau
- Gerenciar fontes de dados e exibições do Tableau
Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.
Pré-requisitos
Para habilitar a conexão, o conector usa a API REST do Tableau, protegida com autenticação básica de nome de usuário e senha. Para configurar o conector, você precisará de:
- Um usuário de integração designado configurado no Tableau para o conector
- As credenciais de autenticação do usuário de integração
- A URL da instância do Tableau à qual se conectar, como
https://[region].online.tableau.compara o Tableau Online - O site ao qual se conectar na instância do Tableau
-
A versão da API que a instância do Tableau usa, ou a versão do Tableau à qual se conectar
Dica: Para obter informações sobre como localizar sua versão do Tableau, consulte a base de conhecimento do Tableau.
Para usar o comando Build Hyper Extract ou Build TDE Extract do conector com um GroundRunner, instale a API de extração do Tableau no servidor e mova seus arquivos de biblioteca de vínculo dinâmico (DLL) para uma pasta usada pelo registro, como C:\Windows\System32. Para obter informações sobre como instalar a API de extração do Tableau, consulte a documentação da API de extração do Tableau.
Versões compatíveis
- 8.3
- 9.x
- 10.x
- 2018.x
- 2019.x
- 2020.1 e 2020.2
- Tableau Online
Observação: Com as atualizações trimestrais do Tableau, as versões mais recentes da API podem não aparecer como opções para o conector, mas ainda são compatíveis com a compatibilidade com versões anteriores.
Determinar o nome do URL do conteúdo do site
Cada instância do Tableau é implantada com um site padrão, mas sua empresa pode implantar sites adicionais. A propriedade Site content URL name do conector indica a qual site ele se conecta. Para determinar o valor de Site content URL name, verifique a URL do conteúdo do Tableau ao qual se conectar:
- O URL do site padrão segue um formato de
https://our.tableau.online.hostname/#/workbooks. Para se conectar ao site padrão, digitePadrãoem Nome do URL do conteúdo do site. - Os URLs de sites adicionais seguem um formato de
https://our.tableau.online.hostname/#site/[ID do site]/workbooks. Para se conectar a um site adicional, digite o valor na parte[ID do site]do URL em Nome do URL do conteúdo do site.
Observação: A propriedade Nome do URL do conteúdo do site diferencia maiúsculas de minúsculas.
Configurar o conector do Tableau
Observação: Para disponibilizar o conector para uso nas cadeias da sua organização, um administrador de segurança da organização deve primeiro ativá-lo em Configuração.
- No Construtor de cadeias, clique em Conexões e, em seguida, em Criar no canto superior direito.
- Em Conexão de conector, selecione Tableau e o CloudRunner padrão.
- Em Informações básicas, insira um nome e uma descrição únicos para ajudar a identificar a conexão.
-
Em Propriedades, insira os detalhes do conector:
Propriedade Detalhes Nome de usuário Insira o nome de usuário do usuário de integração do Tableau do conector. Senha Digite a senha da propriedade Nome de usuário. URL do Tableau Insira a URL de base da instância do Tableau à qual se conectar, como https://us-east-1.online.tableau.compara o Tableau Online.Nome do URL do conteúdo do site Insira a ID do site ao qual se conectar na instância do Tableau:
- Para se conectar ao site padrão do Tableau da sua organização, digite
Default. - Para se conectar a um site adicional implantado por sua organização, digite a ID que aparece após
/#site/no URL do conteúdo.
Observação: O nome do URL do conteúdo do site diferencia maiúsculas de minúsculas.
Versão Selecione a versão da API que a instância do Tableau deve usar, com base na versão do Tableau.
Observação: Se a sua versão não for uma opção, selecione a versão mais recente da API.
Tempo limite de leitura HTTP Período de tempo antes que o comando de leitura HTTP expire.
Esse valor deve ser um inteiro (1, 2, 3,...) maior que 0, e o padrão é 180. O valor máximo é 2.147.483.647, ou aproximadamente 68 anos.Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia AES (Advanced Encryption Standard) de 256 bits.
- Para se conectar ao site padrão do Tableau da sua organização, digite
- Selecione os ambientes a serem usados com a conexão e clique em Salvar.
- Para testar a conexão, crie e execute uma cadeia com o comando Get Sites do conector e verifique se ela retorna uma saída válida.
Solução de problemas
Se a conexão com o Tableau falhar:
- Verifique as credenciais de autenticação do usuário de integração.
- Verifique a URL base e a ID do site da instância do Tableau e o site ao qual se conectar.
- Verifique se a versão da API selecionada para o conector corresponde a versão da sua instância do Tableau.
Se um comando retornar um código de saída Success, mas não tiver saída, verifique a ID do site inserida para o conector Nome do URL do conteúdo do site:
- Para se conectar ao site padrão do Tableau da sua organização, digite
Default. - Para se conectar a um site adicional implantado por sua organização, digite a ID que aparece após
/#site/no URL do conteúdo.