Base de conhecimento

Este artigo irá te ajudar a aprender como conseguir um token e configurar corretamente a ferramenta Tableau Output para publicar dados direto em seu servidor Tableau.    

"Tutorial" da ferramenta Publicar no Servidor Tableau   A parceria entre a Alteryx e o Tableau está se tornando cada vez mais forte e a perfeita integração foi facilitada por meio da ferramenta Publicar no Servidor Tableau.   Você pode baixar a ferramenta no Alteryx Analytics Gallery. Após baixar a ferramenta, ela pode ser encontrada na categoria Conectores.        Agora você está pronto para configurar a ferramenta e publicar no Tableau.   Etapa 1: Acesso   É necessário ter acesso a uma instância do Servidor Tableau (9.0.1 ou superior) ou Tableau Online para utilizar essa ferramenta e publicar um fluxo de dados no Tableau. Salvo indicação em contrário, o Servidor Tableau e o Tableau Online são intercambiáveis ao longo deste documento e em toda a configuração da ferramenta. Para fins de concisão, "Servidor Tableau" fará referência a ambos o Servidor Tableau e o Tableau Online no restante deste documento.   Etapa 2: Opções de conexão   Essa macro permite que você escolha entre conectar-se diretamente ao Servidor Tableau por meio do navegador da Web ou via URL do servidor.   "Conectar-se com URL de página inteira" Quando fizer login no Servidor Tableau, navegue até a página da pasta de trabalho em que deseja gravar. Essa é a opção recomendada. É possível então copiar todo o URL para a caixa de texto fornecida na interface.   Exemplo de URL: https://10ay.online.tableau.com/#/site/mycompanyssite/workbooks   "Conectar-se com servidor e site" Com essa opção selecionada, é necessário inserir o nome de domínio para o URL do Server (por exemplo, usando o exemplo acima, https://10ay.online.tableau.com).   O Servidor Tableau foi projetado para que vários "sites" possam ser hospedados na mesma instância do servidor. Siga as instruções abaixo para determinar o nome do seu site ao fazer login no Servidor Tableau usando um navegador da web.   No Servidor Tableau, imediatamente após inserir um nome de usuário e senha, uma de duas coisas acontece:   1) O usuário deve selecionar um site. Se isso acontece, o site selecionado aqui pode ser inserido no campo "Digitar nome do site". 2) O usuário é conectado diretamente no Servidor Tableau, sem precisar selecionar um site. Se esse for o caso, o usuário deve selecionar a opção "Usar site padrão".   No Tableau Online, não há site padrão e sempre será necessário inserir manualmente o nome do site com essa opção (uma das razões pelas quais "Conectar-se com URL de página inteira" é o método recomendado, especialmente ao se conectar ao Tableau Online). Após fazer login, o URL deve ser algo como: https://10ay.online.tableau.com/#/site/mycompanyssite/workbooks. O nome do site será a cadeia de caracteres contida entre as barras depois de "#/site/". Nesse exemplo, o nome do site seria mycompanyssite.   Após escolher a conexão, você pode optar por "salvar histórico de conexões", que manterá suas credenciais e conexão dentro do botão de opção "selecionar conexão existente". Isso preencherá um menu suspenso com todas as suas conexões anteriores bem-sucedidas.    Etapa 3: Inserir seu nome de usuário e senha   Nessa etapa, insira seu nome de usuário e senha para o Servidor Tableau, os mesmos usados para fazer login por meio de um navegador da web.    *Consulte "Erros comuns" (abaixo) se receber uma "mensagem de erro 400000 de solicitação incorreta"   Etapa 4: Vamos para a guia Saída   Por padrão, a opção "Publicar fonte de dados" estará selecionada. Nesse estágio, será necessário digitar a fonte de dados recém-criada no Servidor Tableau. O nome da fonte de dados diferencia maiúsculas de minúsculas e deve ser exato.   É possível digitar o nome do projeto manualmente ou escolher "selecionar nome de projeto", que só estará preenchido se a opção "Atualizar lista de nomes de projeto..." estiver marcada e você já tiver executado o módulo uma vez. Se a opção "Atualizar lista de nomes de projeto" estiver marcada, nenhum dado será publicado no Servidor Tableau – essa é apenas uma etapa de configuração para que a lista de projetos disponíveis seja inserida no menu suspenso.     Etapa 5: Opções de saída   Com a fonte de dados e o nome do projeto corretos, é possível escolher o método de saída. "Criar fonte de dados" gerará um novo arquivo na pasta do projeto especificada, contudo, se já existir um arquivo com o mesmo nome de fonte de dados, o arquivo não será carregado e apresentará um erro.   A segunda opção é "sobrescrever fonte de dados". O arquivo será carregado independentemente da existência do arquivo na pasta do projeto especificado. Se já existir um arquivo com o mesmo nome, ele será substituído.     Etapa 6: Opcional   Se você selecionar a opção "solicitar token de autenticação", a macro fornecerá um token de autenticação no campo X-Tableau-Auth. Isso pode ser utilizado para fazer chamadas subsequentes para a API REST do Servidor Tableau com a ferramenta Download ou outras ferramentas, como cURL. A fonte de dados não será publicada.   Dicas e truques   Certifique-se de que a ferramenta está atualizada!   Visite a página do Gallery da ferramenta Publicar no Servidor Tableau acessando gallery.alteryx.com e navegando até o Distrito de Macros ou clicando neste link.         Depois, verifique a versão da ferramenta clicando nela com o botão direito do mouse e clicando em "Abrir macro: Publicar no Servidor Tableau.yxmc". Na janela de configuração do fluxo de trabalho, clique na guia Metainformações.         [Observação: v1.02 e anteriores não mostram a versão da ferramenta; nesse caso é necessário atualizar para a versão mais nova baixando-a da página no Gallery!]   Faça seu dever de casa! Faça login no Servidor Tableau ou Online e recupere o nome do URL de conexão! Só é necessário o URL até a pasta de trabalho em que você irá gravar.   Leia as letras pequenas! Se você escolher "selecionar nome de projeto", marque a opção "atualizar lista de nomes de projeto" e execute o módulo uma vez para preencher o menu suspenso (e, novamente, quando a ferramenta for executada com essa opção marcada, nenhum dado será publicado).   "Atualize" a fonte de dados Ao utilizar a nova ferramenta Publicar no Servidor Tableau, mesmo que você tenha êxito, ela não “atualizará” a fonte de dados automaticamente. Ou seja, isso deveria ser feito no Tableau. No Tableau, é possível configurar atualizações intermitentes, que farão a atualização pelo Tableau periodicamente. No entanto, também é possível fazer a atualização manualmente.         Erros comuns   "O conteúdo está em um formato XML malformado ou incompleto"     Solução Trata-se de uma limitação na API do Servidor Tableau, que já comunicamos ao Tableau e para a qual estamos esperando uma resposta/correção, então escapa um pouco do nosso controle. Se sua senha contiver caracteres não permitidos em xml, como aspas duplas/simples, maior que, menor que, E comercial ou sinal de porcentagem – “ ‘ < > %), que ficam de fora do XML – então a solicitação de login falhará. Isso é especialmente verdadeiro se sua senha contiver dois caracteres especiais. A ferramenta Publicar no Servidor Tableau mais recente foi projetada para lidar com a maioria desses caracteres especiais, porém, se você continuar recebendo essa mensagem de erro, a solução atual consiste em alterar sua senha para evitar caracteres especiais ou incluir apenas um dos caracteres acima.     “Foi atingido o limite de iteração de 1000 da ferramenta #200”     Solução Esse erro foi resolvido na versão mais recente da ferramenta. Baixe-a aqui.    “Erro no mecanismo de dados do Tableau: 4: SimpleDatabase: SelectMetadataName: expected found=1, actual found=0 (fk= name="Extract" nameTable="TEST") A tabela "[Extract].[Extract]" não existe. Não foi possível conectar ao arquivo "C/Desktop….". Verifique se o arquivo existe e se você tem privilégios de acesso suficientes para ele." Esse erro foi resolvido na versão mais recente da ferramenta. Baixe-a aqui.     Se continuar tendo problemas com a ferramenta Publicar no Servidor Tableau, entre em contato com a Equipe de Suporte.   Cumprimentos,   Jordan Barker Engenheiro de Suporte de Serviços ao Cliente