Guia do administrador do Tableau Server
Propaganda
Guia do administrador do Tableau Server Versão 8.1.x Última atualização: 1º de outubro de 2013 Antes da instalação... Certifique-se de que o computador no qual você está instalando o Tableau Server atende aos seguintes requisitos: l l Sistemas operacionais compatíveis — O Tableau Server está disponível em versões de 32 e 64 bits. Você pode instalar o Tableau Server no Windows Server 2003 (SP1 ou superior), no Windows Server 2008, no Windows Server 2008 R2, no Windows Server 2012, no Windows Vista, no Windows 7 ou no Windows 8. A versão de 64 bits do Tableau Server em um sistema operacional de 64 bits é recomendada. Você poderá instalar o Tableau Server em plataformas virtuais ou físicas. Memória, núcleos e espaço em disco — os requisitos de sistema do Tableau Server variam com base em muitos fatores. As recomendações a seguir se baseiam no número de usuários no servidor: Tipo de implantação Número de usuários do servidor CPU RAM Avaliação (somente Tableau Server 32 bits) 1-2 2 núcleos 4 GB Pequena <25 4 núcleos 8 GB Média <100 8 núcleos 32 GB Empresarial >100 16 núcleos 32 GB ou mais Os requisitos mínimos para executar a versão de 64 bits do Tableau Server são 4 núcleos e 8 GB de RAM. l l l Conta administrativa: a conta sob a qual você instala o Tableau Server deve ter permissão para instalação de software e serviços. Opcional: Conta Run As— a conta de usuário Run As para execução do serviço do Tableau Server será útil se você estiver usando a autenticação NT com fontes de dados ou se você estiver planejando fazer representação do SQL Server. Para obter mais informações, consulte Usuário Run As e Representação do SQL Server. IIS e porta 80 — o gateway do Tableau Server escuta na porta 80, que também é usada pelo IIS (Serviços de Informações da Internet) por padrão. Se você estiver instalando o Tableau Server em um computador que também executa o IIS, deverá modificar o número da porta do gateway do Tableau para evitar conflito com o IIS. Consulte Portas TCP/IP e Editar as portas padrão para obter detalhes. Informações de configuração Quando você instala e configura o Tableau Server, podem ser solicitadas as seguintes informações: Opção Descrição Conta de O servidor deve ter uma conta de usuário que o serviço servidor possa usar. O padrão é a conta interna Serviço de rede do Windows. Se você usar uma conta de usuário específica, será preciso o nome do domínio, o nome de usuário e a senha. Active Em vez de usar o sistema interno de gerenciamento de Directory usuários do Tableau, você pode autenticar por meio do Active Directory. Se for esse o caso, você precisará do nome de domínio totalmente qualificado. Abrir Quando selecionado, o Tableau Server abrirá a porta usada porta no para solicitações http no Firewall do Windows para permitir Firewall que outros computadores da sua rede acessem o servidor. do Windows Suas informações Nome de usuário: Senha: Domínio: Domínio Active Directory: __ - Sim __ - Não Portas Por padrão, o Tableau Server exige que várias portas TCP/IP estejam disponíveis para o servidor. Veja o tópico Portas TCP/IP para obter a lista completa, inclusive quais portas devem estar disponíveis para todas as instalações vs. instalações distribuídas ou instalações prontas para failover. As portas padrão podem ser alteradas se houver um conflito. Consulte Editar as portas padrão para saber como. Drivers Talvez seja preciso instalar drivers de banco de dados adicionais. Baixe os drivers em www.tableausoftware.com/support/drivers. Instalar e configurar Veja as principais etapas que precisam ser seguidas para instalar e configurar o Tableau Server: Executar a instalação do servidor Após baixar o arquivo de instalação do Tableau Server, siga as instruções abaixo para instalar o servidor. 1. Clique duas vezes no arquivo de instalação. 2. Siga as instruções na tela para concluir a instalação e instale o aplicativo. 3. Após a conclusão da instalação, clique em Avançar para abrir a janela Gerenciador de chaves de produto. Se você precisar oferecer suporte a caracteres que não sejam do conjunto Latin-1, instale os Pacotes de Idiomas do Windows por meio do Painel de controle > Opções regionais e de idioma. Os pacotes de idiomas precisarão ser instalados no servidor primário, bem como em qualquer computador de trabalho. Ativar o Tableau O Tableau Server exige pelo menos uma chave de produto que ativa o servidor e especifica o número de níveis de licença que você pode atribuir aos usuários. É possível acessar as chaves de produto no Centro de contas do cliente do Tableau. Após instalar e configurar o servidor, o gerenciador de chaves de produto é aberto automaticamente para que seja possível inserir a chave de produto e registrar o produto. Se precisar ativar o produto em um computador que esteja off-line, consulte Ativar o Tableau off-line. 1. Selecione Ativar e colar em sua chave de produto: 2. Consulte a página de ajuda de download no site para obter instruções passo a passo. Ativar o Tableau off-line Se estiver trabalhando off-line, você pode seguir as etapas abaixo para concluir a ativação offline. 1. Quando o gerenciador de chaves de produto for aberto, clique em Ativar o produto. Cole sua chave de produto do servidor na caixa de texto correspondente e clique em Ativar. Você pode obter sua chave do produto no Portal do cliente do Tableau. 2. Quando estiver off-line, a ativação falhará e você terá a opção de salvar um arquivo que pode ser usado para a ativação off-line. Clique em Salvar. 3. Selecione um local para o arquivo e clique em Salvar. O arquivo é salvo como offline.tlq. 4. De volta no Tableau, clique em Sair para fechar a caixa de diálogo Ativação. 5. Em um computador com acesso à Internet, abra um navegador da Web e visite a página Ativações de produto no site do Tableau. Complete as instruções para enviar seu arquivo offline.tlq. 6. A Tableau enviará por e-mail um arquivo chamado activation.tlf. Mova esse arquivo para o computador em que você está instalando o Tableau Server. Se o Tableau Desktop estiver instalado no computador, você poderá clicar duas vezes no novo arquivo para concluir a ativação. Caso você não tenha o Tableau Desktop instalado, passe para a etapa 7. 7. No computador em que você está instalando o Tableau Server, abra um prompt de comando como um administrador e execute o seguinte comando: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 8. Em seguida, digite tabadmin activate --tlf <path>\activation.tlf, onde <path> é o local do arquivo de resposta que a Tableau enviou a você. Por exemplo: tabadmin activate --tlf \Desktop\activation.tlf Deixe a janela do prompt de comando aberta. 9. Depois que a licença é inicializada, você deve reativar o produto. No Tableau Server, clique em Iniciar > Todos os Programas > Tableau Server 8.1> Gerenciar chaves de produto. 10. Clique em Ativar o produto. 11. Digite sua chave de produto novamente (a mesma inserida na etapa 1). 12. Salve o arquivo .tlq. 13. Em um computador com acesso à Internet, abra um navegador da Web e visite a página Ativações de produto novamente no site do Tableau. Complete as instruções. 14. O Tableau enviará novamente um e-mail para você chamado activation.tlf. Mova esse arquivo para o computador em que você está instalando o Tableau Server. 15. Novamente na janela do prompt de comando do Tableau Server, digite tabadmin activate --tlf <path>\activation.tlf, em que <path> é o local do segundo arquivo de resposta que o Tableau enviou para você. Por exemplo: tabadmin activate --tlf \Desktop\activation.tlf Agora o Tableau Server está ativado. Caso você precise de assistência adicional, entre em contato com o Atendimento ao cliente do Tableau. Configurar o servidor A caixa de diálogo Configurar é exibida durante a instalação. Você pode abri-la após a configuração selecionando Todos os Programas > Tableau Server8.1 > Configurar Tableau Server no menu Iniciar do Windows. É necessário parar o servidor antes de fazer quaisquer alterações de configuração. Consulte Reconfigurar o servidor para ver as etapas. Há duas coisas para se ter em mente sobre as configurações que você especificar na caixa de diálogo Configuração: l l As configurações abrangem todo o sistema: As configurações especificadas se aplicam a todo o servidor. Se o servidor estiver executando vários sites, essas configurações afetarão todos os sites. A autenticação do usuário é "permanente": Todas as configurações podem ser alteradas após a instalação, interrompendo o servidor e reconfigurando-o. A exceção é a configuração Autenticação do usuário (guia Geral). Ela é “permanente” no sentido de que a alteração de Usar autenticação local para Usar Active Directory requer que você desinstale e reinstale o servidor. Consulte os tópicos abaixo para obter detalhes sobre diferentes guias de configuração: Geral Siga as etapas abaixo para configurar as opções na guia Geral: 1. Por padrão, o Tableau Server é executado sob a conta Serviço de rede. Para usar uma conta que se adapte à autenticação NT com fontes de dados, especifique um nome de usuário e uma senha. O nome do usuário deve incluir o nome do domínio. Consulte Usuário Run As para saber mais sobre como usar uma conta de usuário específica. 2. Selecione se deseja usar o Active Directory para autenticar usuários no servidor. Selecione Usar autenticação local para criar usuários e atribuir senhas usando o sistema interno de gerenciamento de usuários do Tableau Server. Não é possível alternar entre o Active Directory e a Autenticação local posteriormente. 3. Se você usar o Active Directory: l l Você também pode Habilitar logon automático, que usa o Microsoft SSPI para conectar automaticamente seus usuários com base em seus nomes de usuário e suas senhas do Windows. Não selecione Habilitar logon automático caso você pretenda configurar o Tableau Server para SAML ou autenticação confiável. Certifique-se de digitar o FQDN (nome de domínio totalmente qualificado) e o apelido. Para determinar o FQDN: Selecione Iniciar > Executar e digite sysdm.cpl na caixa de texto Executar. Na caixa de diálogo Propriedades do sistema, selecione a guia Nome do computador. O FQDN é mostrado próximo do meio da caixa de diálogo. Na primeira vez em que entrarem, os usuários precisarão usar o nome de domínio totalmente qualificado (por exemplo, myco.lan\jsmith). Nas entradas subsequentes, eles podem usar o apelido (myco\jsmith). 4. A porta padrão de acesso Web ao Tableau Server (via HTTP) é a porta 80. Talvez você precise mudar o número da porta se tiver outro servidor em execução na porta 80 ou outras necessidades de rede. Por exemplo, talvez você tenha um firewall de hardware ou proxy que proteja o host do Tableau Server, o que pode tornar indesejável a execução de um sistema back-end na porta 80. 5. Selecione se você deseja abrir uma porta no Firewall do Windows. Se você não abrir essa porta, os usuários em outras máquinas talvez não possam acessar o servidor. 6. Selecione se deseja incluir usuários e dados de exemplo. Os dados de exemplo podem ajudar você a se familiarizar com o Tableau Server, especialmente se uma versão de avaliação do produto estiver sendo instalada. Inicialmente, o usuário de exemplo usa uma licença Interagente. É possível alterar esse usuário para não licenciado para resgatar níveis de licença. Consulte Licenças e direitos do usuário para saber como. Se você optar por incluir o usuário de exemplo, um único usuário será instalado. O nome de usuário e a senha são mostrados abaixo: Nome de usuário Senha Tableau Software test 7. Se desejar, passe para a próxima página para configurar as opções Cache e SQL inicial. Se não desejar configurar essas opções, clique em OK. Domínios Quando você estiver usando a autenticação do Active Directory para o servidor, será possível exibir uma lista dos domínios que estão sendo usados e editar os respectivos nomes de domínio e apelidos. Talvez seja preciso fazer isso, por exemplo, para garantir que o Tableau Server esteja usando o apelido correto para autenticação SSPI ou o nome de domínio correto. Modificar nomes de domínio Para modificar um nome de domínio: 1. Selecione o link Usuários na área Administração no lado esquerdo da página. 2. Clique no link Domínios na parte inferior da lista de usuários. A lista de domínios mostra o número de usuários e grupos que foram adicionados ao servidor de cada domínio. 3. Para exibir uma lista de usuários que fazem parte de um domínio, clique no nome do domínio. 4. Para modificar o nome do domínio ou apelido, clique no link Editar, digite um nome de domínio totalmente qualificado ou apelido novo e clique em Modificar. 5. É possível modificar o apelido para qualquer domínio que o servidor esteja usando. Em geral, você pode modificar o nome de domínio completo de qualquer domínio, exceto daquele que você usou para entrar. No entanto, caso o nome de usuário atualmente usado por você para entrar esteja no domínio atual e no novo domínio, você pode modificar o nome completo do domínio atual. Conexões de dados Use as opções na guia Conexões de dados para configurar o cache e especificar como lidar com as instruções SQL iniciais de fontes de dados. Cache As exibições publicadas no Tableau Server são interativas e, às vezes, têm uma conexão ativa com um banco de dados. Como os usuários interagem com as exibições em um navegador da Web, os dados que são consultados são armazenados em um cache. As visitas subsequentes extrairão os dados desse cachê, se ele estiver disponível. A guia Conexões de dados é onde você configura aspectos de cache que se aplicarão a todas as conexões de dados: Para configurar o cache, selecione uma das seguintes opções: : l l Atualizar com menos frequência: os dados são armazenados em cache e reutilizados sempre que estiverem disponíveis, independentemente de quando eles foram adicionados ao cache. Essa opção otimiza o número de consultas enviadas ao banco de dados. Selecione essa opção quando os dados não forem alterados com frequência. A atualização menos frequente pode melhorar o desempenho. Balanceado: os dados são removidos do cache após um número de minutos especificado. Se os dados tiverem sido adicionados ao cache dentro do intervalo de tempo especificado, os dados armazenados em cache serão usados, caso contrário, novos dados serão consultados no banco de dados. l Atualizar com mais frequência: o banco de dados é consultado toda vez que a página é carregada. Os dados continuam armazenados no cache e serão reutilizados até que o usuário recarregue a página. Essa opção garantirá que os usuários vejam os dados mais recentes; no entanto, isso pode baixar o desempenho. Independentemente de como o cache foi configurado, o usuário pode clicar no botão Atualizar dados na barra de ferramentas para forçar o servidor a enviar uma consulta e acessar novos dados. SQL inicial Para exibições que se conectam às fontes de dados Teradata, os criadores da pasta de trabalho podem especificar um comando SQL que será executado uma vez, quando a pasta de trabalho for carregada no navegador. Isso é chamado de instrução SQL inicial. Por motivos de segurança ou desempenho, alguns administradores podem querer desabilitar essa funcionalidade. É possível fazer isso na guia Conexões de dados: Para desabilitar a funcionalidade SQL inicial, marque a caixa de seleção Ignorar instruções SQL iniciais para todas as fontes de dados. As pastas de trabalho criadas com as instruções SQL iniciais continuarão abertas, mas os comandos SQL iniciais não serão enviados. Alertas e assinaturas O Tableau Server pode enviar um alerta por e-mail, caso haja uma falha no sistema, e também pode enviar assinaturas por e-mail a usuários do Tableau Server, que são instantâneos de suas exibições favoritas. A guia Alertas e assinaturas é onde você especifica o servidor SMTP que o Tableau Server usa para enviar e-mail. Para alertas e assinaturas, conexões SMTP criptografadas não são aceitas. Configurar alertas de e-mail Quando você configura alertas, o Tableau Server envia um email aos destinatários em Enviar e-mail para sempre que os processos do processador de dados, do repositório ou do servidor de gateway param ou reiniciam, ou sempre que o Tableau Server primário para ou reinicia. Se você estiver executando uma instalação de servidor único (todos os processos no mesmo computador), os alertas INATIVO indicam que o servidor inteiro parou, e os alertas de email ATIVO indicam que o servidor está novamente em execução. Se você estiver executando uma instalação distribuída que esteja configurada para failover (consulte Configurar para failover e vários gateways), um alerta INATIVO indica que o repositório ativo ou a instância de processador de dados falhou, e o alerta ATIVO subsequente indica que a instância em espera desse processo assumiu o controle e agora está ativa. Para configurar um alerta de e-mail: 1. Selecione Enviar alertas de e-mail para problemas de integridade do servidor. 2. Em Servidor SMTP, insira o nome do servidor SMTP. Insira um Nome de usuário e Senha para sua conta de servidor SMTP somente se isso for necessário. O valor da porta SMTP padr? O valor da porta SMTP padrão é 25. Em Enviar e-mail de, insira o endereço de e-mail que enviará um alerta se houver uma falha do sistema. Embora o endereço de e-mail que você digita deva ter uma sintaxe válida (por exemplo, [email protected] ou noreply@myco), ele não precisa ser também uma conta de email real no Tableau Server. 3. Em Enviar e-mail para, insira pelo menos um endereço de e-mail que receberá os alertas. Se você inserir vários endereços de e-mail, separe-os com vírgulas (não pontoe-vírgula). 4. Clique em OK. Quando você iniciar o servidor, ele acionará um alerta de e-mail, e este confirmará que você configurou os alertas corretamente. Configurar assinaturas de e-mail Para configurar um servidor SMTP para enviar assinaturas: 1. Selecione Habilitar assinaturas de e-mail. 2. Em Servidor SMTP, insira o nome do servidor SMTP. Insira um Nome de usuário e Senha para sua conta de servidor SMTP somente se isso for necessário. O valor da porta SMTP padr? O valor da porta SMTP padrão é 25. Em Enviar e-mail de, insira o endereço de e-mail que enviará assinaturas para usuários do Tableau Server. Embora o endereço de e-mail que você digitar deva ter uma sintaxe válida (como em <text>@<text>, [email protected] ou noreply@myco), o Tableau Server não requer que seja uma conta de e-mail real (no entanto, alguns servidores SMTP podem requerer que seja uma conta de e-mail real). Você também pode substituir esse endereço Enviar e-mail de de todo o sistema em uma base por site para assinaturas. Consulte Adicionar ou editar sites para obter detalhes. 3. Em URL do Tableau Server, insira http:// ou https://, seguido pelo nome do Tableau Server. Esse nome será usado para o rodapé dos e-mails de assinatura. 4. Clique em OK. SSL Você pode configurar o Tableau Server para usar comunicações criptografadas por SSL (Secure Sockets Layer) em todo o tráfego HTTP. Configurar o SSL garante que o acesso ao aplicativo Web seja seguro e que as informações confidenciais passadas entre o navegador da Web e o servidor ou o Tableau Desktop e o servidor sejam protegidas. As etapas sobre como configurar o servidor para SSL são descritas no tópico abaixo; no entanto, primeiramente, você deve adquirir um certificado de uma autoridade confiável e depois importar os arquivos de certificado no Tableau Server. Para configurar o Tableau Server para usar SSL: 1. Adquira um certificado Apache SSL de uma autoridade confiável (p. ex., Verisign, Thawte, Comodo, GoDaddy, etc.). Você também pode usar um certificado interno emitido por sua empresa. Certificados curinga, que permitem que você use SSL com muitos nomes de host dentro do mesmo domínio, também têm suporte. Alguns navegadores exigirão configuração adicional para aceitar certificados de determinados provedores. Consulte a documentação fornecida pela sua autoridade de certificação. 2. Coloque os arquivos de certificado em uma pasta chamada SSL, paralelamente à pasta do Tableau Server 8.1. Por exemplo: C:\Program Files\Tableau\Tableau Server\SSL Esse local fornece à conta que está executando o Tableau Server as permissões necessárias para os arquivos. 3. Abra o Utilitário de configuração do Tableau Server selecionando Iniciar > Todos os programas > Tableau Server 8.1 > Configurar o Tableau Server no menu Iniciar. 4. Na caixa de diálogo Configuração do Tableau Server, selecione a guia SSL. 5. Selecione Usar SSL para comunicação do servidor e forneça o local para cada um dos arquivos de certificado a seguir: Arquivo de certificado SSL: deve ser um certificado x509 codificado por PEM válido com a extensão .crt. Arquivo da chave de certificado SSL: deve ser uma chave RSA ou DSA válida que não seja protegida por senha com a extensão de arquivo .key. Arquivo de cadeia de certificado SSL (Opcional): alguns provedores de certificado emitem dois certificados para Apache. O segundo certificado é um arquivo de cadeia, que é uma concatenação de todos os certificados que formam a cadeia de certificados para o certificado do servidor. Todos os certificados no arquivo devem ser x509 codificados por PEM e o arquivo deve ter a extensão .crt (não .pem). 6. Clique em OK. As alterações entrarão em vigor na próxima vez que o servidor for reiniciado. Quando o servidor é configurado para SSL, ele aceita solicitações para a porta não SSL (o padrão é a porta 80) e é redirecionado automaticamente para a porta SSL 443. Os erros de SSL são registrados no diretório de instalação no local a seguir. Use esse registro para solucionar problemas de validação e criptografia. C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\httpd\error.log O Tableau Server oferece suporte apenas à porta 443 como a porta segura. Ele não poderá ser executado em um computador onde qualquer outro aplicativo esteja usando a porta 443. SAML Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP) para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na organização. Antes de configurar o Tableau Server for SAML, verifique se você atende aos Requisitos do SAML. Configurar SAML Para configurar o Tableau Server a fim de usar SAML: 1. Coloque os arquivos de certificado em uma pasta chamada SAML, paralela à pasta 8.1 do Tableau Server. Por exemplo: C:\Program Files\Tableau\Tableau Server\SAML Esse local fornece à conta que está executando o Tableau Server as permissões necessárias para os arquivos. 2. A configuração de SAML é identificada na guia SAML, exibida durante a Instalação do Tableau Server. Caso você esteja configurando o SAML após a Instalação, acesse a guia SAML abrindo o utilitário de configuração do Tableau Server (Iniciar > Todos os Programas > Tableau Server8.1 > Configurar Tableau Server) e clicando na guia SAML. 3. Na guia SAML, selecione Usar SAML para logon único e forneça o local para cada uma das seguintes opções: URL de retorno do Tableau Server — A URL que os usuários do Tableau Server acessarão, como http://tableau_server. Usar http://localhost não é recomendável. ID da entidade SAML — O ID da entidade identifica com exclusividade a instalação do Tableau Server para o IdP. Você pode inserir o URL do Tableau Server novamente aqui, caso queira, mas não precisa ser seu URL do Tableau Server. Arquivo de certificado SAML — Um certificado x509 com codificação PEM e a extensão .crt Arquivo da chave de certificado SAML — Uma chave RSA ou DSA não protegida por senha com a extensão de arquivo .key 4. Deixe a caixa de texto Arquivo de metadados IdP SAML vazia por enquanto e clique em Exportar arquivo de metadados. 5. Uma caixa de diálogo que permite salvar as configurações SAML do Tableau Server como um arquivo XML. Nesse ponto, os metadados de seu IdP não estão incluídos. Salve o arquivo XML com o nome de sua escolha. 6. No site de seu IdP ou em seu aplicativo: l l Adicione o Tableau Server como um provedor de serviços.Você precisará consultar a documentação de seus IdPs sobre como fazer isso. Como parte disso, você importará o arquivo salvo na etapa 5. Confirme se seu IdP usa nome de usuário como o elemento de atributo a ser verificado. 7. Ainda dentro de seu IdP, exporte o arquivo XML de metadados de seu IdP. 8. Copie o arquivo XML de metadados de seu IdP para a seguinte pasta em seu computador do Tableau Server: C:\Program Files\Tableau\Tableau Server\SAML 9. Na guia SAML, na caixa de diálogo Configuração do Tableau Server, informe o local até o arquivo na caixa de texto Arquivo de metadados IdP SAML: 10. Clique em OK. O Tableau Server já está configurado para autenticação SAML. Testar sua configuração Teste sua configuração SAML abrindo uma nova instância do navegador da Web e digitando o nome do Tableau Server na janela URL: O prompt de entrada exibido é de seu IdP, e não do Tableau Server: Adicionar uma conta de administrador A etapa final na ativação do Tableau Server é adicionar uma conta de administrador. O administrador terá acesso completo ao servidor, incluindo a capacidade de gerenciar usuários, grupos e projetos. A adição de uma conta de administrador pode variar, dependendo do que você estiver usando, o Active Directory ou a autenticação local. Active Directory Se estiver usando o Active Directory, digite Nome de usuário e a Senha para um usuário do Active Directory existente que será o administrador. Em seguida, clique em Adicionar usuário. Observação: Se a conta de administrador estiver no mesmo domínio que o servidor, basta digitar o nome de usuário sem o domínio. Caso contrário, você deverá incluir o nome de domínio totalmente qualificado. Por exemplo, test.lan\username. Autenticação local Se estiver usando a Autenticação local, crie uma conta de administrador digitando um Nome de usuário, Nome para exibição e uma Senha (duas vezes) de sua escolha. Em seguida, clique em Adicionar usuário. Reconfigurar o servidor Inserir suas configurações do Tableau Server faz parte da Instalação, mas você pode abrir a caixa de diálogo Configuração após a Instalação para fazer alterações. Consulte as etapas abaixo para obter detalhes. Você também pode usar a ferramenta de linha de comando tabadmin para fazer alterações de configuração. Independentemente de como você fizer a alteração, as novas configurações serão gravadas no arquivo de configuração, tabsvc.yml, que está localizado no diretório config. Observação: Não é possível alternar entre o Active Directory e a Autenticação local. Essas opções só podem ser configuradas durante a instalação. Para alterar uma configuração na caixa de diálogo Configuração do Tableau Server, faça o seguinte: 1. Interrompa o servidor selecionando Todos os programas > Tableau Server 8.0 > Interromper Tableau Server no menu Iniciar do Windows. 2. Em seguida, selecione Configurar o Tableau Server no menu Iniciar do Windows. 3. Se você estiver usando uma conta de usuário Active Directory para a conta Usuário Run As do servidor, digite sua senha na guia Geral. 4. Faça as alterações de configuração. 5. Clique em OK. 6. Inicie o servidor selecionando Todos os programas > Tableau Server 8.0 > Iniciar o Tableau Server no menu Iniciar do Windows. Reconfigurar processos Para alterar como os processos são configurados para uma única instalação de servidor, siga as etapas abaixo. Se você estiver alterando como os processos são configurados para um computador de trabalho, consulte Instalar e configurar servidores de trabalho. 1. Para abrir a caixa de diálogo Configuração do Tableau Server no menu Iniciar, navegue até Todos os programas > Tableau Server 8.1 > Configurar o Tableau Server. 2. Insira sua Senha, se necessário, na guia Geral e clique na guia Servidores: 3. Destaque This Machine e clique em Editar: 4. A caixa de diálogo Editar Tableau Server é onde você muda o número de processos: 5. Você pode executar até oito instâncias do VizQL, servidor de aplicativos, servidor de dados ou de processos em segundo plano, embora esse limite possa ser alterado se necessário. Consulte Sobre o limite de processo do servidor para obter mais informações. Além disso, para que o Tableau Server funcione, sempre deve haver uma instância ativa do mecanismo de dados e do repositório. Para ver as etapas sobre como movê-las para outro computador, consulte Mover os processos de mecanismo de dados e repositório. Para ver as etapas sobre como configurar instâncias em espera delas, consulte Alta disponibilidade. Após fazer as alterações, clique em OK duas vezes para sair da caixa de diálogo Configuração. Os processos do Tableau Server Existem seis processos do Tableau Server cuja configuração padrão você pode alterar para atingir diferentes resultados. Os tópicos Aprimorar o desempenho do servidor e Alta disponibilidade descrevem algumas das abordagens que podem ser adotadas. O status de nível alto para cada processo é exibido na página Manutenção do servidor e informações mais detalhadas relacionadas a alguns dos processos (como processo em segundo plano) estão em Exibições administrativas. Em termos de arquitetura, a versão 64 bits do Tableau Server usa processos nativos 64 bits; a versão 32 bits do Tableau Server usa processos 32 bits. A exceção é o processador de dados. Caso a versão 32 bits do Tableau Server esteja instalada em um sistema operacional de 64 bits, a versão 64 bits do processador de dados é usada. Nome do arquivo servidor de wgserver.exe aplicativos Processo Finalidade Lida com o MultiCaracterísticas de thread? desempenho Sim Consome apenas Processo segundo plano Nome do arquivo MultiCaracterísticas de thread? desempenho aplicativo Web, recursos perceptíveis oferece suporte à durante operações navegação e raras, como publicação pesquisa de uma pasta de trabalho com uma extração ou geração de uma imagem estática para uma exibição. Sua carga pode ser criada pela interação baseada em navegador e por tabcmd. backgrounder.exe Executa tarefas Não Um processo de um de servidor, único encadeamento incluindo onde vários processos atualizações de podem ser executados extrações, tarefas em qualquer \"Executar agora\" computador ou em todos e tarefas iniciadas eles no cluster para em tabcmd. expandir a capacidade. Geralmente, o processador em segundo plano não consome muita memória para processo, mas pode consumir recursos de CPU, E/S ou rede, de acordo com a natureza da carga de trabalho apresentada a ele. Por exemplo, a execução de grandes atualizações de extrações pode usar largura de banda da rede para recuperação de dados. Os recursos de CPU podem ser consumidos pela recuperação de dados ou tarefas tabcmd complexas. Finalidade Nome do MultiFinalidade arquivo thread? mecanismo tdeserver64.exe Armazena Sim de dados extrações de tdeserver.exe dados e responde às consultas Processo servidor de dataserver.exe dados Manipula Sim conexões com as fontes de dados do Tableau Server Características de desempenho A carga de trabalho do mecanismo de dados é gerada pelas solicitações do processo do VizQL Server. Ela é o componente que carrega extrações na memória e executa consultas nela. Basicamente, o consumo de memória é baseado no tamanho das extrações de dados que estão sendo carregadas. O binário de 64 bits é usado como o padrão em sistemas operacionais de 64 bits, mesmo que o Tableau Server 32 bits esteja instalado. O mecanismo de dados é multissegmentado para lidar com várias solicitações ao mesmo tempo. Sob carga alta, ele pode consumir recursos de CPU, E/S e rede, os quais podem ser um afunilamento de desempenho sob carga. Na carga alta, uma única instância do mecanismo de dados pode consumir todos os recursos de CPU para processar as solicitações. Como é um proxy, normalmente é associado somente pela rede, mas pode ser associado pela CPU Processo Nome do arquivo repositório postgres.exe VizQL Server vizqlserver.exe MultiCaracterísticas de thread? desempenho com sessões de usuário simultâneo suficientes. Sua carga é gerada pela interação baseada no navegador e no Tableau Desktop, bem como pelos trabalhos de atualização de extrações para fontes de dados do Tableau Server. O banco de dados Geralmente, consome do Tableau poucos recursos. Pode Server se tornar um armazenada afunilamento em casos metadados da raros de implantações pasta de trabalho muito grandes (milhares e do usuário de usuários) enquanto executa operações como exibição de todas as pastas de trabalho pelo usuário ou alteração de permissões. Carrega e Sim Consome recursos renderiza perceptíveis durante o exibições, calcula carregamento da e executa exibição e uso interativo consultas de um navegador da Web. Pode ser associado por CPU, E/S ou rede. A carga pode ser criada apenas pela interação baseada em navegador. Pode esgotar a memória do processo. Finalidade Sobre o limite de processo do servidor Os processos de servidor wgserver, processador de dados e VizQL foram projetados para serem multithreaded e multiprocessados. Uma única instância de processo pode executar mais de 16 encadeamentos. Por padrão, o Tableau Server é instalado com até duas instâncias de cada processo do servidor. Caso você esteja executando a versão 64 bits do Tableau Server (disponível a partir da versão 8.1), duas instâncias de um processo é o máximo que você deve executar. Caso esteja executando a versão 32 bits do Tableau Server e as configurações padrão não sejam suficientes, você pode alterá-las até oito instâncias durante a Instalação (apenas para atualizações) ou após a Instalação, usando a caixa de diálogo Configuração. O limite superior padrão é de oito instâncias de um processo. Se o seu computador tiver memória RAM e núcleos de CPU suficientes, você poderá alterar o limite superior usando a configuração service.max_procs tabadmin. Para cada instância de processo, o Tableau recomenda que o computador executando o processo tenha pelo menos 1 GB de RAM e 1 núcleo de CPU lógico. Para alterar o número máximo de processos permitidos: 1. Após a Instalação, interrompa o servidor. 2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde number é o número máximo de instâncias de processo que você deseja permitir: tabadmin set service.max_procs number Por exemplo: tabadmin set service.max_procs 16 3. Inicie o servidor para que as alterações possam ter efeito. Atualizar para 8.1 Use os tópicos a seguir para atualizar o software Tableau Server para a versão 8.1. Se estiver atualizando de uma versão anterior à 8.0, consulte a Base de Dados de Conhecimento do Tableau. Lista de verificação antes da atualização Estes são os itens a serem localizados e as etapas a serem executadas antes da atualização do Tableau Server para a versão 8.1.x. Credenciais, arquivos de instalação e personalizações Antes de iniciar a atualização, verifique se você possui os seguintes itens: l l Credenciais da conta de usuário: Em cada computador a ser atualizado, você precisa de credenciais para uma conta de usuário com permissões de administração local. Credenciais da conta Run As: Confirme que você tem o nome de usuário e a senha da conta Run As do Tableau Server. Se estiver usando NT AUTHORITY\NetworkService (o padrão), nenhuma senha será necessária. l l Versão de bit: Desde a versão 8.1, o Tableau Server é fornecido como um aplicativo nativo de 64 bits (bem como um aplicativo de 32 bits). Caso você estivesse executando a versão de 32 bits do Tableau Server anteriormente em um sistema operacional de 64 bits, é recomendável atualizar a versão de 64 bits do Tableau Server. Consulte Antes da instalação... para obter os requisitos mínimos para executar a versão de 64 bits do Tableau Server. Arquivos de instalação: Além de ter o .exe para a atualização que está prestes a ser realizada, você deve localizar ou baixar novamente o Setup .exe da versão do servidor em execução no momento (consulte Baixando produtos do Tableau). Se algo inesperado ocorrer durante a atualização, isso poderá ajudá-lo a agilizar a recuperação. Apesar de o Tableau manter as definições de configuração durante uma atualização, convém também anotar as personalizações executadas para verificá-las mais tarde. Isso inclui a configuração de SSL, a alteração da porta padrão do Tableau e valores de tempo limite, bem como o uso de logotipos personalizados. Além disso, se você adicionou sua versão atual do Tableau Server ao seu ambiente do Windows PATH, você deverá atualizar essa entrada depois do upgrade para que ela se refira à nova versão do Tableau Server. Verificar seu status de manutenção de produto Se você tentar atualizar o Tableau Server de um servidor cuja manutenção expirou, o resultado será uma instância não licenciada do Tableau Server. Para verificar se a manutenção do seu servidor expirou: l Selecione Iniciar > Todos os programas > Tableau Server > Gerenciar chaves de produto e verifique na coluna A manutenção expira. Se a manutenção tiver expirado, contate o Suporte ao cliente Tableau. A reativação da chave do produto fará parte da instalação. Consulte Ativar o Tableau para obter detalhes. Se o seu servidor não tiver acesso à Internet, consulte Ativar o Tableau off-line. Criar um backup “limpo” Além dos backups regulares do Tableau Server, convém criar um backup antes da atualização. Antes de criar o backup, execute o comando de limpeza tabadmin para remover arquivos não essenciais do seu backup. Consulte Execução da limpeza e Fazer backup do banco de dados do Tableau para obter as etapas. Apenas instalações distribuídas: Remover ou não computadores de trabalho antes de criar o backup O arquivo de backup do Tableau (.tsbak) contém informações de configuração, bem como dados. Portanto, um backup de uma instalação distribuída do Tableau Server conterá informações de configuração sobre os computadores de trabalho, inclusive seus endereços IP. Se você não quiser que essas informações façam parte de seu backup (porque você está migrando computadores de trabalho para um novo hardware como parte de sua atualização, por exemplo), escolha uma destas alternativas: remova os computadores de trabalho da configuração do Tableau Server antes de criar o backup, ou planeje usar a opção --noconfig para restaurar o arquivo de backup em sua nova instalação. Observe que com a última opção, nenhuma informação de configuração é restaurada — inclusive as do Tableau Server primário. Se você estiver executando uma instalação do Tableau Server e você tiver um trabalho que esteja executando o Windows XP, remova-o da configuração antes da atualização. O Windows XP não é uma plataforma com suporte na versão 8.1. Para excluir um trabalho da configuração do Tableau Server: 1. Interrompa o servidor no Tableau Server primário. 2. No servidor primário, abra o utilitário de configuração selecionando Tableau Server <versão> > Configurar o Tableau Server no menu Iniciar. 3. Na caixa de diálogo Configuração, selecione a guia Servidores. 4. Se o trabalho estiver hospedando extrações e/ou o repositório, mova esses serviços para outra máquina. Consulte Mover os processos de mecanismo de dados e repositório para ver as etapas. 5. Em seguida, destaque o trabalho e clique em Excluir. 6. Clique em OK. 7. Inicie o servidor. Execução da limpeza A execução do comando de limpeza tabadmin remove arquivos do sistema Tableau Server que são desnecessários no arquivo de backup. Execute a limpeza uma vez quando o servidor estiver em execução, permitindo sua ação no banco de dados Tableau, e uma vez com o servidor parado, permitindo que ele remova arquivos de log. Para executar a limpeza de tabadmin: 1. Abra um prompt de comando como um administrador: 2. Navegue até o diretório bin do Tableau Server. Por exemplo: cd “C:\Program Files (x86)\Tableau\Tableau Server\8.0\bin” 3. Confirme que o servidor está em execução: tabadmin status 4. Execute a limpeza digitando o seguinte: tabadmin cleanup 5. Interrompa o servidor: tabadmin stop 6. Execute nova limpeza: tabadmin cleanup Mantenha o servidor parado para criar um backup (em seguida). Crie um arquivo de backup O comando backup de tabadmin cria um arquivo .tsbak contendo dados do repositório, extrações de dados e configuração de servidor. Após criar o arquivo, armazene-o em um computador separado. Consulte Fazer backup do banco de dados do Tableau para ver as etapas. Apenas instalações distribuídas: Se você removeu trabalhos da configuração do servidor antes de criar o backup, e a atualização for da versão 8.1.x para 8.1.x, agora você poderá readicionar os trabalhos à configuração. A atualização do Tableau Server primário instala as atualizações nos trabalhos. Caso contrário, se a atualização for da versão 8.0 para 8.1.x, deixe os trabalhos fora da configuração. Consulte Atualizar para 8.1 para obter detalhes. Atualizar para 8.1 Ao concluir o Lista de verificação antes da atualização, atualize o Tableau Server existente para a versão 8.1 seguindo o procedimento abaixo. Caso você esteja migrando para um novo hardware como parte de sua atualização, consulte Migrar para novo hardware.Caso esteja atualizando de uma versão de 32 bits do Tableau Server para a versão de 64 bits, não há nenhuma etapa especial que você possa seguir. Você pode seguir o procedimento abaixo. 1. Use Adicionar/remover programas no Tableau Server (ou Tableau Server primário, caso tenha uma instalação distribuída), para desinstalar a versão anterior. A desinstalação remove o software de servidor mas mantém os dados e as definições de configuração inalteradas. 2. Instale o Tableau Server. Se sua instalação é distribuída, esta etapa se encontra no Tableau Server primário. A instalação do Tableau Server tratará da importação de dados e das definições de configuração da versão anterior. Mover os processos de mecanismo de dados e repositório Se você precisar excluir um computador de trabalho da configuração do Tableau Server e esse computador estiver hospedando a única instância do repositório ou do processador de dados (que hospeda extrações), será preciso mover primeiramente o processo para outro computador. Isso é necessário porque deve haver sempre uma instância ativa dos processos de repositório e processador de dados. Para mover os processos de processador de dados e repositório: 1. Caso ainda não tenha feito isso, interrompa o Tableau Server primário e abra a caixa de diálogo Configuração do Tableau Server (Iniciar > Tableau Server 8.1 > Configurar o Tableau Server) no Tableau Server primário. 2. Na guia Servidores, destaque o endereço IP ou o nome do computador para o qual você deseja mover o processo. Pode ser outro computador de trabalho ou o primário (This Computer (Primary)). 3. Clique em Editar. 4. Na caixa de diálogo Editar Tableau Server, marque a caixa de seleção do processo que está movendo: Processador de dados, Repositório ou ambos, e clique em OK. 5. Clique em OK na caixa de diálogo Configuração do Tableau Server. 6. Inicie o Tableau Server primário para que as alterações entrem em vigor. 7. Interrompa o servidor e abra a caixa de diálogo Configuração do Tableau Server. 8. Na guia Servidores, destaque o endereço IP ou o nome do computador de trabalho do qual você está removendo o processo e clique em Editar. 9. Desmarque a caixa de seleção do processo movido e clique em OK. 10. Clique em OK novamente e inicie o servidor primário para que as alterações entrem em vigor. Se você estiver executando esse procedimento como parte da exclusão de um trabalho da configuração do Tableau Server (conforme descrito em Lista de verificação antes da atualização) interrompa o servidor novamente antes de continuar. Sobre o limite de processo do servidor Os processos de servidor wgserver, processador de dados e VizQL foram projetados para serem multithreaded e multiprocessados. Uma única instância de processo pode executar mais de 16 encadeamentos. Por padrão, o Tableau Server é instalado com até duas instâncias de cada processo do servidor. Caso você esteja executando a versão 64 bits do Tableau Server (disponível a partir da versão 8.1), duas instâncias de um processo é o máximo que você deve executar. Caso esteja executando a versão 32 bits do Tableau Server e as configurações padrão não sejam suficientes, você pode alterá-las até oito instâncias durante a Instalação (apenas para atualizações) ou após a Instalação, usando a caixa de diálogo Configuração. O limite superior padrão é de oito instâncias de um processo. Se o seu computador tiver memória RAM e núcleos de CPU suficientes, você poderá alterar o limite superior usando a configuração service.max_procs tabadmin. Para cada instância de processo, o Tableau recomenda que o computador executando o processo tenha pelo menos 1 GB de RAM e 1 núcleo de CPU lógico. Para alterar o número máximo de processos permitidos: 1. Após a Instalação, interrompa o servidor. 2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde number é o número máximo de instâncias de processo que você deseja permitir: tabadmin set service.max_procs number Por exemplo: tabadmin set service.max_procs 16 3. Inicie o servidor para que as alterações possam ter efeito. Migrar para novo hardware Use o procedimento a seguir para migrar o Tableau Server de um computador para outro. Mais especificamente, essas etapas descrevem como mover dados e definições de configuração do Tableau Server de seu computador em produção para um novo computador no qual a versão 8.1 do Tableau Server está instalada. Antes de iniciar, verifique se você seguiu as etapas em Lista de verificação antes da atualização, inclusive a criação de um arquivo .tsbak. 1. Instale o Tableau Server no novo computador. 2. Copie seu arquivo .tsbak para a pasta bin em seu novo Tableau Server (por exemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin). 3. Em seguida, interrompa o Tableau Server. 4. Restaure dados e informações de configuração em execução para a nova instalação do Tableau Server, digitando tabadmin restore <filename>, onde <filename> é o nome do arquivo .tsbak. Por exemplo: tabadmin restore mybackup.tsbak Ou, para restaurar apenas os dados do Tableau Server em execução, sem informações de configuração, digite o seguinte: tabadmin restore --no-config mybackup.tsbak 5. Inicie o servidor. 6. Apenas instalações distribuídas: Execute o instalador de trabalho do Tableau em todos os computadores adicionais que você deseja adicionar a seu cluster do Tableau Server. Consulte Instalar e configurar servidores de trabalho para ver as etapas. 7. Depois de testar a nova instalação, você deve desativar a versão anterior do Tableau Server antes de desinstalá-la. Para desativar a versão anterior: - Selecione Iniciar > Todos os programas > Tableau Server > Gerenciar chaves de produto. - Selecione cada chave de produto e clique em Desativar. Se você não tiver uma conexão com a Internet, será solicitado a criar um arquivo de retorno off-line para concluir o processo de desativação. Consulte Ativar o Tableau off-line para ver as etapas. Ambientes distribuídos Use os tópicos abaixo para aprender mais sobre como executar uma instalação distribuída do Tableau Server: Instalar e configurar servidores de trabalho Depois de concluir a configuração inicial, você poderá definir o Tableau Server para ser executado em vários computadores. Esse procedimento se chama instalação distribuída. A execução de uma instalação distribuída usa portas adicionais no Tableau Server primário e exige que determinadas portas estejam disponíveis para associação durante a Instalação do Tableau Worker Server. Consulte Portas TCP/IP para obter mais informações. Aqui estão algumas outras coisas que devem ser consideradas: l l l O Tableau Server e o Tableau Worker Server estão disponíveis em versões de 32 e 64 bits. Todos os computadores em uma instalação distribuída devem executar a mesma "versão de bit" do software Tableau Server. Em outras palavras, os computadores de trabalho e primário devem executar todos o Tableau Server de 32 bits ou o Tableau Server de 64 bits. Todas as máquinas em um ambiente distribuído devem ser membros do mesmo domínio. A conta Usuário Run As do servidor, especificada no Tableau Server primário, deve ser uma conta de domínio nesse mesmo domínio. Todos os computadores em um ambiente distribuído devem ter endereços IP estáticos. Para instalar e configurar um Tableau Worker Server: 1. Verifique se você instalou o Tableau Server no computador primário. 2. Pare o servidor no computador primário (consulte Tableau Server Monitor para saber como). 3. Baixe o software Tableau Server Worker do Centro de contas do cliente do Tableau. 4. Execute a Instalação Tableau Server Worker em todos os computadores adicionais que você deseja incluir no cluster do Tableau Server. Durante a instalação, você deverá fornecer o endereço IPv4 ou o nome do computador do servidor primário. Se tiver um trabalho executando o Windows 7 com o Firewall do Windows habilitado, consulte a Base de dados de conhecimento do Tableau antes de continuar. 5. Assim que o software de trabalho for instalado nos computadores de trabalho, com o Tableau Server primário ainda parado, retorne ao servidor primário e abra o utilitário de configuração selecionando Tableau Server 8.1 > Configurar Tableau Server no menu Iniciar. 6. No Utilitário de Configuração, digite sua senha na guia Geral e selecione a guia Servidores e clique em Adicionar. 7. Na próxima caixa de diálogo, digite o endereço IPv4 ou o nome do computador de um dos computadores de trabalho e especifique o número de processos VizQL, Servidor de aplicativos, Data Server, Em segundo plano e Processador de dados a serem alocados ao computador. Você pode atribuir até oito instâncias de um processo a um servidor de trabalho (ou primário). Por padrão, o processador de dados, o repositório e o gateway são hospedados no servidor primário. A execução desses processos em um servidor adicional ou a transferência deles do servidor primário faz parte da configuração de alta disponibilidade. Consulte Alta disponibilidade para obter mais informações. 8. Clique em OK. A conclusão das atualizações pode levar vários minutos. 9. Repita essas etapas para cada computador que você deseja adicionar ao ambiente distribuído. Quando você terminar de adicionar trabalhos, clique em OK novamente para salvar as alterações e, em seguida, inicie o Tableau Server primário. Drivers de banco de dados Os instaladores do Tableau Server e Tableau Server Workers instalam drivers automaticamente para bancos de dados Oracle e Oracle Essbase. Se pretender publicar pastas de trabalho e fontes de dados que se conectam a outros bancos de dados, você precisará ter certeza de que os servidores primário e de trabalho tenham os drivers correspondentes. Os computadores de trabalho que executam o VizQL, o servidor de aplicativos, o data server ou processos do processador em segundo plano precisam desses drivers de banco de dados. Por exemplo, caso tenha um computador de trabalho dedicado como um servidor VizQL e outro computador dedicado ao armazenamento de extração, você só precisará instalar drivers no computador que executa o processo de servidor VizQL. Processo do servidor VizQL Servidor de aplicativos Data server Em segundo plano Processador de dados (armazenamento de extração) Repositório Gateway Exige driver de banco de dados? sim sim sim sim não não não Manter um ambiente distribuído Depois de configurar um primário e um ou mais servidores de trabalho para uma instalação distribuída, você poderá realizar todas as configurações subsequentes e as atualizações no servidor primário usando as ferramentas de linha de comando e o utilitário de configuração no servidor primário. As atualizações serão distribuídas aos computadores de trabalho automaticamente. Quando instalou servidores de trabalho, você especificou o endereço IPv4 do primário ou o nome do computador. Se esse endereço IP ou o nome do computador mudar, você precisará reinstalar os servidores de trabalho. Você pode monitorar o status do cluster do Tableau Server na página Manutenção do servidor. Consulte Manutenção do servidor para saber mais sobre a manutenção do servidor. Alta disponibilidade Use os links abaixo para aprender mais sobre o suporte do Tableau Server para alta disponibilidade: Como entender a alta disponibilidade Se você estiver configurando um sistema do Tableau Server para alta disponibilidade, as etapas executadas são relacionadas à criação em redundância, reduzindo assim seu tempo de inatividade potencial. As quatro áreas que requerem redundância são o processador de dados, o repositório e os processos de gateway, além do Tableau Server primário, que executa o componente de licenciamento do servidor. Como sempre deve haver uma instância ativa dos processos do processador de dados e do repositório, configurar o cluster é um procedimento em várias fases que requer a parada do Tableau Server primário e sua reinicialização em determinados pontos, para que as configurações entrem em vigor. Para obter as etapas exatas, consulte Configurar para failover e vários gateways e Configurar um primário de backup. Consulte Requisitos da alta disponibilidade também. Os tópicos abaixo resumem como a topologia de sistema do servidor evolui, à medida que você a configura para alta disponibilidade. A configuração mínima recomendada para alta disponibilidade é um sistema de três nós. Isso inclui um servidor primário para executar o licenciamento e dois computadores de trabalho para hospedar os processos principais. Você pode aumentar a confiabilidade do sistema adicionando um quarto computador para servir como um primário de backup. Se você executar um processo de gateway em todos os nós, também fará sentido usar um balanceador de carga para os gateways. Um sistema de servidor único Depois que você instalar o Tableau Server primário, ele estará executando no mínimo uma instância de todos os processos de servidor. Essa é a configuração mais básica do Tableau Server. Ela não tem nenhuma redundância. Em geral, esta é a aparência da tabela Status na página Manutenção para um sistema de servidor único: Para criar redundância, você precisa adicionar mais servidores para hospedar os processos de mecanismo e repositório de dados ativos e em espera. Além disso, para reduzir a vulnerabilidade do sistema, vários gateways podem ser executados, e o primário deve ser isolado em seu próprio nó, de preferência executando alguns dos processos do servidor, se possível. O menor número de computadores necessários para conseguir isso é três (consulte Um sistema de três nós). Porém, você pode conseguir alguma redundância com dois computadores. Um sistema de dois nós Se tiver restrições de hardware e um cluster de três nós estiver fora de alcance, você poderá conseguir alguma redundância usando dois computadores e um host externo a seu cluster do Tableau Server. No sistema acima, o Tableau Server primário e um servidor de trabalho estão executando as instâncias ativa e em espera do processador de dados, além do repositório, bem como dos gateways. Um terceiro computador, externo ao cluster do Tableau Server, está sendo usado como um terceiro ponto de contato para os dois gateways. Aqui está o porquê: Quando um Tableau Server executando o processador de dados ou o repositório perde conectividade com os outros nós, ele consulta um processo de gateway externo a seu respeito(mas ainda dentro do cluster do Tableau Server) para determinar qual nó falhou e se algum processo em espera agora precisa se tornar ativo. Em um cluster de dois nós, caso a conectividade seja perdida, não é possível alcançar o outro processo de gateway do Tableau. Nesses casos, um site ou um computador fora do cluster do Tableau Server pode ser usado. Consulte Confirmar failover externamente para saber como configurar isso. Aqui está como a tabela Status fica para a configuração acima. Como o terceiro computador não é um Tableau Server, ele não está listado na tabela. Um sistema de três nós Embora o sistema de dois nós descrito acima fornecesse algum suporte a failover para o mecanismo de dados e os processos de repositório, um sistema de três nós ajudaria a reduzir a vulnerabilidade do computador primário: A tabela Status na página Manutenção é semelhante à seguinte: Em um cluster de três nós, os processos de processador de dados e de repositório foram migrados do computador primário para um de trabalho, e o primário é o único executando o processo de gateway. Como a pesquisa e a funcionalidade de licenciamento são integrantes do primário e não podem ser removidos, eles não são exibidos na tabela Status. Nesta configuração, caso o trabalho ativo falhe, o trabalho em espera se torna ativo automaticamente. Como criar exatamente esse cluster de três nós, inclusive como adicionar os computadores de trabalho e remover os processos do primário, é descrito em Configurar para failover e vários gateways. Ainda existem mais duas coisas que você pode fazer para melhorar esse cluster de três nós: 1) adicione um balanceador de carga à interface com os três gateways ativos e 2) crie um backup para resolver o único ponto de falha: o primário. Consulte os tópicos abaixo para obter detalhes. Adicionar um balanceador de carga Nesse ponto, todos os três nós têm gateways, usados para encaminhar solicitações para processos de servidor disponíveis. Diferentemente do processo de repositório, não há gateway ativos e em espera. Todos os gateways estão ativos. Para reduzir ainda mais o potencial de tempo de inatividade de seu cluster, você deve configurar um balanceador de carga. Adicionar um primário de backup Adicionar um primário de backup fornece uma proteção para o sistema. O primário de backup é um servidor adicional incluído no sistema para estar pronto em caso de falha de seu primário. Embora não seja um servidor ativo, depois que você concluir o primeiro conjunto de etapas em Configurar um primário de backup, ele estará pronto para ser ativado. Aqui está como o sistema se parece com um primário de backup: A tabela Status da configuração acima será igual à do sistema de três nós. Caso haja falha no primário e você execute as etapas para que o primário de backup assuma, seu sistema volta a ficar on-line usando o novo primário: Requisitos da alta disponibilidade Antes de começar a configurar um cluster para failover e alta disponibilidade, verifique se os requisitos a seguir são atendidos. Equipamentos Com exceção do gateway, os sistemas usados para failover e alta disponibilidade devem atender aos requisitos descritos em Antes da instalação..., mas não precisam ser idênticos: l l l l Failover—dois ou três computadores: Para configurar um cluster que dê suporte a failover para os processos de processador de dados e repositório, você precisa de pelo menos dois computadores ou VMs: um para o Tableau Server primário e um para o computador de trabalho do Tableau. Nesta configuração, um site ou um computador que não esteja executando o Tableau também pode ser necessário (saiba mais). A configuração de failover recomendada exige três computadores ou VMs: um para o Tableau Server primário r dois para os computadores de trabalho. Suporte a failover e vários gateways—três computadores e um balanceador de carga: Para configurar um cluster que dê o suporte acima e além para vários gateways, você precisa de três computadores ou VMs e um balanceador de carga diante do cluster. Alta disponibilidade — quatro computadores e um balanceador de carga: Para configurar alta disponibilidade, você precisa de três computadores ou VMs descritos acima, além de um computador adicional para ser o primário de backup de seu Tableau Server primário. Computadores primários: Caso você configure para alta disponibilidade, o Tableau Server primário e o primário de backup podem estar executando menos ou nenhum processo do Tableau Server. Por isso, os computadores que executam o primário e o primário de backup não precisam de tantos núcleos quanto aqueles que executam seus servidores de trabalho. Você irá, no entanto, precisar de espaço em disco adequado para backups. O primário é usado temporariamente durante os processos de backup e restauração do banco de dados. Software Os produtos de software do Tableau estão disponíveis em versões de 32 e 64 bits. Caso você esteja executando um cluster do Tableau Server, cada computador deve executar a mesma versão, 64 ou 32 bits. Por exemplo, caso o Tableau Server primário esteja executando a versão 64 bits do Tableau Server, os computadores de trabalho no cluster devem executar a versão 64 bits do Tableau Server Worker. Eles não podem executar a versão 32 bits do Tableau Server Worker. O uso da mesma versão de bit não é um problema entre Tableau Desktop e Tableau Server. Você pode publicar uma pasta de trabalho em um Tableau Server de 64 bits usando uma versão 32 bits do Tableau Desktop e vice-versa. Rede e portas Assim como ocorre com qualquer sistema distribuído, os computadores ou VMs que você usa precisam ser capazes de se comunicar. Consulte Portas TCP/IP para obter uma lista de portas que devem estar disponíveis nos gateways e trabalhos. Práticas recomendadas Veja aqui algumas considerações que você deve ter em mente antes de começar a instalar e configurar: l l l l Endereços IP ou nomes de computador: Anote os endereços IPv4 ou os nomes de cada computador ou VM com que você trabalhará. Será necessário fornecê-los durante a Instalação e a configuração do Tableau Worker. Cada computador no cluster deve usar um endereço IP estático, mesmo que você use o nome do computador para identificá-lo durante a configuração. Registro CNAME: Se você estiver configurando para alta disponibilidade e não estiver usando um balanceador de carga, verifique se seu Tableau Server primário e o primário de backup têm o mesmo registro CNAME, de forma que os usuários do Tableau Server tenham uma experiência tranquila caso um primário falhe e você configure o outro para assumir. Se você estiver usando um balanceador de carga, será o nome do balanceador de carga que os usuários utilizarão como a URL do Tableau Server, independentemente do gateway efetivamente identificando a solicitação. Credenciais da conta de usuário: Para cada computador, você precisa de credenciais para uma conta de usuário com permissões admin locais. Se você estiver configurando para alta disponibilidade, a conta Run As usada para seu Tableau Server primário deve ser igual à usada para seu Tableau Server primário de backup. Backup: É uma prática recomendada criar um backup antes de fazer alterações significativas no sistema. Consulte Fazer backup do banco de dados do Tableau para ver as etapas. Configurar para failover e vários gateways Faça o seguinte para configurar um cluster de três computadores que dê suporte a vários gateways e failover:A execução de vários gateways só tem sentido caso você planeje usar também um balanceador de carga. 1. Instale o Tableau Server no seu computador primário. 2. Após a conclusão da Instalação, verifique a tabela Status na página Manutenção. Todos os processos devem ter um status “aguardando solicitação” verde: 3. Interrompa o servidor no primário. 4. Em seguida, execute a Instalação do Tableau Worker nos dois computadores adicionais ou VMs que darão suporte ao failover e ao gateway extra. Durante a Instalação do Worker, você precisará fornecer o endereço IPv4 ou o nome do computador do Tableau Server primário: Um endereço IP estático deve ser atribuído ao primário, mesmo que você esteja usando o nome do computador primário para identificá-lo. 5. Com o servidor primário ainda interrompido, abra sua caixa de diálogo Configuração: Iniciar > Todos os programas > Tableau Server > Configurar o Tableau Server. Na guia Geral, insira a senha da conta Executar como. 6. Na guia Servidores, clique em Adicionar para adicionar um computador de trabalho. 7. Digite o endereço IPv4 ou o nome do computador de trabalho, insira 1 para Processador de dados e marque a caixa de seleção Repositório. Marque a caixa de seleção Gateway caso você planeje usar também um balanceador de carga. Se você quiser que o trabalho execute outros processos de servidor, insira o número de instâncias que deseja executar, como 1 ou 2. 8. Clique em OK para fechar a caixa de diálogo Adicionar Tableau Server e em Adicionar novamente na guia Servidores para adicionar outro trabalho. 9. Digite o endereço IPv4 ou o nome do computador do segundo trabalho, insira pelo menos 1 para cada processo, mas também o Processador de dados (defina-o como 0). Desmarque a caixa de seleção Repositório e selecione Gateway. Não é necessário especificar qual computador de trabalho está ativo e qual está em espera para o processador de dados e o repositório. 10. Inicie o servidor no primário para que suas alterações possam entrar em vigor (isso pode demorar alguns minutos) e, em seguida, pare o servidor no primário. 11. Reabra a caixa de diálogo Configuração, na guia Servidores, destaque Este computador (primário) e clique em Editar. 12. Na caixa de diálogo Editar Tableau Server, defina Processador de dados como 0 e desmarque a caixa de seleção Repositório. Mantenha Gateway selecionado. Se você quiser que o Tableau Server primário não execute nada além do Apache (portanto, nenhum processo do Tableau Server), poderá remover os processos restantes dele inserindo 0 em cada caixa de texto: Clique em OK. 13. Na guia Servidores, selecione o segundo computador de trabalho e clique em Editar. 14. Defina Processador de dados como 1 e marque a caixa de seleção Repositório. Clique em OK. A guia Servidores agora deve ser semelhante à seguinte: 15. Também é possível configurar alertas de e-mail para que você seja notificado sobre falhas do servidor ou alterações no status dos processos de mecanismo de dados e repositório. Para isso, clique na guia Alertas e assinaturas da caixa de diálogo Configuração e siga as etapas em Configurar alertas de e-mail. 16. Clique em OK para fechar a caixa de diálogo Configuração. 17. Inicie o servidor no primário (talvez sejam necessários alguns minutos para que as alterações tenham efeito). Agora o sistema está configurado para fornecer suporte a failover para os processos de processador de dados e repositório. Ele também é configurado para vários gateways. Agora você pode usar um balanceador de carga para garantir a disponibilidade do cluster em caso de falha do gateway e distribuir a carga de trabalho do cluster. A tabela Status na página Manutenção deve ser semelhante à seguinte: Uma marca de seleção verde-claro indica um processo em espera, pronto para assumir se o processo ativo (marca de seleção verde-escuro) falhar. Confirmar failover externamente Assim que adicionar um segundo servidor à configuração de seu Tableau Server que está executando o processador de dados ou o repositório, você poderá usar a caixa de seleção Usar hosts externos para confirmar failover na guia Servidores. Esta opção permite listar um ou mais computadores ou sites externos ao cluster de seu Tableau Server que será usado para verificar o status de conectividade do cluster em caso de um failover. Usar um host ou site externo para confirmar o failover é mais útil em um sistema Tableau Server de dois nós como o seguinte: No sistema acima, o Tableau Server primário e um servidor de trabalho estão executando as instâncias ativa e em espera do processador de dados, além do repositório, bem como dos gateways. O terceiro computador, externo ao cluster do Tableau Server, está sendo usado como um terceiro ponto de contato para os dois gateways. Aqui está o porquê: Quando um Tableau Server executando o mecanismo de dados ou o repositório perde conectividade com os outros nós, ele consulta um processo de gateway externo a seu respeito(mas ainda dentro do cluster do Tableau Server) para determinar qual nó falhou e se algum processo em espera agora precisa se tornar ativo. Em um cluster de dois nós, caso a conectividade seja perdida, não é possível alcançar o outro processo de gateway do Tableau. Nesses caos, um computador no qual o Tableau não esteja em execução pode ser usado para estabelecer uma conexão TCP simples. Se o servidor de trabalho no diagrama acima perdesse conectividade com o primário, mas ainda conseguisse se conectar ao host externo, isso seria o gatilho para ele começar a executar as instâncias ativas do processador de dados e do repositório. Adicionar um balanceador de carga Você pode aumentar a confiabilidade de um cluster do Tableau Server executando vários gateways e configurando um balanceador de carga para distribuir solicitações em todos os gateways. Diferentemente do processo de repositório, que pode ser ativo ou em espera, todos os processos de gateway são ativos. Caso um gateway em um cluster fique indisponível, o balanceador de carga para de enviar solicitações para ele. O algoritmo do balanceador de carga escolhido por você determina como os gateways encaminharão as solicitações do cliente. Quando um balanceador de carga está diante de um cluster do Tableau Server, a URL que os usuários do Tableau Server utilizam pertence ao balanceador de carga, e não ao Tableau Server primário. Configurar um primário de backup Antes de seguir os procedimentos neste tópico, siga as etapas em Configurar para failover e vários gateways. Depois de passar por essas etapas, você terá dois servidores de trabalho que dão suporte a failover. Cada servidor também está executando um gateway para o qual um balanceador de carga pode ser configurado. O Tableau Server primário está executando um processo de gateway e licenciamento, não exposto ou atribuível como um processo. Agora que tem redundância para o processador de dados, o repositório e o gateway, você precisa criar redundância para seu Tableau Server primário. Você faz isso criando um backup dele. O primeiro procedimento abaixo descreve como criar um backup de seu primário. O segundo procedimento orienta você em relação ao que fazer caso seu primário atual falhe. Criação de um gateway de backup Faça o seguinte para criar um gateway de backup: 1. Pare o servidor em seu Tableau Server primário. 2. No primário, abra um prompt de comando como um administrador e navegue até o diretório bin do Tableau Server: C:\Program Files\Tableau\Tableau Server\8.1\bin 3. Digite o seguinte comando, em que <primary1> é o endereço IPv4 do primário atual ou o nome do computador e <primary2> é o endereço IPv4 do primário de backup ou o nome do computador: tabadmin failoverprimary --primary <primary1> --secondary <primary2> 4. Em seguida, crie uma cópia do arquivo tabsvc.yml do primário (localizado em ProgramData\Tableau\Tableau Server\config) e coloque a cópia em um local temporário em seu computador primário de backup. O arquivo tabsvc.yml contém definições de configuração de servidor. Ele é gravado quando você altera as definições de configuração na caixa de diálogo Configuração do Tableau Server ou via tabadmin. Se tabsvc.yml for alterado, você precisará atualizar a cópia de tabsvc.yml em seu primário de backup. 5. Em seu primário de backup, abra o arquivo tabsvc.yml e substitua o endereço IP ou o nome do computador do primário na linha worker.hosts pelo endereço IP ou o nome do computador do primário de backup (o computador em que você está no momento): 6. Em seu primário de backup, instale o Tableau Server. Use a mesma conta Run As e as mesmas definições de configuração que você usou ao executar a Instalação do Tableau Server em seu primário. 7. Após a conclusão da Instalação, pare o servidor no primário de backup. 8. Ainda em seu primário de backup, digite o seguinte comando para desabilitar seu serviço do Tableau Server: sc config tabsvc start= disabled Você concluiu a criação de um primário de backup. Consulte o próximo conjunto de etapas para saber o que fazer caso seu primário atual falhe. Se você estiver trabalhando em um ambiente de teste, este será um bom momento para testar sua configuração desligando seu primário atual para simular uma falha no sistema. Configuração do primário de backup Siga este segundo conjunto de etapas em caso de uma falha no primário. Todas as etapas devem ser executadas no computador primário de backup. 1. Em seu primário de backup, use o arquivo tabsvc.yml que você editou na etapa 5 do procedimento anterior para substituir o arquivo instalado localmente em ProgramData\Tableau\Tableau Server\config. 2. Abra um prompt de comando como administrador e navegue para o diretório bin do Tableau Server: C:\Program Files\Tableau\Tableau Server\8.1\bin 3. Digite o seguinte comando, em que primary2 é o endereço IP ou o nome do computador de seu primário de backup (logo será seu novo primário) e primary1 é o endereço IP ou o nome do computador de seu primário anterior (logo será seu backup): tabadmin failoverprimary --primary <primary2> --secondary <primary1> 4. Insira o seguinte comando: sc config tabsvc start= auto 5. Inicie o servidor. Seu primário de backup agora é seu computador primário. Ao observar a tabela Status na página Manutenção, você deve perceber que o endereço IP ou o nome do computador do primário foi alterado: 6. Para que seu primário agora atue como seu primário de backup, você precisará fazer o seguinte: l l l Use Adicionar/Remover Programas para remover o Tableau Server de seu primário anterior. Ao final do programa Desinstalar, você receberá um erro de backup, que poderá ignorar. Exclua as pastas do Tableau em Arquivos de Programas e ProgramData em seu gateway primário anterior. Repita as etapas neste tópico a partir da etapa 4 em “Como criar um gateway de backup”. Trabalhar com o Server Consulte os tópicos a seguir enquanto usa a interface do usuário do Tableau Server para administrar sua instalação: Usuários e licenças Todas as pessoas que precisarem acessar o Tableau Server, seja para publicar, pesquisar ou administrar, devem ser adicionadas como um usuário. Além disso, os usuários devem ser atribuídos a um nível de licença. Usuários Todas as pessoas que precisarem acessar o Tableau Server, seja para publicar, pesquisar ou administrar, devem ser adicionadas como um usuário. Se o Tableau Server estiver executando vários sites, a página Todos os usuários será onde os administradores de sistema fazem isso. Caso contrário, se o Tableau Server estiver no modo de site único, os administradores de sistema e site poderá adicionar usuários na página Usuários. Assim que os usuários forem adicionados, você poderá editá-los e excluí-los, adicioná-los ou removê-los de sites, bem como atribuir a eles níveis de licença e direitos do usuário. Consulte os tópicos abaixo para obter mais informações. Adicionar usuários Tanto administradores de sistema quanto administradores de site com as permissões corretas podem adicionar usuários a partir da página Usuários: Há duas maneiras de adicionar usuários a partir da página Usuários: Interativamente (como descrito abaixo) ou em lotes usando o comando Importar, que depende de um arquivo CSV (como descrito em Importar usuários de um arquivo CSV). Para adicionar um usuário: Na página Usuários, clique no link Adicionar acima da lista de usuários: 1. 2. Insira um Nome de usuário. l l Autenticação local: Se o servidor estiver configurado para autenticação local, utilizar um endereço de e-mail em Nome de usuário é a melhor maneira de evitar conflitos de nome de usuário (por exemplo, [email protected] em vez de jsmith). Depois de inserir o Nome de usuário, clique em Adicionar usuário. Active Directory: Se você estiver adicionando um usuário que seja do mesmo domínio Active Directory no qual o servidor está em execução, basta digitar o Nome de usuário sem o domínio. O domínio do servidor será adotado. Se houver uma configuração de confiança bidirecional entre o domínio do servidor e outro domínio, você poderá adicionar usuários de ambos os domínios. Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use o nome de domínio totalmente qualificado com o nome de usuário. Os usuários subsequentes podem ser adicionados usando o apelido do domínio. Por exemplo, presumindo um “domínio fora do servidor” de mybiz.lan, digite o primeiro usuário desse domínio como [email protected] ou mybiz.lan\user1. O próximo usuário pode ser inserido usando o apelido do domínio, como user2@mybiz ou mybiz\user2. Observação: Não insira o Nome completo do usuário nesse campo, pois isso pode causar erros durante o processo de importação. 3. Somente autenticação local, forneça o seguinte: l Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith). l Senha: digite uma senha para o usuário. l Confirmação: digite a senha novamente. 4. Nível de licença: Selecione um nível de licença. Consulte Licenças e direitos do usuário e Permissões para saber mais. 5. Direitos do usuário: Selecione se o usuário pode publicar pastas de trabalho e atribuir direitos de administrador. Consulte Permitir ou negar direitos do usuário para saber mais. 6. Clique em Adicionar. Observação para servidores com vários sites: Os administradores de site podem editar uma conta de usuário existente, desde que o usuário seja apenas membro de sites controlados por esse administrador. Por exemplo, se o usuário Joe for membro dos Sites A e B e o administrador de site somente for administrador do Site B, o administrador de site não poderá editar o Nome completo de Joe, nem redefinir sua senha. Adicionar usuários a um site Ao adicionar um site ao Tableau Server, ele se torna um sistema com vários sites, e o que antes era a página Usuários passa a ser duas páginas: Todos os usuários e Usuários do site. Como administrador de sistema, só você pode acessar a página Todos os usuários, que se aplica a todo o sistema do servidor. Ela é o único local em que você pode adicionar usuários a vários sites de uma vez, remover usuários e, se o servidor estiver usando a autenticação local, redefinir senhas de usuários. A página Usuários do site é uma forma simples de ver rapidamente quais usuários estão no site em que você entrou no momento. Você pode adicionar usuários a partir daqui, mas eles só serão adicionados a esse site. O procedimento a seguir descreve como adicionar usuários de Todos os usuários. Há duas abordagens que você pode adotar: Um de cada vez (como descrito abaixo) ou em lotes usando o comando Importar, que depende de um arquivo CSV (como descrito em Importar usuários de um arquivo CSV). Para adicionar um usuário: 1. Na página Todos os usuários, clique no link Adicionar na parte superior da lista de usuários: 2. Insira um Nome de usuário: l l Autenticação local — Se o servidor estiver usando autenticação local, utilizar um endereço de e-mail como o nome de usuário é a melhor maneira de evitar conflitos de nome de usuário (por exemplo, [email protected] e não jsmith). Active Directory— Se você estiver adicionando um usuário do mesmo domínio do Active Directory em que o servidor está sendo executado, poderá digitar o Nome de usuário sem o domínio. O domínio do servidor será adotado. Se houver uma configuração de confiança bidirecional entre o domínio do servidor e outro domínio, você poderá adicionar usuários de ambos os domínios. Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use o nome de domínio totalmente qualificado com o nome de usuário. Os usuários subsequentes podem ser adicionados usando o apelido do domínio. Por exemplo, adotando um “domínio fora do servidor” de mybiz.lan, digite o primeiro usuário desse domínio como [email protected] ou mybiz.lan\user1. O próximo usuário pode ser inserido usando o apelido do domínio, como user2@mybiz ou mybiz\user2. Observação: Não insira o Nome completo do usuário nesse campo, pois isso pode causar erros durante o processo de importação. 3. Se o servidor estiver usando autenticação local, forneça o seguinte: l Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith). l Senha: digite uma senha para o usuário. l Confirmação: digite a senha novamente. 4. Associação ao site — Selecione de quais sites o usuário deve ser membro. O site em que você entra é selecionado por padrão. 5. Nível de licença e direitos do usuário — Selecione o nível de licença, a função Admin e se o usuário pode publicar pastas de trabalho e fontes de dados. Um usuário que pertence a vários sites pode ter níveis de licença e direitos de usuário diferentes em cada site. Consulte Sobre níveis de licença, Permissões e Sobre direitos do usuário para saber mais. 6. Clique em Adicionar usuário. Importar usuários de um arquivo CSV Você pode automatizar o processo de adição de usuários com um arquivo CSV. Requisitos l l l l O arquivo CSV deve ser salvo no formato UTF-8, com a marca de ordem de byte (BOM). As codificações de caracteres diferentes de UTF-8, como BIG-5, devem ser convertidas. É possível fazer isso usando “Salvar como”. Não use cabeçalhos de coluna. Se você usar cabeçalhos de coluna (Username, Password etc.), Tableau Server o Tableau Server tentará importá-los como credenciais literais para o primeiro usuário no arquivo. As duas colunas seguintes sempre são necessárias: l l Username Password: Se o Tableau Server estiver configurado para utilizar a autenticação de usuário do Active Directory, deverá haver uma coluna Password, mas a coluna em si deverá estar vazia. Se o servidor estiver usando autenticação local, você deverá fornecer senhas para novos usuários. Consulte também “Modo de vários sites e de onde importar” para obter outras informações. l l O arquivo CSV também pode ter as seguintes colunas opcionais, na ordem mostrada abaixo (após as colunas Username e Password): l Full Name l License Level (Interagente, Visualizador ou Não licenciado) l Administrator (Sistema, Site, Site ou Nenhum) l Publisher (sim/verdadeiro/1 ou não/falso/0) l Email Address A ordem das colunas é significativa. A primeira coluna é tratada como Username, a segunda como Password, a terceira como Full Name etc, independentemente do conteúdo das colunas. Modo de vários sites e de onde importar Se o servidor estiver executando vários sites e você for um administrador de sistema, haverá duas páginas das quais você poderá fazer uma importação de usuários do CSV. Cada uma delas tem recursos diferentes em relação às contas de usuário do servidor existentes. Página Todos os usuários: Esta página será exibida se um servidor estive executando vários sites e somente administradores de sistema puderem acessá-la. l As importações do CSV feitas daqui permitem a você atualizar as contas de usuário do servidor existentes, além de adicionar novas contas. Por exemplo, se você realizar uma importação do CSV que tenha uma nova senha para cada usuário existente, suas senhas serão redefinidas. A página Usuários do site: l Quando um administrador de sistema está trabalhando aqui, ele tem os mesmos recursos de um administrador de site. Isso significa que ele pode adicionar novas contas de usuário com importações do CSV e, se usuários existentes fizerem parte da importação, os campos Senha e Nome completo deverão coincidir ou estar em branco. Se novas senhas ou nomes completos forem usados, haverá falha na importação. Se você for um administrador de site em um servidor com vários sites, execute importações de usuários do CSV na página Usuários. Um usuário pode pertencer a mais de um site no mesmo sistema de servidor, mas deve usar as mesmas credenciais para cada site. Isso é importante quando você está adicionando usuários novos ao site, mas talvez não ao servidor (em outras palavras, eles são membros de um site diferente no servidor). Se você achar que esse pode ser o caso, tente deixar a coluna Password em branco (mas mantenha o cabeçalho de coluna Password necessário). Se o servidor estiver configurado para autenticação local e um novo usuário do site também for novo no sistema do servidor, você verá uma mensagem na janela de importação do CSV solicitando o fornecimento de uma senha para o usuário. Adicionar usuários de um arquivo CSV Para adicionar usuários de um arquivo CSV: 1. Na página Usuários ou Todos os usuários, clique no link Importar: 2. Clique em Procurar, navegue até o arquivo e clique em Verificar arquivo: 3. Os resultados preliminares são exibidos. Para visualizar informações específicas de conta, selecione Detalhes da exibição: 4. Para continuar, clique em Importar usuários e clique em Sair na caixa de diálogo final. Adicionar usuários a um grupo Uma maneira de facilitar o gerenciamento de usuários é atribuí-los a grupos. Dessa forma, é possível atribuir permissões a um grupo inteiro, e não a um usuário por vez. Para adicionar um usuário a um grupo, o grupo já deve existir. Consulte Criar grupos para obter mais informações. Para adicionar um usuário a um grupo: 1. Na guia Admin, selecione a página Usuários: Se você for o administrador do sistema para um servidor de vários sites, precisará fazer isso em cada site usando a página Usuários do Site. 2. Selecione um ou mais usuários. 3. Clique no link Grupo + acima da lista de usuários e, em seguida, selecione um grupo ao qual adicionar usuários: Exibir, editar e excluir usuários Use este tópico para saber como exibir, editar, e excluir usuários do Tableau Server. Exibir usuários Caso o Tableau Server esteja executando vários sites, Todos os usuários lista todos os usuários no sistema do servidor e Usuários do site exibe todos os usuários do site no qual você entrou agora: Observação: Por padrão, essa lista de usuários é privada e só pode ser vista por administradores. Você pode tornar a lista de usuários pública habilitando Publicar lista de usuários, na área Configurações da página Manutenção. Se o servidor estiver executando vários sites, habilitar essa configuração mostrará apenas os usuários com os nomes de usuários no respectivo site. Os usuários podem ser listados em várias páginas. Conforme você seleciona os usuários na lista, eles são adicionados a uma lista rápida no canto superior esquerdo. A lista rápida permite ver quantos usuários você selecionou e ajuda a removê-los facilmente da seleção. Clique no botão “x” próximo ao nome de usuário na lista rápida para remover alguém da seleção. Também é possível usar a caixa Pesquisar em Filtros à esquerda para encontrar rapidamente um usuário específico na lista. Digite todo ou parte do nome do usuário e pressione Enter. É possível usar um asterisco (*) como um curinga na pesquisa. Por exemplo, pesquisar por John* retornará todos os nomes que comecem com John. Editar usuários Se o servidor for configurado para usar o sistema interno de gerenciamento de usuários (autenticação local), você poderá editar o Nome para exibição e a Senha dos usuários depois que eles forem adicionados. Se você estiver fazendo muitas alterações, será mais fácil importar as alterações de um arquivo CSV. Consulte Adicionar usuários para obter detalhes. Para editar informações de usuário: 1. Selecione um único usuário na lista de usuários. 2. Clique no link Editar no início da lista. 3. Digite um novo Nome para exibição e Senha nas caixas de texto correspondentes. 4. Clique em Enviar. Observação para servidores com vários sites: Os administradores de site podem editar uma conta de usuário existente, desde que o usuário seja apenas membro de sites controlados por esse administrador. Por exemplo, se o usuário Joe for membro dos Sites A e B e o administrador de site somente for administrador do Site B, o administrador de site não poderá editar o Nome completo de Joe, nem redefinir sua senha. Excluir usuários Para excluir usuários: 1. Selecione u ou mais usuários para excluir. 2. Clique em Excluir no início da lista. 3. Clique em Sim na caixa de diálogo de confirmação. Você só pode remover um usuário do Tableau Server se ele não for proprietário de conteúdo (pastas de trabalho, fontes de dados, etc.). Se você usar o procedimento anterior para excluir um usuário que possui o conteúdo, o usuário será definido como Não licenciado, mas não será removido. Sua página Preferências de usuário As opções em sua página Preferências do usuário afetam suas sessões Web individuais do Tableau Server. Use-as para gerenciar as configurações de sua assinatura, especificar sua página inicial, alterar o idioma e a localidade que você vê no Tableau Server, apagar cookies para senhas de conexão de dados ou alterar sua senha do Tableau Server. É possível também usar essa página para rapidamente procurar itens que você publicou. Para acessar sua página Preferências do Usuário, clique no seu nome de usuário na parte superior da página e selecione Preferências de Usuário no menu suspenso: Alterar seu endereço de email Se você tiver uma assinatura de uma exibição ou pasta de trabalho do Tableau Server, a conta de email que receberá a assinatura será listada na página Preferências do usuário: Para inserir ou alterar o endereço de e-mail para o qual o Tableau Server envia assinaturas, insira o novo endereço de e-mail na caixa de texto E-mail, insira-o novamente na caixa de texto Confirmar e-mail e, em seguida, selecione Definir: Gerenciar as configurações da sua assinatura Use as opções da Assinatura para alterar o agendamento para as assinaturas que você estiver recebendo. Aqui também é onde você pode cancelar a assinatura de uma exibição. Para ver as etapas, consulte Cancelar a Assinatura de uma Exibição e Alterar as Configurações da Assinatura. Personalizar a página inicial Tableau Server é instalado com Exibições como a página inicial padrão para todos os usuários, mas o administrador pode especificar uma página inicial diferente. Para descobrir qual é sua página inicial, clique em Ir para a página inicial: Você pode designar uma página inicial diferente navegando para a página do servidor desejada, por exemplo, Pastas de trabalho e selecionando o comando Tornar esta minha página inicial no menu suspenso no canto superior direito: Para voltar a usar a página inicial designada pelo seu administrador, em sua página Preferências de Usuário, clique em Redefinir como o padrão: Idioma e localidade A configuração de Idioma controla o idioma que você na interface de usuário do Tableau Server e Localidade afeta os itens nas exibições, como a formatação dos números e a moeda usada. Seu administrador pode configurar essas definições para todos os usuários do servidor, mas você pode alterá-las aqui, apenas para si mesmo. Se você alterar essas definições, observe que elas entrarão em vigor apenas se forem um idioma com suporte. Consulte Idioma e localidade para saber mais. Após fazer as seleções de Idioma e Localidade, clique em Definir. Na próxima vez em que você entrar, as configurações serão usadas em suas sessões de servidor. Alterar sua senha do Tableau Server Se o servidor for configurado para usar o sistema interno de gerenciamento de usuários (autenticação local) em vez do Active Directory, você poderá alterar sua senha do Tableau Server clicando em Alterar senha. Ao clicar nesse link, você será solicitado a inserir sua Senha atual e a Nova senha (duas vezes). Após ter digitado as informações necessárias, clique em Alterar para salvar as alterações. Desmarcar suas senhas de conexão de dados salvas Se você acessar uma exibição ou pasta de trabalho que tem uma conexão de banco de dados dinâmico e exige autenticação, o Tableau se oferece para salvar sua senha para você. Se você aceitar, ele armazenará suas credenciais em um cookie. Clique em Limpar tudo em Senhas de conexão de dados salvas para remover o cookie do Tableau Server: Procurar itens publicados Sua página de conta de usuário lista todas as pastas de trabalho, marcas e os comentários que você publicou. Use essa página para procurar rapidamente sua própria atividade no servidor. Licenças e direitos do usuário O nível de licença e os direitos do usuário que você atribui aos usuários determinam o que eles podem fazer no Tableau Server. Sobre níveis de licença Para abrir a página Licenças, clique no link Licenças na guia Admin: É necessário atribuir a todos os usuários do Tableau Server um nível de licença, mesmo que esse nível seja Não licenciado. Os níveis de licença do Tableau Server não correspondem às licenças de usuário nomeadas do Tableau Server que você comprou da Tableau (se você estiver usando licenciamento de servidor baseado em usuário em vez de baseado em núcleo). Essas licenças permitem que você tenha um determinado número de usuários no servidor. Níveis de licença permitem que os administradores controlem o acesso que os usuários terão no servidor. Aqui estão os níveis de licença que você pode atribuir: Nível de licença Descrição Não licenciado O usuário não pode entrar no servidor. Todos os usuários são adicionados como não licenciados, por padrão. Visualizador O usuário pode entrar e ver exibições publicadas no servidor, mas não pode interagir com as exibições. Os usuários com esse nível podem receber apenas permissão para exibir, adicionar comentários e exibir comentários. Eles não podem interagir com filtros rápidos nem classificar dados em uma exibição. Interagente O usuário pode entrar, navegar no servidor e interagir com as exibições publicadas. É importante notar que exibições, pastas de trabalho e projetos específicos podem ser adicionados com permissões que restringem os recursos do usuário. As configurações de permissão podem ser editadas pelo autor da Nível de licença Descrição pasta de trabalho ou por um administrador. Convidado O nível de licença de convidado está disponível para permitir que usuários sem uma conta no servidor vejam e interajam com uma exibição inserida. Quando habilitado, o usuário pode carregar uma página da Web contendo uma visualização inserida sem entrar. Essa opção está disponível somente com um servidor baseado em núcleo. É possível analisar como esses níveis foram distribuídos na página Licenças: Alterar níveis de licença Você normalmente atribui um nível de licença ao criar um usuário. Para alterar o nível de licença para um ou mais usuários existentes, siga estas etapas: 1. Na guia Admin, clique em Usuários. 2. Selecione um ou mais usuários. 3. Clique no link Usuário da licença no início da lista. 4. Selecione Não licenciado, Visualizador ou Interagente para os usuários selecionados. A coluna Nível de licença na lista de usuários é atualizada para refletir as alterações. Sobre direitos do usuário Além do nível de licença, os privilégios dos usuários no Tableau Server também são afetados por seus direitos de usuário: Direito do usuário Publicar Admin Descrição Permite que os usuários se conectem ao Tableau Server do Tableau Desktop para publicar e baixar pastas de trabalho ou fontes de dados. Torna o usuário um administrador. Há dois tipos de administradores: Administradores de site e administradores de sistema. l l Os administradores de site podem gerenciar grupos, projetos, pastas de trabalho e conexões de dados. Por padrão, os administradores de site também podem adicionar usuários e atribuir direitos de usuário e níveis de licença, mas um administrador de sistema pode desabilitar isso (consulte sites_edit.htm). Os administradores de sistema têm todos os direitos de um administrador de site e ainda podem licenciar usuários não licenciados, controlar se os administradores de site podem adicionar usuários, criar administradores de sistema adicionais e administrar o próprio servidor. Isso inclui controlar a manutenção, as definições, as agendas e o índice de pesquisa. O direito Admin só pode ser atribuído a usuários com o nível de licença Interagente e o direito Publicar. Permitir ou negar direitos do usuário Você normalmente atribui direitos do usuário ao criar um usuário. Para alterar os direitos do usuário para um ou mais usuários existentes, siga estas etapas: 1. Na guia Admin, clique em Usuários. 2. Selecione um ou mais usuários. 3. Clique em Publicação ou Admin na parte superior da lista. 4. Selecione Permitir ou Negar para alterar o direito de publicação dos usuários selecionados. 5. Em Admin, selecione Sistema, Site ou Nenhum para alterar o direito Admin para os usuários selecionados. As colunas Admin e Publicar na lista de usuários são atualizadas para refletir as alterações. Grupos e projetos Grupos e projetos ajudam você a organizar suas pastas de trabalho e usuários no Tableau Server. Grupos Você pode organizar os usuários no Tableau Server em grupos para facilitar o gerenciamento de vários usuários. É possível criar grupos localmente no servidor ou importar do Active Directory. Você pode criar e gerenciar grupos na página Grupos, que lista todos os grupos no servidor ou site, se o servidor hospedar vários sites. Criar grupos Dependendo de como o servidor foi configurado, você pode adicionar grupos usando o sistema interno de gerenciamento de usuários (autenticação local) ou pode importar do Active Directory. Criar um grupo local Um grupo local é aquele criado no Tableau Server usando o sistema interno de gerenciamento de usuários. Após criar um grupo, você pode adicionar e remover usuários. Para criar um grupo local: 1. Clique em Novo na parte superior da lista de grupos. 2. Digite um nome para o grupo e clique em Adicionar grupo: 3. Clique em Retornar para grupos para retornar à lista de grupos. Criar um grupo pelo Active Directory Os grupos podem ser importados do Active Directory. Quando você importa grupos do Active Directory, um grupo correspondente é criado no servidor e um usuário é criado no servidor para cada membro do grupo. Os usuários não são licenciados e não têm permissão para publicar. Se o usuário já existir no servidor, ele será adicionado ao novo grupo e suas permissões não serão alteradas. Consulte Licenças e direitos do usuário para saber mais sobre níveis de licença e direitos de usuário. 1. Clique em Importar grupo do Active Directory no fim da lista de grupo 2. Digite o nome do grupo do Active Directory que você deseja importar e clique em Importar. 3. Se você não souber o nome exato do grupo, será possível encontrá-lo digitando todo o nome do grupo, ou parte dele, na caixa de texto Pesquisar. Em seguida, clique em Pesquisar. Você pode usar o símbolo de asterisco (*) como curinga. 4. Selecione o grupo na lista de resultados da pesquisa. 5. O nome do grupo é adicionado automaticamente à caixa de texto Importar. Clique em Importar para adicionar o grupo ao Tableau Server. Não é possível alterar o nome dos grupos importados do Active Directory. O nome do grupo só pode ser alterado no Active Directory. Sincronizar um grupo do Active Directory A qualquer momento, é possível sincronizar um grupo do Active Directory com o Tableau Server para que todos os novos usuários no Active Directory também sejam adicionados ao servidor. Você pode sincronizar grupos individuais ou vários grupos de uma vez. 1. Na página Grupos, selecione um ou mais grupos. 2. Clique em Sincronizar. Se você estiver adicionando um grupo que seja do mesmo domínio Active Directory no qual o servidor está em execução, basta digitar o nome do grupo. Além disso, se houver uma configuração de confiança bidirecional entre o domínio que o servidor está usando e outro domínio, você poderá adicionar grupos de ambos os domínios. Na primeira vez que você adicionar um grupo de um domínio diferente daquele que o servidor está usando, será preciso incluir o nome de domínio totalmente qualificado com o nome do grupo. Por exemplo, domain.lan\group ou [email protected]. Qualquer grupo subsequente pode ser adicionado usando o apelido do domínio. Consulte Modificar nomes de domínio para saber mais sobre como gerenciar nomes de domínio. Excluir grupos Você pode excluir qualquer grupo do servidor. Quando um grupo é excluído, os usuários são removidos do grupo, mas não são excluídos do servidor. 1. Na página Grupos, selecione um ou mais grupos a serem excluídos. 2. Clique em Excluir acima da lista de grupos: Projetos Um projeto é um conjunto de pastas de trabalho relacionadas. Na condição de administrador, há dois locais onde você verá Projetos listados: abaixo da guiaConteúdo e abaixo da guia Admin. Se desejar criar novos projetos, atribuir permissões ou excluir projetos, use a página Projetos abaixo da guia Admin: Embora somente administradores possam criar novos projetos, a permissão Líder de projeto pode ser atribuída a usuários e grupos. As permissões possibilitam ao usuário ou grupo especificar permissões de projeto e mover pastas de trabalho para projetos. Consulte os tópicos abaixo para ver os procedimentos e obter mais informações sobre como trabalhar com projetos: Adicionar projetos Para adicionar um ou mais projetos 1. Clique no link Adicionar. 2. Digite o nome e a descrição do projeto e clique em Adicionar. É possível incluir formatação e hiperlinks na descrição do projeto. Mover pastas de trabalho para projetos Todas as pastas de trabalho devem estar em um projeto. Por padrão, as pastas de trabalho são adicionadas ao projeto Padrão. Depois de criar seus próprios projetos, você poderá mover pastas de trabalho de um projeto a outro. Será possível transferir pastas de trabalho para projetos se você tiver um nível de licença Interagente e, pelo menos, uma das afirmações a seguir for verdadeira: l Você tem permissão para Gravar no projeto. l Você tem permissão Líder do projeto para o projeto. l Você recebeu o direito Admin. Para transferir uma pasta de trabalho para um projeto: 1. Selecione uma ou mais pastas de trabalho e clique no link Mover na parte superior da lista de pastas de trabalho. 2. Selecione um projeto para o qual mover a pasta de trabalho. Como todas as pastas de trabalho devem fazer parte de um projeto, você pode remover uma pasta de trabalho de um projeto movendo-o para o projeto Padrão. Cada pasta de trabalho pode fazer parte apenas de um único projeto. Excluir projetos Somente administradores podem excluir projetos. Quando você exclui um projeto, todas as pastas de trabalho e exibições que fazem parte do projeto também são excluídas do servidor. Para excluir um projeto: 1. Selecione o projeto na lista de projetos. 2. Clique em Excluir abaixo da lista Projetos. 3. Clique em Sim na caixa de diálogo de confirmação. O projeto Padrão não pode ser excluído. Agendar atualizações e assinaturas Atualizações de extrações e entregas de assinaturas são tarefas realizadas pelo Tableau Server e as agendas controlam quando essas tarefas são executadas. Na condição de administrador do servidor, você deve ter o nível mais alto de controle sobre as tarefas e agendas do servidor. No entanto, há dois tipos de tarefas que os usuários do Tableau Server podem agendar. Os autores de pasta de trabalho podem agendar atualizações de extrações ao publicarem uma pasta de trabalho ou uma fonte de dados com uma extração e os usuários do Tableau Server podem assinar exibições, que são entregues de acordo com uma agend. Como administrador, você pode ajustar uma agenda de assinatura ou extração, criar novas agendas, atualizar tarefas e excluí-las. Além de determinar se os autores da pasta de trabalho podem ou não fazer agendamentos (consulte Habilitar agendamento), você pode determinar se o servidor deve ser configurado para enviar assinaturas (consulte Gerenciar assinaturas). Qualquer mudança feita em uma agenda de extração é refletida na caixa de diálogo Agenda do Tableau Desktop na próxima vez que o autor fizer uma publicação. De modo semelhante, ao criar uma nova agenda de assinaturas ou excluir uma existente, isso se reflete nas opções da agenda que um usuário do Tableau Server visualiza quando assina uma exibição. Consulte os tópicos abaixo para obter mais informações: Sobre extrações e agendas O Tableau Desktop permite que os autores criem uma extração de dados, que é uma cópia ou um subconjunto de dados da fonte de dados original. As pastas de trabalho que usam extrações de dados geralmente são mais rápidas do que aquelas que usam conexões de banco de dados ativa, pois os dados extraídos são importados no mecanismo de dados rápido interno do Tableau. As extrações também podem aumentar a funcionalidade. Após a publicação de uma pasta de trabalho ou fonte de dados com uma extração, a extração residirá no Tableau Server. Atualizando extrações diretamente no Tableau Server: l Navegador da Web: Como administrador, você pode alterar ou reatribuir agendas de atualização de extrações independentemente de a pasta de trabalho ou fonte de dados com extração ter recebido uma agenda de atualização no momento em que foi publicada. Qualquer alteração de agendamento feita pelo administrador do site no Tableau Server é refletida na caixa de diálogo Agenda do Tableau Desktop quando a pasta de trabalho ou fonte de dados é publicada novamente. Você também pode atualizar uma extração imediatamente, usando a opção Executar agora. Consulte Gerenciar tarefas de atualização e Criar ou modificar um agendamento para obter detalhes. Observe que, antes de criar agendas de atualização, você deve habilitar o agendamento no servidor. Consulte Habilitar agendamento para saber mais. l Utilitário de linha de comando tabcmd: O utilitário de linha de comando tabcmd fornece um comando refreshextracts, que você pode usar na linha de comando ou incorporar em seu próprio script. Consulte Automatizar tarefas de atualização para obter mais informações. Atualizando extrações do Tableau Desktop: l l No momento da publicação: Quando um autor publica uma pasta de trabalho ou fonte de dados que usa uma extração, esse autor pode atribuí-la a uma agenda de atualização recorrente no Tableau Server. A A atualização pode ser completa ou incremental. As atualizações incrementais referenciam uma coluna na extração que tem um tipo de dados de data, data/hora ou inteiro; como um carimbo de data e hora. O Tableau usa essa coluna para identificar novas linhas que precisam ser adicionadas à sua extração. Consulte Atualizando extrações e Agendas na ajuda do Tableau Desktop para obter mais informações. Interface de usuário: Você pode usar as opções Atualizar da origem e Anexar do arquivo no Tableau Desktop para carregar um acréscimo ou uma atualização de uma extração no Tableau Server. Você poderá fazer isso se o Tableau Server não tiver credenciais suficientes para atualizar os dados da fonte de dados original. Para obter mais informações, consulte Atualização de extrações no Tableau Server na ajuda online do Tableau Desktop para obter detalhes sobre o upload. l Utilitário de linha de comando Extração de DadosO utilitário Extração de Dados do Tableau é instalado com o Tableau Desktop. Você pode usá-lo para carregar um acréscimo a uma extração no Tableau Server ou atualizá-la. Consulte Utilitário de linha de comando Extração de Dados do Tableau Data na ajuda on-line do Tableau Desktop para obter mais informações sobre como fazer o upload. C Habilitar agendamento Para que seja possível agendar uma atualização de extração, o agendamento deve ser habilitado no servidor. Após habilitar o agendamento, você poderá adicionar pastas de trabalho e fontes de dados a agendas, criar e editar agendas, gerenciar tarefas agendadas e alterar configurações de agenda para permitir que editores atribuam pastas de trabalho a agendas. Essa configuração não afeta o agendamento para assinaturas. Para habilitar o agendamento, marque a caixa de seleção Agendamento em Configurações na página Manutenção do Servidor: Como as senhas de banco de dados podem ser exigidas para atualizar a extração, você deve habilitar Credenciais inseridas para permitir o agendamento. Criar ou modificar um agendamento A página Agendas apresenta uma lista de agendas que inclui o nome, o tipo, a que se destinam (escopo), o número de tarefas, o comportamento (processamento serial ou simultâneo) e quando elas estão agendadas para execução. 1. Para criar uma nova agenda, clique em Novo: 2. Para modificar uma agenda existente, selecione-a e clique em Modificar: 3. Especifique um Nome descritivo para a agenda (p. ex., Todo sábado de manhã, Fim do mês). 4. Escolha um Escopo da agenda, ou seja, o que a agenda manipulará — atualizações de extrações ou entregas de assinaturas. 5. Como opção, defina uma Prioridade padrão de 0 a 100. Essa é a prioridade que será atribuída às tarefas por padrão. Se duas tarefas estiverem pendentes na fila, aquela com a prioridade mais alta será executada primeiro. Consulte Gerenciar tarefas de atualização para saber mais sobre como modificar a prioridade de uma tarefa. 6. Escolha se as tarefas na agenda serão executadas ao mesmo tempo (simultaneamente, o padrão) ou uma após a outra (sequencialmente). 7. Termine de definir ou editar a agenda. É possível definir uma agenda por hora, dia, semana ou mês. 8. Clique em Criar agenda se for uma nova agenda, ou em Salvar agenda se você tiver modificado uma agenda existente. Adicionar fonte de dados ou pasta de trabalho à agenda Uma vez que você tenha habilitado o agendamento, poderá adicionar uma pasta de trabalho a uma agenda da lista Pastas de trabalho ou adicionar uma fonte de dados a uma agenda da lista Fontes de dados. Por padrão, o Tableau Server tem três agendas internas para atualizar extrações. Também é possível criar sua própria agenda. Consulte Criar ou modificar um agendamento para obter detalhes. 1. Se você está agendando uma pasta de trabalho para uma atualização de extração, selecione uma ou mais na página Pastas de trabalho e clique em Tarefas agendadas: Se você está agendando uma fonte de dados para uma atualização de extração, selecione uma ou mais na página Fontes de dados e clique em Tarefas agendadas: 2. Selecione Adicionar atualização completa ou Adicionar atualização incremental e, em seguida, selecione uma agenda da lista: Adicionar atualização completa estará disponível somente se a fonte de dados selecionada se conectar a uma fonte de dados de extração. Adicionar atualização incremental está disponível somente se a fonte de dados selecionada se conectar a uma fonte de dados de extração para a qual você definiu uma atualização incremental. Tableau Server não pode atualizar as fontes de dados que se conectam a fontes de dados de arquivo local em uma unidade mapeada. Atualize a conexão para usar o caminho completo até a fonte de dados. Gerenciar tarefas de atualização A página Tarefas exibe todas as tarefas de atualização de extração completa e incremental que estão sendo gerenciadas pelo servidor. Os administradores de sistema e site podem usar essa página para alterar a prioridade de uma tarefa, movê-la para uma agenda diferente, executá-la ou excluí-la. Você pode abrir a página Tarefas clicando em Tarefas na guia Admin: Editar uma agenda da tarefa Mova uma tarefa de atualização de extração de uma agenda para outra fazendo o seguinte: 1. Na página Tarefas, selecione uma ou mais tarefas a serem modificadas. 2. Clique em Editar agenda. Selecione uma nova agenda na lista de agendas: Também é possível excluir e executar tarefas selecionando uma ou mais tarefas na lista e selecionando uma opção na barra de ferramentas. Executar uma tarefa agora Você pode forçar uma atualização imediata de uma tarefa, como uma tarefa de atualização de extração, usando a opção Executar agora. 1. Na página Tarefas, selecione uma tarefa a ser executada. 2. Clique em Executar agora. Alterar a prioridade de uma tarefa Para alterar a prioridade de uma tarefa de atualização de extração: 1. Na página Tarefas, selecione uma ou mais tarefas a serem modificadas. 2. Clique em Editar prioridade. 3. Digite uma nova prioridade de 0 a 100 e clique em Enviar. Automatizar tarefas de atualização Você pode associar tarefas de atualização de extração a agendas no Tableau Server para automatizar a atualização de extrações de dados. Você também pode automatizar atualizações de extração usando tabcmd, um utilitário de linha de comando fornecido com o Tableau Server e que pode ser instalado em um computador separado do Tableau Server. Em particular, você pode usar o comando refreshextracts em combinação com outros comandos em seu próprio script. Por exemplo: tabcmd login - http://mytabserver -u jsmith -p P@ssw0rd! refreshextracts --datasource salesq4 Identificar alertas de atualização da extração Caso as atualizações de extração não tenham sido bem-sucedidas, o Tableau exibe um menu Alertas no canto inferior direito: Você só verá o menu Alertas se houver uma falha na atualização da extração e você estiver: l Um administrador de sistema ou do site. l Não foi possível atualizar o autor da pasta de trabalho ou da fonte de dados. l Não foi possível atualizar o autor de uma pasta de trabalho que se conecta a uma fonte de dados. Ao abrir o menu Alertas, você pode ver mais informações sobre as falhas de atualização: Quando uma Fonte de dados é listada como Inserida isso significa que a definição da fonte de dados (que inclui coisas como as credenciais da fonte de dados ou o nome do banco de dados) está inserida ou reside dentro da própria pasta de trabalho. Isso também significa que o problema deve ser corrigido no Tableau Desktop. Por exemplo, a fonte do problema pode ser que as credenciais precisem ser inseridas na pasta de trabalho. Quando o nome de uma fonte de dados ou de uma pasta de trabalho é listado como a Fonte de dados (por exemplo, Fonte de dados: sales_data), significa que a fonte de dados é uma Fonte de dados do Tableau Server. A definição da fonte de dados reside no Tableau Server. Quando a pasta de trabalho ou a fonte de dados foi originalmente criada no Tableau Desktop, um ícone do Tableau, e não um ícone de banco de dados, era exibido próximo à fonte de dados, na janela Dados: Às vezes, você pode corrigir um problema de atualização de extração clicando em Editar informações da conexão, inserindo informações não encontradas e clicando em Salvar: Gerenciar assinaturas Assinatura é uma exibição ou pasta de trabalho no Tableau Server da qual os usuários podem receber um instantâneo por e-mail. Quando eles clicarem no instantâneo em seus emails, a exibição ou a pasta de trabalho se abrirá no Tableau Server. Para gerenciar assinaturas, clique em Assinaturas na guia Admin. Requisitos Para que os usuários do Tableau Server recebam assinaturas, é necessário definir o seguinte: l l l l Definição as configurações de e-mail: Como administrador do sistema, você define as configurações básicas do servidor SMTP para assinaturas na guia Alertas de email/assinaturas na caixa de diálogo Configuração, que é exibida durante a Instalação. Essa é a conta remetente que o Tableau Server usa para enviar assinaturas por e-mail para usuários do servidor. Você também pode acessar essa guia após a Instalação. Consulte Reconfigurar o servidor e Configurar assinaturas de e-mail para ver as etapas. Credenciais inseridas ou não exigidas: Da perspectiva do Tableau Server, uma assinatura inclui uma pasta de trabalho, dados e uma agenda. Para fornecer os dados, o Tableau Server precisa ter acesso aos dados sem o envolvimento do usuário final. Isso pode ser feito usando uma pasta de trabalho com credenciais de banco de dados, uma fonte de dados do Tableau Server ou usando dados que não exigem credenciais, como um arquivo que é incluído com a pasta de trabalho no momento da publicação. As pastas de trabalho que solicitam credenciais para conexões de banco de dados ativas não podem ser assinadas. Requisitos do usuário: Se o usuário puder ver uma exibição ou pasta de trabalho no ( ) no canto superior direito, ele poderá assiná-la. A capacidade de ver uma exibição ou pasta de trabalho é controlada pela permissão Exibição. Um usuário também deve ter um endereço de e-mail. Se Tableau Server ainda não tiver um endereço de e-mail para um assinante, ele solicitará um no momento do cadastro da assinatura. Os usuários podem alterar suas opções de entrega, cancelar a assinatura ou atualizar seu endereço de e-mail na página Preferências do usuário. Sem autenticação confiável: Se o Tableau Server estiver configurado para a autenticação confiável, as assinaturas estarão desabilitadas. A autenticação confiável, em combinação com a autenticação local do Tableau, cria uma experiência "sem entrada", mas autenticada, para usuários finais. Para criar essa mesma experiência e usar assinaturas, use o Active Directory (com Habilitar logon automático) como o tipo de autenticação do usuário. Você escolhe o tipo de autenticação do usuário durante a Instalação. Consulte Configurar o servidor para obter os detalhes. Configurações de assinatura adicionais Desde que as assinaturas estejam configuradas na guia Alertas e assinaturas e o Tableau Server esteja usando suas configurações padrão, os usuários do servidor podem assinar as exibições e as pastas de trabalho que veem. Para impedir que os usuários assinem ou personalizem sua experiência de assinatura, vá para: l página dos Sites: Por padrão, as assinaturas são habilitadas para cada site, mas você pode usar a página Sites para desabilitar assinaturas por site ou personalizá-lo. Por exemplo, você pode inserir um Endereço de envio personalizado para assinaturas em vez do especificado na caixa de diálogo Configuração. Você também pode criar seu próprio rodapé para os emails da assinatura que seus usuários recebem. l l Página Agendas: Seus usuários precisarão de pelo menos uma agenda de assinatura para escolher quando assinarem. O Tableau fornece duas por padrão. Como administrador do sistema, você pode criar agendas adicionais ou remover as padrão. Consulte Criar ou modificar um agendamento para obter detalhes. Página Assinaturas: Essa página lista todas as assinaturas no servidor ou, se você for administrador do site, no site. Os administradores do sistema podem alterar a agenda da assinatura de um usuário do servidor ou excluir a assinatura. Consulte os tópicos abaixo para obter detalhes. Para saber quais são as etapas para testar se você configurou as assinaturas corretamente, consulte Testar sua configuração de assinatura. Se você estiver tendo um problema com assinaturas, consulte Solucionar problemas de assinaturas. Excluir uma assinatura Para excluir uma assinatura, selecione a que você quer remover e clique em Excluir: Editar uma agenda de assinatura Para alterar a agenda para uma assinatura, selecione a assinatura, clique em Editar agenda e selecione uma agenda: Testar sua configuração de assinatura Como administrador, você pode testar se configurou corretamente as assinaturas fazendo o seguinte: 1. Assinar uma exibição. 2. Na página Agendas, selecione a agenda que contém sua assinatura. 3. Clique em Executar agora: 4. Em alguns instantes, sua assinatura deverá aparecer em sua caixa de entrada de email. Solucionar problemas de assinaturas "O instantâneo da exibição neste email não pôde ser renderizado adequadamente." Se você receber uma assinatura com essa mensagem de erro, poderá ser por vários motivos: l l l Credenciais ausentes: Algumas exibições são publicadas com credenciais inseridas. Você pode receber o erro acima se as credenciais inseridas estiverem desatualizadas, ou se a exibição foi publicada novamente sem as credenciais inseridas. Banco de dados temporariamente inativo: Se a exibição tiver uma conexão de banco de dados ativa, e o banco de dados estava temporariamente inativo quando a assinatura era gerada, você poderá receber o erro acima. Tempo limite de processo em segundo plano: Por padrão, o processo em segundo plano que administra as assinaturas tem seu tempo esgotado após 30 minutos. Na maioria dos casos, isso é muito tempo. Entretanto, se o processo em segundo plano estiver manipulando um painel extremamente grande e complexo, esse tempo talvez não seja suficiente. Você poderá verificar a exibição do administrador Tarefas em segundo plano para ver se é esse o caso. Para aumentar o tempo limite, use a opção tabadmin subscriptions.timeout. Não é possível assinar Se você puder ver uma exibição ou pasta de trabalho no Tableau Server e ela tiver um ícone de assinatura ( ) no canto superior direito, você poderá assiná-la. Dois fatores precisam estar presentes para você assinar uma exibição: O Tableau Server precisa estar configurado corretamente (descrito em Gerenciar assinaturas) e a exibição que você está assinando deve ter credenciais inseridas para sua fonte de dados ou não usar credenciais. Exemplos do último item são uma pasta de trabalho que se conecta a uma extração que não está sendo atualizada, ou uma pasta de trabalho cujos dados estão em um arquivo fornecido com a pasta de trabalho no momento da publicação. Inserir credenciais é uma etapa que acontece no Tableau Desktop (consulte a ajuda do Tableau Desktop para obter os detalhes). Sem ícone de assinatura É possível ver uma exibição no Tableau Server, mas não é possível assiná-la. Isso acontece para exibições com conexões de banco de dados ativas, onde você é solicitado a fornecer as credenciais do banco de dados ao clicar pela primeira vez na exibição. Uma assinatura inclui uma exibição (ou pasta de trabalho), dados ou uma agenda. Para fornecer os dados, o Tableau Server precisa das credenciais do banco de dados inseridas ou de dados que não exigem credenciais. Em relação às conexões de bancos de dados ativas, o Tableau Server não tem as credenciais, somente os usuários individuais têm. É por isso que você só pode assinar exibições que não exigem credenciais ou as têm inseridas. Você também pode ver uma exibição, mas não poder assiná-la (sem ícone de assinatura) se o Tableau Server estiver configurado para a autenticação confiável. Consulte Requisitos de assinatura para obter mais informações. Recebimento de assinaturas inválidas ou "corrompidas" Se você configurou assinaturas nas instâncias de teste ou desenvolvimento do Tableau Server além de sua instância de produção, desabilite as assinaturas nas instâncias que não são de produção. Manter as assinaturas habilitadas em todas as instâncias pode resultar em seus usuários recebendo assinaturas que parecem ser válidas, mas não funcionam, ou recebendo assinaturas mesmo que eles as tenham cancelado na exibição ou pasta de trabalho. As assinaturas não chegam ("Erro no envio de e-mail. Não é possível enviar o comando para o host SMTP.") Você pode ver o erro acima no Visualizador de Eventos do Windows se as assinaturas aparecerem como enviadas (de acordo com a exibição de administração Tarefas em segundo plano), mas não estiverem chegando, e seu servidor SMTP estiver usando sessões criptografadas (SSL). Assinaturas são aceitas somente para conexões SMTP não criptografadas. A solução é usar um servidor SMTP não criptografado. Assinar as exibições Se você puder ver uma exibição no Tableau Server e ela tiver um ícone de assinatura ( ) no canto superior direito, seu administrador terá assinaturas configuradas para seu site e você poderá assinar a exibição. Isso significa que, em um intervalo regular, você pode ter um instantâneo da exibição enviado automaticamente para sua caixa de entrada de e-mail, sem precisar entrar no Tableau Server. Você também pode assinar as pastas de trabalho. Em vez de receber uma única exibição, você recebe todas as exibições na pasta de trabalho em um único email. Você pode alterar qual agenda de assinatura está usando ou cancelar a assinatura. Consulte abaixo para obter detalhes. Assinar uma exibição Para assinar uma exibição ou pasta de trabalho: 1. Selecione a página Exibições ou Pastas de trabalho: 2. Clique em uma exibição ou pasta de trabalho. 3. Clique no ícone de assinatura no canto superior direito: 4. Se sua conta do Tableau Server não tiver sido associada a um endereço de email, você será solicitado a fornecer um. Insira seu endereço de email e clique em Avançar. 5. Na próxima caixa de diálogo, selecione uma agenda de assinatura. Por padrão, o Tableau Server fornece uma agenda para todos os dias de manhã e uma agenda para as manhãs de segunda. O administrador do Tableau Server também pode criar agendas de assinatura personalizadas. 6. Em seguida, escolha se você quer assinar uma exibição única (Esta folha) ou a pasta de trabalho inteira (Planilhas na pasta de trabalho) e clique em Assinar. 7. Mais tarde, quando você receber a assinatura por e-mail, clique no instantâneo da exibição e ela será aberta no Tableau Server: Cancelar a assinatura de uma exibição Para cancelar a assinatura de uma exibição ou pasta de trabalho: 1. Acesse sua página Preferências de usuário no Tableau Server clicando no link na parte inferior de um e-mail de assinatura: Você também pode abrir a página Preferências do usuário no menu suspenso do Tableau Server: 2. Ao lado da exibição da qual você quer cancelar a assinatura, marque a caixa de seleção Cancelar assinatura. 3. Clique em Atualizar. Alterar as configurações da assinatura Para alterar a agenda da assinatura: 1. Abra sua página Preferências de usuário: 2. Em Agenda, selecione uma agenda diferente: 3. Clique em Atualizar. Sites Use a página Sites para criar sites independentes para diferentes organizações ou grupos em um único sistema de servidor. As pastas de trabalho, os dados e as listas de usuários de cada site são isolados desses mesmos itens de outros sites. Como administrador do sistema, somente você pode ver cada site e executar ações como criar sites e fazer alterações em todo o sistema. Consulte os tópicos abaixo para obter mais informações: Trabalhar com sites Os tópicos abaixo descrevem aspectos do trabalho com vários sites, como qual tipo de autenticação será usado, bem como coisas que você deve saber sobre licenças de usuário e funções de administrador. Autenticação e credenciais de entrada Todos os sites em um servidor usam a mesma conta Run As e modo de autenticação. Você escolhe ambas as configurações quando instala o Tableau Server. Consulte Geral para obter mais informações. Os usuários que pertencem a mais de um site no mesmo sistema de servidor usam as mesmas credenciais para cada site. Por exemplo, se Jane Silva tiver um nome de usuário jsmith e uma senha “MyPassword” no Site A, ela usará essas mesmas credenciais no Site B. Quando entrar no Tableau Server, ela poderá escolher qual site deseja acessar. O site padrão Para ajudar a fazer transição harmoniosa de um sistema de um único site para um com vários sites, o Tableau Server é instalado com um site chamado Padrão. Se você estiver executando no modo de único site, não será preciso usar explicitamente o Padrão; isso acontece automaticamente. No entanto, caso você adicione um ou mais sites, o Padrão se torna um dos sites nos quais pode entrar quando entra no Tableau Server. O Padrão é diferente dos sites que você adiciona ao sistema nos seguintes aspectos: l l l Ele nunca pode ser excluído, mas, assim como os sites adicionados, ele pode ser renomeado. Ele armazena os exemplos e conexões de dados que são enviados com o Tableau Server. A URL usada para o Padrão não tem uma pasta da Web correspondente denominada “padrão”. Por exemplo, a URL para uma exibição denominada Profits em um site denominado Sales é http://localhost/t/sales/views/profits. A URL para essa mesma exibição no site Padrão seria http://localhost/views/profits. As funções Administrador de site e sistema Existem dois tipos de administrador no Tableau Server: administradores de sistema e administradores de site. Os administradores de sistema podem controlar se os administradores de site podem adicionar e remover usuários na caixa de diálogo Adicionar novo site (ou Editar site): Se a opção Apenas administradores de sistema estiver selecionada, os administradores de site não poderão adicionar, nem remover usuários de site. No entanto, eles ainda poderão gerenciar grupos, projetos, pastas de trabalho e conexões de dados em seus sites. Se a opção Administradores de site e administradores de sistema estiver selecionada (o padrão), os administradores de site poderão executar todas as ações acima e adicionar ou remover usuários. Licenciamento e limites do usuário Os usuários podem pertencer a vários sites, com diferentes direitos de usuário e níveis de licença em cada site. No entanto, um usuário que pertence a vários sites não precisa de uma licença para cada site. Cada usuário do servidor precisa somente de uma licença. Os administradores de sistema podem usar a configuração Quantidade máxima de usuários no site <n> para especificar um limite de usuários de um site. Somente usuários licenciados são contabilizados; os administradores de sistema não são considerados. Por exemplo, se um site tiver 90 usuários licenciados, 20 usuários licenciados e um administrador de sistema, a contagem de usuários será 90. Se a opção Quantidade máxima de usuários no site estiver definida como 100, será possível adicionar mais 10 usuários licenciados. Adicionar ou editar sites Se você for um administrador de sistema, poderá adicionar um site ao Tableau Server ou editar um existente seguindo as etapas abaixo: 1. Abra a página Sites clicando em Sites, em Admin e clique em Adicionar: Ou, se você estiver editando um site, selecione o site que deseja alterar e clique em Editar. Se você não adicionou sites ao Tableau Server, haverá apenas um único site para selecionar: Padrão. 2. Insira um Nome do site e ID do site para o site (se você estiver editando usando o site Padrão, não poderá alterar a ID do site): A letra “t” na URL (por exemplo, http://localhost/t/wsales) não pode ser alterada. Em sistemas de servidor de vários sites, ela aparece na URL de sites diferentes do site padrão. 3. Pastas de trabalho, extrações e fontes de dados consomem espaço de armazenamento no servidor. Selecione Sem limite ou Cota e insira o número de GB desejado como limite. Se você definir uma cota e o site excedê-la, os publicadores serão impedidos de carregar um novo conteúdo até que o site esteja dentro do limite novamente. Os administradores do sistema podem rastrear onde o site é relativo a essa cota usando as colunas Cota de armazenamento e % Cota usada na página Sites. 4. Em seguida, selecione se apenas você, o administrador de sistema, pode adicionar e remover usuários (Apenas administradores de sistema) ou se isso pode ser feito por ambos os tipos de administradores (Administradores de site e administradores de sistema). Se você estiver permitindo que administradores de site adicionem usuários, especifique quantos usuários eles podem adicionar ao site selecionando uma destas opções: l l Até a capacidade do servidor: Para um servidor com licenciamento baseado em usuário, o limite é o número de licenças de posições no servidor disponíveis. Para um servidor com licenciamento baseado no núcleo, não há um limite para o número de usuários que podem ser adicionados. Quantidade máxima de usuários no site <n>: Permite que um administrador de site adicione usuários até um limite especificado por você. Consulte Como trabalhar com sites para obter informações sobre licenciamento e limites de usuário. 5. Selecione Permitir registro de desempenho para permitir que os usuários do site coletem métricas sobre o desempenho das pastas de trabalho, como, por exemplo, a velocidade de carregamento, etc. Além de ter essa caixa de seleção marcada para o site, para começar a gravação, os usuários devem adicionar um parâmetro à URL da pasta de trabalho. Consulte Criar um registro de desempenho para obter mais informações. 6. Em Configurações de assinatura do site, mantenha Habilitar assinaturas selecionado se quiser que os usuários do site possam assinar as exibições. Essa opção só estará visível se você também tiver definido configurações de assinatura na caixa de diálogo Configuração. Você também pode inserir um Endereço de envio personalizado para as assinaturas. Embora o endereço que você inserir deva usar uma sintaxe de endereço de email válida (por exemplo, [email protected] ou noreply@sales), o Tableau Server não exige que ele corresponda a uma conta de email real (alguns servidores de SMTP podem exigir que seja um endereço real, no entanto). 7. Em Rodapé do email, selecione Personalizado e insira qualquer texto que você quiser que apareça acima da URL do Tableau Server em rodapés de assinaturas. Por exemplo, se você inserir este texto: O rodapé do email será semelhante ao seguinte: 8. Clique em OK. Se você estiver adicionando seu primeiro site ao Tableau Server, a guia Admin será alterada. A opção Usuários agora é Todos os usuários, pois pertence a todos os usuários no servidor, e uma categoria Usuários do site é exibida. Adicionar usuários a um site Ao adicionar um site ao Tableau Server, ele se torna um sistema com vários sites, e o que antes era a página Usuários passa a ser duas páginas: Todos os usuários e Usuários do site. Como administrador de sistema, só você pode acessar a página Todos os usuários, que se aplica a todo o sistema do servidor. Ela é o único local em que você pode adicionar usuários a vários sites de uma vez, remover usuários e, se o servidor estiver usando a autenticação local, redefinir senhas de usuários. A página Usuários do site é uma forma simples de ver rapidamente quais usuários estão no site em que você entrou no momento. Você pode adicionar usuários a partir daqui, mas eles só serão adicionados a esse site. O procedimento a seguir descreve como adicionar usuários de Todos os usuários. Há duas abordagens que você pode adotar: Um de cada vez (como descrito abaixo) ou em lotes usando o comando Importar, que depende de um arquivo CSV (como descrito em Importar usuários de um arquivo CSV). Para adicionar um usuário: 1. Na página Todos os usuários, clique no link Adicionar na parte superior da lista de usuários: 2. Insira um Nome de usuário: l l Autenticação local — Se o servidor estiver usando autenticação local, utilizar um endereço de e-mail como o nome de usuário é a melhor maneira de evitar conflitos de nome de usuário (por exemplo, [email protected] e não jsmith). Active Directory— Se você estiver adicionando um usuário do mesmo domínio do Active Directory em que o servidor está sendo executado, poderá digitar o Nome de usuário sem o domínio. O domínio do servidor será adotado. Se houver uma configuração de confiança bidirecional entre o domínio do servidor e outro domínio, você poderá adicionar usuários de ambos os domínios. Na primeira vez que você adicionar um usuário do “domínio fora do servidor”, use o nome de domínio totalmente qualificado com o nome de usuário. Os usuários subsequentes podem ser adicionados usando o apelido do domínio. Por exemplo, adotando um “domínio fora do servidor” de mybiz.lan, digite o primeiro usuário desse domínio como [email protected] ou mybiz.lan\user1. O próximo usuário pode ser inserido usando o apelido do domínio, como user2@mybiz ou mybiz\user2. Observação: Não insira o Nome completo do usuário nesse campo, pois isso pode causar erros durante o processo de importação. 3. Se o servidor estiver usando autenticação local, forneça o seguinte: l Nome completo: digite um nome de exibição para o usuário (p. ex., John Smith). l Senha: digite uma senha para o usuário. l Confirmação: digite a senha novamente. 4. Associação ao site — Selecione de quais sites o usuário deve ser membro. O site em que você entra é selecionado por padrão. 5. Nível de licença e direitos do usuário — Selecione o nível de licença, a função Admin e se o usuário pode publicar pastas de trabalho e fontes de dados. Um usuário que pertence a vários sites pode ter níveis de licença e direitos de usuário diferentes em cada site. Consulte Sobre níveis de licença, Permissões e Sobre direitos do usuário para saber mais. 6. Clique em Adicionar usuário. Excluir sites Os administradores de sistema podem excluir sites que foram adicionados ao Tableau Server. A exclusão de um site também remove pastas de trabalho e fontes de dados que foram publicadas no site, bem como usuários. Se um usuário pertencer a outros sites, eles não serão removidos. Para remover permanentemente um usuário, você precisa usar a página Todos os usuários. Para excluir um site: 1. Abra a página Sites em Servidor: 2. Selecione o site que deseja remover e clique em Excluir: 3. Clique em Sim na caixa de diálogo de confirmação que aparece. Navegação em vários sites Vejamos algumas dicas sobre como navegar de site para site e identificar qual site você está usando. Entrada no site Caso seja membro de vários sites, ao entrar no servidor, você deve escolher um site: Navegação para outros sites Se você pertence a vários sites, verá um menu Site no alto da página: Para entrar em um site diferente, clique no menu Site e selecione o site: Identificação de seu site Caso o servidor esteja executado vários sites, mas você pertença a apenas um, você não precisa escolher seu site na entrada no servidor. Depois de entrar, você não verá um menu Site no alto da página: No entanto, a URL do navegador da web mostrará um t seguido pela ID do site referente ao seu site: Se o servidor não estiver executando vários sites, a URL do navegador da web será semelhante a isto (sem t, sem ID do site). Se você vir isto, estará usando o site interno do Tableau, que é chamado de Padrão. Manutenção do servidor Como um administrador do sistema, você desejará verificar o status do servidor, analisar e monitorar a atividade no servidor, gerenciar tarefas agendadas ou executar determinadas atividades de manutenção, como recriar o índice de pesquisa. Além disso, existem várias configurações que talvez você queira especificar para personalizar a experiência do usuário para pessoas que usam o servidor. Isso tudo isso pode ser feito na página Manutenção. Exibir o status de processo do servidor Você pode usar a tabela Status na página Manutenção para exibir o estado dos processos do Tableau em cada Tableau Server: Para obter informações sobre o status não licenciado de um processo do VizQL Server, consulte Manipular um processo do VizQL Server não licenciado. Para exibir uma versão das informações acima que possa ser lida pelo computador, na página Manutenção, substitua a palavra status na sua URL por systeminfo (por exemplo, http://jsmith/admin/systeminfo). Uma página da Web semelhante à página a seguir aparece: Os tipos de status para um serviço do Tableau são OK, Ocupado, Inoperante e Standby. Acessar o status remotamente Como administrador do Tableau, somente você pode ver as ferramentas na página Manutenção, incluindo a tabela Status. No entanto, você pode disponibilizar a versão da tabela Status que pode ser lida pelo computador para usuários não administrativos e a computadores que não estejam hospedando o Tableau Server, por exemplo, como parte de um processo de monitoramento remoto. Para conceder acesso remoto ao status do serviço do Tableau: 1. No computador que está executando o Tableau Server, abra o arquivo config do Tableau Server: ProgramData\Tableau\Tableau Server\config\tabsvc.yml 2. Adicione a linha wgserver.systeminfo.allow_referrer_ips: <IP address or name> para tabsvc. yml, em que <IP address or name> é o endereço IPv4 ou o nome do computador que você gostaria de adicionar. Caso você esteja concedendo acesso de status de serviço a vários computadores, use vírgulas (sem espaços) para separar cada entrada. IP. Por exemplo: 3. Salve e feche tabsvc.yml. 4. Abra um prompt de comando como um administrador e digite: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 5. Em seguida, use o comando a seguir para reiniciar os processos do Tableau Server: tabadmin restart Agora, usuários em computadores cujos endereços IP ou nomes de computador tenham sido adicionados a tabsvc.yml podem exibir o status do processo do Tableau digitando a URL http://<server>/admin/systeminfo em um navegador ou em uma linha de comando (por exemplo, curl http://jsmith/admin/systeminfo). Essa funcionalidade também pode ser usada como parte de um processo de monitoramento remoto automatizado. Recompilar o índice de pesquisa Se por qualquer motivo o índice de pesquisa parar de retornar os resultados corretos ou não apresentar todos os resultados, talvez seja preciso recriar o índice de pesquisa. Além disso, você deverá recriar o índice de pesquisa se o indexador for desativado por um longo período. 1. Para recompilar o índice de pesquisa clique em Manutenção na guia Admin: 2. Clique em Recompilar índice de pesquisa para começar. Limpar senhas de conexão de dados salvas Como administrador, se você habilitar a configuração Senhas salvas, os usuários do servidor poderão salvar senhas de fonte de dados em vários navegadores e visitas. Você pode redefinir todas as senhas de todos os usuários do Tableau Server, o que os força a entrar nas fontes de dados na próxima vez em que visitarem uma exibição que exija autenticação do banco de dados. Os usuários do servidor também podem limpar suas senhas de conexão de dados salvas individualmente usando a página Preferências de usuário. Para limpar senhas de conexão de dados salvas de todos os usuários do servidor: 1. Clique no link Manutenção na seção Administração no lado esquerdo da página: 2. Em Atividades, clique em Limpar todas as senhas de conexão de dados salvas para todos os usuários. Configurações de manutenção As configurações a seguir estão disponíveis na seção Configurações da página Manutenção no servidor: Configuração Descrição Credenciais inseridas Permite que os publicadores anexem senhas a pastas de trabalho publicadas que autenticarão automaticamente usuários da Web para se conectarem às fontes de dados. As senhas são anexadas às pastas de trabalho e só podem ser acessadas no servidor. Isto é, quando a pasta de trabalho é aberta no Tableau Desktop, os usuários ainda precisarão inserir um nome de usuário e uma senha para se conectarem à fonte de dados. Quando essa configuração é desativada, todas as senhas inseridas existentes são salvas, mas não são usadas para autenticação. Dessa forma, se você ativar novamente a configuração, os usuários não precisarão reinserir as senhas. Agendamento Permite que os publicadores atribuam pastas de trabalho a agendas. Essa opção só estará disponível se Credenciais inseridas estiver habilitada. Quando essa configuração for desabilitada, os publicadores verão opções de agendamento na caixa de diálogo Publicar. Permite que os usuários salvem senhas de fonte de dados em vários navegadores e visitas. Por padrão, os usuários podem optar por "Lembrar minha senha até eu sair", que os permite salvar suas senhas durante uma sessão de navegador única. Quando a configuração Senhas salvas é selecionada, um usuário pode optar por Lembrar Senhas salvas minha senha, que salva a senha em vários navegadores e visitas, de modo que os usuários serão autenticados automaticamente, independentemente do computador que estejam usando. Você, como um administrador, pode limpar todas as senhas salvas a qualquer momento. Além disso, os usuários podem limpar suas próprias senhas salvas. Habilitar convidado Permite que os usuários exibam e interajam com exibições inseridas sem precisar entrar em uma conta do Tableau Server. A permissão pode ser atribuída à conta de usuário convidado para controlar a interatividade permitida para cada exibição. Essa opção estará disponível somente se você tiver uma licença de servidor baseada em núcleo. Esta opção pode ser usada com Habilitar logon automático, uma opção que você pode selecionar durante a Instalação. Página inicial padrão Leva você à página inicial padrão atual do servidor para todos os usuários. Consulte Definir a página inicial padrão para todos os usuários para ver as etapas sobre como alterá-la. Usuários individuais poderão substituir essa configuração (consulte Sua página Preferências de usuário para obter detalhes). Idioma e localidade padrão Controla o idioma usado para a interface de usuário do servidor e a localidade usada para exibições. Usuários individuais podem substituir essa configuração em sua página Preferências do usuário. Além disso, as configurações do navegador da Web são o primeiro item usado para determinar qual idioma e localidade serão usados. Consulte Idioma e localidade para obter mais informações. Redefinir todas as configurações Qualquer configuração de servidor que tenha sido alterada desde a para seus Instalação será retornada ao seu estado original. valores padrão Definir a página inicial padrão para todos os usuários Por padrão, o Tableau Server é instalado com a página Exibições como a página inicial padrão para todos os usuários. Como administrador, você pode alterar essa página para outra que todos os usuários possam acessar, como a página Pastas de trabalho. Usuários individuais poderão substituir sua configuração (consulte Sua página Preferências de usuário para obter detalhes). Para definir a página inicial padrão para todos os usuários: 1. Navegue até a página que você quer definir como padrão. 2. Clique em seu nome no canto superior direito da página. 3. Selecione Tornar esta a página inicial padrão para todos os usuários. Tableau Server Monitor O Tableau Server Monitor é instalado como parte do Tableau Server e pode ser acessado na bandeja do sistema do Windows. Usando essa ferramenta, é possível iniciar e interromper o servidor, abrir o Tableau Server e exibir o status do servidor. Abrir o servidor Esse comando inicia o Tableau Server no navegador da Web. Essa é uma maneira fácil de acessar o aplicativo Web e as ferramentas de manutenção associadas. Iniciar/interromper o servidor Você pode iniciar e interromper o servidor usando esses comandos. Quando você interrompe o servidor, ele se torna indisponível para todos os usuários e encerra qualquer sessão que esteja atualmente em andamento. Se alguém estiver publicando uma pasta de trabalho quando o servidor for interrompido, o processo será abandonado. Como resultado, somente algumas das planilhas na pasta de trabalho podem ser publicadas no servidor. Como interromper o servidor pode atrapalhar bastante os usuários, certifique-se de avisá-los antes de executar essa operação ou planeje a manutenção para que ela ocorra em horários não comerciais. Reiniciar o servidor Esse comando reinicia o servidor. Enquanto o servidor estiver reiniciando, ele estará indisponível a todos os usuários. Não se esqueça de avisar os usuários da paralisação antes dessa operação. Será preciso reiniciar o servidor se você fizer alterações na configuração do Tableau Server. Exibir status Esse comando abre uma dica de tela que contém o status de cada processo. Para obter mais detalhes de status, use a página Manutenção. Gerenciar chaves de produto Esse comando abre o gerenciador de chaves de produto, onde é possível adicionar e remover chaves de produto. Sair Esse comando fecha o Tableau Server Monitor. Ele não interrompe o Tableau Server. Você pode reabrir o aplicativo selecionando Todos os Programas > Tableau Server 8.1 > Tableau Server Monitor no menu Iniciar do Windows. Fontes de dados Uma fonte de dados do Tableau Server é uma conexão com dados reutilizável. Ela pode incluir uma extração de dados ou informações de uma conexão de passagem para um banco de dados relacional ativo. Também pode incluir uma camada de personalizações, como cálculos, grupos ou conjuntos.Tableau Server Os usuários com as permissões apropriadas podem usar uma fonte de dados para criar pastas de trabalho do zero no servidor. Consulte Criar uma pasta de trabalho e criar uma exibição para obter detalhes. Os administradores podem executar duas tarefas principais na página Fontes de dados: l Editar e exibir permissões de fonte de dados: Use permissões para especificar quais usuários ou grupos podem se conectar a fontes de dados, modificá-las e baixálas. Consulte Definição de permissões para uma fonte de dados para obter mais informações. l Agendar extrações de fonte de dados para atualização: Se uma fonte de dados inclui uma extração, você pode atribuir a extração para uma agenda de atualização. Consulte Agendamento de tarefas para obter mais informações. Embora ambas as tarefas acima possam ser executadas no Tableau Desktop pela pessoa que publicou a fonte de dados, os administradores também podem alterar as configurações. Também é possível usar a página Fontes de dados para remover uma fonte de dados ou adicionar marcas a ela. Consulte os tópicos abaixo para obter mais informações. Gerenciar fontes de dados Para que os usuários trabalhem com as fontes de dados do Tableau Server, eles precisam ter as permissões apropriadas para a fonte de dados. Para fontes de dados que são conexões proxy, você também deve estar ciente de como os usuários serão autenticados no banco de dados e saber se você tem os drivers apropriados instalados no Tableau Server. Para obter informações, veja a seguir. Definir permissões para uma fonte de dados Drivers de banco de dados Segurança de dados Sobre o Data Server do Tableau O Data Server do Tableau é um componente de servidor que permite gerenciar e armazenar centralmente as fontes de dados do Tableau Server. Uma fonte de dados é uma conexão com dados reutilizável. Os dados podem ser localizados no processador de dados do Tableau, como uma extração, ou em um banco de dados relacional dinâmico (cubos não têm suporte). No segundo caso, as informações armazenadas na fonte de dados se destinam a uma conexão de passagem. A fonte de dados também pode incluir personalizações feitas no nível de campo no Tableau Desktop, como cálculos, aliases de dimensão, grupos ou conjuntos. Para administradores, há muitas vantagens em usar as fontes de dados do Tableau Server. Como uma extração de fonte de dados pode ser usada por muitas pastas de trabalho, você economiza espaço no servidor e tempo de processamento. As atualizações da extração podem ser agendadas por extração, e não por pasta de trabalho, e quando uma pasta de trabalho que usa uma fonte de dados do Tableau Server for baixada, a extração de dados permanecerá no servidor, resultando em menos tráfego de rede. Por fim, se um driver do banco de dados for exigido para uma conexão, você só precisará instalá-lo uma vez, no Tableau Server, e não várias vezes em todos os desktops dos usuários. Para usar o Data Server, basta que os autores se conectem a dados no Tableau Desktop, seja criando uma extração ou por uma conexão com o banco de dados relacional ativo, e que publiquem isso no Tableau Server. Uma vez publicadas, essas fontes de dados reutilizáveis e o servidor contêm tudo que os autores da pasta de trabalho precisam para se conectarem aos dados rapidamente e iniciar a criação.Para alterar uma fonte de dados publicada, baixe-a no Tableau Desktop, faça as alterações e republique-a, substituindo a versão original. Observe que os membros novos adicionados a um parâmetro ou as alterações feitas na ordem de classificação padrão não farão parte da fonte de dados (farão parte da pasta de trabalho). Se você estiver executando uma instalação distribuída do Tableau Server e espera que as fontes de dados sejam usadas continuamente, existem várias maneiras de otimizar a implantação do seu servidor. Consulte Ambientes distribuídos para obter mais informações. Usar fontes de dados Se você for autor de uma pasta de trabalho, usar uma fonte de dados do Tableau Server é simplesmente uma questão de se conectar a ela a partir do Tableau Desktop. Na página Conectar a dados do Tableau Desktop, clique em Tableau Server e forneça suas credenciais: Depois que você entra no Tableau Server, as fontes de dados disponíveis são listadas à direita. Para ver uma fonte de dados, a pessoa que a publicou precisa ter definido a permissão Conectar como Permitir para você como um usuário. Por padrão, todos os usuários têm essa permissão. Selecione uma fonte de dados e ela será carregada na janela Dados da pasta de trabalho. Tableau Server fontes de dados têm um ícone do Tableau em vez de um ícone de banco de dados: Para obter mais informações sobre a publicação de fontes de dados do Tableau Desktop, consulte Publicar fontes de dados na ajuda on-line do Tableau Desktop. Solucionar problemas de fontes de dados Para que os usuários trabalhem com as fontes de dados do Tableau Server, até três itens precisa ser definidos: l l Permissões para a fonte de dados: Qualquer pessoa que for se conectar a uma fonte de dados deve ter as permissões Conectar e Exibir para essa fonte. Isso também se aplica a usuários que acessam exibições que se conectam a fontes de dados. Qualquer pessoa que esteja publicando e modificando fontes de dados deve estar licenciada para Publicar e também ter as permissões Baixar/salvar na Web como e Baixar/salvar na Web como. Consulte Trabalhar com permissões e Definir permissões para uma fonte de dados para obter mais informações. Capacidade de autenticação no banco de dados: Há várias maneiras de se conectar aos dados no Tableau e controlar quem tem acesso a quê. Basicamente, qualquer entidade que esteja se conectando ao banco de dados deve ser capaz de se autenticar. A entidade pode ser o Tableau Server executando uma atualização de extração. Pode ser um usuário do Tableau Desktop se conectando a uma fonte de dados que então se conecta a um banco de dados dinâmico. Também pode ser um usuário do Tableau Server que está acessando uma exibição que se conecta a um banco dedados ativo. Consulte Segurança de dados para saber mais sobre suas opções. l Drivers de banco de dados: Se a pessoa que criou e publicou a fonte de dados no Tableau Desktop precisou instalar drivers de bancos de dados adicionais, talvez você precise instalá-los também no Tableau Server. Se você estiver executando uma instalação distribuída do Tableau Server onde, por exemplo, o processo do data server está sendo executado em um servidor de trabalho, todos os drivers de banco de dados necessários devem ser instalados nesse servidor, bem como no servidor primário. Outros processos também requerem drivers. Consulte Drivers de banco de dados para obter mais informações. Mensagens de erro da fonte de dados Veja aqui alguns erros que os autores da pasta de trabalho e outros usuários podem encontrar enquanto trabalham com fontes de dados e exibições: A permissão para acessar esta fonte de dados do Tableau Server foi negada: A conexão com uma fonte de dados exige a permissão Conectar. Consulte Trabalhar com permissões e Definir permissões para uma fonte de dados para obter mais informações. Fonte de dados não encontrada: Alguém que estiver trabalhando com uma exibição poderá ver esse erro se uma fonte de dados for removida do Tableau Server ou se a página Conectar a dados precisar ser atualizada. Para atualizar a página Conectar a dados no Tableau Desktop, clique no ícone Atualizar: Não é possível conectar a esta fonte de dados do Tableau Server: Esse erro pode aparecer se as informações de conexão para a fonte de dados forem alteradas, por exemplo, em resultado da alteração do nome do servidor de banco de dados. Observe as informações de Conexão de dados da fonte de dados e verifique se as configurações estão corretas. Não é possível listar fontes de dados do Tableau Server: Esse erro poderá ocorrer se um usuário estiver tentando acessar as fontes de dados do Tableau Server e houver problemas de conectividade entre o Tableau Server e o Tableau Desktop. Não é possível conectar a uma fonte de dados de cubo: Não há suporte de conexões a fontes de dados de cubos (como MSAS). Os dados precisam ser uma extração ou uma conexão ativa a um banco de dados relacional. Conexões de dados Cada pasta de trabalho que é publicada no Tableau Server contém uma ou mais conexões. Essas conexões são listadas na guia Admin, na página Conexões de dados: A diferença entre Conexões de dados e Fontes de dados As conexões de dados são diferentes das fontes de dados já que cada conexão é associada a uma única pasta de trabalho e descreve os atributos exigidos para conexão com uma fonte de dados (por exemplo, nome de servidor, nome do banco de dados, etc.). Isso significa que se você tiver três pastas de trabalho que se conectam à mesma fonte de dados, existirão três conexões listadas na página de conexões. Pesquisa de conexões de dados A área Pesquisar na parte superior da página Conexões de dados ajuda você a localizar conexões por nome do servidor de banco de dados, nome de usuário, porta, tipo de conexão geral e credenciais de banco de dados inseridas ou não. Para usar essa área para pesquisar uma conexão, preencha uma ou mais áreas e clique em Pesquisar: Que conexões eu posso editar? Você pode editar informações de conexão para conexões de banco de dados ativas e para extrações que precisam ser atualizadas pelo Tableau Server. Por exemplo, é possível ter um grande número de pastas de trabalho que se conectam a um banco de dados em um servidor de banco de dados específico. Se o nome do servidor for alterado, você poderá atualizar todas as pastas de trabalho de uma vez para que elas façam referência ao novo nome do servidor. Outro exemplo é se uma pasta de trabalho se conectar a um banco de dados usando um nome de usuário e uma senha específicos. É possível atualizar rapidamente todas as pastas de trabalho para usar um conjunto diferente de credenciais. Para obter detalhes sobre como editar conexões de dados, consulte o tópico abaixo. Editar conexões de dados Use a página Conexão de dados para gerenciar as informações de conexão de todas as pastas de trabalho publicadas no servidor ou em um site. Para modificar atributos de conexão: 1. Se você estiver executando vários sites no servidor, conecte-se ao site que tem as conexões de dados que deseja modificar. Navegue até a página Conexões de dados. 2. Use a caixa de pesquisa na parte superior da lista de conexões para encontrar as conexões a serem editadas. Você pode procurar por Servidor, Tipo de conexão, Porta do servidor, Nome de usuário do banco de dados e pela opção Tem senha inserida. Os valores digitados nos campos Servidor e Nome de usuário do banco de dados são tratados como expressões regulares. 3. Selecione as conexões a serem modificadas na lista de resultados da pesquisa: 4. Digite um novo valor para um ou mais dos atributos de conexão. Se um banco de dados ou um driver de banco de dados não aceitar conexão via endereço IP, o valor especificado para Servidor deverá ser o nome do banco de dados. Todos os atributos selecionados na coluna Alterar? serão atualizados. Se você marcar a caixa de seleção Alterar? e deixar o campo Novo valor em branco, o atributo também será definido como em branco. 5. Clique em Enviar. 6. Atualize a página do servidor (pressione F5) para que suas alterações entrem em vigor. Monitorar andamento Uma caixa de diálogo do monitor é aberta automaticamente quando você observa o andamento das alterações. Se você fechar essa caixa de diálogo, as modificações serão executadas em segundo plano até serem concluídas. Tableau Server fará o maior número de alterações possível. Todas as falhas serão ignoradas, mas não impedirão que outras alterações sejam feitas. Por exemplo, se você tentar alterar o nome do servidor e adicionar uma senha a várias conexões, os nomes de servidor serão alterados e as senhas nas pastas de trabalho também, mas como não é possível adicionar uma senha a uma fonte de dados, as senhas para as fontes de dados não serão alteradas. Há uma exibição administrativa que permite revisar detalhes de tarefas concluídas e pendentes. Consulte Tarefas em segundo plano para saber mais. Personalizar o servidor É possível personalizar a aparência do Tableau Server para sua empresa ou seu grupo. Por exemplo, você pode alterar o nome que aparece nas dicas e mensagens de tela, bem como alterar o logotipo que aparece na maioria das páginas do servidor. Também é possível personalizar como os usuários podem interagir com o servidor. Por exemplo, você pode permitir que os editores da pasta de trabalho insiram as respectivas credenciais de fonte de dados para que quando as pessoas cliquem em uma exibição publicada com uma conexão a uma fonte de dados ativa, elas obtenham acesso imediato à exibição e não tenham que fornecer as respectivas credenciais de banco de dados primeiro. Também é possível controlar que idioma será usado para a interface de usuário do servidor e qual localidade será usada para as exibições. Consulte os tópicos a seguir para obter mais informações sobre como personalizar o Tableau Server: Alterar o nome ou o logotipo É possível personalizar os seguintes aspectos da aparência do Tableau Server: Alterar o nome Você pode personalizar a aparência do Tableau Server personalizando o nome que aparece nas dicas de ferramenta e mensagens. Por exemplo, se você alterar o nome para MyCo, o texto na página Logon do servidor será "Digite seu nome de usuário e a senha do MyCo para fazer logon," e a dica de ferramenta do ícone de navegação da página inicial exibirá Início do MyCo em vez de Início do Tableau Server: As informações de copyright no final de cada página do servidor ainda listarão Tableau (por exemplo, ©2013, Tableau Software, Incorporated e seus licenciadores. Todos os direitos reservados.) Para alterar o nome que aparece nas dicas de ferramenta e mensagens: 1. Abra um prompt de comando como um administrador e digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Altere o nome digitando o seguinte: tabadmin customize name "new_name" Na linha acima, substitua "new_name" pelo texto que você quer que apareça como o nome no servidor. Exemplo: tabadmin customize name "Company Server" 3. Reinicie o servidor para que a alteração entre em vigor digitando: tabadmin restart Alterar o logotipo É possível personalizar a aparência do Tableau Server personalizando o logotipo que aparece na página de logon do Tableau Server e na coluna esquerda das páginas principais do servidor (como a página Projetos, página Pastas de trabalho, página Manutenção, etc.). O tamanho de logotipo grande aceito é de até 160 x 160 px e é implementado com a execução do comando tabadmin customize logo. Também é possível personalizar o logotipo que aparece no canto superior esquerdo de cada pasta de trabalho e exibição. O tamanho de logotipo pequeno aceito é de até 32 x 32 px e é implementado com a execução do comando tabadmin customize smalllogo. Se uma imagem for maior que 160 x 160 px (logotipo grande) ou 32 x 32 px (logotipo pequeno), ela aparecerá cortada. O arquivo de imagem que você usa deve estar no formato GIF, JPEG ou PNG. O logotipo do Tableau que aparece na guia do navegador da Web do servidor e à esquerda do endereço da URL não pode ser alterado. Para alterar o logotipo: 1. Abra um prompt de comando como um administrador e digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Altere o logotipo digitando o seguinte para um logotipo "tamanho grande" (até 160 x 160 px, mas não menor que 32 x 32 px): tabadmin customize logo "C:\My Pictures\logo.png" Se seu logotipo tiver o tamanho 32 x 32 px ou menor, use o seguinte comando: tabadmin customize smalllogo "C:\My Pictures\logo.png" 3. Reinicie o servidor para que a alteração entre em vigor digitando: tabadmin restart Restaurar o nome ou o logotipo padrão Você pode restaurar a aparência padrão do Tableau Server seguindo os passos a seguir: 1. Abra um prompt de comando como um administrador e digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Altere o logotipo digitando o seguinte: tabadmin customize <parameter> -d Na linha acima, substitua <parameter> pelo item que deseja restaurar, name ou logo. 3. Reinicie o servidor para que a alteração entre em vigor digitando: tabadmin restart Idioma e localidade O Tableau Server está localizado em vários idiomas e tem configurações de idioma e localidade que podem ser definidas por usuário (consulte Sua página Preferências de usuário) e para todo o sistema (consulte Configurações de manutenção). A definição de Idioma controla itens de UI (interface de usuário), como menus e mensagens. A definição de Localidade controla itens nas exibições, como formatação de número e moeda. Configurações padrão O Tableau Server obtém sua configuração padrão de idioma durante a instalação. Se o computador host for definido para um idioma ao qual o Tableau Server oferece suporte, ele será instalado com esse idioma. Se não for um idioma com suporte, o Tableau Server será instalado em inglês. Como o idioma e a localidade são determinados Outra influência em que idioma e localidade são exibidos quando um usuário clica em uma exibição é o navegador da Web do usuário. Se um usuário do servidor não tiver especificado uma definição de Idioma na página Conta de usuário e o navegador da Web for definido para um idioma com suporte do Tableau Server, o idioma do navegador será usado, mesmo se o próprio Tableau Server estiver definido para um idioma diferente. Vejamos um exemplo: Suponhamos que o Tableau Server tenha uma configuração que abranja todo o sistema definindo Inglês como o Idioma para todos os usuários. O usuário do servidor, Claude, não tem um idioma especificado na sua página Conta de usuário do Tableau Server. O navegador de Claude usa Alemão (Alemanha) para seu idioma/localidade. Quando Claude entra no Tableau Server, a UI do servidor é exibida em alemão e quando ele clica em Exibição A, é usada a localidade Alemanha para números e moeda. Se Claude tivesse definido Idioma e Localidade da sua conta de usuário para Francês (França), a UI e a exibição teriam sido exibidas em francês. A definição da sua conta de usuário substitui as definições do navegador da Web e ambas têm preferência sobre a configuração de todo o sistema do Tableau Server. Outra definição que precisa ser lembrada é a de Localidade no Tableau Desktop (Arquivo > Localidade da pasta de trabalho). Essa definição determina a localidade dos dados na exibição, como qual moeda é listada ou como os números são formatados. Por padrão, Localidade no Tableau Desktop é definida como Automática. No entanto, um autor pode substituir isso selecionando uma localidade específica. Usando o exemplo acima, se o autor da Exibição A definisse Localidade para Grego (Grécia), determinados aspectos dos dados na Exibição A seriam exibidos usando a localidade Grego (Grécia). Veja as configurações que o Tableau usa para determinar o idioma e a localidade, na seguinte ordem de preferência: 1. Localidade da pasta de trabalho (definida no Tableau Desktop) 2. Configurações de idioma/localidade da Conta de usuário do Tableau Server 3. Idioma/localidade do navegador da Web 4. Configurações de idioma/localidade da página Manutenção do Tableau Server 5. Configurações de idioma/localidade do computador host Exibições administrativas O Tableau Server apresenta várias exibições para administradores, desenvolvidas com o intuito de ajudar a monitorar a atividade no Tableau Server. As exibições estão localizadas a tabela Análise da página Manutenção: Consulte o seguinte para obter mais informações: Atividade do do servidor A exibição administrativa Atividade do servidor mostra um instantâneo da atividade do Tableau Server durante os últimos 30 dias. Em Total de exibições ao longo do tempo, você pode focalizar em qualquer ponto da linha e ver uma dica de ferramenta que mostra o número de exibições que foram abertas nesse dia, além de outras informações: Clique em um ponto na linha para atualizar os gráficos de barras para mostrar quais pastas de trabalho foram visualizadas nesse dia e quem visualizou mais: Selecionar a marca em Total de exibições ao longo do tempo também filtra o Padrão de exibição total de 24 horas para mostrar o padrão de exibição desse dia específico. Se nenhuma marca for selecionada em Total de exibições ao longo do tempo, o Padrão de exibição total de 24 horas somará os dados em Total de exibições ao longo do tempo e os exibirá em um período de 24 horas, para que você possa ver os padrões comuns no período de um dia: Atividade do usuário A exibição Atividade do usuário pode ajudar a medir a intensidade da utilização da instalação do Tableau Servere se você precisa comprar licenças adicionais. Especificamente, essa exibição mostra para você quem entrou no Tableau Server, de onde e quando foi a última vez em que ele interagiu com o servidor. Se um usuário entrar usando vários navegadores, isso também será mostrado. Por exemplo, caso um usuário entre uma vez usando o Internet Explorer e uma vez usando o Mozilla Firefox, o nome desse usuário é exibido duas vezes. Mas, caso um usuário entre duas vezes usando o Mozilla Firefox, o nome dele é exibido apenas uma vez. Atualmente ativo significa que o usuário interagiu com o servidor durante os últimos cinco minutos. Recentemente ativo indica que o usuário estava ativo entre os últimos cinco e 15 minutos; e Ocioso significa que não houve atividade do usuário nos últimos 15 minutos. Por padrão, depois de quatro horas de inatividade, os usuários saem do Tableau Server. Você pode alterar essa configuração usando a opção tabadmin Opções tabadmin set. Na exibição Atividade detalhada do usuário, os círculos indicam uma ação como, por exemplo, entrar ou filtrar uma exibição. As barras incluem o período total no qual houve atividade. Para saber mais, basta focalizar uma área e uma dica de ferramenta será exibida: Histórico do desempenho Use Exibir histórico do desempenho para ver quais exibições são as mais caras em termos de desempenho de servidor. Há duas solicitações diferentes associadas a exibições: solicitações de carga inicial, em laranja, e solicitações de cálculo, em azul. As últimas fazem com que o Tableau Server recalcule o que o usuário está vendo. Isso inclui solicitações de recarga, bem como seleção e filtragem de itens em uma exibição. As máscaras de exceções representam solicitações com maior impacto no desempenho do servidor: Tarefas em segundo plano A exibição Tarefas em segundo plano mostra as tarefas executadas pelo servidor. As tarefas mais comuns são aquelas associadas às ações do usuário. Elas são selecionadas por padrão em Tipo de tarefa: As tarefas podem ter um status de conclusão bem-sucedida, erro, em andamento ou pendente: Ícone Descrição Erro: o servidor não pôde concluir a tarefa. Êxito: o servidor concluiu a tarefa. Em andamento: o servidor está concluindo a tarefa no momento. Pendente: uma tarefa que o servidor ainda não começou. Para obter detalhes sobre uma máscara, focalize seu ícone: Tableau Server pode executar vários processos em segundo plano paralelamente. Os endereços IP em ID de segundo plano na exibição Tarefas em segundo plano mostram quais máquinas foram designadas para executar processos em segundo plano: Uma máquina com vários núcleos executando mais de um processo em segundo plano será listada com <IP address>:0 para o primeiro processo, <IP address>:1 para o segundo e assim por diante. Utilização do espaço A exibição Utilização do espaço pode ajudar a identificar quais pastas de trabalhos e fontes de dados estão usando mais espaço em disco no servidor. A utilização do espaço em disco é exibida por usuário, projeto e tamanho da pasta de trabalho ou fonte de dados e é arredondada para o número inferior mais próximo. Mova o cursor sobre qualquer barra de tamanho para exibir detalhes da utilização: Você também pode analisar os links na dica de ferramenta. Por exemplo, você pode ir aos detalhes do usuário e ver a pasta de trabalho. Exibições personalizadas As pessoas que trabalham com exibições podem usar a opção Lembrar minhas alterações para salvar as respectivas exibições personalizadas e os editores podem permitir ou impedir o compartilhamento das exibições personalizadas. A exibição administrativa Exibições personalizadas lista todas as exibições no servidor que foram personalizadas com Lembrar minhas alterações. Ela pode ser usada como um indicador da popularidade ou importância da exibição. Criar exibições administrativas personalizadas Além das exibições administrativas predefinidas disponíveis na página Manutenção do Servidor, você pode usar o Tableau Desktop para consultar e criar suas próprias análises de atividade do servidor. O repositório do Tableau Server tem várias exibições de banco de dados configuradas, às quais você pode se conectar e fazer consultas. A opção tabadmin auditing.enabled controla se o Tableau Server coleta atividades de histórico do usuário e outras informações no repositório. Ela é habilitada por padrão. A opção tabadmin wgserver.audit_history_expiration_days controla quantos dias do histórico de eventos são mantidos no repositório. Por padrão, isso é definido para 183 dias. Um aspecto a ser observado é que a coleta de eventos de histórico não afetam o tamanho do arquivo de backup do Tableau Server (.tsbak). Para acessar essas exibições, primeiramente é preciso usar a ferramenta de linha de comando para habilitar o acesso externo ao banco de dados do Tableau Server. Em seguida, é preciso se conectar ao banco de dados do Tableau Server e consultá-lo. Como habilitar o acesso externo ao banco de dados do Tableau Server O repositório do Tableau Server tem várias exibições de banco de dados configuradas, às quais você pode se conectar e fazer consultas como parte da criação de suas próprias análises da atividade do Tableau Server. Para acessar essas exibições, primeiramente é preciso usar o utilitário de linha de comando tabadmin de modo a habilitar o acesso externo ao banco de dados. 1. Abra um prompt de comando como um administrador e digite: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Em seguida, use o comando a seguir a fim de habilitar o acesso externo ao banco de dados para o usuário "tableau" com uma senha especificada por você. tabadmin dbpass [password] Substitua a opção [password] por sua própria senha. Por exemplo: tabadmin dbpass P@ssw0rD! 3. Reinicie o Tableau Server. Depois de habilitar o acesso externo ao banco de dados, o Tableau permite que qualquer endereço IP acesso o banco de dados, contanto que a senha correta seja fornecida. Siga as etapas descrita em Conexão com o banco de dados do Tableau Server para conectar. Para desabilitar o acesso externo mais tarde, execute tabadmin dbpass --disable e reinicie o servidor. Conexão com o banco de dados do Tableau Server Após habilitar o acesso externo com o banco de dados do Tableau Server, siga as etapas abaixo para se conectar ao banco de dados e consultá-lo. 1. No Tableau Desktop, selecione Dados > Conectar a dados e selecione PostgreSQL como o banco de dados ao qual se conectar. Talvez seja preciso instalar drivers de banco de dados PostgreSQL. Você pode baixar drivers do site www.tableausoftware.com/drivers. 2. Na caixa de diálogo Conexão PostgreSQL, digite o nome ou a URL do Tableau Server. Se você tiver uma instalação de servidor distribuída e um trabalho estiver hospedando o repositório, insira o nome do trabalho. Você deve se conectar usando a porta configurada para o pgsql.port, que é 8060, por padrão. Para obter mais informações sobre portas, consulte Portas TCP/IP. 3. Digite workgroup como o banco de dados ao qual se conectar. 4. Conecte-se usando o seguinte nome de usuário e senha: Nome de usuário: tableau Senha: A senha que você especificou quando habilitou o acesso ao banco de dados do Tableau Server. 5. Clique em Conectar. 6. Selecione uma ou mais tabelas para conectar. O usuário "tableau" tem acesso a todas as tabelas que começam com um sublinhado e hist_. Por exemplo, é possível se conectar a _background_tasks e _datasources. As tabelas que começam com historical_ apontam para tabelas hist_. As tabelas hist_ contêm informações sobre os usuários do servidor que não são apresentadas na exibição Atividade do usuário. 7. Clique em OK. Editar e criar exibições Os usuários com as credenciais apropriadas para o ambiente de edição da Web podem editar pastas de trabalho existentes ou criar novas pastas de trabalho. Quando você entra no Tableau Server, a seção Exibições é exibida por padrão. Exibições a que você tem acesso são exibidas aqui como resultado dos seguintes processos: l l Um usuário do Tableau Desktop publica a pasta de trabalho contendo a exibição para Tableau Server. Um usuário cria a exibição e salva a pasta de trabalho diretamente no ambiente de edição na Web do Tableau Server. Quem pode criar, editar e salvar exibições Os administradores sempre podem editar e salvar pastas de trabalho existentes ou criar novas pastas de trabalho. Eles também podem atribuir permissões a outros usuários e grupos para editar e salvar exibições em pastas de trabalho, bem como outras ações que podem ser realizadas no servidor. Definir licença do usuário e níveis de publicação Os administradores atribuem um nível de licença e direitos de usuário quando criam ou modificam usuários. Para permitir que os usuários editem pastas de trabalho, primeiro provisione os usuários da seguinte forma: l O usuário deve ter o nível de licença Interagente. l O usuário deve receber o direito de usuário Publicar. Para obter mais informações, consulte Usuários e Licenças e direitos do usuário. Permitir edição e gravação de pastas de trabalho Depois de configurar usuários ou grupos, definir níveis de licença e conceder direitos de publicação, você precisa definir permissões nos níveis de projeto e pasta de trabalho, dependendo do tipo de edição que deseja permitir. Na lista de permissões no nível da tarefa que os administradores podem permitir ou negar usuários e grupos, entre as permissões primárias para editar e salvar exibições estão as seguintes: l l l Edição na Web determina se o usuário pode editar exibições da pasta de trabalho por meio da criação na Web. Baixar/salvar como determina se o usuário vê os comandos Salvar e Salvar como enquanto editam uma exibição, e se conseguem salvar suas alterações em uma nova pasta de trabalho. Além disso, determina se os usuários podem abrir uma pasta de trabalho no servidor usando o Tableau Desktop. Gravar/salvar na Web determina se os usuários podem salvar alterações em uma pasta de trabalho existente no servidor (substitua uma pasta de trabalho). Para permitir que um usuário ou um grupo salve alterações feitas em pastas de trabalho existentes ou em pastas de trabalho novas, defina essas três permissões no nível de tarefa de acordo com as tabelas nas seções a seguir. Permitir que os usuários salvem alterações feitas em pastas de trabalho existentes e novas Permissão Para o projeto Edição na Permitir Web Baixar/salvar Permitir como Gravar/salvar Permitir Para pastas de trabalho apropriadas no projeto Permitir Permitir Permitir Nesse cenário, como as permissões são definidas da mesma maneira para projetos e pastas de trabalho, caso queira aplicar alterações nas permissões no nível do projeto a todas as pastas de trabalho dentro do projeto, você pode selecionar Atribuir permissões ao conteúdo enquanto estiver nas Permissões: Página do projeto. Permitir que os usuários salvem pastas de trabalho novas, mas não substituam existentes Permissão Para o projeto Edição na Permitir Web Baixar/salvar Permitir como Gravar/salvar Permitir Para pastas de trabalho apropriadas no projeto Permitir Permitir Negar Importante: Nesse cenário, as permissões devem ser definidas manualmente em cada pasta de trabalho. Caso você selecione Atribuir permissões ao conteúdo conforme descrito em Permitir que os usuários salvem alterações feitas em pastas de trabalho existentes e novas, as permissões do projeto substituem as permissões da pasta de trabalho, o que concede aos usuários acesso para salvar alterações feitas em pastas de trabalho existentes. Permissões para exibições dentro das pastas de trabalho As permissões para exibições em pastas de trabalho são herdadas das permissões da pasta de trabalho quando um usuário publica uma pasta de trabalho usando o Tableau Desktop. Caso um usuário selecione Mostrar folhas como guias ao publicar uma pasta de trabalho usando o Tableau Desktop ou ao salvá-la no Tableau Server, as permissões da pasta de trabalho substituem as permissões em exibições individuais até a pasta de trabalho ser salva novamente sem guias. Para obter mais informações, consulte Permissões e também o artigo da base de dados de conhecimento Criação de permissões com base em projeto. Caso não seja um administrador, você pode descobrir se está autorizado a editar uma exibição abrindo-a e, em seguida, verificando se um comando Editar é exibido acima da área do visualizador. Criar uma pasta de trabalho e criar uma exibição Você pode criar uma nova exibição criando uma nova folha em uma pasta de trabalho existente ou criando uma nova pasta de trabalho. Este tópico mostra como criar uma exibição em uma nova pasta de trabalho. O procedimento a seguir usa a fonte de dados de exemplo Superstore que acompanha o Tableau Desktop, além de ser publicada em Tableau Server, para criar uma exibição que incorpora informações sobre vendas por categoria e região. Caso tenha acesso à fonte de dados de exemplo Superstore, você pode seguir as etapas no procedimento. 1. Na guia Conteúdo, selecione Fontes de dados. 2. Na lista de fonte de dados, marque a caixa de seleção próxima à fonte de dados que você deseja visualizar e, em seguida, selecione Nova pasta de trabalho. Uma exibição nova, em branco, é aberta no ambiente de criação do Tableau Server. 3. No painel Medidas, arraste Vendas para a divisória Colunas. 4. No painel Dimensões, expanda Produto para exibir suas subcategorias e, em seguida, arraste Categoria para a divisória Linhas. O Tableau agora tem o suficiente para converter os dados em uma visualização (exibição), neste caso, um gráfico de barras horizontais. 5. No painel Dimensões, arraste Região para a divisória Linhas. A exibição agora contém outra camada de dados – as categorias são dividias por região. Agora suponhamos que você queira exibir e comparar vendas por categoria em uma única região. Você pode fazer isso usando um filtro. 6. No painel Dimensões, arraste Região para a divisória Filtros. Quando você focaliza a divisória Filtros, um pequeno triângulo à esquerda do campo indica que é possível soltar Região na divisória. Um controle Filtro é exibido na margem direita da página. 7. Desmarque as caixas de seleção de todas as regiões, exceto a região que você deseja analisar e, em seguida, marque-as novamente. 8. Você pode aprimorar a visualização usando cores. Arraste Região para Cor no cartão Marcas. Você agora tem uma visualização útil que permite comparar vendas de diferentes categorias de produto entre regiões: Dica: Para aprender a selecionar uma paleta de cores diferente para as barras ou redimensioná-las, consulte Cartão Marcas. 9. Em vez de se concentrar nas vendas regionais de cada produto, talvez você prefira uma exibição que permita analisar mais facilmente as vendas de produto gerais de uma região. Na divisória Linhas, arraste Região à esquerda de Categoria. A exibição é atualizada para mostrar vendas de todos os produtos por região. 10. Caso ache que prefere a versão anterior da exibição, você pode clicar em Desfazer na Barra de ferramentas. 11. Caso você queira criar uma segunda planilha, selecione a guia Nova planilha na parte inferior da exibição. Selecione a guia da planilha e selecione Renomear planilha para dar a ela um nome mais descritivo. 12. Clique em Salvar para salvar a pasta de trabalho. Na caixa de diálogo Salvar pasta de trabalho, conclua as seguintes etapas: l Especifique o nome da pasta de trabalho e deixe Projeto definido como Padrão. l Selecione Mostrar folhas como guias caso você tenha criado várias folhas e queira que suas guias sejam exibidas na parte inferior da exibição. l Selecione Inserir senha para fonte de dados caso você queira que os usuários que não tenham uma conta no banco de dados possam ver a exibição. l Quando terminar, clique em Salvar. Editar uma exibição Na seção Exibições, você pode abrir uma exibição para edição de uma das seguintes maneiras: l l Clique em Editar na dica de ferramenta exibida quando você focaliza uma exibição. Selecione uma exibição para mostrá-la e, em seguida, clique em Editar na parte superior da exibição. Se a pasta de trabalho tiver uma conexão de banco de dados ativa, você será solicitado a autenticar. Tableau Server Edição de ambiente O ambiente de edição na Web do servidor é semelhante ao do Tableau Desktop. A janela Dados é exibida no lado esquerdo, mostrando os nomes das fontes de dados incluídas na pasta de trabalho, além dos campos, parâmetros e conjuntos incluídos na fonte de dados ativa. Da mesma forma, na área principal, uma barra de ferramentas é exibida na parte superior, cartão Marcas, divisórias Páginas e Filtros à esquerda da exibição, além das divisórias Colunas e Linhas acima da exibição. Todas as guias de folha incluídas na pasta de trabalho são exibidas na parte inferior da exibição. Ao abrir uma exibição para edição, você pode editar as outras exibições na mesma pasta de trabalho, mas não painéis. Você também pode selecionar a guia Nova Folha para começar a criar uma nova exibição. Para ver detalhes sobre como usar cada um desses componentes para editar exibições, consulte os tópicos listados na parte inferior deste tópico. Gravação ou descarte das alterações Enquanto trabalha com uma exibição, você pode salvar ou descartar alterações a qualquer momento, usando os links acima da área de exibição. Ao salvar seu trabalho, mesmo que tenha entrado no ambiente de edição usando uma exibição única, a pasta de trabalho completa é salva, inclusive outras exibições que você possa ter editado ou não. l l l l Salvar substitui a pasta de trabalho original. Salvar como cria uma nova pasta de trabalho no mesmo projeto. Caso você queira manter a versão original de uma exibição e sua versão editada, use Salvar como para criar uma nova pasta de trabalho. Reverter descarta edições e retorna à versão salva mais recentemente de uma exibição. Concluído deixa o ambiente de edição. Se tiver alterações não salvas, você deverá salvá-las. Caso opte por não salvar alterações, as alterações não salvas continuam presentes quando você retorna ao modo de edição da exibição durante o tempo em que permanece na sessão do servidor atual. A maneira como você pode salvar pastas de trabalho depende das permissões concedidas pelo administrador. Para obter mais informações, consulte Quem pode criar, editar e salvar exibições. Barra de ferramentas Ao editar uma exibição, você pode usar a barra de ferramentas na parte superior da exibição para realizar ações em comum. Desfazer/Refazer Desfazer e refazer uma ação ou uma série de ações. Você pode desfazer ou refazer praticamente qualquer tipo de alteração selecionando esses botões da barra de ferramentas. Pausar atualizações Quando você coloca um campo em uma divisória, o Tableau gera a exibição consultando a fonte de dados. Caso as atualizações pareçam lentas durante a edição da exibição, você pode pausar as atualizações enquanto faz uma série de edições e, em seguida, reativá-las. Trocar Isso move os campos da divisória Linhas para a divisória Colunas e vice-versa. Mais usado com tipos de exibição que se baseiam em eixos x e y. Totais Você pode calcular automaticamente totais gerais e subtotais para os dados em uma exibição. Selecione Totais para ver quatro opções: l l l Mostrar totais gerais da coluna Adiciona uma linha que mostra os totais de todas as colunas da exibição. Mostrar totais gerais da linha Adiciona uma coluna que mostra os totais de todas as linhas da exibição. Adicionar todos os subtotais Insere linhas e colunas de subtotal na exibição, caso l você tenha várias dimensões em uma coluna ou linha. Remover todos os subtotais Remove linhas ou colunas de subtotal. Mostrar/ocultar rótulos Marque para mostrar ou ocultar rótulos de marca na exibição. Tamanho da exibição Use as opções em Tamanho de exibição para alterar as proporções de sua exibição dentro da janela do navegador, além de avançar e voltar entre a exibição de detalhes e a exibição de toda a imagem. Os comandos Tamanho da célula têm efeitos diferentes, dependendo do tipo de visualização. Planilha Contém opções para fazer alterações no nível da planilha. Crie planilhas, modifique nomes de folha, limpe a formatação de folha ou limpe a folha toda. Exportar Use as opções em Exportar para capturar partes da exibição a serem usadas em outros aplicativos. l l l l Imagem: Mostra a exibição ou o painel como uma imagem em uma nova guia do navegador. Dados: Exibe os dados da exibição em uma nova janela do navegador com duas guias: Resumo, que mostra dados agregados para os campos mostrados na exibição, e Subjacente, que mostra dados subjacentes para as marcas selecionadas na visualização. Caso a nova janela não abra, você talvez precise desabilitar o bloqueador de pop-ups de seu navegador. Tabela de referência cruzada: Salva os dados subjacentes para as marcas selecionadas na visualização em um arquivo CSV (valores separados por vírgulas) que pode acabar sendo aberto no Microsoft Excel. PDF: Abre a exibição atual como um PDF em uma nova janela do navegador. A partir daí, você pode salvá-la em um arquivo. Caso a nova janela não abra, você talvez precise desabilitar o bloqueador de pop-ups de seu navegador. Mostre-me Abre um controle que mostra um intervalo dos tipos de visualização que você pode usar no Tableau. Quando você exibe a lista Mostre-me, os dados usados atualmente na exibição determinam quais tipos de visualização estão disponíveis para seleção. Você também pode focalizar um tipo de visualização para ver quais tipos de campo são obrigatórios para disponibilizar esse tipo de visualização. Janela Dados Na parte superior da janela Dados está uma lista das fontes de dados disponíveis para a pasta de trabalho. Se você estiver editando uma pasta de trabalho existente, poderá haver várias fontes de dados. Selecione uma fonte de dados para ver as dimensões e as medidas para essa fonte de dados. Se estiver criando uma nova pasta de trabalho, verá apenas a fonte de dados a partir da qual você criou a pasta de trabalho. Todas as fontes de dados contêm campos. Esses campos aparecem abaixo da lista de fontes de dados na janela Dados. As dimensões e as medidas sempre aparecem, outros tipos de campos aparecerão se estiverem presentes na fonte de dados: l l l l Dimensões são campos que contêm dados qualitativos discretos. Exemplos de dimensões incluem: datas, nomes de clientes e segmentos de cliente. Medidas são campos que contêm dados numéricos que podem ser agregados. Exemplos de medidas incluem vendas, lucro, número de funcionários, temperatura, frequência e pressão. Conjuntos são campos personalizados que definem um subconjunto de dados com base em algumas condições. Um conjunto pode ser baseado em uma condição computada, que é atualizada à medida que os dados são alterados, uma lista constante de valores. Os conjuntos podem estar presentes em pastas de trabalho que você edita, mas você não pode criar conjuntos. Parâmetros são valores dinâmicos que podem substituir valores constantes em cálculos, filtros e linhas de referência. Os parâmetros podem estar presentes em pastas de trabalho que você edita, mas você não pode criar parâmetros. Para criar visualizações, arraste campos da janela Dados para as divisórias Linhas e Colunas, o cartão Marcas ou uma das outras divisórias disponíveis. Para ver uma demonstração, consulte Criar uma pasta de trabalho e criar uma exibição. Divisórias Colunas e Linhas Arraste os campos para a divisória Colunas para criar as colunas de uma tabela, ou para a divisória Linhas para criar as linhas de uma tabela. Você pode arrastar vários campos para cada divisória. Os valores discretos (geralmente, dimensões) são exibidos em azul nas divisórias Colunas e Linhas; os valores contínuos (geralmente, medidas) são exibidos em verde. Na extremidade direita de cada campo que você coloca na divisória Colunas ou Linhas está um menu suspenso que você pode usar para configurar a dimensão ou medida: As opções disponíveis dependem do tipo de campo. A lista completa de opções inclui: l Incluir na dica de ferramenta Por padrão, todos os campos na divisória Colunas e Linhas estão incluídas nas dicas de ferramentas que aparecem quando você passa seu mouse sobre uma ou mais marcas na exibição. Desmarque esta opção para remover um campo das dicas de ferramentas. l Mostrar filtro Escolha essa opção para adicionar um filtro para esse campo para a exibição. Os usuários em seguida poderão especificar quais dados serão incluídos e excluídos para essa dimensão ou medida. l Discreto/contínuo Use essas opções para converter um intervalo contínuo de valores em um conjunto de valores discretos, ou um conjunto discreto em um intervalo contínuo. l Dimensão/atributo/medida Use este intervalo de opções para converter uma dimensão para uma medida ou uma medida para uma dimensão. Você também pode definir a opção como um Atributo, que retorna o valor da expressão especificada se ela tiver apenas um único valor para todas as linhas no grupo; caso contrário exibirá um caractere de asterisco (*). Os valores nulos são ignorados. l Cálculo de tabela rápido Fornece um conjunto de opções para redefinir o significado das marcas para o valor. l Remover Remove o valor da divisória Colunas ou Linhas. Opções para dimensão de data Um conjunto adicional de opções está disponível para dimensões de data: Escolha uma das opções do grupo superior para definir a granularidade dos dados como valores discretos. Por exemplo, se você escolher Mês, sua exibição combinará os dados para cada mês especificado em seus dados no intervalo inteiro de anos: Há exatamente doze marcas nos dados, uma para cada mês. A marca de novembro combina os dados de novembro de 2008, novembro de 2009 etc. Escolha uma das opções do grupo inferior para definir a granularidade dos dados como valores contínuos. Por exemplo, se você escolher Mês, sua exibição mostrará seus dados sequencialmente, sobre o intervalo de meses disponíveis. Nesse caso, há 48 marcas nos dados, uma para cada mês desde novembro de 2008. Cartão Marcas Quando você arrasta campos para a exibição, os dados são exibidos com marcas. Cada marca representa a interseção de todas as dimensões na exibição. Por exemplo, em uma exibição com as dimensões Region e Year, há uma marca para cada combinação desses dois campos (East 2011, East 2012, West 2011, West 2012). As marcas podem ser exibidas de muitas formas diferentes, incluindo linhas, formas, barras, mapas e assim por diante. Você pode mostrar informações adicionais sobre os dados usando propriedades de marca tais como cor, tamanho, forma, rótulos etc. O tipo de marca a ser usada e as propriedades de marca são controladas pelo cartão Marcas. Para mostrar mais dados, arraste campos para o cartão Marcas. Por exemplo, a mesma exibição de cima é mostrada novamente, mas desta vez com Profit em Cor. Com essa informação adicional, ficou evidente que a região sul não era lucrativa em 2010. Controle as marcas na exibição usando o cartão Marcas. Use o menu suspenso para especificar o tipo de marca a ser mostrada. Arraste campos para o cartão Marcas e use os controles do menu suspenso para adicionar mais informações à exibição e controlar cor, forma, tamanho, rótulos e número de marcas na exibição. Tipos de marca Os tipos de marca estão disponíveis no menu suspenso do cartão Marca. Propriedades de marca Você pode controlar as cores, o tamanho, a forma e outras propriedades das marcas na exibição. Arraste um campo para uma propriedade no cartão Marcas para codificar as marcas usando seus dados. As propriedades disponíveis variam entre os tipos de marca. Por exemplo, a propriedade Forma está disponível apenas para o tipo de marca Forma e a propriedade Ângulo está disponível apenas para o tipo de marca Pizza. As propriedades são: Propriedade Descrição Codifica dados atribuindo diferentes cores às marcas em uma exibição de dados com base nos valores de um campo. Paletas de cores quantitativas são aplicadas a campos contínuos, como uma medida de lucro. Paletas categóricas são aplicadas a campos discretos, como um campo que representa regiões geográficos. Altere a paleta de cores ou a transparência selecionando Cor e, em seguida, usando o controle da paleta e o controle deslizante. Cor Tamanho Separa marcas de acordo com os membros em uma dimensão e atribui um tamanho exclusivo a cada membro. Como o tamanho tem uma ordem inerente (de pequeno a grande), os tamanhos categóricos funcionam melhor para dados organizados, como anos ou trimestres. Para alterar o tamanho geral de marcas na exibição, selecione Tamanho e arraste o controle deslizante. Codifica dados atribuindo rótulos de texto às marcas. Quando você trabalha com uma tabela de texto, essa propriedade é chamada de Texto e mostra os números associados a uma exibição de dados. Para exibir ou ocultar os rótulos em marcas, selecione Rótulo e, em seguida, marque ou desmarque a caixa de seleção. Rótulo/texto Detalhe Quando você coloca uma dimensão na divisória Linhas ou Colunas, os membros categorizados criam cabeçalhos de tabela. Os cabeçalhos representam níveis de detalhe porque separam as linhas da fonte de dados em categorias específicas. Você pode identificar cada categoria pelo nome do membro. A propriedade Detalhe também permite separar as marcas em uma exibição de dados de acordo com os membros (níveis de detalhe) de uma dimensão. Entretanto, ao contrário das divisórias Linhas e Colunas, essa propriedade não modifica a estrutura da tabela. Dica de ferramenta Adiciona o nome do campo e o valor à dica de ferramenta para cada marca. Caminho Permite codificar dados por marcas de conexão usando uma determinada ordem de desenho. Você pode codificar dados por caminho usando uma dimensão ou uma medida. Quando você coloca uma dimensão na divisória Caminho, o Tableau conecta as marcas de acordo com os membros da dimensão. Se a dimensão for uma data, a ordem de desenho será especificada de acordo com a ordem de data. Se houver determinadas palavras na dimensão, como nomes de cliente ou tipos de produto, a ordem de desenho será fornecida pela ordem dos membros na fonte de dado. Quando você coloca uma medida na divisória Caminho, o Tableau conecta as marcas de acordo com os valores da medida. A propriedade Caminho só permanece disponível quando você seleciona o tipo de marca de linha ou polígono no menu Marca. Forma Separa as marcas de acordo com os membros da dimensão e atribui uma forma exclusiva a cada membro. Divisória Filtros Use a divisória Filtros para especificar quais dados serão incluídos e excluídos para uma dimensão ou medida. Por exemplo, talvez você queira analisar o lucro de cada segmento de cliente, mas somente de alguns contêineres de envio e tempos de entrega. Ao colocar a dimensão Contêiner na divisória Filtros, você pode especificar quais contêineres serão incluídos. Da mesma forma, você pode colocar o campo Data de Entrega na divisória Filtros para definir quais tempos de entrega serão incluídos. Quando você arrasta uma dimensão ou medida para a divisória Filtros, o Tableau automaticamente insere um controle de filtro na exibição para selecionar os valores a serem exibidos. Por exemplo: Para dimensões, o controle de filtros mostra valores discretos, conforme mostrado acima. Para medidas, o controle mostra um intervalo contínuo: Focalize o cursor do mouse à direita do título para o controle de filtro especificar como os valores no controle deverão ser exibidos: Divisória Páginas Arraste uma dimensão ou medida para a divisória Páginas para dividir uma exibição em uma série de páginas para que se possa analisar melhor como um campo específico afeta o restante dos dados em uma exibição. Arrastar uma dimensão para a divisória Páginas é como adicionar uma nova linha para cada membro na dimensão. Arrastar uma medida para a divisória Páginas automaticamente converte a medida em uma medida discreta que pode ser quebrada em páginas individuais. Quando você arrasta uma dimensão ou medida para a divisória Páginas, o Tableau automaticamente insere um controle na exibição para permitir navegar nas páginas em sua exibição. Por exemplo: Você pode avançar manualmente pelas sequência de páginas em qualquer uma das seguintes maneiras: l l l Use o menu suspenso para selecionar um valor. Use os botões de avançar e voltar nos dois lados da lista suspensa para navegar pelas páginas uma de cada vez. Use o controle deslizante de página para rolar rapidamente para frente ou para trás na sequência de páginas. Selecione Mostrar histórico para mostrar as marcas de páginas anteriores além das marcas para a página atual. Dicas de ferramenta Coloque o cursor sobre uma marca na exibição para ver a dica de ferramenta para essa marca. As dicas de ferramentas fornecem informações sobre os valores das dimensões e medidas para a marca selecionada: As dicas de ferramentas também fornecem essas opções: l Manter apenas Excluir todas as marcas da exibição exceto esta. l Excluir Excluir apenas esta marca. l Agrupar membros Escolha o ícone de clipe de papel para criar um novo grupo, que é uma dimensão, da marca selecionada. Geralmente, você selecionaria várias marcas e, em seguida, criaria um grupo. Por exemplo, se você tivesse uma dimensão Região com valores Norte, Sul, Leste e Oeste, poderia selecionar Sul e Oeste e, em seguida, criar um grupo a partir deles. l Exibir dados Escolha o ícone de tabela para abrir uma nova janela de navegador para exibir duas guias: Resumo, que mostra somente os dados para a marca atual, e Subjacente, que mostra os dados para a exibição inteira. Trabalhar com permissões O que você pode fazer com exibições, pastas de trabalho, projetos e fontes de dados no Tableau Server é controlado por seu nível de licença (especificado por um administrador) e as permissões definidas pelo autor da exibição ou fonte de dados. Você poderá alterar permissões para um item se tiver um nível de licença Interagente e, pelo menos, uma das afirmações a seguir for verdadeira: l Você é o proprietário da pasta de trabalho ou fonte de dados (você a publicou no servidor). l Você recebeu a permissão Definir permissões. l Você recebeu a permissão Líder do projeto para o projeto que contém o item. l Você recebeu o direito Admin. Consulte os tópicos a seguir para obter mais informações: Como as permissões são definidas O diagrama abaixo ilustra como as permissões são avaliadas. Se uma pasta de trabalho for configurada para mostrar folhas como guias, todas as exibições herdarão as permissões da pasta de trabalho, mesmo que diferentes permissões sejam especificadas em uma exibição individual. Definir permissões para pastas de trabalho e exibições Siga as etapas abaixo para definir permissões para uma pasta de trabalho ou exibição. 1. Em uma página que exiba uma ou mais pastas de trabalho, ou uma ou mais exibições, clique para selecionar uma ou mais pastas de trabalho ou exibições e, em seguida, clique em Permissões: 2. Clique em Adicionar/editar permissões na página Permissões: Pasta de trabalho ou Permissões: Exibição: A opção Atribuir permissões para conteúdo é mostrada para pastas de trabalho, mas não para exibições. 3. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à esquerda: Você pode configurar a lista para mostrar usuários, grupos ou ambos. 4. Selecione uma função predefinida no menu suspenso Função ou especifique permissões individuais na área abaixo. A lista de permissões e as funções predefinidas variam um pouco dependendo do fato de você estar definindo permissões para uma pasta de trabalho ou uma exibição. Consulte Permissões para ver uma tabela que define as várias permissões e os itens aos quais elas se aplicam. As funções disponíveis para pastas de trabalho e exibições são: Função Visualizador Aplicase a... pastas de trabalho exibições Interagente pastas de trabalho exibições Editor pastas de trabalho exibições Conector de fonte de dados Editor de fonte de dados Descrição Permite que o usuário ou grupo veja a pasta de trabalho ou exibição no servidor. Permite que o usuário ou grupo veja a pasta de trabalho ou exibição no servidor, edite exibições de pasta de trabalho, aplique filtros, veja dados subjacentes, exporte imagens e exporte dados. Todas as outras permissões são herdadas das permissões de projeto do grupo ou do usuário. Concede todas as permissões ao usuário ou grupo exibições Permite que o usuário ou grupo se conecte à fonte de dados no servidor. Essa permissão é relevante para exibições no acesso a uma exibição que se conecta a uma fonte de dados. exibições Permite que o usuário ou grupo se conecte às fontes de dados no servidor. Além de publicar, editar, baixar, excluir e definir permissões para uma fonte de dados e agendar atualizações das fontes de dados que você publicar. Essa permissão é relevante para exibições no acesso a uma exibição que se conecta a uma fonte de dados. 5. É possível configurar permissões para um usuário ou grupo, ou para vários usuários e grupos. Ao terminar, clique em Enviar. Definir permissões para uma fonte de dados Siga as etapas abaixo para definir permissões para uma fonte de dados. 1. Na página Fontes de dados, clique para selecionar uma ou mais fontes de dados e, em seguida, clique em Permissões. 2. Clique em Adicionar/editar permissões na página Permissões: Fonte de dados: 3. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à esquerda: 4. Selecione uma função predefinida no menu suspenso Função ou especifique permissões individuais na área abaixo. Consulte Permissões para ver uma tabela que define as várias permissões e os itens aos quais elas se aplicam. As funções disponíveis para fontes de dados são: Função Descrição Conector de fonte de dados Permite que o usuário ou grupo se conecte à fonte de dados no servidor. Editor de fonte de dados Permite que o usuário ou grupo se conecte às fontes de dados no servidor. Além de publicar, editar, baixar, excluir e definir permissões para uma fonte de dados e agendar atualizações das fontes de dados que você publicar. 5. É possível configurar permissões para um usuário ou grupo, ou para vários usuários e grupos. Ao terminar, clique em Enviar. Definir permissões para um projeto Administradores e Líderes de projeto podem especificar permissões de projeto. Quando você cria um novo projeto, ele tem as mesmas permissões que o projeto Padrão. É possível definir permissões para o projeto a fim de conceder ou negar permissão a usuários individuais ou grupos para acessar o projeto. Para especificar permissões de projeto: 1. Clique em Admin >Projetos. 2. Clique para selecionar um ou mais projetos clique em Permissões: 3. Clique em Adicionar/editar permissões na página Permissões: Projeto: 4. Na janela Adicionar/editar permissões, selecione um usuário ou grupo na listagem à esquerda: Você pode configurar a lista para mostrar usuários, grupos ou ambos. 5. Selecione uma função predefinida no menu suspenso Função ou especifique permissões individuais na área abaixo. Consulte Permissões para ver uma tabela que define as várias permissões e os itens aos quais elas se aplicam. As funções disponíveis para projetos são: Função Descrição Visualizador Permite que o usuário ou grupo veja as pastas de trabalho e exibições no projeto. Interagente Permite que o usuário ou grupo veja as pastas de trabalho e exibições no projeto, edite exibições de pasta de trabalho, aplique filtros, veja dados subjacentes, exporte imagens e exporte dados. Editor Concede todas as permissões ao usuário ou grupo Conector de fonte de dados Permite que o usuário ou grupo se conecte às fontes de dados no projeto. Editor de fonte de dados Permite que o usuário ou grupo se conecte às fontes de dados no projeto. Além de publicar, editar, baixar, excluir e definir permissões para uma fonte de dados e agendar atualizações das fontes de dados que você publicar. Essa permissão é relevante para exibições no acesso a uma exibição que se conecta a uma fonte de dados. Líder do projeto Permite que o usuário ou grupo defina permissões para todos os itens de um projeto. Publicador Concede ao usuário ou grupo todas as permissões necessárias para publicar pastas de trabalho no servidor. As permissões que você especificar se aplicam ao projeto em si. As permissões explícitas definidas nas pastas de trabalho, exibições e fontes de dados no projeto não são afetadas. No entanto, você tem a opção de atribuir permissões de projeto a todas as pastas de trabalho, exibições e fontes de dados do projeto. Nesse caso, essas permissões substituem as permissões existentes nas pastas de trabalho e exibições. Por exemplo, digamos que há várias pastas de trabalho que foram publicadas com permissões personalizadas e você agrupa as pastas de trabalho em um novo projeto com um novo conjunto de permissões. É possível aplicar as novas permissões a cada uma das pastas de trabalho clicando em Atribuir permissões para conteúdo na página Permissões. Verificar permissões atuais A qualquer momento, você pode ver permissões de um usuário para uma exibição, uma pasta de trabalho, um projeto ou uma fonte de dados específica. Em qualquer página em que você possa definir permissões, selecione um usuário na lista suspensa Verificar permissões de usuário. As permissões mostradas são específicas à exibição, à pasta de trabalho, à fonte de dados ou ao projeto que você selecionou. Permissões Os administradores e outros usuários autorizados podem permitir ou negar permissões em ações que os usuários podem executar no Tableau Server. As permissões também podem ser definidas no Tableau Desktop durante a publicação de uma pasta de trabalho ou fonte de dados no Tableau Server. Os administradores sempre têm controle total de todos os ativos no Tableau Server, e os administradores de site têm controle total de todos os ativos em um site. Se você publicar uma pasta de trabalho ou fonte de dados no Tableau Server, será o publicador desse ativo, e terá o controle total sobre ele. A tabela a seguir mostra que permissões aplicar a que itens no Tableau Server, e descreve as ações que os usuários podem executar com cada permissão. Permissão Afeta... pastas de trabalho Exibir fontes de dados exibições projetos Quando autorizados, os usuários podem... Exibir o item no Tableau Server. Um usuário que acessa uma exibição que se conecta a uma fonte de dados deve ter as permissões Exibir, para a pasta de trabalho, e Conectar, para a fonte de dados. Permissão Afeta... Quando autorizados, os usuários podem... Editar exibições em pastas de trabalho. Consulte Quem pode criar, editar e salvar exibições. pastas de trabalho Edição na Web exibições projetos pastas de trabalho Gravar/salvar na Web fontes de dados exibições projetos As permissões para planilhas (exibições) em uma pasta de trabalho são copiadas (substituídas) das permissões da pasta de trabalho quando você publica uma pasta de trabalho do Tableau Desktop. Elas também são copiadas quando você clica em Atribuir permissões para conteúdo na página Permissões: Pasta de trabalho. Se você selecionar Mostrar planilhas como guias ao salvar uma pasta de trabalho, as permissões para todas as planilhas (exibições) na pasta de trabalho serão substituídas pelas permissões para a pasta de trabalho, mas somente até as guias serem desabilitadas. Consideração especial para o grupo Todos os usuários: Com o interesse de proteger o conteúdo de um editor contra a substituição por outro usuário (seja publicando no Tableau Desktop ou salvando uma pasta de trabalho editada na Web no Tableau Server), sempre que um usuário publicar em um projeto onde o grupo Todos os usuários tiver permissões, a permissão Gravar/salvar na Web do grupo Todos os usuários mudará de Permitir para Herdar por padrão. Você pode modificar manualmente essa permissão seguindo as etapas em Definir permissões para pastas de trabalho e exibições para mudar de Herdar para Permitir. Substituir o item no servidor. Quando autorizado, o usuário pode publicar novamente uma pasta de trabalho ou fonte de dados do Tableau Desktop, tornando-se assim o editor e adquirindo todas as permissões. Subsequentemente, o acesso do publicador original à pasta de trabalho é determinado pelas permissões do grupo do usuário, além de qualquer permissão adicional que o novo publicador decidir definir. Essa permissão também determina a capacidade do usuário ou do grupo de substituir uma pasta de trabalho depois de editá-la no servidor. Consulte Quem pode criar, editar e salvar exibições. Permissão Baixar/salvar na Web como Afeta... Quando autorizados, os usuários podem... pastas de trabalho Quando autorizado, um usuário pode baixar o item do servidor, e também salvar uma pasta de trabalho editada como uma nova pasta de trabalho no servidor. Consulte Baixar pastas de trabalho e Quem pode criar, editar e salvar exibições. fontes de dados projetos pastas de trabalho Excluir fontes de dados Excluir o item. exibições projetos pastas de trabalho Filtrar exibições Modificar filtros rápidos, manter apenas filtros e excluir dados. Consulte Comentários sobre exibições. projetos Adicionar comentário pastas de trabalho exibições Adicionar comentários a exibições em uma pasta de trabalho. projetos pastas de trabalho Exibir comentários exibições Exibir os comentários associados às exibições em uma pasta de trabalho. projetos Exibir dados de resumo pastas de trabalho exibições Ver os dados agregados em uma exibição, ou na seleção do usuário dentro da exibição, e baixar esses dados como arquivo de texto. projetos Exibir dados subjacentes pastas de trabalho exibições projetos Exportar imagem pastas de trabalho exibições Ver os dados brutos atrás de cada linha de uma exibição, conforme restritos pelas marcas selecionadas pelo usuário, e baixar os dados como arquivo de texto. Exportar cada exibição como uma imagem. Consulte Exportar exibições. Permissão Afeta... Quando autorizados, os usuários podem... projetos pastas de Compartilhamento trabalho personalizado exibições projetos Criar personalizações salvas em uma exibição disponível para outras pessoas verem. Os usuários podem criar exibições personalizadas usando a opção Lembrar minhas alterações no Tableau Server. Consulte Exibições personalizadas. pastas de trabalho Mover exibições Mover pastas de trabalho entre projetos projetos pastas de trabalho fontes de Definir permissões dados exibições Especificar permissões para o item. Para as pastas de trabalho, essa permissão se estende às exibições em uma pasta de trabalho. projetos fontes de dados Conectar exibições projetos Líder do projeto projetos Conectar-se à fonte de dados. Um usuário que acessa uma exibição que se conecta a uma fonte de dados deve ter as permissões Exibir, para a exibição, e Conectar, para a fonte de dados. Definir permissões para todos os itens de um projeto e para o próprio projeto. Segurança Existem quatro componentes principais para segurança no Tableau Server: Autenticação A autenticação estabelece a identidade de um usuário. Isso é feito para impedir acesso não autorizado ao Tableau Server e permite experiência de usuário personalizada. O Tableau Server oferece suporte a quatro tipos de autenticação: l l l Active Directory: Autentica os usuários do Tableau Server com base nas respectivas credenciais do Windows. Autenticação local: Usa o mecanismo de autenticação interna fornecido com o Tableau Server. SAML: Usa um provedor de identidades (IdP) externo para autenticar usuários do Tableau Server. l Autenticação confiável: Manipula a autenticação por meio de uma relação de confiança entre o Tableau Server e um ou mais servidores Web. Usar o Active Directory ou a Autenticação local é uma escolha que você faz durante a Instalação do Tableau Server. Após a instalação, você não pode alternar entre as duas. Para alternar os tipos de autenticação, desinstale o Tableau Server (seus dados serão preservados) e execute a instalação novamente. Você também pode optar por configurar o SAML durante a Instalação, mas este não é o único momento em que pode configurá-lo. Quando o SAML identifica a autenticação do usuário, o Active Directory ou a Autenticação local se torna aquilo que você está usando para gerenciar, não autenticar, seus usuários do Tableau Server. O SAML pode ser habilitado ou desabilitado sem que seja necessário desinstalar o Tableau Server e reexecutar a Instalação. Active Directory Quando o Active Directory é usado para autenticação de usuário, todos os nomes de usuário e senha são gerenciados pelo Active Directory. Quando um usuário insere suas credenciais para entrar no Tableau Server, o Tableau as transfere para o servidor Active Directory. Ele não participa do processo de autenticação, embora armazene nomes de usuário (mas não senhas) em seu repositório. Com a autenticação de usuário do Active Directory, os administradores também podem entrar automaticamente com base em suas credenciais do Windows (Habilitar logon automático). Isso significa que as credenciais do usuário estão sendo passadas de seu computador local, não de outro sistema ou portal em que eles possam ter entrado. Por exemplo, se um usuário entrar em seu computador local como ‘MSmith’ e depois entrar no portal do SharePoint como 'Mary', as credenciais passadas para o Tableau Server serão para ‘MSmith’. Para usar as credenciais do site do SharePoint (‘Mary’) em entrada automática, o portal do SharePoint deve usar a web part do Tableau com autenticação confiável. Os administradores podem sincronizar grupos com o Active Directory, seja de forma manual ou programática, usando tabcmd. Consulte Sincronizar um grupo do Active Directory e syncgroup group-name em Comandos de tabcmd para obter mais informações. Autenticação local Quando a Autenticação local é usada para autenticação do usuário, o Tableau Server gerencia usuários, grupos, senhas e o processo inteiro de autenticação. As listas de usuários podem ser facilmente importadas no Tableau Server e a maioria das funções de gerenciamento de usuário pode ser executada de forma programática por meio de tabcmd. Os usuários podem entrar manualmente inserindo suas credenciais quando solicitados ou ao acessar conteúdo em um portal por meio da autenticação confiável transparente. SAML Quando o SAML é usado na autenticação do usuário, um provedor de identidades (IdP) externo autentica usuários do Tableau Server. Ainda assim, você precisa usar o Active Directory ou a Autenticação local para gerenciar seus usuários do Tableau Server, adicionálos ao Tableau Server etc., mas a parte da autenticação é identificada pelo IdP. Quando os usuários entram no Tableau Server usando SAML, a entrada que eles veem pertence ao outro IdP, e não ao Tableau Server. Consulte SAML para obter informações sobre como configurar o SAML em seu site. Autenticação confiável A autenticação confiável significa que você configurou uma relação confiável entre o Tableau Server e um ou mais servidores Web. Por exemplo, você pode ter sua autenticação confiável de uso do wiki corporativo para mostrar painéis a funcionários que já estão conectados ao wiki, sem exigência de outro logon. Quando o Tableau Server recebe solicitações de um servidor Web confiável, ele supõe que o servidor Web já foi tratado, independentemente de a autenticação ser necessária. O Tableau Server recebe a solicitação com um token ou ticket resgatável e apresenta ao usuário uma exibição personalizada que leva em consideração a função e as permissões do usuário. Consulte Autenticação confiável para obter informações sobre como configurar a autenticação confiável em seu site. Autorização A autorização é o que um usuário pode acessar e acessa assim que é autenticado. No Tableau, a autorização é controlada pelos seguintes itens: l l Funções e permissões: Definem recursos específicos que os usuários podem ou não executar em certos objetos no Tableau. Uma função é um conjunto de permissões que os administradores podem usar no estado em que se encontram ou personalizar. Consulte Trabalhar com permissões para obter detalhes. Licenciamento e direitos do usuário: Controla o conjunto máximo de permissões que um usuário pode ter. Consulte Licenças e direitos do usuárioLicenças e direitos do usuário e Permitir ou negar direitos do usuário. Embora os itens acima controlem quais ações um usuário pode executar e sobre o quê, eles não controlam quais dados aparecerão em uma exibição. Os dados que um usuário vê são controlados por suas escolhas de segurança de dados. Permissões iniciais As permissões iniciais para um projeto são copiados do projeto Padrão. As permissões iniciais para uma pasta de trabalho são copiadas das permissões para o respectivo projeto. As permissões iniciais para uma exibição são copiadas das permissões da respectiva pasta de trabalho. Essa é uma cópia ocasional das permissões do pai. As alterações nas permissões do pai não são aplicadas automaticamente nos filhos, a menos que as novas permissões sejam atribuídas ativamente ao conteúdo. Qualquer item pode ter permissões que diferem do pai. Por exemplo, um grupo pode não ter permissões para ver o Projeto X, mas pode ter permissões para ver uma exibição que é publicada no Projeto X. O Tableau Server não oferece suporte a permissões de objeto hierárquicas; no entanto, ele fornece um modelo de herança para usuários e grupos. Se um usuário não tiver uma permissão explicitamente definida como Permitir ou Negar, a configuração será herdada dos grupos aos quais o usuário pertence. Permissões e o projeto padrão Se o Tableau Server estiver implantado em um ambiente aberto onde o principal é o compartilhamento de conhecimento e informações, você deverá considerar a definição de permissões para o projeto Padrão para incluir o grupo Todos os usuários, com sua função definida como Interagente. Os usuários poderão publicar automaticamente e consumir conteúdo de novos projetos. Se o Tableau Server estiver implantado em um ambiente restritivo onde o principal é a segurança de dados e o controle de acesso, considere remover as permissões para o projeto Padrão: Exclua as permissões de todos os usuários e grupos. Os usuários e grupos precisarão receber permissões explicitamente para publicar e consumir conteúdo em novos projetos. Segurança de dados O Tableau fornece várias maneiras de controlar quais usuários podem ver quais dados. Para fontes de dados que se conectam a bancos de dados ativos, também é possível controlar se os usuários serão solicitados a fornecer credenciais de banco de dados quando clicarem em uma exibição publicada. As três opções a seguir trabalham juntas para atingir resultados diferentes: l l l Conta de logon do banco de dados: Ao criar uma fonte de dados que se conecta a um banco de dados dinâmico, você escolhe entre a autenticação no banco de dados por meio do Windows NT ou por meio do mecanismo interno de segurança do banco de dados. Modo de autenticação: Ao publicar uma fonte de dados ou uma pasta de trabalho com uma conexão de banco de dados ativa, você pode escolher um Modo de autenticação. Os modos que serão disponibilizados dependem das escolhas feitas acima. Filtros de usuário: É possível definir filtros em uma pasta de trabalho ou fonte de dados que controlam quais dados uma pessoa vê em uma exibição, com base na respectiva conta de logon do Tableau Server. A tabela abaixo descreve algumas dependências com as opções acima: Opções de conexão de banco de dados A conta de logon do banco de dados usa... Segurança integrada do Windows NT (Autenticação do Windows) Nome de usuário e senha Perguntas sobre a segurança de dados Modo de autenticação Os filtros E possível de usuário usar a são a segurança única do banco maneira de dados de por restringir usuário quais do dados Tableau cada Server? usuário vê? Os caches da Web são compartilhados entre usuários? Conta Run As do servidor Não Sim Sim Representar por meio da conta Run As do Sim servidor Não* Não Avisar usuário: Os visualizadores são solicitados a fornecer as credenciais do banco de dados quando clicam em uma exibição. As credenciais podem ser salvas. Sim Não Não Credenciais inseridas: O publicador da pasta de trabalho ou fonte de dados pode inserir as respectivas credenciais de banco de dados. Não Sim Sim Não* Não Representar por meio da senha inserida: As credenciais de banco Sim de dados com permissão de representação são Opções de conexão de banco de dados A conta de logon do banco de dados usa... Modo de autenticação Perguntas sobre a segurança de dados Os filtros E possível de usuário usar a são a segurança única do banco maneira de dados de por restringir usuário quais do dados Tableau cada Server? usuário vê? Os caches da Web são compartilhados entre usuários? inseridas. * Como podem ser criados resultados inesperados, o Tableau recomenda não usar esse modo de autenticação com filtros de usuário. Os filtros de usuário, a opção de credenciais inseridas e os modos de representação têm efeitos semelhantes. Quando um usuário clica em uma exibição, não é solicitado que ele forneça credenciais e ele vê apenas os dados que pertencem a ele. No entanto, os filtros de usuário são aplicados na pasta de trabalho por editores, e os modos de autenticação de representação dependem das políticas de segurança definidas pelos administradores no próprio banco de dados. Algumas das opções descritas acima exigem etapas de configuração que devem acontecer durante a instalação do Tableau Server ou antes da publicação de uma pasta de trabalho ou fonte de dados. Consulte os tópicos a seguir para obter mais informações: l Usuário Run As l Representação do SQL Server l Credenciais inseridas l Senhas salvas Segurança de rede Existem três interfaces de rede principais no Tableau Server: l l Cliente para o Tableau Server:O cliente pode ser um navegador da Web, Tableau Desktop ou o utilitário tabcmd. Tableau Server para seu(s) banco(s) de dadosPara atualizar extrações de dados ou manipular conexões de banco de dados ativas, o Tableau Server precisa se comunicar com seus bancos de dados. l Comunicação de componente do servidor: Isso se aplica somente a implantações distribuídas. Cliente para o Tableau Server O cliente do Tableau Server pode ser um navegador da Web, Tableau Desktop ou o utilitário tabcmd. As comunicações entre o Tableau Server e seus clientes usam solicitações e respostas HTTP padrão. O Tableau Server também pode ser configurado para HTTPS (consulte SSL). Quando o Tableau Server é configurado para SSL, todo o conteúdo e as comunicações entre clientes são criptografados e usam o protocolo HTTPS. As senhas são comunicadas dos navegadores e do tabcmd para o Tableau Server usando criptografia de chave pública/privada. O Tableau Server envia uma chave pública ao navegador, que usa a chave para criptografar a senha para transmissão. Cada transmissão criptografada usa uma chave uma vez antes de ela ser descartada. Isso significa que as senhas são sempre protegidas, independentemente do uso do SSL. Tableau Server para seu banco de dados O Tableau Server faz conexões dinâmicas com bancos de dados para processar conjuntos de resultados e atualizar extrações. Ele usa drivers nativos para se conectar a bancos de dados sempre que possível e depende de um adaptador ODBC genérico quando drivers nativos estiverem indisponíveis. Todas as comunicações com o banco de dados são roteadas por meio desses drivers. Assim, configurar o driver para se comunicar em portas não padrão ou fornecer criptografia de transporte faz parte da instalação do driver nativo. Esse tipo de configuração é transparente para o Tableau. Comunicação de componente do servidor Existem dois aspectos para a comunicação entre os componentes do Tableau Server em uma instalação de servidor distribuído: confiança e transmissão. Cada servidor em um cluster do Tableau usa um modelo confiável rígido para garantir que ele receba solicitações válidas de outros servidores no cluster. Computadores no cluster em que um processo de gateway está em execução aceitam solicitações de terceiros (clientes), a menos que sejam antecedidos por um balanceador de carga, que recebe as solicitações. Os servidores que não estejam executando um processo de gateway só aceitam solicitações de outros membros confiáveis do cluster. A confiança é estabelecida por uma lista de aprovações de endereço IP, porta e protocolo. Se algum deles for inválido, a solicitação será ignorada. Todos os membros do cluster podem se comunicar entre si. Com a exceção da validação de licença e acesso ao repositório, a transmissão de toda a comunicação interna é executada via HTTP. Quando as senhas são transmitidas dentro do cluster, a chave é usada para criptografar as senhas transmitidas entre componentes do Tableau Server (por exemplo, entre os processos do servidor de aplicativos e o servidor VizQL). Cada transmissão criptografada usa uma chave uma vez antes de ela ser descartada. Desempenho Cada ambiente de servidor é exclusivo e há muitas variáveis que afetam o desempenho. As variáveis incluem detalhes de hardware, como velocidade de disco, memória e núcleos; o número de servidores na sua implantação; tráfego de rede; fatores de uso, como complexidade da pasta de trabalho, atividade simultânea de usuário e armazenamento de dados em cache; definições de configuração do Tableau Server, por exemplo, quantos de cada processo de servidor você está executando; e considerações de dados, como volume de dados, tipo de banco de dados e configuração de banco de dados. Devido a essa complexidade, não há uma única fórmula para melhorar o desempenho do servidor, mas algumas diretrizes básicas que podem ser seguidas. Use os tópicos abaixo para obter mais informações: Diretrizes gerais de desempenho Hardware e software Usar um sistema operacional de 64 bits e o produto de 64 bits: Embora o Tableau Server seja executado tranquilamente em sistemas operacionais Microsoft de 32 bits, para obter o melhor desempenho, escolha um sistema operacional de 64 bits e instale a versão 64 bits do Tableau Server. Adicionar mais núcleos e memória: Independentemente de estar executando o Tableau Server em um computador ou em vários, a regra geral é: quanto mais núcleos de CPU e mais RAM, melhor desempenho você terá. Certifique-se de que você atendeu aos requisitos de hardware e software recomendados do Tableau Server e veja Quando adicionar trabalhos e reconfigurar para avaliar se é preciso adicionar mais computadores. Se estiver executando o Tableau Server em um ambiente virtual, use as práticas recomendadas de sua VM para a alocação vCPU em relação ao número de núcleos de CPU físicos no host da VM. Configuração Agende atualizações para horários fora de pico: as tarefas de backup tendem a atrasar outras tarefas de segundo plano até o backup ser concluído. Use a exibição administrativa Tarefas em segundo plano para ver suas agendas de tarefas de atualização e backup. Suas tarefas de atualização devem ser agendadas para horários alternativos que não se sobreponham à sua janela de backup. Verificar o cache: O cache Tableau Server responde às solicitações de clientes rapidamente, especialmente para exibições que se conectam aos bancos de dados ativos. Verifique se Atualizar com menos frequência na guia Conexões de dados da caixa de diálogo Configuração está selecionada. Considere alterar as configurações de memória de duas sessões: l Tempo limite da sessão VizQL: O tempo limite padrão da sessão do VizQL é de 30 minutos. Mesmo se uma sessão VizQL estiver ociosa, ela ainda estará consumindo memória e ciclos de CPU. Se você puder fazer isso com um limite inferior, use tabadmin para alterar a configuração de l vizqlserver.session.expiry.timeout . Limpeza de sessão VizQL: Por padrão, as sessões VizQL são mantidas na memória até mesmo quando o usuário navega afastado de uma exibição. Isso consome uma boa parte da memória de sessão. Em vez disso, você pode finalizar as sessões quando os usuários saem de uma exibição alterando o valor da configuração vizqlserver.clear_session_on_unload para true (o padrão é false). Avalie a configuração de seus processos: O Tableau Server é dividido em seis componentes diferentes chamados processos de servidor. Embora a configuração padrão tenha sido desenvolvida para trabalhar em uma ampla gama de cenários, você também pode reconfigurá-la para atingir diferentes metas de desempenho. Mais especificamente, você pode controlar em quais computadores os processos são executados e quantos são executados. Consulte Aprimorar o desempenho do servidor para ver diretrizes para implantações de um, dois e três nós. Quando adicionar trabalhos e reconfigurar O Tableau Server pode ser dimensionado horizontal e verticalmente, conforme o aumento dos seus requisitos e necessidades. Veja algumas diretrizes que ajudam a perceber se é hora de adicionar mais nós ao sistema, reconfigurar o servidor, ou ambos: l l l Mais de 100 usuários simultâneos: Se sua implantação tiver um grande número de usuários (>100 visualizadores simultâneos), é importante ter processos VizQL suficientes, mas nem tantos a ponto de exceder a capacidade do hardware para lidar com eles. Além disso, habilitar a opção Conta de usuário convidado do Tableau Server aumenta o número de possíveis visualizadores simultâneos para além da lista de usuários que você acha que tem. A exibição administrativa Atividade do usuário pode ajudar a fazer essa medição. Para obter dicas sobre como configurar ou dimensionar a implantação, consulte Aprimorar o desempenho do servidor. Uso intenso de extrações: As extrações podem consumir muitos recursos da memória e da CPU. Não há uma medida que qualifique um site como grande consumidor de extrações. Ter apenas algumas extrações extremamente grandes pode colocar seu site nessa categoria, como se você tivesse muitas extrações pequenas. Os sites com uso intenso de extrações se beneficiam do isolamento do processo do mecanismo de dados em seu próprio computador. Consulte Aprimorar o desempenho do servidor para ver as diretrizes. Extrações atualizadas com frequência: Atualizar uma extração é uma tarefa que consome muitos recursos da CPU. Os sites em que extrações são frequentemente atualizadas (por exemplo, várias vezes ao dia) são geralmente ajudados pela maior ênfase no processo em segundo plano, que lida com tarefas de atualização. Use a Tarefas em segundo plano exibição administrativa para ver a taxa de atualização atual, bem como Aprimorar o desempenho do servidor para obter detalhes sobre como fazer o dimensionamento. l l Solução de problemas de desempenho: Pode haver vários motivos para a lentidão no carregamento de exibições ou o desempenho do servidor for geralmente lento. Consulte Diretrizes gerais de desempenho, bem como Aprimorar o desempenho do servidor. Tempo de inatividade potencial: Se seu sistema de servidores for considerado essencial e exigir um alto nível de disponibilidade, você poderá configurá-lo de forma que haja redundância para os processos do servidor que identificam extrações, o repositório e o gateway. Consulte Alta disponibilidade para obter detalhes. Aprimorar o desempenho do servidor Use os tópicos abaixo para saber como melhorar o desempenho das implantações que consomem muitas extrações, ou com um grande número de usuários, ou ambos. Qual é seu objetivo? Quantos processos executar Onde configurar processos Otimização das extrações e pastas de trabalho Exemplo de um computador: Extrações Exemplo de dois computadores: Extrações Exemplo de dois computadores: Exibição Exemplo de três computadores: Extrações e exibição Avaliação da capacidade de resposta da exibição Qual é seu objetivo? Otimização de extrações O processo do mecanismo de dados armazena extrações e responde às consultas; o processo em segundo plano atualiza extrações. Como ambos exigem recursos de CPU, a melhor abordagem para melhorar o desempenho de uma implantação com um uso intenso de extrações é isolar esses dois processos um do outro, bem como de outros processos do servidor. Isso pode exigir três máquinas. Se você não tiver três computadores com os quais trabalhar, ainda há estratégias que podem ser usadas (consulte os exemplos de implantação abaixo). Otimização para usuários e exibição O processo do VizQL Server lida com o carregamento e a renderização de exibições para os usuários do Tableau Server. Se estiver tentando otimizar sua implantação para um número alto de usuários e muitas interações de exibição, esse é o processo no qual se concentrar. Quantos processos executar Este tópico pressupõe que você esteja executando a versão de 64 bits do Tableau Server em um sistema operacional de 64 bits. Nessa situação, duas instâncias de cada processo devem atender às necessidades. Caso sua máquina atenda apenas ao requisito mínimo de RAM do Tableau Server, que são 8 GB, seu limite deve ser uma instância de cada processo. Processos em segundo plano Um único processo em segundo plano pode consumir 100% de um único núcleo de CPU e, às vezes, ainda mais para determinadas tarefas. Consequentemente, o número total de instâncias que você deverá executar dependerá dos núcleos disponíveis no computador, bem como do que você está tentando aprimorar. Os exemplos de implantação abaixo usam N para representar o número total de núcleos da máquina e cada um sugere uma estratégia diferente onde o processo em segundo plano está relacionado. Na dúvida, comece com o intervalo mais baixo sugerido e avalie o desempenho antes de aumentar o número. Processos do repositório e mecanismo de dados Há cenários onde o processo de mecanismo de dados deve ser isolado em seu próprio nó – como se você estivesse tentando melhorar uma implantação com alta utilização de extrações e quisesse enfatizar a consulta mais do que as atualizações de extrações. Os exemplos de implantação fornecem especificações. Como o mecanismo de dados armazena dados em tempo real, transferi-lo é um procedimento de várias fases. Mover os processos de mecanismo de dados e repositório descreve como fazer isso. Outro motivo para isolar o mecanismo de dados (e/ou o repositório) é minimizar o potencial da implantação para o tempo de inatividade. Consulte Alta disponibilidade para obter detalhes. A menos que você esteja configurando para alta disponibilidade, geralmente, o repositório pode permanecer no Tableau Server primário. Onde configurar processos Você configura o tipo e o número de processos em qualquer computador que esteja em execução usando a caixa de diálogo Configuração do Tableau Server. Se estiver adicionando novos computadores como parte da reconfiguração, eles já devem ter o software de trabalho Tableau instalado. Consulte Instalar e configurar servidores de trabalho para ver as etapas. Se estiver reconfigurando os processos em seu Tableau Server primário ou autônomo, consulte Reconfigurar processos. Otimização das extrações e pastas de trabalho O desempenho rápido do servidor com extrações é, parcialmente, uma função das extrações e pastas de trabalho em si. Os autores da pasta de trabalho podem ajudar a aumentar o desempenho do servidor mantendo o conjunto de dados da extração reduzido, por meio da filtragem ou agregação, e limitado, ocultando campos não utilizados. Use as opções do Tableau Desktop Ocultar todos os campos não utilizados e Agregar dados para dimensões visíveis para fazer isso. Para ver as etapas, consulte Criação de uma extração (Ajuda do Tableau Desktop). Para obter dicas gerais sobre a criação de pastas de trabalho de bom desempenho, procure por \"desempenho\" na ajuda do Tableau Desktop. Para ver o desempenho das pastas de trabalho depois que elas são publicadas no Tableau Server, você pode criar um registro de desempenho. Consulte Criar um registro de desempenho para obter detalhes. Avaliação da capacidade de resposta da exibição Quando um usuário abre uma exibição, os componentes da exibição são primeiro recuperados e interpretados e, em seguida, exibidos no navegador da web do usuário. Para a maioria das exibições, a fase de renderização ocorre no navegador da web do usuário e, na maior parte dos casos, isso gera os resultados mais rápidos e o mais alto nível de resposta interativa. Lidar com a maioria das interações no navegador da web do cliente reduz a largura de banda e elimina latências de solicitação de ida e volta. Se uma exibição for muito complexa, o Tableau Server manipulará a fase de renderização no servidor, em vez de no navegador da web do cliente, pois isso geralmente resulta no melhor desempenho. Se você achar que as exibições não respondem conforme você gostaria, poderá testar e alterar o limite que faz com que as exibições sejam renderizadas pelo servidor, em vez de no navegador da web do cliente. Consulte Sobre a renderização do lado do cliente para obter mais informações. Exemplo de um computador: Extrações Uma instalação do Tableau Server 64 bits com uso intenso de extração pode ser executada em uma única máquina de 64 bits configurada da seguinte forma: A configuração acima deve ser parecida com a que se segue na página Manutenção do Tableau Server: Notas de configuração: l l l l Execute 2 processos do VizQL Server. Calcule o menor número dos processos em segundo plano a ser executado dividindo o número total de núcleos do computador por 4. Para determinar o número máximo, divida por 2. Tanto os processos do mecanismo de dados, quanto do segundo plano consomem muitos recursos de CPU e a configuração acima os equilibra. Agendar as atualizações da extração para fora dos horários de pico ajuda os processos de mecanismo de dados e em segundo plano a não competirem entre si pelos recursos do sistema. Exemplo de dois computadores: Extrações Veja como você pode configurar uma implantação do Tableau Server com dois computadores para que seja possível lidar com a utilização intensa de extrações. O mais importante a ser notado neste exemplo é que o processo do mecanismo de dados é isolado dos processos em segundo plano. Com a configuração acima, a tabela Status na página Manutenção terá uma aparência parecida com esta: Notas de configuração: l l l Assim que você passa de uma implantação de um computador para dois computadores, seu primeiro servidor torna-se o Tableau Server primário. Na tabela Status, ele obtém um valor de Gateway. Execute 2 processos do VizQL Server em cada máquina. Para calcular o número mínimo dos processos em segundo plano a ser executado no Tableau Server primário, divida o número total de núcleos do computador por 4. Para o número máximo, divida por 2. l Mover o mecanismo de dados do Tableau Server primário para o computador de trabalho é um procedimento de várias fases. Consulte Mover os processos de mecanismo de dados e repositório para ver as etapas. Exemplo de dois computadores: Exibição Uma implantação de dois computadores com pouca utilização de extração e muita exibição pode ser configurada da seguinte maneira: A tabela Status para a configuração acima teria a uma aparência parecida com esta: Notas de configuração: l l Execute 2 processos do VizQL Server em cada máquina. Um mínimo de 2 processos em segundo plano deve ser executado no Tableau Server primário. O número máximo que você deve executar é igual ao número total de núcleos do computador. l l l Em uma implantação onde as extrações são atualizadas raramente, o mecanismo de dados e os processos em segundo plano podem estar no mesmo computador que os outros processos. Se os trabalhos de atualização de extrações forem executados somente fora do horário de trabalho, muitos processos em segundo plano podem ser colocados em cada computador para maximizar o paralelismo. O número de máquinas no cluster é determinado exclusivamente pelo número total de núcleos e pela memória principal disponível. Exemplo de três computadores: Extrações e exibição Uma configuração de três computadores será o número mínimo recomendado de computadores para atingir o melhor desempenho se você tiver um volume alto de atualização e utilização de extração, bem como um número alto de usuários simultâneos. Veja a tabela Status para a configuração acima: Notas de configuração: l l l l l Execute 2 processos do VizQL Server. Os processos em segundo plano estão nas suas próprias máquinas, de modo que os respectivos trabalhos não concorram com os de outros processos. Como o computador é dedicado aos processos em segundo plano e eles podem consumir 100% dos recursos da CPU, o intervalo mais baixo sugerido é igual ao número total de núcleos. Dependendo do tamanho dos dados que estão sendo atualizados, é possível para algumas implantações executar até duas vezes mais processos em segundo plano do que os núcleos e ainda obter agilidade paralela. Como o processo do mecanismo de dados pode consumir todos os recursos da CPU em um computador, ele é isolado em seu próprio computador. As cargas do usuário para processos do servidor de aplicativos e servidor de dados geralmente podem ser manipuladas por 1 processo cada, mas podem ser definidas para 2, de modo a fornecer redundância. Sob a maioria das condições, o Tableau Server primário e o mecanismo de dados não serão um afunilamento para a taxa de transferência geral do sistema, desde que existam ciclos de CPU suficientes para eles. Para aumentar a capacidade de exibição, adicione computadores dedicados ao processo do VizQL Server. Para aumentar a capacidade de atualização de extrações, adicione computadores dedicados ao processo em segundo plano. Sobre a renderização do lado do cliente Antes de as marcas e os dados de uma exibição serem mostrados em um navegador da web do cliente, eles são recuperados, interpretados e renderizados. O Tableau Server pode executar esse processo no navegador da web do cliente ou no servidor. A renderização no lado do cliente é o modo padrão, pois a manipulação da renderização e de toda a interação no servidor pode resultar na transferência de mais dados de rede e em atrasos de ida e volta. Com a renderização no lado do cliente, a maior parte das interações de exibição são mais rápidas, pois elas são interpretadas e renderizadas diretamente no cliente. Algumas exibições, no entanto, são renderizadas com mais eficiência no servidor, onde há mais poder de computação. A renderização no lado do servidor faz sentido para uma exibição que é mais complexa na medida em que os arquivos de imagem ocupam largura de banda significativamente menor do que os dados usados para criar as imagens. Além disso, como os tablets normalmente têm um desempenho inferior ao dos computadores, eles podem lidar com menos complexidade de exibição. Há casos em que uma exibição aberta no navegador da web de um computador pode ser renderizada pelo cliente, mas a mesma exibição aberta no navegador de um tablet é renderizada pelo servidor. O Tableau Server é configurado para manipular automaticamente todas essas situações usando um O cálculo do limite como gatilho para renderizar uma exibição no servidor, em vez de no navegador da web. Como administrador, você pode testar ou fazer o ajuste fino dessa configuração para PCs e tablets. Consulte os tópicos abaixo para obter mais informações. Requisitos l l Supported browsers: A renderização no lado do cliente é compatível com o Internet Explorer versão 9.0 ou posterior, o Firefox, o Chrome e o Safari. Todos esses navegadores da web incluem o elemento HTML 5 <canvas>, que é usado pela renderização no lado do cliente. Polígonos, formas personalizadas e o recurso Histórico de página: Se uma exibição usar polígonos, formas personalizadas ou o recurso de histórico de página, será realizada a renderização no lado do servidor, mesmo que a renderização no lado do cliente esteja habilitada de outra forma. O cálculo do limite Quando a renderização no lado do cliente está habilitada, o Tableau Server usa um cálculo para determinar a complexidade da exibição. Se o valor de complexidade exceder 100 (para navegadores de computadores) ou 20 (para navegadores de tablets), a exibição será renderizada no servidor em vez de no navegador da web. Aqui está o cálculo: (# of marks) + 3(# of headers) + 3(# of annotations) + 3(# of reference lines) = view complexity Por exemplo, se você tiver uma exibição com 2.000 marcas, 150 cabeçalhos (às vezes é possível determinar isso adicionando o número de linhas e colunas em uma exibição), 1 anotação e 1 linha de referência, sua equação será: 2,000 + 3(150) + 3(1) + 3(1) = 2,456 Agora pegue o valor de limite e divida-o por 100; em seguida, multiplique-o por 5.000 (dividir o limite por 100 é uma normalização, e multiplicar por 5.000 é o fator de dimensionamento do Tableau). Presumindo-se um valor de limite atual de 100, a equação seria a seguinte: 100/100 * 5,000 = 5,000 Compare as duas somas. Sabendo que 5.000 representa uma complexidade de 100, você pode ver que 2.456 representa cerca da metade da complexidade (49). Portanto, para forçar a renderização no lado do servidor para essa exibição em particular em um navegador de computador, você precisaria definir esse limite como 48. Lembre-se de que as interações, como a filtragem, podem alterar a complexidade da exibição, e uma sessão pode alternar modos de renderização sempre que a complexidade muda. Consulte os tópicos abaixo para obter detalhes sobre como testar e configurar a renderização no lado do cliente: Testar com o parâmetro de URL O Tableau Server é configurado para realizar a renderização no lado do cliente por padrão, desde que os requisitos sejam atendidos. Para testar a renderização no lado do servidor com base na sessão, digite ?:render=false no final da URL da exibição. Por exemplo: http://localhost/views/Supplies/MyView?:render=false Se a renderização no lado do cliente for desabilitada no Tableau Server, insira ?:render=true para habilitá-la para a sessão. http://localhost/views/Supplies/MyView?:render=true Você também pode testar limites de complexidade em particular em exibições individuais para ver se é apropriado ajustar o limite em todo o servidor para suas condições de servidor e rede. Por exemplo, você poderá achar que os pontos decisivos de complexidade mais baixa (como 80) ou mais alta (como 120) resultam em mais capacidade de resposta às interações do usuário. Para testar um limite, você pode manter a configuração padrão do servidor (habilitada para renderização no lado do cliente) e inserir o número do limite de teste ao final da URL da exibição. Por exemplo: http://localhost/views/Supplies/MyView?:render=80 Configurar com as opções tabadmin set É possível usar as opções tabadmin vizqlserver.browser.render para desabilitar ou habilitar a renderização no lado do cliente, e vizqlserver.browser.render_ threshold e vizqlserver.browser.render_threshold_mobile para alterar os limites dessa renderização. Consulte Opções tabadmin set para obter detalhes. Os processos do Tableau Server Existem seis processos do Tableau Server cuja configuração padrão você pode alterar para atingir diferentes resultados. Os tópicos Aprimorar o desempenho do servidor e Alta disponibilidade descrevem algumas das abordagens que podem ser adotadas. O status de nível alto para cada processo é exibido na página Manutenção do servidor e informações mais detalhadas relacionadas a alguns dos processos (como processo em segundo plano) estão em Exibições administrativas. Em termos de arquitetura, a versão 64 bits do Tableau Server usa processos nativos 64 bits; a versão 32 bits do Tableau Server usa processos 32 bits. A exceção é o processador de dados. Caso a versão 32 bits do Tableau Server esteja instalada em um sistema operacional de 64 bits, a versão 64 bits do processador de dados é usada. Nome do arquivo servidor de wgserver.exe aplicativos Processo Finalidade Lida com o aplicativo Web, oferece suporte à MultiCaracterísticas de thread? desempenho Sim Consome apenas recursos perceptíveis MultiCaracterísticas de thread? desempenho navegação e durante operações pesquisa raras, como publicação de uma pasta de trabalho com uma extração ou geração de uma imagem estática para uma exibição. Sua carga pode ser criada pela interação baseada em navegador e por tabcmd. segundo backgrounder.exe Executa tarefas Não Um processo de um plano de servidor, único encadeamento incluindo onde vários processos atualizações de podem ser executados extrações, tarefas em qualquer \"Executar agora\" computador ou em todos e tarefas iniciadas eles no cluster para em tabcmd. expandir a capacidade. Geralmente, o processador em segundo plano não consome muita memória para processo, mas pode consumir recursos de CPU, E/S ou rede, de acordo com a natureza da carga de trabalho apresentada a ele. Por exemplo, a execução de grandes atualizações de extrações pode usar largura de banda da rede para recuperação de dados. Os recursos de CPU podem ser consumidos pela recuperação de dados ou tarefas tabcmd complexas. mecanismo tdeserver64.exe Armazena Sim A carga de trabalho do de dados extrações de tdeserver.exe Processo Nome do arquivo Finalidade Processo Nome do arquivo servidor de dataserver.exe dados MultiCaracterísticas de thread? desempenho dados e responde mecanismo de dados é às consultas gerada pelas solicitações do processo do VizQL Server. Ela é o componente que carrega extrações na memória e executa consultas nela. Basicamente, o consumo de memória é baseado no tamanho das extrações de dados que estão sendo carregadas. O binário de 64 bits é usado como o padrão em sistemas operacionais de 64 bits, mesmo que o Tableau Server 32 bits esteja instalado. O mecanismo de dados é multissegmentado para lidar com várias solicitações ao mesmo tempo. Sob carga alta, ele pode consumir recursos de CPU, E/S e rede, os quais podem ser um afunilamento de desempenho sob carga. Na carga alta, uma única instância do mecanismo de dados pode consumir todos os recursos de CPU para processar as solicitações. Manipula Sim Como é um proxy, conexões com as normalmente é fontes de dados associado somente pela do Tableau rede, mas pode ser Server associado pela CPU com sessões de usuário Finalidade Processo Nome do arquivo repositório postgres.exe VizQL Server vizqlserver.exe MultiCaracterísticas de thread? desempenho simultâneo suficientes. Sua carga é gerada pela interação baseada no navegador e no Tableau Desktop, bem como pelos trabalhos de atualização de extrações para fontes de dados do Tableau Server. O banco de dados Geralmente, consome do Tableau poucos recursos. Pode Server se tornar um armazenada afunilamento em casos metadados da raros de implantações pasta de trabalho muito grandes (milhares e do usuário de usuários) enquanto executa operações como exibição de todas as pastas de trabalho pelo usuário ou alteração de permissões. Carrega e Sim Consome recursos renderiza perceptíveis durante o exibições, calcula carregamento da e executa exibição e uso interativo consultas de um navegador da Web. Pode ser associado por CPU, E/S ou rede. A carga pode ser criada apenas pela interação baseada em navegador. Pode esgotar a memória do processo. Finalidade Criar um registro de desempenho Com o recurso Registro de Desempenho no Tableau, é possível registrar informações de desempenho sobre eventos importantes à medida que você interage com pastas de trabalho. Em seguida, você exibe métricas de desempenho em uma pasta de trabalho de desempenho que o Tableau cria automaticamente. As etapas seguidas para criar e exibir o registro de desempenho variam um pouco entre o Tableau Desktop e o Tableau Server. Entretanto, as pastas de trabalho de desempenho resultantes têm o mesmo formato no Tableau Desktop e no Tableau Server. Use as pastas de trabalho de desempenho para analisar e solucionar problemas de desempenho relacionados a diferentes eventos que são conhecidos por afetar o desempenho, incluindo: l l l l l l l Execução de consultas Codificação geográfica Conexões com fonte de dados Cálculos de layout Geração de extrações Combinação de dados Renderização do servidor (somente o Tableau Server) O suporte do Tableau poderá solicitar que você crie pastas de trabalho de desempenho durante o diagnóstico de problemas de desempenho. Para criar um registro de desempenho no Tableau Server A habilitação do registro de desempenho no nível de site é determinada pelo administrador do servidor. Por padrão, o registro de desempenho não é habilitado no site padrão ou em qualquer site que você crie. Para habilitar o registro de desempenho em um site, acompanhe estes níveis: 1. Escolha o botão Admin no Tableau Server. 2. Escolha Site. 3. Selecione um site. 4. Escolha Editar. 5. Na caixa de diálogo Editar site, selecione Permitir registro de desempenho. 6. Escolha OK. Você inicia o registro de desempenho para uma exibição específica adicionando ?:record_ performance=yes à URL. Por exemplo: http://localhost/views/Variety/BaseballStatistics?:record_performance=yes A confirmação visual de que o registro foi iniciado é um comando Mostrar registro de desempenho na barra de ferramentas. Escolha Mostrar registro de desempenho para abrir uma pasta de trabalho de desempenho, que é um instantâneo atualizado de dados de desempenho. Você pode continuar a tirar instantâneos adicionais enquanto trabalha com a exibição; os dados de desempenho são cumulativos. Se você sair da página, ou remover ?:record_ performance=yes da URL, o registro parará. Interpretar um registro de desempenho Uma pasta de trabalho de registro de desempenho é um painel do Tableau que contém três exibições. Linha do tempo, Eventos e Consulta. Para obter informações sobre como criar um registro de desempenho no Tableau Server, consulte Criar um registro de desempenho. Linha do tempo A exibição na parte superior de um painel de registro de desempenho mostra os eventos que ocorreram durante o registro, organizados cronologicamente da esquerda para a direita. O eixo inferior mostra o tempo decorrido desde que o registro começou. Na exibição Linha do tempo, as colunas Pasta de trabalho, Painel e Planilha identificam o contexto dos eventos. A coluna Evento identifica a natureza do evento, e a coluna final mostra a duração de cada evento e como ele se compara cronologicamente a outros eventos registrados: Eventos A exibição intermediária em uma pasta de trabalho de registro de desempenho mostra os eventos, classificados por duração (da maior para a menor). Isso pode ajudar a identificar onde procurar primeiro, caso você queira acelerar sua pasta de trabalho. Cores diferentes indicam tipos de eventos diferentes. A variedade de eventos que podem ser registrados é: l Cálculo de layouts. Se os layouts estiverem muito demorados, considere simplificar sua pasta de trabalho. l Conexão à fonte de dados. As conexões lentas podem ser devido a problemas de rede ou do servidor de banco de dados. l Execução de consulta. Se as consultas estiverem muito demoradas, consulte a documentação do servidor de banco de dados. l Geração de extração. Para acelerar a geração de extração, considere importar apenas alguns dados da fonte de dados original. Por exemplo, você pode filtrar por campos de dados específicos, ou criar uma amostra baseada em um número específico de linhas ou uma porcentagem dos dados. l Codificação geográfica. Para acelerar o desempenho da codificação geográfica, experimente usar menos dados ou filtrar os dados. l Combinação de dados. Para acelerar a combinação de dados, experimente usar menos dados ou filtrar os dados. l Renderização do servidor. Você pode acelerar a renderização do servidor executando processos adicionais do VizQL Server em outros computadores. Consulta Se você clicar em um evento Executando consulta na seção Linha do tempo ou Eventos de um painel de registro de desempenho, o texto dessa consulta será exibido na seção Consulta. Por exemplo: Às vezes, a consulta será truncada e você precisará consultar o log do Tableau para encontrar a consulta completa. A maioria dos servidores de banco de dados podem aconselhar você sobre como otimizar uma consulta adicionando índices ou outras técnicas. Consulte a documentação do servidor de banco de dados para obter detalhes. Inserir exibições Você pode inserir exibições do Tableau Server em páginas da Web, blogs, wikis, aplicativos Web e portais da intranet. As exibições inseridas mesclam-se perfeitamente às páginas da Web e são interativas. As exibições são atualizadas à medida que os dados subjacentes mudam ou que as pastas de trabalho são atualizadas no servidor. As exibições inseridas seguem as mesmas restrições de permissão e licenciamento usadas no servidor.Em geral, as pessoas que carregam uma página da Web com uma exibição inserida também têm uma conta no Tableau Server. Caso tenha uma licença com base em núcleo, você pode selecionar Habilitar convidado, que permite que os usuários carreguem a exibição sem entrar. Existem três maneiras de inserir exibições: l l l Use o código inserido Compartilhar como está: O link Compartilhar no canto superior esquerdo de cada exibição fornece o código inserido gerado automaticamente. Tudo o que você precisa fazer é copiar o código e colá-lo na sua página da Web. Escreva seu próprio código inserido: Você pode aprimorar o código inserido padrão que o Tableau fornece ou pode criar seu próprio código. De qualquer maneira, você pode adicionar parâmetros que controlam a barra de ferramentas, guias e muito mais. Use a API do Tableau JavaScript: Você pode usar objetos do Tableau JavaScript em seu próprio código do aplicativo Web. Consulte JavaScript API para obter detalhes. Para que os usuários consigam autenticar quando clicam em uma exibição inserida, seus navegadores devem estar configurados para permitir cookies de terceiros. Consulte os tópicos a seguir para obter detalhes sobre a inserção de exibições: Como escrever código inserido Se estiver escrevendo seu próprio código inserido, você pode adotar uma das duas abordagens. l Usar o Tableau JavaScript: essa é a abordagem preferida. Basta usar o código inserido Compartilhar como o ponto de partida para seu próprio código, adicionando ou editando parâmetros de objeto que controlam a barra de ferramentas, guias, entre outros. Basta usar o código inserido Compartilhar como o ponto de partida para seu próprio código, adicionando ou editando parâmetros de objeto que controlam a barra de ferramentas, guias, entre outros. O código inserido padrão, que depende de um arquivo do Tableau JavaScript, também é o único meio de controlar a ordem de carregamento de várias exibições inseridas. l Especifique a URL da exibição: Assim como nas versões anteriores do Tableau, você pode inserir uma exibição usando uma marca Iframe ou Image, onde a fonte é a URL bruta da exibição. Talvez seja conveniente fazer isso se não for possível usar o JavaScript no seu site. Talvez também haja situações em que tudo o que você pode fazer é especificar uma URL, como se você tivesse inserindo uma exibição usando Web Part do Visualizador de Páginas do SharePoint. Independentemente da abordagem adotada, é preciso definir a largura e a altura se estiver inserindo uma exibição. Tableau JavaScript Veja um exemplo do código inserido que você obtém por padrão quando clica em Compartilhar: <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <div class="tableauPlaceholder" style="width:800; height:600;"> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="/t/Sales" /> <param name="name" value="MyCoSales/SalesScoreCard/[email protected]/EastCoastSales" /> <param name="tabs" value="yes" /> <param name="toolbar" value="yes" /></object></div> A origem da marca <script> é a URL do arquivo Tableau Server JavaScript, viz_v1.js. O arquivo JavaScript trata da montagem da URL completa da exibição que é mostrada aos usuários. Os parâmetros de objeto name e site_root são os únicos parâmetros exigidos; todos os outros parâmetros são opcionais. Por obter exemplos, consulte a Lista de parâmetros inseridos e os "Exemplos de marca de script" na seção Exemplos. Exibir URL como a origem Veja um exemplo de inserção da mesma exibição usando um IFrame, onde a origem é a URL para a exibição: <iframe src="http://myserver/t/Sales/MyCoSales/SalesScoreCard?:embed=yes&:tabs=yes&:toolbar=yes" width="800" height="600"></iframe> Especifique o parâmetro de URL embed e, se desejar, inclua parâmetros que controlam as opções de barra de ferramentas e reversão, entre outros. Também é possível adicionar filtros à URL que controla os dados específicos que mostram quando uma exibição é carregada. Para obter exemplos, consulte Lista de parâmetros inseridos e os "Exemplos de marca Iframe" na seção Exemplos. Lista de parâmetros inseridos Você pode inserir uma exibição usando uma marca Iframe, que usa parâmetros de URL, ou uma marca JavaScript, que usa parâmetros de objeto. A tabela a seguir lista os conjuntos de parâmetros e como usá-los: Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Oculta a opção “Lembrar minhas alterações”. <param name="customViews" value="no"/> http://tabserver/views/DateTime/DateCalcs?:embed=yes&:customViews=no yes Obrigatório para o parâmetro de URL. Oculta a área de navegação superior, mesclando a exibição com a página da Web. http://tabserver/views/DateTime/DateCalcs?:embed=yes string Personaliza o que é exibido quando a exibição é aberta. A <param name="filter" filtragem value="Team=Blue"/> por parâmetros de URL também é possível. Consulte customV- :custono iews mViews - filter :embed - Exemplos Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Exemplos os exemplos de marcas Iframe em Adicionar filtros e Filtrar por vários campos. - Mostra uma exibição :forma- pdf; como um t png arquivo PDF ou .png. - Renderiza uma exibição usando DPI (dots per inch, pontos por :highd- falshttp://tableauserver/views/Salespolegada) pi e /Q2?:highdpi=false padrão para monitores e dispositivos de alta resolução. host_ url - string linktar- :linktstring get arget O nome do servidor conforme ele aparece na URL. O nome da janela de destino http://tabserver/views/Sales/Q2?:format=pdf <param name="host_url" value="http://myserver.bigco.com/"> <param name="host_url" value="http://localhost/"> <param name="linktarget" value="_blank"/> Parâmetr- ParâmeValoo de tro de Descrição res objeto URL para hiperlinks externos. loadorder name - - Exemplos http://tabserver/views/DateTime/DateCalcs?:embed=yes&:linktarget=_blank Quando várias exibições forem inseridas, a ordem de carregamento padrão será a ordem na qual as <param name="load-order" numb- exibições value="2"/> er foram listadas. Use essa configuração para substituir essa ordem. Números negativos são permitidos. string Exigido para parâmetro de objeto. O nome da pasta de trabalho e da folha e, se desejar, uma exibição personalizada (username- <param name="name" value="MyCoSales/Sales"/> <param name="name" value="MyCoSales/Sales/[email protected]/EastCoastSales"/> Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Exemplos @domain/ [nome da exibição personalizada]). path - string Somente para autenticação confiável; não pode ser usado com o parâmetro “ticket”. Substitui o valor do parâmetro “name” e é usado como a URL. Consulte os exemplos de autenticação confiável. <param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4"/> http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes - :refresh Renderiza a página novamenthttp://tabserver/views/Datee. Consulte Time/DateCalcs?:embed=yes&:refreAtualizar sh dados para obter detalhes. - all; filt:reverers; t sorts; Retorna o item para seu estado original. http://tabserver/views/DateTime/DateCalcs?:embed=yes&:revert=all Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Exemplos axes; shelves site_ root tabs ticket - :tabs - string Obrigatório. O nome do site. O valor do site padrão é nulo ( value="" ). Se seu servidor tiver vários sites e você desejar usar a autenticação, consulte os exemplos de Autenticação Confiável. Exibe ou yes; oculta as no guias. Somente para autenticação confiável; não pode numb- ser usado er com o parâmetro de objeto “path”. Deve ser <param name="site_root" value="/t/Sales"/> <param name="site_root" value=""/> <param name="tabs" value="yes"/> <param name="ticket" value="Etdpsm_Ew6rJY9kRrALjauU"/> http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Exemplos usado com o objeto “name” para construir a URL de resgate de ticket confiável. Consulte os exemplos de autenticação confiável. A barra de ferramentas é exibida por padrão na parte inferior quando esse parâmetro não está definido. Quando yes; :toolbno, a barra toolbar no; ar de top ferramentasé excluída da exibição inserida. Quando top, a barra de ferramentasé colocada acima da <param name="toolbar" value="top"/> http://tabserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no Parâmetr- ParâmeValoo de tro de Descrição res objeto URL Exemplos exibição. Exemplos Veja alguns exemplos de como é possível personalizar ou trabalhar com seu código inserido: Adicionar filtros Você pode passar valores de filtro para que a exibição abra mostrando apenas os dados desejados. Por exemplo, talvez seja conveniente incluir um hiperlink de outra parte da sua aplicação Web em uma exibição inserida de desempenho de vendas que mostra somente uma região específica. Exemplo de marca de script <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"> </script> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name="name" value="Sales/Sales-Performance" /> <param name="filter" value="Region=East" /> </object> Para passar por vários filtros, basta separar cada valor com uma vírgula. Por exemplo: <param name="filter" value="Region=East,West" /> Exemplos de marca Iframe <iframe src="http://myserver/views/CalculatedFields?:embed=yes&Region=East"width="800" height="600"></iframe> <iframe src="http://myserver/views/Sales/SalesPerformance?:embed=yes&Region=East,West" width="900px" height="700px"></iframe> Filtrar por vários campos É possível passar filtros por quantos campos você desejar, incluindo campos que não estão na exibição original. Exemplo de marca de script <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"> </script> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name="name" value="Sales/Sales-Performance" /> <param name="filter" value="Region=East,West&Customer Segment=Consumer,HomeOffice" /> </object> Exemplo de marca Iframe <iframe src="http://myserver/views/CalculatedFields?:embed=yes&Region=East,West&Customer Segment=Consumer,Home Office" width="800" height="600"></iframe> Se um valor de filtro contiver um caractere especial, como uma vírgula, substitua o caractere pela sequência de codificação de URL para \ (barra invertida, %5c) seguido pela sequência de codificação de URL do caractere especial. A barra invertida é necessária para o escape do caractere especial. Por exemplo, a sequência de codificação de URL para \, (barra invertida, vírgula) é %5c%2c. Filtrar datas e horas Se você deseja filtrar por um campo de Data/hora, inclua o valor usando o formato padrão do Tableau mostrado abaixo: yyyy-mm-dd hh:mm:ss A parte da hora usa um relógio de 24 horas. Muitos bancos de dados armazenam todos os valores de data como campos Datetime, de modo que talvez seja preciso passar um valor de hora juntamente com a data. Exemplo de marca de script <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name="name" value="Sales/Sales-Performance" /> <param name="filter" value="Date=2012-12-01" /> </object> Esse exemplo filtra por um campo de data e por um campo datetime: <param name="filter" value="2012-12-01%2022:18:00" /> Exemplo de marca Iframe <iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800" height="600"></iframe> Para filtrar várias datas, separe cada data com uma vírgula. Filtrar medidas É possível filtrar medidas incluindo um ou mais valores. Não há suporte para maior que, menor que ou intervalos. O exemplo abaixo filtra para mostrar somente vendas de US$ 100 e US$ 200. Exemplo de marca de script <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"> </script> <object class="tableauViz" width="800" height="600 "style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name="name" value="Sales/Sales-Performance" /> <param name="filter" value="Profit=100, 200" /> </object> Exemplo de marca Iframe <iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Profit=100,200" width="800" height="600"></iframe> Controlar o pedido de carregamento de várias exibições Você pode controlar a ordem em que várias exibições são carregadas para que as pessoas trabalhem com suas exibições. Esse recurso pode ser acessado apenas usando o código inserido que depende do arquivo do Tableau JavaScript. No exemplo a seguir, duas exibições são inseridas. A segunda exibição é carregada primeiro, seguida pela primeira. Se você inseriu várias exibições e fornecer a elas o mesmo valor de ordem de carregamento ou se não especificar os parâmetros de ordem de carregamento, elas serão carregadas na ordem em que aparecem na página. Exemplo de marca de script <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"> </script> <object class="tableauViz" width="600" height="400" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name ="name" value="MyCoSales/TopPerformers" /> <param name="tabs" value="yes" /> <param name="toolbar" value="yes" /> <param name="filter" value="Salesperson=Top 5" /> <param name="load-order" value="0" /> </object> <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"> </script> <object class="tableauViz" width="600" height="400" style="display:none;"> <param name="host_url" value="http://myserver/" /> <param name="site_root" value="" /> <param name="name" value="MyCoSales/SalesScoreCard" /> <param name="tabs" value="yes" /> <param name="toolbar" value="yes" /> <param name="load-order" value="-1" /> </object> Inserir exibições no SharePoint (Microsoft SSPI) Você pode inserir uma exibição do Tableau Server em uma página do SharePoint. Para autenticar os usuários do Tableau Server que acessam a exibição inserida, você tem duas opções, que dependem do método de autenticação do usuário selecionado durante a configuração do Tableau Server. Você pode usar Active Directory com Habilitar logon automático para autenticar usuários do Tableau Server (também conhecidos por usarem o Microsoft SSPI) ou pode usar a Autenticação local — e também configurar o Tableau Server para autenticação confiável. Este tópico se aplica à primeira opção, onde o Tableau Server e o SharePoint estão usando o Microsoft SSPI. Se o Tableau Server estiver usando a Autenticação local, consulte as etapas em Inserir exibições no SharePoint (autenticação local). Siga as etapas abaixo para usar a Web Part Visualizador de Páginas do SharePoint inserida em uma exibição em uma página do SharePoint. 1. Navegue até a página do SharePoint em que você deseja inserir uma exibição (o tipo da página deve ser Página de Web Part). 2. No menu Ações do site, no canto superior esquerdo da página, selecione Editar página. 3. Clique em Adicionar uma Web Part na seção da página onde você deseja inserir a exibição. 4. Em Categorias, selecione TableauEmbeddedView, localizado na pasta Diversos ou Personalizado, e clique em Adicionar. 5. De volta na página do SharePoint, selecione Editar Web Part no menu Editar da nova web part. 6. No lado direito da página, é possível especificar os atributos da Web part da exibição de página. Digite a URL para a exibição que deseja inserir. Use o formato especificado em Inserir exibições. Por exemplo, você pode digitar: http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no 7. Na seção Aparência, você pode especificar o Título da web part, a Altura e a Largura. Em geral, você deve especificar uma altura fixa (por exemplo, 700 pixels) e ajustar a largura para se adequar à zona. 8. Clique em OK para aplicar as alterações e sair do modo de edição. A exibição será inserida na web part que acabou de ser criada. Os usuários não precisarão fazer logon no Tableau Server para ver a exibição inserida, em vez disso, serão automaticamente autenticados usando o Microsoft SSPI. Inserir exibições em wikis Você pode inserir facilmente uma exibição em um wiki ou em outra página da Web, bastando colocar a exibição dentro de uma marca <iframe>. 1. Navegue até a página wiki na qual deseja inserir uma exibição. 2. Edite a página e adicione um <iframe> onde a origem é a URL para a exibição. Por exemplo: <iframe src="http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no" width="800" height="600"></iframe> 3. Salve as alterações. A exibição é inserida na página wiki. Se o Tableau Server e o wiki forem configurados para usar o Microsoft SSPI, os usuários que acessam uma exibição inserida no wiki entrarão automaticamente para que possam ver a exibição. Se o servidor e o wiki não estiverem usando o mesmo método para autenticação, primeiro, os usuários serão solicitados a entrar no servidor para que possam ver a exibição. Inserir imagens Além de inserir uma exibição em um <script> ou em uma marca <iframe>, você também pode inserir a exibição como uma imagem. Quando você insere uma imagem, a exibição não é interativa; no entanto, ela á atualizada toda vez que a página é completamente recarregada. Dessa forma, a imagem mostra os dados mais recentes, mesmo se os dados subjacentes forem alterados. 1. Navegue até a página em que você deseja inserir a imagem. 2. Edite a página e adicione uma marca <img> onde a origem é a URL para a exibição mais a extensão de arquivo .png. Por exemplo: <img src="http://tableauserver/views/DateTime/DateCalcs.png" width="900" height="700"> Observação: Se a página da Web e o Tableau Server estiverem usando o Microsoft SSPI para autenticação, qualquer pessoa que esteja acessando a imagem inserida entrará automaticamente no Tableau Server e poderá ver a exibição. No entanto, se o servidor e a página da Web não estiverem usando o mesmo método de autenticação, a imagem não será exibida. Inserir exibições no SharePoint (autenticação local) Você pode inserir uma exibição do Tableau Server em uma página do SharePoint. Se Autenticação local for o método de autenticação do usuário do Tableau Server, você deverá executar algumas etapas antes de começar a inserir as exibições. As etapas identificam os usuários do Tableau Server, entre outras coisas, no SharePoint. O Tableau fornece essa funcionalidade por meio dos arquivos complementares TableauEmbeddedView.dll e TableauEmbeddedView.wsp. Este tópico descreve como instalar e provisionar esses arquivos, testar sua configuração e inserir uma exibição usando uma Web Part do SharePoint. Se o Active Directory for seu método de autenticação de usuário, não será necessário executar essas etapas extras, pois o Active Directory e o SharePoint usam o Microsoft SSPI. Você pode começar a inserir agora mesmo. Consulte as etapas em Inserir exibições no SharePoint (Microsoft SSPI). Requisitos Qualquer pessoa que acessa uma exibição inserida deve ser um usuário licenciado no Tableau Server e o respectivo nome de usuário no SharePoint deve ser igual ao nome de usuário no Tableau Server. Editar permissões de segurança do DLL A primeira etapa é editar as permissões de segurança do .dll para que todos os usuários do sistema operacional possam usá-lo. 1. Localize os arquivos TableauEmbeddedView.dll e TableauEmbeddedView.wsp que foram instalados com o Tableau Server: C:\Program Files\Tableau\Tableau Server\8.1\extras\embedding\sharepoint\ 2. Copie os arquivos no diretório raiz do servidor SharePoint. O diretório raiz é normalmente localizado em C:\Inetpub\wwwroot\wss\VirtualDirectories\<port>\bin, por exemplo: C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin O restante desse procedimento e tudo o que vem em seguida focará apenas no arquivo .dll. 3. Edite as permissões de segurança em TableauEmbeddedView.dll clicando nele com o botão direito do mouse e selecionando Propriedades > Segurança. 4. Em Nomes de grupos ou usuários, selecione Todos e clique em Editar. 5. Em Permissões para todos, selecione Permitir para a permissão Controle total. 6. Clique OK. Instalar e implantar o arquivo WSP O procedimento acima concedeu permissão para usar o arquivo .dll a todos os usuários do sistema operacional. No procedimento a seguir, você dará ao SharePoint mais informações sobre o que fazer com o arquivo .dll. Isso é feito pelo arquivo TableauEmbeddedView.wsp. Você copiou esse arquivo na etapa 2 de Editar permissões de segurança do DLL. Para instalar e implantar o arquivo .wsp: 1. Abra um prompt de comando como administrador. 2. Navegue para a pasta a seguir: C:\Program Files (x86)\Common Files\Microsoft Shared\Web Server Extensions\14\BIN 3. Execute o comando a seguir para adicionar o arquivo .wsp: stsadm -o addsolution -filename "C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin\TableauEmbeddedView.wsp" 4. Em seguida, execute o comando a seguir para implantá-lo. No comando, http://<your SharePoint site>/ deve ser o diretório raiz do site do SharePoint, como http://mySharePoint/. stsadm -o deploysolution -name TableauEmbeddedView.wsp http://<your SharePoint Site>/ -local -force allowgacdeployment -url 5. Por fim, ative o recurso Web Part executando o seguinte comando: stsadm -o activatefeature -name TableauEmbeddedView_Feature1 -url http://<your SharePoint Site>/ Verificar a implantação da Web Part Depois de instalar e implantar o arquivo TableauEmbeddedView.wsp, verifique as configurações fazendo o seguinte: 1. Abra o site do SharePoint em um navegador da Web. Pode demorar alguns instantes para o site aparecer. 2. Na lista Ações do site, selecione Configurações do site. 3. Em Galerias, selecione Web parts. 4. Confirme que o TableauEmbeddedView está listado. 5. Retorne para Configurações do site e, em Administração de coleta do site, selecione Recursos de coleta do site. Confirme que o recurso TableauEmbeddedView está com o status de Ativo. Inserir uma exibição usando a Web Part Agora que você está pronto para inserir uma exibição em uma página do SharePoint: 1. Navegue até a página do SharePoint em que você deseja inserir uma exibição (o tipo da página deve ser Página de Web Part). 2. No menu Ações do site, no canto superior esquerdo da página, selecione Editar página. 3. Clique em Adicionar uma Web Part na seção da página onde você deseja inserir a exibição. 4. Em Categorias, selecione TableauEmbeddedView, localizado na pasta Diversos ou Personalizado, e clique em Adicionar. 5. De volta na página do SharePoint, selecione Editar Web Part no menu Editar da nova web part. 6. No lado direito da página, é possível especificar os atributos da web part TableauEmbeddedView. Digite o nome do seu Tableau Server e, em seguida, digite o caminho da exibição que você deseja inserir. Por exemplo, você pode digitar /views/Date-Time/DateCalcs. 7. Especifique outros atributos - se você deseja mostrar a barra de ferramentas ou, até mesmo, se deseja inserir a exibição como uma imagem em vez de uma exibição interativa. 8. Na seção Aparência, você pode especificar o Título da web part, a Altura e a Largura. Em geral, você deve especificar uma altura fixa (por exemplo, 700 pixels) e ajustar a largura para se adequar à zona. 9. Clique em OK para aplicar as alterações e sair do modo de edição. Agora a exibição está inserida na página e os usuários que a acessarem entrarão automaticamente com base em seus nomes de usuário e senhas do SharePoint. Qualquer pessoa que acessa uma exibição inserida precisa ser um usuário licenciado no Tableau Server e o respectivo nome de usuário no SharePoint deve ser igual ao nome de usuário no Tableau Server. Esse é um exemplo de inserção de exibições no SharePoint usando o arquivo .dll fornecido. Você também pode inserir exibições em outros tipos de aplicativos Web. Consulte JavaScript API para obter mais informações. Servidores proxy O Tableau Server também pode ser configurado para funcionar com um servidor proxy. Neste tipo de ambiente, o servidor proxy atua como um intermediário entre o Tableau Server e os clientes que estão fazendo solicitações de recursos no Tableau Server. Há várias maneiras de configurar servidores proxy — por exemplo, como proxies avançados ou proxies reversos. Estes tópicos pressupõem que você já configurou seu servidor proxy e agora precisa identificá-lo para o Tableau Server. Use os tópicos abaixo para obter mais informações: Preparar-se para a configuração de um ambiente com proxy Para configurar o Tableau Server para funcionar com um servidor proxy, você precisará das seguintes informações sobre seu servidor proxy: l l l l Endereço IP: Os endereços IP do servidor proxy. O endereço IP deve estar no formato IPv4, por exemplo, 123.45.67.89, além de ser um IP estático. FQDN: O nome de domínio totalmente qualificado do servidor proxy. Por exemplo, bigbox.myco.com. Não FQDN: Qualquer nome de domínio não totalmente qualificado do servidor proxy. Usando o exemplo acima, o nome de domínio totalmente qualificado do servidor proxy seria bigbox. Aliases: Qualquer alias do servidor proxy. Os aliases são designados com o uso de CNAMEs (registros de Nome canônico). Um exemplo seria um servidor proxy com um CNAME de bigbox.myco.com e aliases de ftp.myco.com e www.myco.com. Configurar o Tableau para funcionar com um servidor proxy Após a coleta das informações descritas em Preparar-se para a configuração de um ambiente com proxy, você pode configurar o Tableau Server para funcionar com um proxy executando as etapas a seguir. Para obter informações sobre as configurações abaixo, consulte Opções tabadmin set. 1. Interrompa o servidor. 2. Ainda no diretório bin do Tableau Server, insira o seguinte comando, onde name é o nome canônico (externamente visível) do servidor proxy: tabadmin set gateway.public.host "name" 3. Por padrão, o Tableau presume que o servidor proxy esteja ouvindo as comunicações externas na porta 80. Para designar uma porta diferentes, digite o comando a seguir, onde port_number corresponde à porta. tabadmin set gateway.public.port "port_number" 4. Agora, digite o seguinte comando, em que server é o endereço IPv4 ou o nome do computador do servidor proxy: tabadmin set gateway.trusted "server" O valor de server pode ser uma lista separada por vírgulas, por exemplo: tabadmin set gateway.trusted "123.45.67.890, 123.45.67.880, 123.45.67.870" ou tabadmin set gateway.trusted "proxy1, proxy2, proxy3" 5. No comando seguinte, você fornecerá nomes alternativos para o servidor proxy, como seu nome de domínio totalmente qualificado, nomes de domínio não totalmente qualificados e aliases. Esses são os nomes que um usuário poderá digitar em um navegador. Separe cada nome com uma vírgula: tabadmin set gateway.trusted_hosts "name1, name2, name3" Por exemplo: tabadmin set gateway.trusted_hosts "proxy1.example.com, proxy1, ftp.example.com, www.example.com" 6. Inicie o servidor para que as alterações possam ter efeito. Autenticação confiável Quando você insere exibições do Tableau Server em páginas da Web, todos que visitarem a página deverão ser um usuário licenciado no Tableau Server. Ao visitarem a página, os usuários são solicitados a entrarem no Tableau Server para que possam ver a exibição. Caso já tenha uma maneira de autenticar usuários na página da Web ou em seu aplicativo web, você pode evitar essa solicitação e evitar que seus usuários precisem entrar duas vezes configurando a autenticação confiável. A autenticação confiável simplesmente significa que você configurou uma relação confiável entre o Tableau Server e um ou mais servidores Web. Quando o Tableau Server recebe solicitações desses servidores Web confiáveis, ele supõe que o servidor já foi tratado, independentemente de a autenticação ser necessária. Se seu servidor Web usar SSPI (Security Support Provider Interface), você não precisará configurar a autenticação confiável. É possível inserir exibições, e seus usuários terão acesso seguro a elas desde que sejam usuários e membros licenciados do Tableau Server do seu Active Directory. O uso de Habilitar logon automático (uma opção configurada durante a Instalação que usa o Microsoft SSPI) e da autenticação confiável não é compatível. Se você estiver usando o SSPI com o Active Directory e quiser que seus usuários tenham acesso seguro às exibições do Tableau Server sem serem solicitados a inserir credenciais, você pode configurar a autenticação confiável. Para que os usuários possam ser autenticados quando clicam em uma exibição inserida, seus navegadores devem estar configurados para permitir cookies de terceiros. Como a autenticação confiável funciona O diagrama abaixo descreve como a autenticação confiável funciona entre o navegador da Web do cliente, seu servidor Web e o Tableau Server. O usuário visita a página da Web: Quando um usuário visita a página da Web com a exibição inserida do Tableau Server, ele envia uma solicitação GET a seu servidor Web para o HTML dessa página. O servidor Web envia POSTS ao Tableau Server: O servidor Web envia uma O servidor Web passa a URL para o navegador: O servidor Web constrói a URL para a exibição usando a URL da exibição ou sua marca de objeto (se inserida na exibição) e a insere no HTML da página. O ticket é incluído (ex.: http://tabserver/trusted/<ticket>/views/requestedviewname). O servidor Web passa todo o HTML da página de volta ao navegador da Web do cliente. O navegador solicita a exibição do Tableau Server: O navegador da Web do cliente envia uma solicitação ao Tableau Server usando uma solicitação POST ao Tableau Server confiável (por exemplo, http://tabaserver/trusted, não http://tabserver). Essa solicitação POST deve ter um parâmetro username. O valor de username deve ser o nome de usuário de um usuário licenciado do Tableau Server. Se o servidor estiver executando vários sites e a exibição estiver em um site que não seja o site padrão, a solicitação POST também deverá incluir um parâmetro target_site. O Tableau Server cria um ticket: O Tableau Server verifica o endereço IP ou o nome de host do servidor Web (192.168.1.XXX no diagrama acima) que enviou a solicitação POST. Caso seja configurado como um host confiável, o Tableau Server cria um ticket na forma de uma cadeia de caracteres exclusiva de 24 caracteres (URL segura, codificada com Base64). O Tableau Server responde à solicitação POST com esse ticket. Se houver um erro e o ticket não puder ser criado, o Tableau Server responderá com um valor de 1. solicitação GET que inclui a URL com o ticket. O Tableau Server resgata o ticket: O Tableau Server vê que o navegador da Web solicitou uma URL com um ticket e resgata o ticket. Os tickets devem ser resgatados em até três minutos, a contar de quando foram emitidos. Assim que o ticket é resgatado, o Tableau Server conecta o usuário, remove o ticket da URL e envia a URL final de volta para a exibição inserida. Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server A primeira etapa da configuração da autenticação confiável é configurar o Tableau Server para reconhecer e confiar em solicitações de um ou mais servidores Web: 1. Abra um prompt de comando como um administrador e navegue até seu diretório bin do Tableau Server (por exemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin). 2. Em seguida, digite o seguinte comando: tabadmin set wgserver.trusted_hosts "<trusted IP addresses or host names>" No comando acima, <trusted IP addresses> deve ser uma lista separada por vírgulas dos endereços IPv4 ou dos nomes de host de seus servidores Web. Por exemplo: tabadmin set wgserver.trusted_hosts "192.168.1.101, 192.168.1.102, 192.168.1.103" ou tabadmin set wgserver.trusted_hosts "webserv1, webserv2, webserv3" Observações: l l A lista separada por vírgulas deve estar entre aspas com um espaço após cada vírgula. Os servidores Web especificados devem usar endereços IP estáticos, mesmo que você use nomes de host aqui para especificá-los. 3. Caso tenha um ou mais servidores proxy entre o computador que está solicitando o ticket confiável (um dos configurados na etapa 2, acima) e o Tableau Server, você também precisa adicioná-los como gateways confiáveis. Consulte Configurar o Tableau para funcionar com um servidor proxy para ver as etapas. 4. Por fim, digite o seguinte comando para reiniciar o servidor: tabadmin restart Em seguida, você deverá configurar seu servidor Web para receber tickets do Tableau Server. Obter um ticket do Tableau Server Depois de adicionar endereços IP confiáveis ao Tableau Server, você estará pronto para configurar seu servidor Web para obter tickets do Tableau Server via solicitações POST (etapa 3 do diagrama). A solicitação POST deve ser enviada a http://<server name>/trusted — por exemplo, http://tabserv/trusted, não a http://tabserv. Para obter exemplos de códigos que você pode usar para criar a solicitação POST em Java, Ruby e PHP, consulte o seguinte: C:\Program Files\Tableau\Tableau Server\8.1\extras\embedding Estes são os dados que você pode usar em uma solicitação POST ao Tableau Server: l l l username=<username> (obrigatório): O nome de usuário para um usuário licenciado do Tableau Server. Se estiver usando a Autenticação local, o nome de usuário pode ser uma string simples (por exemplo, username=jsmith). Se estiver usando o Active Directory com vários domínios, você deverá incluir o nome de domínio com o nome de usuário (por exemplo, username=MyCo\jsmith). target_site=<site id> (obrigatório, se a exibição não estiver no site padrão): Especifica o site que contém a exibição se o Tableau Server estiver executando vários sites e a exibição estiver em um site diferente do site padrão (por exemplo, target_ site=Sales). O valor que você usa para <site id> deve ser o nome da pasta Web do site. client_ip=<IP address> (opcional): Usado para especificar o endereço IP do computador cujo navegador da Web está acessando a exibição (por exemplo, client_ip=123.45.67.891). Não é o endereço IP do servidor Web que está fazendo a solicitação POST do Tableau Server. Se você decidir usar esse parâmetro, consulte Opcional: Configurar a correspondência IP do cliente para obter mais informações. A resposta do Tableau Server à solicitação POST será uma string exclusiva de nove dígitos (o ticket). Se o Tableau Server não puder processar a solicitação, a resposta será -1. Consulte Valor de ticket -1 retornado pelo Tableau Server para ver as dicas de como corrigir isso. Além disso, para que os usuários consigam se autenticar quando clicam em uma exibição inserida, seus navegadores devem estar configurados para permitir cookies de terceiros. Em seguida, você deverá adicionar o código que permite que o servidor Web construa uma URL para a exibição que contenha o local da exibição e o ticket. Ver a exibição com o ticket Depois de criar a solicitação POST, você deverá gravar o código que fornece ao servidor Web o local da exibição e o ticket do Tableau Server. Ele usará essas informações para mostrar a exibição. A maneira como você especifica isso depende se a exibição é inserida e se o Tableau Server está executando vários sites. Exemplos de exibição do Tableau Server Este é um exemplo de como especificar uma exibição que os usuários acessam somente via Tableau Server (a exibição não é inserida): http://tabserver/trusted/<ticket>/views/<workbook>/<view> Se o Tableau Server estiver executando vários sites e a exibição estiver em um site diferente do padrão, você deverá adicionar t/<site name> ao caminho. Por exemplo: http://tabserver/trusted/<ticket>/t/Sales/views/<workbook>/<view> Exemplos de exibição inserida Estes são alguns exemplos de como especificar exibições inseridas. Como há duas abordagens que você pode adotar para o código inserido, as duas maneiras são descritas abaixo. Independentemente do que for usado, haverá algumas informações exclusivas da autenticação confiável que você deverá fornecer. Exemplos de marca de script Este exemplo usa o parâmetro de objeto ticket: <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="name" value="MyCoSales/SalesScoreCard" /> <param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" /> </object> Aqui está como o exemplo acima ficaria em um Tableau Server com vários sites, onde a exibição está publicada no site Sales: <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <object class="tableauViz" width="800" height="600" style="display:none;"> <param name="site_root" value="/t/Sales" /> <param name="name" value="MyCoSales/SalesScoreCard" /> <param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" /> </object> Em vez de usar ticket, você pode usar o parâmetro path para indicar explicitamente o caminho completo da exibição. Quando path é usado, você também não precisa do parâmetro name, que é geralmente um parâmetro obrigatório no código inserido do Tableau JavaScript: <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <object class="tableauViz" width="900" height="700" style="display:none;"> <param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/MyCoSales/SalesScoreCard" /> </object> Este é o mesmo exemplo, só que para um servidor com vários sites. Observe que /t/<site name> é usado aqui: <script type="text/javascript" src="http://myserver/javascripts/api/viz_v1.js"></script> <object class="tableauViz" width="900" height="700" style="display:none;"> <param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/t/Sales/views/MyCoSales/SalesScoreCard" /> </object> Exemplo de marca Iframe <iframe src="http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes" width="800" height="600"></iframe> Opcional: Configurar a correspondência IP do cliente Por padrão, o Tableau Server não considera o endereço IP do navegador da Web do cliente quando ele cria ou resgata tickets. Para mudar isso, é necessário fazer duas coisas: especificar um endereço IP usando o parâmetro client_ip na solicitação POST que obtém o ticket e seguir as etapas abaixo para configurar o Tableau Server para impor a correspondência de endereço IP do cliente. 1. Abra uma janela de comando e altere os diretórios para o local do diretório bin do Tableau Server. O local padrão é C:\Program Files\Tableau\Tableau Server\8.1\bin 2. Abra um prompt de comando como um administrador e digite o seguinte comando: tabadmin set wgserver.extended_trusted_ip_checking true 3. Em seguida, digite o seguinte comando: tabadmin configure 4. Por fim, reinicie o servidor digitando o seguinte: tabadmin restart Solucionar problemas de autenticação confiável Veja abaixo alguns problemas e erros comuns que você pode encontrar quando estiver configurando a autenticação confiável. As informações de autenticação confiável são gravadas em ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Para aumentar o nível de registro de info para debug, use a configuração tabadmin vizqlserver.trustedticket.log_ level. Para obter dicas de teste de autenticação confiável, consulte a Base de dados de conhecimento do Tableau. Valor de ticket -1 retornado pelo Tableau Server O Tableau Server retornará -1 para o valor do ticket se ele não puder emitir o ticket como parte do processo de autenticação confiável. O motivo exato dessa mensagem está gravado no arquivo production*.log na seguinte pasta: ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver Estes são alguns fatores a serem confirmados: l Todos os nomes de host do servidor Web ou endereços IP são adicionados a hosts confiáveis O endereço IP ou o nome de host do computador que envia a solicitação POST deve estar na lista de hosts confiáveis no Tableau Server. Consulte Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server para saber como adicionar endereços IP ou nomes de host a essa lista. l O valor de wgserver.trusted_hosts está formatado corretamente A lista de hosts confiáveis fornecidas por você usando a configuração wgserver.trusted_hosts deve ser uma lista separada por vírgulas com um espaço após cada vírgula. Por exemplo, a lista deve ser semelhante ao seguinte: 192.168.1.101, 192.168.1.102, 192.168.1.103 ou bigbox1.example.lan, bixbox2.example.lan, bigbox3.example.lan. l Endereços IP são IPv4 Caso você esteja usando endereços IP para especificar hosts confiáveis, eles devem estar no formato do protocolo IP versão 4 (IPv4). Um endereço IPv4 será semelhante a isto: 123.456.7.890. Os endereços IPv6 (por exemplo, fe12::3c4a:5eab:6789:01c%34) não são compatíveis como forma de inserir hosts confiáveis. l O nome de usuário na solicitação POST é um usuário válido do Tableau Server O nome de usuário que você envia na solicitação POST deve ser um usuário licenciado do Tableau Server com um nível de licença Visualizador ou Interagente. Você pode ver uma lista de usuários e seus níveis de licença entrando no Tableau Server como um administrador e clicando no link Licenciamento no lado esquerdo da página. l O nome de usuário na solicitação POST inclui o domínio Se o Tableau Server for configurado para usar a Autenticação local, o nome de usuário que você envia no POST pode ser uma string simples. No entanto, se o servidor for configurado para o Active Directory, você deverá incluir o nome de domínio com o nome de usuário (domínio\nome de usuário). Por exemplo, o parâmetro de nome de usuário pode ser: username=dev\jsmith HTTP 401 - Não autorizado Caso receba um erro 401 – Não autorizado, você pode ter configurado o Tableau Server para usar o Active Directory com SSPI (consulte Habilitar logon automático). Se seu servidor Web usar SSPI, você não precisará configurar a autenticação confiável. É possível inserir exibições e seus usuários terão acesso a elas, desde que eles sejam usuários e membros licenciados do Tableau Server do seu Active Directory. O uso simultâneo de Habilitar logon automático e da autenticação confiável não é compatível. HTTP 404 – Arquivo não encontrado Você poderá receber esse erro se o código do seu programa fizer referência a uma URL do Tableau Server que não existe. Por exemplo, o servidor Web pode construir uma URL inválida que não pode ser encontrada quando a página da Web tenta recuperá-la. Usuário inválido (SharePoint ou C#) Você poderá encontrar esse erro se tiver configurado o Tableau Server para autenticação confiável. O código de exemplo para a .dll do SharePoint faz referência à seguinte solicitação GET: SPContext.Current.Web.CurrentUser.Name A solicitação acima retornará o nome para exibição do usuário atual do Windows Active Directory. Se desejar usar a ID de logon, você precisará alterar o código para: SPContext.Current.Web.CurrentUser.LoginName Após fazer a alteração, recompile a .dll do SharePoint. Tentativa de recuperar o ticket do endereço IP incorreto Você poderá encontrar esse erro se tiver configurado o Tableau Server para autenticação confiável. O endereço IP do navegador da Web do cliente não é considerado por padrão no resgate do ticket. Se o Tableau Server foi configurado para impor a correspondência de endereço IP do cliente, certifique-se de que o endereço IP do navegador da Web do cliente que foi enviado na POST ao Tableau Server é o mesmo de quando o navegador tentar recuperar a exibição inserida. Por exemplo, no diagrama Autenticação confiável, se a solicitação POST na etapa 3 enviar o parâmetro client_ip=74.125.19.147, a solicitação GET na etapa 5 deverá vir do mesmo endereço IP. Consulte Opcional: Configurar a correspondência IP do cliente para saber como configurar o Tableau Server para impor a correspondência de endereço IP do cliente. Erro de restrição de cookie Quando um usuário entra no Tableau Server, um cookie de sessão é armazenado em seu navegador local. O cookie armazenado é a forma como o Tableau Server mantém que o usuário que entrou foi autenticado e pode acessar o servidor. Como o cookie é definido com o mesmo domínio ou subdomínio que a barra de endereços do navegador, ele é considerado um cookie primário. Se o navegador de um usuário estiver configurado para bloquear cookies primários, ele não conseguirá entrar no Tableau Server. Quando um usuário entra no Tableau Server por meio de uma exibição inserida, ou em um ambiente em que a autenticação confiável tenha sido configurada, o mesmo acontece: um cookie é armazenado. Nesse caso, entretanto, o navegador trata o cookie como um cookie de terceiros. Isso acontece porque o cookie é definido com um domínio que é diferente daquele mostrado na barra de endereços do navegador. Se o navegador da web do usuário estiver configurado para bloquear cookies de terceiros, a autenticação no Tableau Server falhará. Para evitar que isso ocorra, os navegadores da web devem ser configurados para permitir cookies de terceiros. Erro na comunicação com o servidor (403) Se o Tableau Server estiver configurado para a autenticação confiável, talvez você receba esse erro depois de abrir uma nova exibição em um navegador e tentar navegar de volta para as exibições abertas anteriormente. O Tableau Server fornece proteção contra reutilização não autorizada das sessões VizQL por meio da opção tabadmin set vizqlserver.protect_ sessions, definida como true por padrão. Como o Tableau Server é configurado para autenticação confiável, você também não precisa habilitar vizqlserver.protect_ sessions. Para desabilitá-la, use tabadmin set para mudar para false. SAML Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP) para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na organização. Consulte os links abaixo para obter mais informações sobre o SAML: Como a autenticação SAML funciona SAML é um padrão aberto com base em XML para troca de informações de autenticação entre duas partes, um provedor de serviços (nesse caso, Tableau Server) e um provedor de identidades (IdP). Quando você configura o Tableau Server para SAML, um IdP de terceiros é usado para autenticar usuários e passar informações de identidade para o Tableau Server na forma de um documento XML assinado digitalmente. Tentativas de usuário para acessar um link da pasta de trabalho do Tableau Server ou outro recurso. O Tableau Server inicia o processo de autenticação e redireciona o usuário para o IdP. O IdP autentica o usuário. O IdP envia uma resposta de êxito do SAML para o Tableau Server. O usuário abre a pasta de trabalho no Tableau Server. Conta de usuário do Tableau Server. Este nome de usuário deve ser igual ao que o IdP tem armazenado como o nome de usuário ( ). Conta de usuário no IdP. Requisitos do SAML Para configurar o Tableau Server para SAML, você precisa do seguinte: Arquivo de certificado: Um certificado x509 codificado por PEM com a extensão .crt. Arquivo de chave do certificado: Um arquivo de chave RSA ou DSA não protegido pode senha e que tenha uma extensão de arquivo .key. Conta do IdP: Você precisa de uma conta com um provedor de identidades externo. Alguns exemplos são PingFederate, SiteMinder e Open AM. Atributo nomeado nome de usuário: Você deve configurar seu provedor de identidades para retornar um atributo chamado username na resposta SAML. Nomes de usuário correspondentes: Os nomes de usuário do Tableau Server e os nomes de usuário no IdP devem ser iguais. Por exemplo, se o nome de usuário de Jane Silva estiver armazenado no PingFederate como jsmith, ele também deverá ser armazenado no Tableau Server como jsmith. Além disso, caso você esteja configurando SAML como parte da Instalação do Tableau Server, parte da Instalação está criando a conta de administrador do Tableau Server. Antes de executar a Instalação, verifique se a conta que você pretende usar existe em seu IdP. Nenhum logon automático do Active Directory: Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o Active Directory no gerenciamento de usuários, não use também Habilitar logon automático. SAML Você pode configurar o Tableau Server para usar um provedor de identidade externo (IdP) para autenticar usuários do Tableau Server usando SAML. Toda a autenticação de usuário é feita fora do Tableau, independentemente de você estar usando ou não o Active Directory ou a autenticação local no Tableau Server para gerenciar suas contas de usuário no Tableau Server. Isso permite oferecer uma experiência de logon único em todos os aplicativos na organização. Antes de configurar o Tableau Server for SAML, verifique se você atende aos Requisitos do SAML. Configurar SAML Para configurar o Tableau Server a fim de usar SAML: 1. Coloque os arquivos de certificado em uma pasta chamada SAML, paralela à pasta 8.1 do Tableau Server. Por exemplo: C:\Program Files\Tableau\Tableau Server\SAML Esse local fornece à conta que está executando o Tableau Server as permissões necessárias para os arquivos. 2. A configuração de SAML é identificada na guia SAML, exibida durante a Instalação do Tableau Server. Caso você esteja configurando o SAML após a Instalação, acesse a guia SAML abrindo o utilitário de configuração do Tableau Server (Iniciar > Todos os Programas > Tableau Server8.1 > Configurar Tableau Server) e clicando na guia SAML. 3. Na guia SAML, selecione Usar SAML para logon único e forneça o local para cada uma das seguintes opções: URL de retorno do Tableau Server — A URL que os usuários do Tableau Server acessarão, como http://tableau_server. Usar http://localhost não é recomendável. ID da entidade SAML — O ID da entidade identifica com exclusividade a instalação do Tableau Server para o IdP. Você pode inserir o URL do Tableau Server novamente aqui, caso queira, mas não precisa ser seu URL do Tableau Server. Arquivo de certificado SAML — Um certificado x509 com codificação PEM e a extensão .crt Arquivo da chave de certificado SAML — Uma chave RSA ou DSA não protegida por senha com a extensão de arquivo .key 4. Deixe a caixa de texto Arquivo de metadados IdP SAML vazia por enquanto e clique em Exportar arquivo de metadados. 5. Uma caixa de diálogo que permite salvar as configurações SAML do Tableau Server como um arquivo XML. Nesse ponto, os metadados de seu IdP não estão incluídos. Salve o arquivo XML com o nome de sua escolha. 6. No site de seu IdP ou em seu aplicativo: l l Adicione o Tableau Server como um provedor de serviços.Você precisará consultar a documentação de seus IdPs sobre como fazer isso. Como parte disso, você importará o arquivo salvo na etapa 5. Confirme se seu IdP usa nome de usuário como o elemento de atributo a ser verificado. 7. Ainda dentro de seu IdP, exporte o arquivo XML de metadados de seu IdP. 8. Copie o arquivo XML de metadados de seu IdP para a seguinte pasta em seu computador do Tableau Server: C:\Program Files\Tableau\Tableau Server\SAML 9. Na guia SAML, na caixa de diálogo Configuração do Tableau Server, informe o local até o arquivo na caixa de texto Arquivo de metadados IdP SAML: 10. Clique em OK. O Tableau Server já está configurado para autenticação SAML. Testar sua configuração Teste sua configuração SAML abrindo uma nova instância do navegador da Web e digitando o nome do Tableau Server na janela URL: O prompt de entrada exibido é de seu IdP, e não do Tableau Server: Solução de problemas do SAML Use os tópicos a seguir para solucionar problemas do SAML. SAML e habilitar logon automático Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o Active Directory, não selecione também Habilitar logon automático. Habilitar logon automático e SAML não podem ser usados. Falha no logon Caso você receba a mensagem "Falha no logon: Autenticação do Provedor de identidade bem-sucedida para o usuário <username from IdP>. Falha ao encontrar o usuário no Tableau Server." Os nomes de usuário conforme armazenados no Tableau Server e conforme armazenados em seu IdP não são idênticos. Para corrigir isso, verifique se eles são iguais. Por exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como jsmith, ele deverá ser armazenado no Tableau Server como jsmith. Log de erros do SAML Os erros de entrada do SAML são registrados no local a seguir. Você pode usar esse log para solucionar problemas. C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver\error.log Usuário Run As Você pode usar uma conta de usuário AD (Active Directory) dedicada sob a qual executar o serviço do Tableau Server chamada conta de usuário Run As. Alguns administradores optam por fazer isso quando pastas publicadas no Tableau Server se conectam a fontes de dados ativas. A conta Serviço de rede padrão do servidor (NT AUTHORITY\NetworkService) não tem as permissões corretas para se conectar a fontes de dados em outros computadores. Uma conta AD configurada corretamente sim. Para fontes de dados que exigem autenticação NT, a conta AD também pode tratar automaticamente do processo de autenticação, evitando, assim, que os usuários sejam solicitados a fornecer credenciais quando a pasta de trabalho se conecta à fonte de dados ativa. Por fim, a conta AD de usuário Run As que é dedicada a um recurso específico é, muitas vezes, menos problemática para gerenciar do que uma conta AD associada a uma pessoa. Para configurar o Tableau Server para usar uma conta de usuário Run As, siga os procedimentos abaixo. Se você estiver executando uma instalação distribuída do Tableau Server, estas etapas deverão ser executadas nos computadores de trabalho e primário. Observe também que as etapas em Configurações da conta Run As a serem confirmadas podem variar de site para site. Observação: Se estiver instalando o Tableau Server com sua conta de usuário Run As, antes de executar a instalação, confirme se o serviço Logon Secundário do Windows tem os valores corretos para Logon e Inicialização. Consulte Verificar as configurações do Tableau Service para obter mais informações. Identificar a conta Sua primeira etapa é identificar ou criar uma conta Active Directory sob a qual executar o serviço do Tableau Server. Essa será a conta de usuário Run As do Tableau Server e deverá ter o seguinte: l l l Permissões para se conectar à fonte de dados com pelo menos acesso de leitura. Credenciais para permitir que o Tableau Server atenda ao processo de autenticação NT com a fonte de dados. As fontes de dados Microsoft que executam a autenticação NT incluem o Microsoft SQL Server e Microsoft Analytical Services (MSAS), mas não o Access nem o Excel. Permissões para consultar seu controlador de domínio do Active Directory para usuários e grupos. Uma conta de usuário criada no computador local em que o Tableau Server está sendo executado provavelmente não terá essas permissões. Confirmar a relação de confiança bidirecional do domínio Confirme se existe uma relação de confiança bidirecional entre domínios, se alguma das afirmações a seguir for verdadeira: l Os computadores que hospedam o Tableau Server e a fonte de dados estão em domínios separados. l Os usuários do Tableau Server estão em domínio separado do Tableau Server ou da fonte de dados. Verificar as configurações do Tableau Service Confirme se os serviços do Tableau receberam os valores corretos de Logon e Inicialização. Se você estiver executando uma instalação distribuída do Tableau Server, execute estas etapas nos computadores de trabalho e primário. 1. Faça logon como administrador no computador que está executando o Tableau Server. 2. No computador do Tableau Server, selecione Iniciar > Painel de controle > Ferramentas administrativas > Gerenciamento de computador > Serviços e aplicativos > Serviços. 3. Abra Serviços e aplicativos e clique em Serviços. Confirme se os serviços a seguir têm as configurações corretas: Nome do serviço Serviço de licenciamento FLEXnet Logon secundário Tableau Server (tabsvc) Tablicsrv Valor do logon Sistema local Valor de inicialização Manual Sistema local Automático <domínio>\<nome_de_usuário> Essa Automático é a conta de usuário Run As. Veja abaixo. Sistema local Automático Alteração do valor de logon Para alterar o valor de Logon do Tableau Server (tabsvc) para a conta de usuário Run As: 1. Na janela Serviços, interrompa o serviço do Tableau Server clicando com o botão direito do mouse no Tableau Server (tabsvc) e selecionando Parar. 2. Selecione Iniciar > Todos os programas > Tableau Server > Configurar o Tableau Server. 3. Na guia Geral, insira o domínio, o nome de usuário e a senha para a conta de usuário Run As do Tableau Server. 4. Clique em OK e reinicie o Tableau Server (tabsvc). Preparar a política de segurança local Se sua conta de usuário Run As não for um administrador no computador (primário e de trabalho, se estiver executando uma instalação distribuída) do Tableau Server, você deverá preparar a política de segurança local do computador para que a conta de usuário Run As do Tableau Server possa fazer logon no computador como um serviço e fazer alterações de configuração. Para isso: 1. Selecione Iniciar > Painel de controle > Ferramentas administrativas > Política de segurança local. 2. Na janela Configurações locais de segurança, abra Políticas locais, destaque Atribuições de direitos do usuário e clique com o botão direito do mouse em Fazer logon como um serviço e selecione Propriedades. 3. Na janela Propriedades de Fazer logon como um serviço, clique em Adicionar usuário ou grupo. 4. Digite o <domain>\<username> para a conta de usuário Run As do Tableau Server (por exemplo: MYCO\tableau_server) e clique em Verificar nomes. 5. Quando a conta for resolvida corretamente, ela será sublinhada. Clique em OK. 6. Repita estas etapas para remover a conta Run As da política Fazer logon localmente. 7. Repita estas etapas para remover a conta Run As da política Negar logon. 8. Clique em OK para fechar as janelas Configurações locais de segurança. Definir as configurações de conexão à fonte de dados Para autenticar automaticamente seus usuários quando a pasta de trabalho que eles estiverem acessando se conectar a uma fonte de dados ativa, autenticada por NT, configure sua conexão de dados do Tableau com a opção Use a segurança integrada do Windows NT selecionada: Segurança integrada do Windows NT Autentica com a conta de usuário Run As do servidor Nome de usuário e senha Cada usuário do Tableau Server é solicitado a fornecer credenciais de banco de dados Configurações da conta Run As a serem confirmadas A conta de usuário Run As precisa de permissões que a permitam ler, executar e, às vezes, modificar arquivos. Dependendo da conta usada como um ponto de partida, ela já pode ter as permissões corretas. Sempre que você alterar a conta Run As do servidor, é preciso confirmar se ela atende aos requisitos a seguir.Se você estiver executando uma instalação distribuída, isso se aplicará aos computadores primário e de trabalho. Conceder permissões de leitura e execução A conta sob a qual o serviço do Tableau Server é executado precisa de permissão para ler e executar arquivos. Sempre que a conta de usuário Run As do servidor for alterada, confirme ou configure o seguinte: 1. No computador que está hospedando o Tableau Server (e o Tableau Worker, se distribuído), use o Windows Explorer para clicar com o botão direito do mouse na unidade na qual o Tableau está instalado, como Disco local (C:) e selecione Propriedades. 2. Na janela Propriedades do disco local, selecione a guia Segurança. 3. Clique em Editar e em Adicionar. 4. Na caixa de diálogo, Selecionar usuários, computadores, contas de serviço ou grupos, digite o <domain>\<username> para a conta de usuário Run As do Tableau Server. Não use uma conta de grupo. 5. Clique em Verificar nomes para resolver a conta e em OK para confirmar. 6. Com a conta de usuário Run As do Tableau Server em destaque, confirme se ela tem as permissões Ler e executar. A seleção de Ler e executar seleciona automaticamente Listar conteúdo da pasta e Ler. 7. Clique em OK para sair. Conceder permissões de modificação A conta também precisa ter a capacidade de executar tarefas como criar arquivos de registro. Confirme ou configure o seguinte: 1. Navegue até as seguintes pastas: C:\Program Files\Tableau C:\ProgramData\Tableau\ Se estiver executando o Tableau Server 32 bits em um sistema operacional de 64 bits, você precisará ir até C:\Program Files (x86)\Tableau, e não C:\Program Files\Tableau. Além disso, a unidade acima e os caminhos podem variar de acordo com o local da instalação do Tableau Server. 2. Clique com o botão direito do mouse na pasta, selecione Propriedades e clique na guia Segurança: l l l l Clique em Editar e em Adicionar. Digite o <domain>\<username> para a conta de usuário Run As do Tableau Server. Clique em Verificar nomes para resolver a conta e em OK para confirmar. Com a conta de usuário Run As do Tableau Server em destaque, confirme se ela tem as permissões Modificar. A seleção de Modificar concede automaticamente todas as permissões, exceto Controle total e Permissões especiais: 3. Para cada pasta a partir da etapa 1 acima, na guia Segurança das propriedades do Tableau, clique em Avançado: 4. Na janela Configurações de segurança avançada do Tableau, clique em Alterar permissões. 5. Na caixa de diálogo Configurações de segurança avançada do Tableau, destaque a conta de usuário Run As e marque a caixa de seleção Substituir todas as permissões de objeto filho com permissões hereditárias desse objeto: 6. Clique em OK para aplicar alterações em todas as subpastas e arquivos. Isso pode demorar alguns minutos. É comum receber várias mensagens de erro do Windows quando você aplica essas alterações. Não há necessidade de cancelar o processo; em vez disso, clique em Continuar. 7. Clique em OK para confirmar as alterações e depois clique em OK na caixa de diálogo Propriedades do Tableau. Modificar configurações de registro A etapa a seguir é opcional e não é vista na maioria dos ambientes. Se a segurança de registro for altamente restritiva, conceda à conta de usuário Run As do Tableau Server as permissões de leitura e gravação para as seguintes ramificações de registro: l HKEY_CURRENT_USER\Software\Tableau l Computador de 32 bits: HKEY_LOCAL_MACHINE\Software\Tableau l Computador de 64 bits: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Tableau e Representação do SQL Server A representação acontece quando uma conta de usuário atua em nome de outra conta de usuário. Você pode configurar o Tableau e o Microsoft SQL Server para executarem a representação de usuários de banco de dados, de modo que a conta de banco de dados do SQL Server usada pelo Tableau Server faz consultas em nome dos usuários do banco de dados do SQL Server, que também são usuários do Tableau. O principal benefício desse recurso é que ele permite aos administradores implementar e controlar a respectiva política de segurança de dados em um local: nos respectivos bancos de dados. Quando os usuários do Tableau acessam uma exibição com uma conexão ativa a um banco de dados do SQL Server, a exibição mostra apenas o que as permissões de banco de dado dos usuários permitem que eles vejam. Um benefício adicional é que os usuários não precisam responder a uma solicitação de logon do banco de dados quando acessam a exibição. Além disso, os editores da pasta de trabalho não precisam depender de filtros específicos de usuário para restringir o que é visto nas exibições. Use os tópicos abaixo para obter mais informações sobre o que você precisa para usar esse recurso. Requisitos de representação Veja o que você precisa para usar o recurso: l l l l Conexões ativas somente com o SQL Server: A representação pode ser usada somente para exibições que têm conexão ativa com um banco de dados SQL Server versão 2005 ou mais recente. Contas de banco de dados individuais: Cada pessoa que acessará a exibição deverá ter uma conta individual explícita no banco de dados do SQL Server ao qual a exibição se conectará. Membros de um grupo do Active Directory (AD) não podem ser representados. Por exemplo, se Jane Smith for um membro do grupo Vendas do AD e seu administrador de banco de dados adicionar o grupo ao banco de dados do SQL Server, Jane não poderá ser representada. Credenciais correspondentes e tipo de autenticação: As credenciais de cada conta de usuário do Tableau e o respectivo tipo de autenticação de usuário do Tableau devem corresponder às credenciais e ao tipo de autenticação no banco de dados do SQL Server. Em outras palavras, se a conta de usuário de Jane Smith no Tableau Server tiver um nome de usuário de MyCo\jsmith e o Tableau Server estiver usando o Active Directory para autenticação de usuário, seu nome de usuário no banco de dados do SQL Server também deverá ser MyCo\jsmith e o SQL Server deverá estar usando a Autenticação Integrada do Windows. Pré-requisitos do SQL Server: No SQL Server, você deve ter uma tabela de segurança de dados, uma exibição que imponha a segurança de dados, e você deve exigir que os usuários de seu banco de dados usem a exibição. l Conta SQL IMPERSONATE: Você precisa de uma conta de banco de dados do SQL Server que tenha a permissão IMPERSONATE para os usuários do banco de dados acima. Essa é uma conta com a função sysadmin ou uma que tenha recebido a permissão IMPERSONATE para cada conta de usuário individual (consulte o artigo do MSDN em EXECUTE AS). Essa conta do SQL Server também deve ser uma de duas contas no Tableau: l l A conta de usuário Run As do Tableau Server (consulte Representação com uma conta de usuário Run As). A conta do publicador da pasta de trabalho (consulte Representação com credenciais SQL inseridas). Como funciona a representação Veja uma ilustração de como funciona a representação do usuário do banco de dados: Na ilustração acima, Jane Smith (MyCo\jsmith) é uma representante de vendas da Costa Oeste e Henry Wilson (MyCo\hwilson) cobre a Leste. No banco de dados do SQL Server, as permissões da conta de Jane, MyCo\jsmith, fornecem apenas acesso ao dados da Costa Oeste. A conta de Henry, MyCo\hwilson, pode acessar apenas os dados da Costa Leste. Uma exibição foi criada, mostrando dados do país inteiro. Ela tem um conexão ativa com um banco de dados do SQL Server. Ambos os usuários entram no Tableau Server e clicam na exibição. O Tableau Server se conecta ao SQL Server usando uma conta de banco de dados com a permissão IMPERSONATE para a conta de banco de dados de cada usuário. Essa conta atua em nome da conta de banco de dados de cada usuário. Quando a exibição é mostrada, ela é restringida pelas permissões de banco de dados individuais de cada usuário. Jane vê somente os dados de vendas da Costa Oeste; Henry vê apenas os dados da Costa Leste. Representação com uma conta de usuário Run As A representação por uma conta de usuário Run As é a maneira recomendada de executar a representação. A conta de usuário Run As é uma conta do AD que o serviço do Tableau Server pode executar na máquina que está hospedando o Tableau Server (consulte Usuário Run As). Essa mesma conta deve ter a permissão IMPERSONATE para as contas de usuário do banco de dados no SQL Server. Do ponto de vista de segurança de dados, usar a conta Run As do Tableau Server para representação fornece ao administrador mais controle. Para configurar a representação com uma conta de usuário Run As: 1. Quando você configura o Tableau Server como parte da instalação, em Usuário Run As do servidor, insira a conta do AD do usuário Run As que tem a permissão IMPERSONATE para as contas de usuário. Em Autenticação do usuário, selecione Usar Active Directory: 2. Clique em OK para concluir a configuração. 3. Crie uma pasta de trabalho no Tableau Desktop. Ao criar a conexão de dados, selecione Use a segurança integrada do Windows NT para a conexão ativa da pasta de trabalho com um banco de dados do SQL Server. 4. No Tableau Desktop, publique a pasta de trabalho no Tableau Server (Servidor > Publicar pasta de trabalho). 5. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo Autenticação, selecione Representar por meio da conta Run As do servidor na lista suspensa: 6. Clique em OK. 7. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve ver apenas os dados que o usuário está autorizado a ver. Representação com credenciais SQL inseridas Também é possível executar a representação tendo a pessoa que publica uma exibição inserindo suas respectivas credenciais de conta do SQL Server na exibição. O Tableau Server pode ser executado sob qualquer tipo de conta, mas ele usará essas credenciais, fornecidas pelo editor, para se conectar ao banco de dados. Essa pode ser a escolha certa para seu site se a conta que manipula a representação não puder ser uma conta do AD e se você se sentir à vontade fornecendo aos editores da pasta de trabalho uma conta com um nível de permissão potencialmente alto no SQL Server. Observação: Para usar essa abordagem, Credenciais inseridas devem estar habilitadas no Tableau Server: Para representar com a conta do SQL do publicador da pasta de trabalho: 1. No Tableau Desktop, crie uma pasta de trabalho. Ao criar a conexão de dados, selecione Use um nome de usuário e uma senha específicos para a conexão ativa da pasta de trabalho com um banco de dados do SQL Server: 2. Publique a pasta de trabalho no Tableau Server (Servidor > Publicar pasta de trabalho). 3. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo Autenticação, selecione Representar por meio da senha inserida na lista suspensa: 4. Clique em OK. 5. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve ver apenas os dados que o usuário está autorizado a ver. Portas TCP/IP A tabela a seguir lista as portas usadas por padrão pelo Tableau Server e quais devem estar disponíveis para associação. Se o Firewall do Windows estiver habilitado, o Tableau Server abrirá as portas necessárias; você não precisa fazer isso (para instalações distribuídas com um computador de trabalho executando o Windows 7, consulte a Base de dados de conhecimento do Tableau). Usada por este processo do Porta servidor... 80 Gateway. TIPO DE INSTALAÇÃO Alta Todos Distribuído disponibilidade Parâmetro X gateway.public.port, worker0.gateway.port Usada por este processo do Porta servidor... TIPO DE INSTALAÇÃO Alta Todos Distribuído disponibilidade Parâmetro 443 SSL. Quando o Tableau Server é configurado para SSL, o servidor de aplicativos redireciona solicitações para essa porta. X -- 3729 Instalação do Tableau Server. X -- O Tableau Worker atua em ambientes distribuídos e altamente 3730disponíveis (o 3731 Tableau Server primário não escuta nessas portas). Servidor de aplicativos (porta base 8000). São usadas as portas consecutivas após a 8000, até o número de 8000 processos. Por 8059 padrão, o Tableau Server é instalado com dois processos de servidor de aplicativos (portas 8000 e 8001). X X -- X wgserver.port 8060 Banco de dados PostgreSQL. X pgsql.port 8061 Firebird. X firebird.port 8062 Processo que X pgsql.initport Usada por este processo do Porta servidor... TIPO DE INSTALAÇÃO Alta Todos Distribuído disponibilidade Parâmetro executa a descoberta em um ambiente distribuído que foi configurado para alta disponibilidade. 8080 Solr e Tomcat HTTP. X solr.port, tomcat.http.port1 8250 Tarefas em segundo plano. X backgrounder.port 9090 Processo que executa a replicação em um ambiente distribuído que foi configurado para alta disponibilidade. X rsync.port VizQL Server (porta base 9100). As portas consecutivas após a 9100, até o número de processos, 9100 - também são 9199 usadas. Por padrão, o Tableau Server é instalado com dois processos do VizQL Server (portas 9100 e 9101). X vizqlserver.port 9700 - Data Server (porta 9899 X dataserver.port 1Esses parâmetros devem ser definidos para o mesmo valor. Usada por este processo do Porta servidor... TIPO DE INSTALAÇÃO Alta Todos Distribuído disponibilidade Parâmetro base 9700). As portas consecutivas após a 9700, até o número de processos, também são usadas. Por padrão, o Tableau Server é instalado com dois processos de servidor de dados (portas 9700 e 9701). Servidores primário e de trabalho para comunicar 27000 informações de licenciamento em 27009 ambientes distribuídos e altamente disponíveis. Uma porta adicional é selecionada dinamicamente para servidores primários ou de trabalho de modo a transmitir informações de licenciamento em ambientes distribuídos e altamente disponíveis. Em vez disso, é X X -- X X -- Usada por este processo do Porta servidor... TIPO DE INSTALAÇÃO Alta Todos Distribuído disponibilidade Parâmetro possível especificar uma porta fixa (27010 é recomendada). Consulte a Base de dados de conhecimento do Tableau para ver detalhes. As instalações onde o servidor primário está em um DMZ devem usar essas orientações. Mecanismo de dados. O Tableau Server é instalado com um processo do processador de dados. É possível 27042 que haja até dois processos do processador de dados por nó, em até dois nós em um cluster. Inicialização de mecanismo de dados em um ambiente 27043 distribuído que foi configurado para alta disponibilidade. X dataengine.port X Editar as portas padrão Você pode modificar as portas padrão usadas pelos processos do Tableau Server utilizando a ferramenta administrativa de linha de comando, tabadmin. Por exemplo, a porta padrão do processo do servidor de aplicativo (wgserver) é 8000. Você pode usar o parâmetro tabadmin workerX.wgserver.port para alterá-la para uma porta diferente. Siga as etapas abaixo para alterar a configuração da porta do Tableau Server. Se você estiver habilitando portas JMX do servidor, consulte Habilitar as portas JMX 1. Abra um prompt de comando como um administrador e digite o seguinte: cd “C:\Program Files\Tableau\Tableau Server\8.1\bin” 2. Modifique um valor de porta digitando o seguinte: tabadmin set <workerX>.<parameter> <new port value> No comando acima, <workerX> se refere ao computador cuja porta você deseja alterar, <parameter> é um dos valores na tabela abaixo (uma porta do processo de servidor, como wgserver.port) e <new port value> é o novo número de porta que você deseja que o processo use. Se o Tableau Server estiver sendo executado em uma máquina, <workerX> será worker0. Se você estiver executando um cluster, worker0 será o primário, worker1 será seu primeiro servidor de trabalho, worker2 será o segundo etc. Nesse último caso, seria necessário executar o comando (de um prompt de comando no primário) uma vez para cada máquina no cluster. Aqui está um exemplo que define a porta no primário ou um servidor autônomo como 8020 para o processo do servidor de aplicativo (wgserver): tabadmin set worker0.wgserver.port 8020 O exemplo a seguir define a porta para um cluster de 3 máquinas (uma primária e dois trabalhos) como 9200 para o processo de servidor VizQL. tabadmin set worker0.vizqlserver.port 9200 tabadmin set worker1.vizqlserver.port 9200 tabadmin set worker2.vizqlserver.port 9200 Você pode usar os parâmetros a seguir para modificar as portas correspondentes — consulte Portas TCP/IP para obter uma lista completa dos parâmetros tabadmin que podem ser definidos. Porta a ser alterada Parâmetro 80 gateway.public.port, worker0.gateway.port 8000 wgserver.port 8060 pgsql.port 8080 solr.port, tomcat.http.port1 9100 vizqlserver.port 9700 dataserver.port 3. Depois que você fizer as alterações de configuração de porta necessárias, reinicie o Tableau Server digitando o seguinte: tabadmin restart 1Esses parâmetros devem ser definidos para o mesmo valor. Enquanto o servidor estiver reiniciando, ele estará indisponível a todos os usuários. Não se esqueça de avisar os usuários sobre a paralisação antes de executar essa operação ou agende essa manutenção para ser executada fora de horários comerciais. Habilitar as portas JMX Para ajudá-lo a lidar com um problema no Tableau Server, o Suporte do Tableau poderá solicitar que você habilite as portas JMX do servidor. Essas portas podem ser usadas para o monitoramento e a solução de problemas, geralmente com uma ferramenta como o JConsole. Para habilitar as portas JMX no Tableau Server: 1. Interrompa o servidor. 2. Insira o seguinte comando: tabadmin set service.jmx_enabled true 3. Insira o comando configurar: tabadmin configure 4. Inicie o servidor. Lista de portas JMX Aqui está a lista de portas JMX, todas as quais estão desabilitadas por padrão. Quando habilitadas, essas portas são usadas para todos os tipos de instalações: servidor único, distribuído e de alta disponibilidade. Porta Usada por este processo do servidor... Parâmetro 8300 8359 Servidor de aplicativos JMX Determinada pelas portas do -servidor de aplicativo + 300. 8550 Monitor em segundo plano JMX. Determinado pela porta -em segundo plano de 8250 + 300. 9095 Monitor de serviços JMX. svcmonitor.jmx.port 9400 9499 VizQL Server JMX. Determinada pelas portas do VizQL Server + 300. -- 10000 10299 Data Server JMX. Determinada pelas portas do servidor de dados + 300. -- Como as portas JMX são determinadas As portas JMX para o servidor de aplicativos (8300 - 8359), o processador em segundo plano (8550), o VizQL Server (9400 - 9599) e o Data Server (10000 - 10299) são atribuídas com o uso da fórmula “porta base + 300” (consulte Portas TCP/IP para ver uma lista das portas base padrão). Além disso, se houver várias instâncias de um processo, cada uma terá uma porta JMX. Por exemplo, se você configurar o Tableau Server para executar quatro instâncias do processo do servidor de aplicativos, as portas 8000 (porta base padrão), 8001, 8002 e 8003 são usadas. Em seguida, as portas JMX do servidor de aplicativo 8300 (porta base + 300), 8301, 8302 e 8303 são associadas a suas respectivas instâncias de processo. Mesmo que não sejam usadas diretamente pelo Tableau Server, se uma porta JMX estiver sendo usada por outro aplicativo, os processos do Tableau Server não serão executados. Além disso, as portas JMX não podem ser editadas diretamente com o uso de tabadmin. Você altera uma porta JMX alterando a porta base para seu processo. Em outras palavras, se a porta 10000 não estiver disponível para o processo JMX do servidor de dados, você usará tabadmin (conforme descrito em Editar as portas padrão) para alterar a porta base do servidor de dados de 9700 para 9800. Isso moverá a porta JMX do servidor de dados para 11000. Para reduzir os riscos de segurança, é uma boa prática configurar seu firewall para bloquear o tráfego externo para as portas JMX. Restaurar o valor padrão para uma porta Você pode restaurar o valor padrão para uma porta seguindo o procedimento abaixo: 1. Abra um prompt de comando como um administrador e digite o seguinte: cd “C:\Program Files\Tableau\Tableau Server\8.1\bin” 2. Restaure o valor de porta padrão digitando o seguinte: tabadmin set <workerX>.<parameter> --default Se o Tableau Server estiver sendo executado em uma máquina, <workerX> será worker0. Se você estiver executando um cluster, worker0 será o primário, worker1 será seu primeiro servidor de trabalho, worker2 será o segundo etc. Vejamos um exemplo: tabadmin set worker0.wgserver.port --default 3. Reinicie o Tableau Server digitando o seguinte: tabadmin restart tabcmd O utilitário tabcmd é uma das duas ferramentas de linha de comando que são instaladas com o Tableau Server (a outra é tabadmin). Os comandos fornecidos pelo tabcmd podem ajudar a automatizar tarefas comuns, como publicar pastas de trabalho em lotes e administrar usuários e grupos. O utilitário tabcmd é instalado na pasta bin do Tableau Server (C:\Program Files\Tableau Server\8.1\bin), mas você pode instalar e executar o tabcmd em outro computador também. Consulte os tópicos abaixo para obter mais informações: Instalar tabcmd O utilitário de linha de comando tabcmd é instalado com o Tableau Server por padrão e pode ser executado com base na pasta bin do servidor (por exemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin). Para flexibilidade administrativa, ele pode ser instalado em outro computador também. Para instalar o tabcmd: 1. Navegue até a pasta extras do Tableau Server: C:\Program Files\Tableau\Tableau Server\8.1\extras\TabcmdInstaller.exe 2. Copie TabcmdInstaller.exe no computador onde deseja instalá-lo. 3. Clique duas vezes em TabcmdInstaller.exe para executá-lo. 4. Siga as instruções para instalar o tabcmd. Como tabcmd é uma ferramenta de linha de comando e, devido a algumas limitações com o sistema operacional Windows, a Tableau recomenda instalar o tabcmd em uma pasta chamada tabcmd na raiz de C:\ drive (C:\tabcmd). Executar o programa de instalação tabcmd não adiciona tabcmd automaticamente à variável PATH do Windows. Então, é necessário chamar tabcmd explicitamente usando o caminho completo ou adicionar seu diretório à variável PATH. Como usar tabcmd A primeira etapa para usar o tabcmd é abrir um prompt de comando como administrador. Em seguida, você navega até a pasta bin do Tableau Server (por exemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin) ou inclui esse local em seus comandos. Para usar tabcmd para executar tarefas no Tableau Server, estabeleça uma sessão de servidor autenticada. A sessão identifica o Tableau Server e o usuário do Tableau Server que está executando a sessão. Você pode iniciar uma sessão primeiro e depois especificar seu comando em seguida, ou você pode iniciar uma sessão e executar um comando de uma vez. O comando a seguir demonstra como iniciar uma sessão com o Tableau Server chamada tabserver.myco.com: tabcmd login -s http://tabserver.myco.com -u admin -p p@ssw0rd! Este comando exclui uma pasta de trabalho chamada Sales_Workbook: tabcmd delete "Sales_Workbook" Confira aqui como fazer tudo o que foi descrito acima com um comando; observe que não é preciso usar login aqui: tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -u admin -p p@ssw0rd! O Tableau Server Não pode executar vários sites. Quando uma pasta de trabalho está no site Padrão de um servidor de vários sites, não é preciso especificar Padrão, o comando acima é o suficiente. No entanto, se o comando se aplicar somente a algo em um site diferente do Padrão, você deverá especificar a ID desse site (consulte login). Este é o mesmo comando para uma pasta de trabalho que está no site West Coast Sales (ID de site wsales): tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -t wsales -u admin -p p@ssw0rd! As opções -s, -t, -u e -p estão entre as variáveis globais do tabcmd, o que significa que elas podem ser usadas com qualquer comando. Quando o comando for bem-sucedido, tabcmd retornará um código de status de zero. Uma mensagem de erro completa para códigos de status diferentes de zero é impressa para stderr. Além disso, as mensagens de progresso ou informativas podem ser impressas para stdout. Um registro completo chamado tabcmd.log que inclui mensagens de depuração, progresso e erro é gravado em: l l Windows Server 2012, Windows Server 2008 R2, Windows Vista, Windows 7, Windows 8: C:\Users\<username>\AppData\Roaming\Tableau Windows Server 2003: C:\Documents and Settings\<username>\Application Data\Tableau Opções globais de tabcmd A tabela abaixo mostra as opções que são usadas por todos os comandos. As opções -server, --user e --password são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem incluir essas opções. Esse token permanece válido por cinco minutos depois que o último comando o usou. Opção Opção (curta) (longa) -h --help Argumento Descrição Exibe a ajuda do comando. Opção Opção (curta) (longa) Argumento Descrição -s --server Tableau Server URL Exigida pelo menos uma vez para iniciar a sessão. -u --user Tableau Server nome de usuário Exigida pelo menos uma vez para iniciar a sessão. -p -password Tableau Server senha Exigida pelo menos uma vez para iniciar a sessão. Se preferir, você pode usar a opção -P. -P -password- filename.txt file -t --site Tableau Server site name -x --proxy Host:Port Permite que a senha seja armazenada no arquivo fornecido, em vez de na linha de comando para aumento da segurança. Especifica que o comando se aplica ao site do Tableau Server especificado. Se você não especificar um site, o site Padrão será adotado. Aplica-se somente a servidores com vários sites. Use o proxy HTTP especificado. --noprompt Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará. --noproxy Quando especificada, um proxy HTTP não será usado. --nocertcheck Quando especificada, o certificado SSL não será validado. --[no-] cookie Quando especificada, a Id da sessão é salva no logon, para que comandos subsequentes não precisem fazer logon. Use o prefixo no- para não salvar a Id da sessão. Por padrão, a sessão é salva. --timeout segundos Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o tempo limite do processo se esgotará em 30 segundos. Comandos de tabcmd Veja os comandos que podem ser usados com a ferramenta de linha de comando tabcmd: addusers nome do grupo creategroup nome do grupo createproject nome do projeto createsite nome do site createsiteusers filename.csv createusers filename.csv delete workbook-name or datasource-name deletegroup nome do grupo deletesite nome do site deleteusers filename.csv editsite nome do site export get url listsites login logout publish filename.twb (x), filename.tds (x), or filename.tde refreshextracts workbookname or datasourcename removeusers nome do grupo runschedule nome da agenda set configuração syncgroup nome do grupo version addusers nome do grupo Adiciona os usuários listados no argumento --users ao grupo com o nome de grupo fornecido. Exemplo tabcmd addusers "Development" --users "users.csv" Opção Opção (longa) (curta) --users Argumento Descrição filename.csv Adiciona usuários no arquivo Opção Opção (longa) (curta) Argumento Descrição fornecido ao grupo especificado. O arquivo deve ser uma lista simples com um nome de usuário por linha. Os usuários já devem ter sido criados no Tableau Server. Consulte também Importar usuários de um arquivo CSV. --[no-]complete Quando definida como complete, essa opção exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, -complete será usada. creategroup nome do grupo Cria um grupo com o nome do grupo fornecido. Use os comandos addusers (para grupos locais) e syncgroup (para grupos do Active Directory) para adicionar usuários após a criação do grupo. Exemplo tabcmd creategroup "Development" createproject nome do projeto Cria um projeto com o nome do projeto fornecido. Exemplo tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports." Opção (curta) Opção (longa) Argumento Descrição -n --name nome Especifique o nome do projeto que você deseja criar. Opção (curta) Opção (longa) Argumento Descrição -d -descrição description Especifique uma descrição para o projeto. createsite nome do site Cria um site com o nome do site fornecido. Exemplos Crie um site denominado West Coast Sales. Uma ID de site WestCoastSales será automaticamente criada, o site não terá limite de cota de armazenamento e os administradores de site poderão adicionar e remover usuários: tabcmd createsite "West Coast Sales" Crie um site denominado West Coast Sales com a ID de site wsales: tabcmd createsite "West Coast Sales" -r "wcoast" Impeça que os administradores de site adicionem usuários ao site: tabcmd createsite "West Coast Sales" --no-site-mode Defina uma cota de armazenamento, em MB: tabcmd createsite "West Coast Sales" --storage-quota 100 OpçOpção ão (cur- (longa) ta) Argumento Descrição -r --url ID do site Usada em URLs para especificar o site. Diferente do nome do site. -userquota número de usuários Número máximo de usuários que podem ser adicionados ao site. -[no-] sitemode Permitir ou negar a administradores de site a capacidade de adicionar usuários ao site ou removê-los. -storag- número de eMB quota Em MB, a quantidade de pastas de trabalho, extrações e fontes de dados que podem ser armazenadas no site. createsiteusers filename.csv Esse comando permite que administradores de site adicionem usuários a um site. Isso cria usuários no site atual usando o arquivo csv (valores separados por vírgula) fornecido. O arquivo pode ter as seguintes colunas, na ordem mostrada abaixo: 1. Username 2. Password 3. Full Name 4. License Level (interactor/viewer/unlicensed) 5. Administrator (site/none) 6. Publisher (yes/true/1 ou no/false/0) 7. Email Address O arquivo pode ter menos colunas. Por exemplo, ele pode ser uma lista simples com um nome de usuário por linha. Quando o servidor estiver usando a autenticação do Active Directory, a coluna Password deverá ser ignorada. As cotações poderão ser usadas se um valor contiver vírgulas. Consulte Importar usuários de um arquivo CSV para obter outros detalhes. Exemplo tabcmd createsiteusers "users.csv" --license "Interactor" -publishers Opção Opção (curta) (longa) Argumento Descrição --nowait Não espera que os trabalhos assíncronos sejam concluídos. --silentprogress Não exibe mensagens de progresso para trabalhos assíncronos. --license --admintype Define o nível de licença padrão Interactor para todos os usuários. Essa , Viewer ou configuração pode ser substituída Unlicensed pelo valor no arquivo CSV. Site ou None Atribui ou remove o direito de administração de site para todos os usuários no arquivo CSV. Essa configuração pode ser substituída pelo valor no arquivo CSV. O Opção Opção (curta) (longa) Argumento Descrição padrão é None para novos usuários e não alterado para usuários existentes. Administradores de sistema não podem ser criados nem rebaixados usando createsiteusers (use createusers). --[no-] publishers Atribui ou remove o direito de publicação para todos os usuários no arquivo CSV, por padrão. Essa configuração pode ser substituída pelo valor no arquivo CSV. O padrão é no para novos usuários e não alterado para usuários existentes. --[no-] complete Exige (ou não) que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Por padrão, é usada a opção -complete. createusers filename.csv Cria os usuários listados no arquivo CSV (valores separados por vírgula). Esse comando pode ser usado somente por administradores de sistema. O arquivo pode ter as seguintes colunas, na ordem mostrada abaixo: 1. Username 2. Password 3. Full Name 4. License Level (interactor/viewer/unlicensed) 5. Administrator (system/site/none) 6. Publisher (yes/true/1 ou no/false/0) 7. Email Address O arquivo pode ter menos colunas. Por exemplo, ele pode ser uma lista simples com um nome de usuário por linha. Quando o servidor estiver usando a autenticação do Active Directory, a coluna Password deverá ser deixada em branco. As cotações poderão ser usadas se um valor contiver vírgulas. Consulte Importar usuários de um arquivo CSV para obter mais detalhes. Exemplo tabcmd createusers "users.csv" --license "Interactor" --publisher Opção Opção (curta) (longa) Argumento Descrição --nowait Não espera que os trabalhos assíncronos sejam concluídos. --silentprogress Não exibe mensagens de progresso para trabalhos assíncronos. Define o nível de licença padrão para Interactor todos os usuários. Essa configuração --license , Viewer ou pode ser substituída pelo valor no Unlicensed arquivo CSV. --admintype System, Site ou None Atribui ou remove o direito Admin para todos os usuários no arquivo CSV, por padrão. Essa configuração pode ser substituída pelo valor no arquivo CSV. O padrão é None para novos usuários e não alterado para usuários existentes. --[no-] publisher Atribui o direito Publicar a todos os usuários no arquivo CSV, por padrão. Essa configuração pode ser substituída pelo valor no arquivo CSV. O padrão é no para novos usuários e não alterado para usuários existentes. --[no-] complete Exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Por padrão, é usada a opção --complete. delete workbook-name or datasource-name Exclui do servidor a pasta de trabalho ou fonte de dados fornecida. Esse comando captura o nome da pasta de trabalho ou da fonte de dados como está no servidor, e não o nome do arquivo quando ele foi publicado. Exemplo tabcmd delete "Sales_Analysis" Opção Opção (curta) (longa) -r --project Argumento Descrição Nome do projeto O nome do projeto que contém a pasta de trabalho ou a fonte de dados a ser excluída. Caso não esteja especificado, o projeto “Padrão” será adotado. Nome da --workbook pasta de trabalho O nome da pasta de trabalho que você deseja excluir. Nome da -fonte de datasource dados O nome da fonte de dados que você deseja excluir. deletegroup nome do grupo Exclui do servidor o grupo com o nome de grupo fornecido. Exemplo tabcmd deletegroup "Development" deletesite nome do site Exclui do servidor o site com o nome de site fornecido. Exemplo tabcmd deletesite "Development" deleteusers filename.csv Exclui os usuários listados no arquivo CSV (valores separados por vírgula) fornecido. O arquivo é uma lista simples de um nome de usuário por linha. Exemplo tabcmd deleteusers "users.csv" Opção Opção (curta) (longa) Argumento Descrição --[no-] complete Quando definida como --complete, essa opção exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, --complete será usada. editsite nome do site Permite alterar o nome de um site ou o nome de sua pasta Web. Você também pode usar esse comando para permitir ou negar a administradores de site a capacidade de adicionar e remover usuários. Se os administradores de site tiverem direitos de gerenciamento de usuário, você poderá especificar quantos usuários eles podem adicionar a um site. Exemplos tabcmd editsite wc_sales --site-name "West Coast Sales" tabcmd editsite wc_sales --site-id "wsales" tabcmd editsite wsales --status ACTIVE tabcmd editsite wsales --user-quota 50 Opção (longa) Argumento Descrição --sitename Nome para o qual alterar o site O nome do site que é exibido. --siteid A ID para a qual alterar o site Usada na URLs para identificar o site de forma exclusiva. --userquota Número de usuários Número máximo de usuários que podem ser membros do site. --[no-] sitemode Permitir ou impedir que os administradores de site adicionem usuários ao site. --status ACTIVE ou Ativar ou suspender um site. SUSPENDED -- Número de Em MB, a quantidade de pastas de trabalho, Opção (longa) Argumento storageMB quota Descrição extrações e fontes de dados que podem ser armazenadas no site. export Exporta uma exibição ou pasta de trabalho do Tableau Server e a salva em arquivo. Observe o seguinte quando for usar esse comando: l l Permissões: Para exportar, você deve ter a permissão Exportar imagem. Por padrão, essa permissão é autorizada ou herdada para todas as funções, embora as permissões possam ser definidas por pasta de trabalho ou exibição. A exibição, a pasta de trabalho ou os dados a serem exportados: Você especifica isso usando a string "workbook/view" como aparece na URL da pasta de trabalho ou exibição, e não usando seu “nome amigável”. Por exemplo, para exportar o exemplo de exibição do Investment Growth da pasta de trabalho Finance, você usaria a string Finance/InvestmentGrowth. Use -t <site_id> se o servidor estiver executando vários sites e a exibição ou pasta de trabalho estiver em um site que não seja o site padrão. Para exportar a pasta de trabalho, você ainda inclui uma exibição válida na string que será usada. Usando o exemplo acima, para exportar a pasta de trabalho Finance, você usaria a string Finance/InvestmentGrowth. Finalmente, para exportar uma pasta de trabalho, ela deve ter sido publicada com a opção Mostrar planilhas como guias na caixa de diálogo Publicar do Tableau Desktop. l l l O formato do arquivo salvo: Suas opções de formato dependem do que está sendo exportado. Uma pasta de trabalho pode ser exportada somente como um PDF usando o argumento --fullpdf. Uma exibição pode ser exportada como PDF (--pdf), PNG (--png), ou você pode exportar os dados da exibição como arquivo CSV (-csv). O nome e o local do arquivo salvo (opcional): Se você não fornecer um nome, ele será derivado do nome da exibição ou da pasta de trabalho. Se você não fornecer um local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você pode especificar um caminho completo ou um que esteja relacionado ao seu diretório de trabalho atual. Objetos de página da Web do painel não incluídos em exportações para PDF: Um painel também pode conter opcionalmente um objeto de página da Web. Se você estiver executando uma exportação para PDF de um painel que contém um objeto de página da Web, esse objeto não será incluído no PDF. Limpeza do cache para usar dados em tempo real Opcionalmente, você pode adicionar o parâmetro de URL ?:refresh=yes para forçar uma consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver usando o tabcmd com seu próprio script e o parâmetro de URL refresh estiver sendo muito usado, isso poderá ter um impacto negativo sobre o desempenho. É recomendável usar somente refresh quando dados em tempo real são necessários, por exemplo, em um painel único em vez de uma pasta de trabalho inteira. Exemplos Exibições tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report" tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports" tabcmd export "Finance/InvestmentGrowth" --png tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png Pastas de trabalho tabcmd export "Q1Sales/Sales_Report" --fullpdf tabcmd export -t Sales "Sales/Sales_Analysis" --fullpdf -pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports" Opção Opção (curta) (longa) Argumento Descrição -f Nome para salvar o arquivo Salva o arquivo com o nome de arquivo fornecido. --filename --csv Somente exibição. Exporta os dados da exibição no formato CSV. --pdf Somente exibição. Exportar como PDF. --png Somente exibição. Exportar como imagem em formato PNG. --fullpdf Somente pasta de trabalho. Exportar como PDF. A pasta de trabalho deve ter sido publicada com a opção Opção Opção (curta) (longa) Argumento Descrição Mostrar planilhas como guias habilitada. -landscape, pagelayout portrait Define a orientação da página do PDF exportado. Se não especificada, sua configuração do Tableau Desktop será usada. unspecified, letter, legal, note folio, tabloid, ledger, --pagesize statement, executive, a3, a4, a5, b4, b5, quatro Define o tamanho da página do PDF exportado. O padrão é letter. --width Número de pixels Define a largura. O padrão é 800 px. --height Número de pixels Define a altura. O padrão é 600 px. get url Usar uma string URL como um de seus parâmetros gera uma solicitação HTTP “GET” do Tableau Server. O resultado é retornado como arquivo. Observe o seguinte quando for usar esse comando: l l Permissões: Para obter um arquivo, você deve ter a permissão Baixar/salvar na Web como. Por padrão, essa permissão é autorizada ou herdada para todas as funções, embora as permissões possam ser definidas por pasta de trabalho ou exibição. Extensão do arquivo: A cadeia de caracteres de URL do arquivo que você deseja OBTER deve conter uma extensão de arquivo - como "/views/Finance/InvestmentGrowth.pdf". A extensão (por exemplo, .pdf) determina o que será retornado. Uma exibição pode ser retornada em formato PDF, PNG, CSV (somente dados) ou XML (somente informações). A pasta de trabalho pode ser retornada como TWB ou TWBX. Para saber a extensão correta a ser usada, você pode usar um navegador da Web para navegar até o item em que está interessado no Tableau Server e adicionar a extensão de arquivo ao final da URL. l l O nome e o local do arquivo salvo (opcional): O nome que você usa para -filename deve incluir a extensão do arquivo. Se você não fornecer um nome e extensão de arquivo, ambos serão derivados da string URL. Se você não fornecer um local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você pode especificar um caminho completo ou um que esteja relacionado ao seu diretório de trabalho atual. Tamanho do PNG (opcional): Se o arquivo salvo estiver em PNG, você poderá especificar o tamanho, em pixels, na URL. Limpeza do cache para usar dados em tempo real Opcionalmente, você pode adicionar o parâmetro de URL ?:refresh=yes para forçar uma consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver usando o tabcmd com seu próprio script e o parâmetro de URL refresh estiver sendo muito usado, isso poderá ter um impacto negativo sobre o desempenho. É recomendável usar somente refresh quando dados em tempo real são necessários, por exemplo, em um painel único em vez de uma pasta de trabalho inteira. Exemplos Exibições tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png" tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf" tabcmd get "/views/Finance/InvestmentGrowth.csv" tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png Pastas de trabalho tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_ Workbooks\Weekly-Reports.twb" tabcmd get "/workbooks/Sales.xml" Outros tabcmd get "/users.xml" --filename "UserList.xml" Opção (curta) Opção (longa) -f -Nome para filename salvar o arquivo Argumento Descrição Salva o arquivo com o nome de arquivo fornecido. listsites Retorna uma lista de sites aos quais o usuário conectado pertence. Exemplo tabcmd listsites -u corman -pw P@ssword! login Conecta um usuário do Tableau Server. Use as opções globais --server, --site, -username, --password para criar uma sessão. e desejar fazer logon usando as mesmas informações já usadas para criar uma sessão, basta especificar a opção --password. Serão usados o nome de usuário e servidor armazenados no cookie. Se o servidor estiver usando uma porta diferente de 80 (padrão), você deverá especificá-la. Você só precisa da opção --site (-t) quando o servidor está executando vários sites e você está se conectando a um site que não o site Padrão. Se você não fornecer uma senha, uma será solicitada. Se a opção --no-prompt for especificada e nenhuma senha for fornecida, o comando falhará. Após o logon, a sessão continuará até expirar no servidor ou até que o comando logout seja executado. Exemplo Conecta você ao Tableau Server executado em seu computador local: tabcmd login -s http://localhost -u jsmith -p p@ssw0rd! tabcmd login -s https://online.tableausoftware.com/t/oursite -u [email protected] -p p@ssw0rd Conecta você ao site Sales em sales-server: tabcmd login -s http://sales-server -t Sales -u administrator -p p@ssw0rd! tabcmd login -s http://sales-server:8000 -t Sales -u administrator -p p@ssw0rd! Conecta você ao site Sales em sales-server usando SSL: tabcmd login -s https://sales-server -t Sales -u administrator -p p@ssw0rd! Estabelece um proxy avançado e uma porta para localhost: tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u jsmith -p p@ssW0rd! Conecta você ao proxy reverso usando SSL: tabcmd login -s https://myreverseproxy -u jsmith -p p@ssW0rd! Opção Opção (curta) (longa) -s Argumento Descrição URL do --server Tableau Server Se você estiver executando o comando do computador do Tableau Server, poderá usar http://localhost. Caso contrário, especifique a URL do computador, por exemplo http://bigbox.myco.com ou http://bigbox. A ID do site. É usada na URL para identificar o site de forma exclusiva. Por exemplo, um site denominado ID do site do West Coast Sales pode ter uma ID Tableau de site WestCoastSales. Use esta Server opção quando o servidor está executando vários sites e você está se conectando a um site que não é o site padrão. -t --site -u Tableau -Server username nome de usuário O nome do usuário do Tableau Server. -p Tableau -Server password senha Senha para o usuário do Tableau Server. Se você não fornecer uma senha, uma será solicitada. -x --proxy Host:Port Use para especificar o servidor proxy HTTP e a porta para a Opção Opção (curta) (longa) Argumento Descrição solicitação tabcmd. --noprompt Não solicite uma senha. Se nenhuma senha for especificada, o comando login falhará. --noproxy Não usar um servidor proxy HTTP. --[no-] cookie Salva a ID de sessão no logon. Os comandos subsequentes não exigirão logon. Os cookies estão habilitados (--cookie) por padrão. -timeout SECONDS O número de segundos que o servidor deve esperar antes de processar o comando login. Padrão: 30 segundos. Número de segundos logout Faz logout no servidor. Exemplo tabcmd logout publish filename.twb(x), filename.tds(x), or filename.tde Publica a pasta de trabalho (.twb(x)), fonte de dados (.tds(x)) ou extração de dados (.tde) fornecida no Tableau Server. Por padrão, todas as planilhas na pasta de trabalho são publicadas sem nomes de usuário ou senhas de banco de dados. Exemplo tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-user "jsmith" --db-password "p@ssw0rd" Opção Opção (longa) Argumento Descrição (curta) -n -o -r --name Nome da pasta de trabalho ou fonte de dados no servidor. Se omitida, a pasta de trabalho, fonte de dados ou extração de dados terá o nome do arquivo. --overwrite Substitui a pasta de trabalho, fonte de dados ou extração de dados se ela já existir no servidor. --project Publica a pasta de trabalho, fonte de dados ou extração de dados no projeto especificado. Publica no projeto “Padrão” se não for especificado. Nome de um projeto --dbusername Use essa opção para publicar um nome de usuário de banco de dados com a pasta de trabalho, fonte de dados ou extração de dados. --dbpassword Use essa opção para publicar uma senha de banco de dados com a pasta de trabalho, fonte de dados ou extração de dados. --save-dbpassword Armazena a senha de banco de dados fornecida no servidor. -thumbnailusername Se a pasta de trabalho contiver filtros de usuários, as miniaturas serão geradas com base no que o usuário específico pode ver. Não pode ser especificada quando a opção --thumbnail-group é definida. -thumbnailgroup Se a pasta de trabalho contiver filtros de usuários, as miniaturas serão geradas com base no que o grupo específico Opção Opção (longa) Argumento Descrição (curta) pode ver. Não pode ser especificada quando a opção -thumbnail-username é definida. --tabbed Quando uma pasta de trabalho com exibições com guias é publicada, cada planilha tornase uma guia que os visualizadores podem usar para navegar pela pasta de trabalho. Observe que essa configuração substituirá qualquer segurança no nível de planilha. --append Anexa o arquivo de extração à fonte de dados existente. --replace Usa o arquivo de extração para substituir a fonte de dados existente. --disableuploader Desabilita o carregador de arquivos incremental. --disabletdecompression Para a compactação do arquivo de extração antes de ele ser carregado. --restart Reinicia o upload do arquivo. Se a pasta de trabalho contiver filtros de usuário, uma das opções de miniatura deverá ser especificada. refreshextracts workbook-name or datasource-name Faz uma atualização completa ou incremental de extrações que pertencem à pasta de trabalho ou fonte de dados especificada. Esse comando captura o nome da pasta de trabalho ou fonte de dados como ele aparece no servidor, e não o nome do arquivo quando ele foi publicado. Exemplos tabcmd refreshextracts --datasource sales_ds tabcmd refreshextracts --workbook "My Workbook" tabcmd refreshextracts --url SalesAnalysis Opção Opção (longa) Argumento Descrição (curta) -incremental Executa a operação de atualização incremental. -synchronous Executa a operação de atualização completa imediatamente no primeiro plano. --workbook Nome de uma pasta de trabalho O nome da pasta de trabalho que contém extrações para atualização. Se a pasta de trabalho tiver espaços no nome, coloque-o entre aspas. -datasource Nome de uma fonte de dados O nome da fonte de dados que contém extrações para atualização. --project Nome de um projeto Use com --workbook ou -datasource para identificar uma pasta de trabalho ou fonte de dados em um projeto que não seja Padrão. Caso não esteja especificado, o projeto Padrão será adotado. --url Nome de URL de uma pasta de trabalho O nome da pasta de trabalho conforme ele aparece na URL. Uma pasta de trabalho publicada como “Análise de vendas” tem um nome de URL denominado “SalesAnalysis”. removeusers nome do grupo Remove os usuários listados no argumento --users do grupo com o nome de grupo fornecido. Exemplo tabcmd removeusers "Development" --users "users.csv" Opção Opção (curta) (longa) --users Argumento Descrição Remove os usuários no arquivo fornecido do grupo especificado. O arquivo deve filename.csv ser uma lista simples com um nome de usuário por linha. --[no-] complete Exige que todas as linhas sejam válidas para que qualquer alteração seja bemsucedida. Se não especificada, -complete será usada. runschedule nome da agenda Executa a agenda especificada. Esse comando captura o nome da agenda como está no servidor. Exemplo tabcmd runschedule "5AM Sales Refresh" set configuração Habilita a configuração especificada no servidor. Os detalhes sobre cada configuração podem ser vistos na página Manutenção do servidor. Use um ponto de exclamação em frente ao nome da configuração para desabilitá-la. É possível habilitar ou desabilitar as seguintes configurações: l embedded_credentials l remember_passwords_forever Exemplo tabcmd set embedded_credentials syncgroup nome do grupo Sincroniza o grupo com o nome de grupo fornecido com o Active Directory. Esse comando também pode ser usado para criar um novo grupo no servidor que é baseado em um grupo existente do Active Directory. Exemplo tabcmd syncgroup "Development" Opção Opção (longa) (curta) --license Argumento Descrição viewer Define o nível de licença para interactor todos os usuários no grupo. unlicensed -system administrator site none Atribui ou remove o direito de Administrador para todos os usuários do grupo. O tipo de usuário Administrador pode ser de sistema, site ou nenhum. O padrão é nenhum (novos usuários não recebem o direito de Administrador) e os usuários existentes não são alterados. --[no-] publisher Atribui ou remove o direito Publicar para todos os usuários do grupo. Se não especificada, novos usuários não receberão esse direito e usuários existentes não serão alterados. --[no-] complete Exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, --complete será usada. --silentprogress Suprime mensagens de progresso. versão Imprime as informações da versão para a instalação atual do utilitário tabcmd. Exemplo tabcmd version tabadmin Você pode executar certas tarefas administrativas e alterar as configurações do Tableau Server usando a ferramenta de linha de comando tabadmin. Para acessá-lo, abra um prompt de comando como um administrador e altere os diretórios usando o comando abaixo: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" Para ver uma lista dos comandos tabadmin disponíveis, digite: tabadmin help commands Para obter mais informações, consulte os tópicos abaixo: tabadmin set Um dos comandos tabadmin usados com mais frequência é tabadmin set, que permite alterar o valor das opções de configuração do Tableau Server. A sintaxe é a seguinte: tabadmin set option-name value Para usar este comando: 1. Interrompa o servidor. 2. Digite tabadmin set seguido do nome da opção e do valor. Por exemplo, para alterar o valor padrão da opção tabadmin backgrounder.querylimit de 7200 segundos (2 horas, o padrão) para 9000 segundos, digite o seguinte: tabadmin set backgrounder.querylimit 9000 Se você configurar uma opção cujo valor começa com hífen, use aspas aninhadas: tabadmin set option-name "'-value'" tabadmin set option-name "'-value1 -value2'" 3. Depois de usar tabadmin set, digite o comando configure: tabadmin configure 4. Por fim, inicie o Tableau Server. Opções tabadmin set Use a tabela abaixo para saber mais sobre as opções do Tableau Server que você pode configurar usando o comando tabadmin set. Consulte Portas TCP/IP para obter uma lista completa de portas. Mostrar padrão Descrição auditing.enabled true Permite acesso às tabelas de auditoria de histórico PostgreSQL (banco de dados próprio do Tableau Server). Consulte Criar exibições administrativas personalizadas para obter detalhes. backgrounder.querylimit 7200 Tempo mais longo permitido para concluir uma atualização de extração, em segundos (7200 segundo = 2 horas). dataengine.port 27042 Porta em que o mecanismo de dados é executado. dataserver.port 9700 Porta em que o data server é executado. gateway.public.host Nome do computador O nome canônico do servidor, usado para acesso externo ao Tableau Server. Se o Tableau Server estiver configurado para funcionar com um servidor proxy, ele será o nome canônico do servidor proxy (não Tableau Server). gateway.public.port 80 (443 se SSL) Aplicável apenas a ambientes de servidor proxy. A porta externa em que o servidor proxy escuta. gateway.timeout 1800 O tempo mais longo, em segundo, que o gateway aguardará por certos eventos antes de reprovar uma solicitação (1800 segundos = 30 minutos). gateway.trusted O endereço IP Aplicável apenas a ambientes de servidor do computador proxy. Os endereços IP ou os nomes de host servidor proxy do servidor proxy. gateway.trusted_hosts Nomes alternativos d servidor proxy Aplicável apenas a ambientes de servidor proxy. Qualquer nome de host alternativo do servidor proxy. java.heap.size 128m Tamanho do heap para Tomcat (repositório e solr). Isso geralmente não precisa ser alterado, exceto por recomendação da Tableau. pgsql.port 8060 Porta na qual o PostgreSQL escuta. rsync.timeout 600 O tempo mais longo permitido, em segundos, para concluir a sincronização de arquivos (600 segundos = 10 minutos). A sincronização de Opção Opção Mostrar padrão Descrição arquivos ocorre como parte da configuração da alta disponibilidade ou de processos para mover o mecanismo de dados e o repositório. service.jmx_enabled falso Configurar como true permite às portas JMX o monitoramento opcional e a resolução de problemas. Consulte Habilitar as portas JMX para obter detalhes. service.max_procs Nº de processos Número máximo de processos do servidor. subscriptions.enabled falso Controla se as assinaturas são configuráveis em todo o sistema. Consulte Gerenciar assinaturas. subscriptions.timeout 1800 Número de segundos após o qual o processo em segundo plano que manipula uma assinatura atinge o tempo limite. solr.port 8080 Porta na qual solr escuta. Dever ter o mesmo valor de tomcat.http.port. tomcat.http.port 8080 Porta na qual Tomcat é executado. tomcat.https.port 8443 Porta SSL para Tomcat (não utilizada). tomcat.server.port 8085 Portal na qual tomcat escuta mensagens de desligamento. vizqlserver.browser.render true As exibições abaixo do limite definido por vizqlserver.browser.render_ threshold ou vizqlserver.browser.render_ threshold_mobile são renderizadas pelo navegador da web do cliente e não pelo servidor. Consulte Sobre a renderização do lado do cliente para obter detalhes. vizqlserver.browser.rende100 r_threshold O valor padrão (100) representa um alto nível de complexidade para uma exibição mostrada em um computador. Fatores de complexidade incluem o número de marcas, cabeçalhos, linhas de referência e anotações. As exibições que excedem esse nível de complexidade são renderizadas pelo servidor e não no navegador da web do computador. Opção Mostrar padrão Descrição vizqlserver.browser.rende20 r_threshold_mobile O valor padrão (20) representa um alto nível de complexidade para uma exibição mostrada em um tablet. Fatores de complexidade incluem o número de marcas, cabeçalhos, linhas de referência e anotações. As exibições que excedem esse nível de complexidade são renderizadas pelo servidor e não no navegador da web do tablet. vizqlserver.port 9100 Porta base para os servidores VizQL. vizqlserver.protect_ sessions true Quando definido como true (o padrão), impede que sessões VizQL sejam reutilizadas após a saída do usuário original. vizqlserver.querylimit 1800 Tempo mais longo permitido para atualizar uma exibição, em segundos. Especifica um host Rserve. Esta configuração e as três configurações logo abaixo dão suporte à funcionalidade R em pastas de trabalho. R é uma linguagem de programação de software com código-fonte aberto e um ambiente de software para computação estatística e gráficos. No Tableau Desktop, você pode usar um conjunto de quatro funções a fim de passar expressões R para um servidor Rserve e obter um resultado. Caso carregue uma pasta de trabalho que use qualquer uma dessas funções, você deve configurar o Tableau Server para uma conexão Rserve definindo essa opção e as três seguintes. Do contrário, todas as planilhas que usam a funcionalidade R estarão indisponíveis. Consulte Conexão R na ajuda do Tableau Desktop para ver mais detalhes. vizqlserver.rserve.host vizqlserver.rserve.port vizqlserver.rserve.username 6311 Especifica uma porta de Rserve. Esta configuração dá suporte à funcionalidade R em pastas de trabalho. Especifica um nome de usuário de Rserve. Esta configuração dá suporte à funcionalidade R em pastas de trabalho.Nem todos os hosts Rserve exigem um nome de usuário e uma Opção Mostrar padrão Descrição senha. vizqlserver.rserve.password Especifica uma senha de Rserve. Esta configuração dá suporte à funcionalidade R em pastas de trabalho.Nem todos os hosts Rserve exigem um nome de usuário e uma senha. vizqlserver.session.expiry.5 minimum Número de minutos de tempo de inatividade após o qual uma sessão VizQL poderá ser descartada se o processo VizQL começar a ficar sem memória suficiente. vizqlserver.session.expiry.t30 imeout Número de minutos do tempo ocioso após o qual uma sessão VizQL é descartada. vizqlserver.showdownload true Controla a exibição do botão Baixar acima das exibições. vizqlserver.showshare Controla a exibição do botão Compartilhar acima das exibições. true vizqlserver.trustedticket.loinfo g_level O nível de registro da autenticação confiável, gravado em ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Defina para debug para obter mais informações. vizqlserver.trustedticket.to24 ken_length Determina o número de caracteres em cada ticket confiável. A configuração padrão de 24 caracteres fornece 144 bits de aleatório. O valor pode ser definido como qualquer inteiro entre 9 e 255, inclusive. vizqlserver.trustedticket.use_deprecated_9digit_ falso token Quando definido como true, os tickets têm 9 dígitos (como na versão 8.0 e anterior) e a configuração vizqlserver.trustedticket.token_ length é ignorada. wgserver.audit_history_ expiration_days Número de dias após o qual os registros de eventos de histórico são removidos do banco de dados PostgreSQL (banco de dados próprio do Tableau Server). Consulte Criar exibições administrativas personalizadas para obter detalhes. 183 Opção Mostrar padrão wgserver.domain.fqdn valor de O nome de domínio totalmente qualificado do %USERDOMservidor Active Directory a ser usado. AIN% wgserver.password_ autocomplete.enabled falso Descrição Controla se os navegadores da web podem preencher campos de senhas automaticamente. wgserver.session.idle_limit 240 O número de minutos de tempo ocioso até uma entrada no aplicativo web atingir o tempo limite. wgserver.trusted_hosts Esta opção usa uma lista separada por vírgulas de endereços IP ou nomes de host confiáveis para o computador do qual você deseja aceitar solicitações confiáveis. Um valor comum é 127.0.0.1, caso você queira colocar o servidor Web e o Tableau Server no mesmo computador. Essa opção é usada na configuração de uma relação confiável entre o servidor Web e o Tableau Server na inserção de exibições. workerX.gateway.port 80 (443 se SSL) A porta externa em que o Apache escuta para workerX. worker0.gateway.port é a porta externa do Tableau Server. Em um ambiente distribuído, worker0 é o Tableau Server primário. workerX.vizqlserver.procs Nº de processos Número de servidores VizQL. workerX.vizqlserver.port 9100 Porta base para o vizQL Server em workerX. workerX.wgserver.port 8000 Porta base para os servidores de aplicativo web em workerX. workerX.wgserver.procs Nº de Número de processos do servidor de processadores aplicativos Web. Restaurar o valor padrão de uma configuração Você pode restaurar o valor padrão para uma configuração do Tableau Server fazendo o seguinte: 1. Interrompa o servidor. 2. Ainda no diretório Bin, restaure o valor padrão para uma configuração específica digitando o seguinte: tabadmin set option-name --default Por exemplo, para definir a opção vizqlserver.session.expiry.timeout de tabadmin de volta para seu valor padrão de 30 minutos, digite o seguinte: tabadmin set vizqlserver.session.expiry.timeout --default Opcionalmente, você pode usar o comando mais curto -d. Por exemplo: tabadmin set vizqlserver.querylimit -d 3. Em seguida, execute o comando de configuração: tabadmin configure 4. Inicie o servidor. tabadmin stop Para usar o tabadmin para interromper o Tableau Server: 1. Abra um prompt de comando como um administrador: 2. Digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 3. Digite o seguinte para interromper o servidor: tabadmin stop tabadmin start Para usar o tabadmin para iniciar o Tableau Server: 1. Abra um prompt de comando como um administrador: 2. Digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 3. Digite o seguinte para iniciar o servidor: tabadmin start Manutenção do banco de dados Você pode usar a ferramenta de linha de comando tabadmin para fazer backup e restaurar seus dados do Tableau. Os dados do Tableau incluem seu próprio banco de dados PostgreSQL do Tableau Server, que armazena metadados da pasta de trabalho e do usuário, arquivos de extração de dados (.tde) e dados de configuração do servidor. Para automatizar o backup desses dados, é possível usar os comandos descritos nos tópicos abaixo, juntamente com o agendador de tarefas interno do Windows. Fazer backup do banco de dados do Tableau É importante fazer backup dos dados do Tableau para poder restaurar exibições publicadas e outras informações em caso de falha do sistema. Os dados gerenciados pelo Tableau Server consistem no próprio banco de dados PostgreSQL do Tableau, que contém metadados da pasta de trabalho e do usuário, arquivos de extração de dados (.tde) e dados de configuração. Quando você cria um backup, tudo isso é colocado em um único arquivo criado com a extensão .tsbak. Caso você esteja executando uma instalação distribuída do Tableau Server, esta etapa é realizada no computador primário, mesmo que o processador de dados, que identifica os arquivos .tde, esteja em um computador de trabalho. Como ele pode ser um backup efetivo para você, não se esqueça de armazenar o .tsbak em um computador fora do host de seu Tableau Server. Você pode criar um arquivo .tsbak usando o procedimento abaixo. Desinstalar o Tableau, que é a primeira etapa para atualizar para uma nova versão, também cria automaticamente um arquivo .tsbak. Esse mesmo arquivo .tsbak é usado para migrar seus dados para a versão mais recente. Executar o comando backup também remove os arquivos de registro do Tableau Server anteriores a sete dias, bem como algumas das informações exibidas em determinado Exibições administrativas do Tableau Server. 1. Abra um prompt de comando como um administrador e digite o seguinte: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Crie um arquivo de backup digitando tabadmin backup <filename>, em que <filename> é o nome ou o local e o nome de seu arquivo de backup. Não há necessidade de parar o servidor antes de criar o backup. Por exemplo: tabadmin backup tabserver ou tabadmin backup C:\backups\tableau\tabserver Opcionalmente, você também pode usar -d para anexar a data atual ao nome do arquivo e -t, seguido de um caminho, para especificar um local para arquivos temporários que você criou durante o processo de backup. Por exemplo: tabadmin backup tabserver -d -t C:\mytemp\tableau Restaurar um backup Quando você faz uma restauração, o conteúdo do banco de dados PostgreSQL do Tableau, as extrações de dados e os arquivos de configuração são substituídos pelo conteúdo do arquivo de backup (.tsbak). Se você está executando uma instalação distribuída do Tableau Server, esta etapa é executada no computador primário. Para restaurar usando um arquivo de backup de banco de dados: 1. Interrompa o servidor digitando: tabadmin stop 2. Restaure o banco de dados de um arquivo de backup digitando: tabadmin restore <filename> Na linha acima, substitua <filename> pelo nome do arquivo de backup que deseja usar para fazer a restauração. Para restaurar apenas os dados e nenhuma definição de configuração, digite o seguinte: tabadmin restore --no-config <filename> 3. Reinicie os processos do Tableau Server digitando: tabadmin start Recuperar extrações de um backup O arquivo uninstall-<version>.tsbak (por exemplo, uninstall-8.0.tsbak) é criado como parte do processo de desinstalação. Depois de atualizar para a versão 8.1, você poderá usar esse arquivo para restaurar extrações de dados — por exemplo, se você excluiu a pasta dataengine por engano durante a atualização. Para usar uninstall-<version>.tsbak para restaurar extrações de dados: 1. Interrompa o servidor. 2. De dentro do seu diretório bin do Tableau Server versão 8.1 , digite o seguinte: Windows Server 2012, Windows Server 2008, Windows Vista, Windows 7, Windows 8: tabadmin restore \ProgramData\Tableau\Tableau Server\uninstall-8.0.tsbak Tableau Server 32 bits instalado no Windows Server 2003 64 bits: tabadmin restore \Program Files (x86)\Tableau\Tableau Server\uninstall-8.0.tsbak Tableau Server 32 bits instalado no Windows Server 2003 32 bits: tabadmin restore \Program Files\Tableau\Tableau Server\uninstall8.0.tsbak Solução de problemas Use os tópicos a seguir para solucionar problemas que você possa estar enfrentando com o Tableau Server. Para obter dicas de solução de problemas de autenticação confiável, consulte Solucionar problemas de autenticação confiável. Registros e arquivos temporários O Tableau Service gera vários registros e arquivos temporários que podem ajudar a entender e rastrear a atividade recente, bem como depurar qualquer problema que possa surgir. Se precisar salvar espaço na unidade de disco rígido, de vez em quando, você pode excluir esses arquivos. Use os tópicos a seguir para saber onde os arquivos de registro estão localizados, sua finalidade, como arquivá-los e como salvar espaço executando o comando de limpeza. Locais do arquivo de registro Os arquivos de registro do Tableau Server podem ser encontrados nas seguintes pastas: Registros de serviço do Tableau Os arquivos de registro a seguir rastreiam atividades relacionadas ao aplicativo Web, banco de dados e índice. C:\ProgramData\Tableau\Tableau Server\data\tabsvc Registros do VizQL Esses arquivos de registro rastreiam atividades relacionadas à visualização de exibições, como consulta no banco de dados e geração de imagens: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Logs Arquivos temporários Todos os arquivos que começam com exe_ in na pasta abaixo é um arquivo do Tableau Server e pode ser excluído. C:\ProgramData\Tableau\Tableau Server\temp Arquivar arquivos de registro É possível arquivar arquivos de registro do Tableau Server usando o comando ziplogs. Esse comando cria um arquivo zip contendo todos os arquivos de registro e é útil quando você está trabalhando com o Suporte do Tableau. O comando ziplogs não remove os arquivos de registro, mas os copia em um arquivo zip. Se você está executando uma instalação distribuída do Tableau Server, esta etapa é executada no computador primário. Qualquer log de trabalho será incluído no arquivo zip. 1. Abra um prompt de comando como administrador e navegue para o diretório bin do Tableau Server. Por exemplo: cd "C:\Program Files\Tableau\Tableau Server\8.1\bin" 2. Interrompa o Tableau Server digitando: tabadmin stop 3. Crie o arquivo zip digitando tabadmin ziplogs -l -n <filename> onde <filename> é o nome do arquivo zipado que você deseja criar. Escolha um nome exclusivo sem espaços. O Tableau não substituirá um arquivo existente. Por exemplo: tabadmin ziplogs -l -n my_logs Se você não especificar um nome de arquivo, o arquivo será denominado logs.zip. Também é possível usar -d mm/dd/yyyy para incluir apenas registros gerados desde uma determinada data. Por exemplo: tabadmin ziplogs -l -n -d 02/14/2013 O comando acima cria um arquivo compactado denominado logs.zip que inclui registros datados de 14 de fevereiro de 2013 até a data atual; os registros mais antigos são excluídos. A opção -n captura informações sobre o ambiente de servidor, incluindo quais portas estão em uso. Para ver uma lista de todas as opções de ziplogs, digite tabadmin ziplogs -h. 4. Reinicie o Tableau Server digitando: tabadmin restart Você pode encontrar o arquivo de registro compactado no diretório bin do Tableau Server. Remover arquivos de registro O comando cleanup remove os registros de processo e as entradas de tabela HTTP do Tableau Server anteriores a sete dias para economizar espaço. Isso afetará algumas das informações apresentadas no Exibições administrativas Tableau Server. l Em um prompt de comando, digite: tabadmin cleanup --restart Em geral, você deve desligar o servidor antes de executar esse comando. No entanto, se o servidor estiver em execução, você deverá incluir a opção -restart para garantir uma limpeza e restauração bem-sucedidas. Manipular um servidor não licenciado O Tableau oferece dois modelos de licenciamento: baseado em usuário e baseado em núcleo. O licenciamento baseado em usuário exige que cada conta de usuário ativa seja coberta por uma licença. As licenças baseadas em usuário têm uma capacidade definida ou número de usuários que ela permite. Cada usuário tem um nome de usuário exclusivo atribuído a ele no servidor e é exigido para identificar a si mesmo quando conectado ao servidor. O software pode ser instalado em um computador único ou distribuído pelo número de computadores em um ambiente de servidor distribuído. O licenciamento baseado em núcleo não tem restrições quanto ao número de contas de usuário no sistema, mas ele não restringe o número máximo de núcleos de processador que o Tableau Server pode usar. Você pode instalar o servidor em um ou mais computadores para criar um cluster, com as restrições de que o número total de núcleos em todos os computadores não exceda o número de núcleos que você licenciou e que todos os núcleos em um computador específico sejam cobertos pela licença. Servidor baseado em usuário não licenciado O motivo mais comum para que um servidor que tenha licenciamento baseado em usuário tenha sua licença cancelada é uma chave de produto expirada ou um contrato de manutenção expirado. Você pode ver suas chaves de produto e adicionar novas selecionando Iniciar > Todos os programas > Tableau Server > Gerenciar chaves de produto. Servidor baseado em núcleo não licenciado Um servidor baseado em núcleo pode se tornar não licenciado por vários motivos. Um problema comum é que o computador primário ou de trabalho tenha mais núcleos do que a licença permite. Quando o servidor for não licenciado, você não poderá iniciar nem administrar o servidor. No entanto, é possível gerenciar licenças usando a ferramenta de linha de comando tabadmin. Siga as etapas abaixo para ver uma lista de suas licenças e o número de núcleos por computador. 1. Abra um prompt de comando e digite o seguinte: cd C:\Program Files\Tableau\Tableau Server\8.1\bin 2. Digite o seguinte: tabadmin licenses. Manipular um processo do VizQL Server não licenciado Há vários indicadores de status na página Manutenção do Tableau Server que o ajudam a compreender o estado dos processos do Tableau Server. Uma caixa de status laranja, "Não licenciado", indica que um dos processos de VizQL Server não pode recuperar informações de licença do Tableau Server. Vários motivos podem levar o processo a não acessar essas informações. Por exemplo, talvez existam questões de rede impedindo que um processo VizQL, em execução em um computador de trabalho, se comunique com o computador primário. Também é possível que o processo esteja recebendo mais solicitações do que pode aceitar naquele momento e, assim, não consiga lidar com a solicitação de licenciamento. Como resultado, alguns dos usuários talvez consigam acessar exibições, enquanto outros não. Para resolver o problema, interrompa e, depois, inicie o Tableau Server. Erro de falta de memória do VizQL Em versões de 32 bits do Tableau Server, caso um processo VizQL alcance seu limite de sessões de exibição simultânea, você pode ver um erro ‘Falta de memória’, que também será gravado nos logs vizqlserver*.txt localizados aqui: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Logs O processo VizQL não é encerrado quando esse erro ocorre, mas ele não aceitará conexões adicionais. É possível resolver esse problema fazendo o seguinte: l l l Atualização para a versão de 64 bits do Tableau Server: Consulte upgrade.htm para ver detalhes. Aumentando o número de processos VizQL: Isso pode significar que você precisa adicionar um ou mais trabalhos. Consulte Instalar e configurar servidores de trabalho para saber como fazer isso. Editar vizqlserver.session.expiry.timeout: Use tabadmin para alterar a configuração vizqlserver.session.expiry.timeout de seu padrão (30 minutos) para um período de tempo mais curto de 10 ou 5 minutos. Isso permitirá que sessões ociosas expirem mais rápido, liberando memória para novas sessões. Erro de restrição de cookie Quando um usuário entra no Tableau Server, um cookie de sessão é armazenado em seu navegador local. O cookie armazenado é a forma como o Tableau Server mantém que o usuário que entrou foi autenticado e pode acessar o servidor. Como o cookie é definido com o mesmo domínio ou subdomínio que a barra de endereços do navegador, ele é considerado um cookie primário. Se o navegador de um usuário estiver configurado para bloquear cookies primários, ele não conseguirá entrar no Tableau Server. Quando um usuário entra no Tableau Server por meio de uma exibição inserida, ou em um ambiente em que a autenticação confiável tenha sido configurada, o mesmo acontece: um cookie é armazenado. Nesse caso, entretanto, o navegador trata o cookie como um cookie de terceiros. Isso acontece porque o cookie é definido com um domínio que é diferente daquele mostrado na barra de endereços do navegador. Se o navegador da web do usuário estiver configurado para bloquear cookies de terceiros, a autenticação no Tableau Server falhará. Para evitar que isso ocorra, os navegadores da web devem ser configurados para permitir cookies de terceiros. Solucionar problemas de fontes de dados Para que os usuários trabalhem com as fontes de dados do Tableau Server, até três itens precisa ser definidos: l l l Permissões para a fonte de dados: Qualquer pessoa que for se conectar a uma fonte de dados deve ter as permissões Conectar e Exibir para essa fonte. Isso também se aplica a usuários que acessam exibições que se conectam a fontes de dados. Qualquer pessoa que esteja publicando e modificando fontes de dados deve estar licenciada para Publicar e também ter as permissões Baixar/salvar na Web como e Baixar/salvar na Web como. Consulte Trabalhar com permissões e Definir permissões para uma fonte de dados para obter mais informações. Capacidade de autenticação no banco de dados: Há várias maneiras de se conectar aos dados no Tableau e controlar quem tem acesso a quê. Basicamente, qualquer entidade que esteja se conectando ao banco de dados deve ser capaz de se autenticar. A entidade pode ser o Tableau Server executando uma atualização de extração. Pode ser um usuário do Tableau Desktop se conectando a uma fonte de dados que então se conecta a um banco de dados dinâmico. Também pode ser um usuário do Tableau Server que está acessando uma exibição que se conecta a um banco dedados ativo. Consulte Segurança de dados para saber mais sobre suas opções. Drivers de banco de dados: Se a pessoa que criou e publicou a fonte de dados no Tableau Desktop precisou instalar drivers de bancos de dados adicionais, talvez você precise instalá-los também no Tableau Server. Se você estiver executando uma instalação distribuída do Tableau Server onde, por exemplo, o processo do data server está sendo executado em um servidor de trabalho, todos os drivers de banco de dados necessários devem ser instalados nesse servidor, bem como no servidor primário. Outros processos também requerem drivers. Consulte Drivers de banco de dados para obter mais informações. Mensagens de erro da fonte de dados Veja aqui alguns erros que os autores da pasta de trabalho e outros usuários podem encontrar enquanto trabalham com fontes de dados e exibições: A permissão para acessar esta fonte de dados do Tableau Server foi negada: A conexão com uma fonte de dados exige a permissão Conectar. Consulte Trabalhar com permissões e Definir permissões para uma fonte de dados para obter mais informações. Fonte de dados não encontrada: Alguém que estiver trabalhando com uma exibição poderá ver esse erro se uma fonte de dados for removida do Tableau Server ou se a página Conectar a dados precisar ser atualizada. Para atualizar a página Conectar a dados no Tableau Desktop, clique no ícone Atualizar: Não é possível conectar a esta fonte de dados do Tableau Server: Esse erro pode aparecer se as informações de conexão para a fonte de dados forem alteradas, por exemplo, em resultado da alteração do nome do servidor de banco de dados. Observe as informações de Conexão de dados da fonte de dados e verifique se as configurações estão corretas. Não é possível listar fontes de dados do Tableau Server: Esse erro poderá ocorrer se um usuário estiver tentando acessar as fontes de dados do Tableau Server e houver problemas de conectividade entre o Tableau Server e o Tableau Desktop. Não é possível conectar a uma fonte de dados de cubo: Não há suporte de conexões a fontes de dados de cubos (como MSAS). Os dados precisam ser uma extração ou uma conexão ativa a um banco de dados relacional. Solucionar problemas de assinaturas "O instantâneo da exibição neste email não pôde ser renderizado adequadamente." Se você receber uma assinatura com essa mensagem de erro, poderá ser por vários motivos: l l l Credenciais ausentes: Algumas exibições são publicadas com credenciais inseridas. Você pode receber o erro acima se as credenciais inseridas estiverem desatualizadas, ou se a exibição foi publicada novamente sem as credenciais inseridas. Banco de dados temporariamente inativo: Se a exibição tiver uma conexão de banco de dados ativa, e o banco de dados estava temporariamente inativo quando a assinatura era gerada, você poderá receber o erro acima. Tempo limite de processo em segundo plano: Por padrão, o processo em segundo plano que administra as assinaturas tem seu tempo esgotado após 30 minutos. Na maioria dos casos, isso é muito tempo. Entretanto, se o processo em segundo plano estiver manipulando um painel extremamente grande e complexo, esse tempo talvez não seja suficiente. Você poderá verificar a exibição do administrador Tarefas em segundo plano para ver se é esse o caso. Para aumentar o tempo limite, use a opção tabadmin subscriptions.timeout. Não é possível assinar Se você puder ver uma exibição ou pasta de trabalho no Tableau Server e ela tiver um ícone de assinatura ( ) no canto superior direito, você poderá assiná-la. Dois fatores precisam estar presentes para você assinar uma exibição: O Tableau Server precisa estar configurado corretamente (descrito em Gerenciar assinaturas) e a exibição que você está assinando deve ter credenciais inseridas para sua fonte de dados ou não usar credenciais. Exemplos do último item são uma pasta de trabalho que se conecta a uma extração que não está sendo atualizada, ou uma pasta de trabalho cujos dados estão em um arquivo fornecido com a pasta de trabalho no momento da publicação. Inserir credenciais é uma etapa que acontece no Tableau Desktop (consulte a ajuda do Tableau Desktop para obter os detalhes). Sem ícone de assinatura É possível ver uma exibição no Tableau Server, mas não é possível assiná-la. Isso acontece para exibições com conexões de banco de dados ativas, onde você é solicitado a fornecer as credenciais do banco de dados ao clicar pela primeira vez na exibição. Uma assinatura inclui uma exibição (ou pasta de trabalho), dados ou uma agenda. Para fornecer os dados, o Tableau Server precisa das credenciais do banco de dados inseridas ou de dados que não exigem credenciais. Em relação às conexões de bancos de dados ativas, o Tableau Server não tem as credenciais, somente os usuários individuais têm. É por isso que você só pode assinar exibições que não exigem credenciais ou as têm inseridas. Você também pode ver uma exibição, mas não poder assiná-la (sem ícone de assinatura) se o Tableau Server estiver configurado para a autenticação confiável. Consulte Requisitos de assinatura para obter mais informações. Recebimento de assinaturas inválidas ou "corrompidas" Se você configurou assinaturas nas instâncias de teste ou desenvolvimento do Tableau Server além de sua instância de produção, desabilite as assinaturas nas instâncias que não são de produção. Manter as assinaturas habilitadas em todas as instâncias pode resultar em seus usuários recebendo assinaturas que parecem ser válidas, mas não funcionam, ou recebendo assinaturas mesmo que eles as tenham cancelado na exibição ou pasta de trabalho. As assinaturas não chegam ("Erro no envio de e-mail. Não é possível enviar o comando para o host SMTP.") Você pode ver o erro acima no Visualizador de Eventos do Windows se as assinaturas aparecerem como enviadas (de acordo com a exibição de administração Tarefas em segundo plano), mas não estiverem chegando, e seu servidor SMTP estiver usando sessões criptografadas (SSL). Assinaturas são aceitas somente para conexões SMTP não criptografadas. A solução é usar um servidor SMTP não criptografado. Solução de problemas do SAML Use os tópicos a seguir para solucionar problemas do SAML. SAML e habilitar logon automático Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o Active Directory, não selecione também Habilitar logon automático. Habilitar logon automático e SAML não podem ser usados. Falha no logon Caso você receba a mensagem "Falha no logon: Autenticação do Provedor de identidade bem-sucedida para o usuário <username from IdP>. Falha ao encontrar o usuário no Tableau Server." Os nomes de usuário conforme armazenados no Tableau Server e conforme armazenados em seu IdP não são idênticos. Para corrigir isso, verifique se eles são iguais. Por exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como jsmith, ele deverá ser armazenado no Tableau Server como jsmith. Log de erros do SAML Os erros de entrada do SAML são registrados no local a seguir. Você pode usar esse log para solucionar problemas. C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver\error.log Identificar alertas de atualização da extração Caso as atualizações de extração não tenham sido bem-sucedidas, o Tableau exibe um menu Alertas no canto inferior direito: Você só verá o menu Alertas se houver uma falha na atualização da extração e você estiver: l Um administrador de sistema ou do site. l Não foi possível atualizar o autor da pasta de trabalho ou da fonte de dados. l Não foi possível atualizar o autor de uma pasta de trabalho que se conecta a uma fonte de dados. Ao abrir o menu Alertas, você pode ver mais informações sobre as falhas de atualização: Quando uma Fonte de dados é listada como Inserida isso significa que a definição da fonte de dados (que inclui coisas como as credenciais da fonte de dados ou o nome do banco de dados) está inserida ou reside dentro da própria pasta de trabalho. Isso também significa que o problema deve ser corrigido no Tableau Desktop. Por exemplo, a fonte do problema pode ser que as credenciais precisem ser inseridas na pasta de trabalho. Quando o nome de uma fonte de dados ou de uma pasta de trabalho é listado como a Fonte de dados (por exemplo, Fonte de dados: sales_data), significa que a fonte de dados é uma Fonte de dados do Tableau Server. A definição da fonte de dados reside no Tableau Server. Quando a pasta de trabalho ou a fonte de dados foi originalmente criada no Tableau Desktop, um ícone do Tableau, e não um ícone de banco de dados, era exibido próximo à fonte de dados, na janela Dados: Às vezes, você pode corrigir um problema de atualização de extração clicando em Editar informações da conexão, inserindo informações não encontradas e clicando em Salvar: JavaScript API With Tableau's JavaScript API you can integrate Tableau visualizations into your own web applications. The API lets you tightly control your users' interactions and combine functionality that otherwise couldn't be combined. For example, you can code a single control that filters a group of marks, selects some of those marks, and presents their data for download. See the topics below for details: l Requirements l Concepts l Tutorial l API Reference Requirements The requirements for Tableau's JavaScript API are as follows: Tableau Server: To program with Tableau's JavaScript API you need Tableau Server, version 8.1 or higher. The API is powered by the file tableau_v8.js, which is located in the following folder: Program Files\Tableau\Tableau Server\8.1\wgserver\public\javascripts\api. Your web application shouldn't be on the same computer as Tableau Server, but it needs to be able to access it. Supported browsers: Your end-users can experience the web application you create in most supported web browsers, specifically: Chrome, Firefox, Safari 3.2.1 and higher, and Internet Explorer 8.0 and higher. If you are using Internet Explorer 8.0, it must have compatability mode disabled. Concepts This topic is designed for people familiar with JavaScript and object-oriented programming concepts. You should also be familiar with Tableau visualizations from a user's point of view. If you are just getting started, a good place to begin is the Tutorial. Programming Approach Tableau's JavaScript API uses an object model. The entry point into the object model is to instantiate a new Viz object as follows: var viz = new tableauSoftware.Viz(/* params omitted */); Nearly every Tableau object allows you to navigate back to its parent Viz object by way of "parent" properties on the object. Accessing the API The API is about programmatically controlling views embedded from Tableau Server. To use it, you need access to a Tableau server running version 8.0 or higher, and a published workbook on that server. The API is provided through the file tableau_v8.js (minimized) or tableau_v8.debug.js, which install in the following folder on Tableau Server: Program Files\Tableau\Tableau Server\8.1\wgserver\public\javascripts\api If you don't have a Tableau Server on-premise, you have a couple other options: l l Tableau Public is a free Tableau Server implementation that you can also use to access the JavaScript API. The workbooks published to Tableau Public must be packaged .twbx workbooks (data extract and workbook bundled together). Workbooks published to Tableau Public can't use live database connections or rely on extract refresh schedules (Tableau can't connect to databases behind your firewall). The Tutorial uses a workbook published to Tableau Public for its example. Tableau Online is another Tableau-hosted implementation of Tableau Server, in the cloud. Workbooks published to Tableau Online need to use extracts, or live connections to certain cloud-based data sources like Salesforce and Google Analytics. Contact Tableau Software to learn more. Bootstrapping There is only one entry point into the API: instantiating a new Viz object, which creates the HTML necessary to embed a Tableau visualization. To instantiate a new Viz object, simply call the Viz constructor via new, passing the required parentElement and URL parameters and an optional set of options. The URL parameter is where you specify the name of the Tableau server: var placeholderDiv = document.getElementById("tableauViz"); var url = "http://tabserver/views/workbookname/viewname"; var options = { hideTabs: true, width: "800px", height: "700px" }; var viz = new tableauSoftware.Viz(placeholderDiv, url, options); Trusted Authentication If Tableau Server is using trusted authentication and the trusted ticket server is configured to return the ticket value itself, add a ticket option. For example: var placeholderDiv = document.getElementById("tableauViz"); var url = "http://tabserver/views/workbookname/viewname"; var options = { hideTabs: true, width: "800px", height: "700px", ticket: "Etdpsm_Ew6rJY-9kRrALjauU" }; var viz = new tableauSoftware.Viz(placeholderDiv, url, options); If the trusted ticket server is configured to return a full URL, specify the ticket in the URL by first adding trusted after the server name, followed by the ticket. For example: var placeholderDiv = document.getElementById("tableauViz"); var url = "http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookname/viewname"; var options = { hideTabs: true, width: "800px", height: "700px" }; var viz = new tableauSoftware.Viz(placeholderDiv, url, options); Property Getters and Setters Getters and setters are always functions that start with get or set. They can be called multiple times with little performance impact (in other words, they should simply return cached fields or do very simple calculations). Properties are always synchronous and return immediately with the value, rather than having a callback function. Call Behavior - Asynchronous By default, calls are asynchronous since many of them may require a roundtrip to the server. Methods use the following naming convention: l l Asynchronous calls are indicated by an Async suffix on the method name, for example, Worksheet.applyFilterAsync(). Asynchronous calls return a Promise object, allowing chaining. The Tableau JavaScript API uses the CommonJS Promises/A standard. The premise behind Tableau's implementation is that asynchronous methods return an object that has a then method in the following form: then(fulfilledHandler, errorHandler) The fulfilledHandler is called when the promise is fulfilled (on success). The errorHandler is called when a promise fails. All arguments are optional and non-function values are ignored. Chaining Promises The promised result of an asynchronous method is passed as the parameter to the next then () method. For example: var activeSheet; viz.getWorkbook().activateSheetAsync("Sheet 1") .then(selectLemon).then(filterToLemonAndMint); function selectLemon(sheet) { activeSheet = sheet; return sheet.selectMarksAsync("Product", "Lemon", "replace"); } function filterToLemonAndMint() { return activeSheet.applyFilterAsync("Product", ["Lemon", "Mint"], "replace"); } The result of activateSheetAsync() is a promise to eventually return the Sheet object that was activated, which is passed as the first parameter to the selectLemon() method. Notice that the selectLemon() method returns a Promise object (the return value of the selectMarksAsync() method), not the result after the marks have been selected. However, since it’s a Promise object, the next then() method is not called until that promise is fulfilled. If a link in the chain is added after the promise has been fulfilled, the callback will be immediately called with the value that was previously returned. As the programmer, this means you don't need to determine if the response has already been received from the server. The asynchronous methods will always be called, whether it's now or later. var promise = viz.getWorkbook().activateSheetAsync("Sheet 1"); // Pretend that activatSheeteAsync() has already returned from the server. promise.then(callback); // callback will be called immediately using the Sheet object // returned from activateSheetAsync() Return Values of Then() Methods Whatever is returned in a then() method will get passed as the first parameter to the next then() method. It can be a scalar value (Number, Boolean, String, etc.), an object, or another Promise. The infrastructure will automatically wrap non-Promise values into a Promise value so that they can be chained. viz.getWorkbook().activateSheetAsync("Sheet 1") .then(function (sheet) { return "First link"; }) .then(function (message) { if (message === "First link") { alert("Expected"); } // no return value here means nothing is passed to the next link }) .then(function () { }); Breaking Out of a Chain Technically, there’s no way to break out of a chain since that would invalidate the guarantee that subsequent links in the chain will be called. If there is an exception thrown in part of the chain, the rest of the chain is run but the errorHandler is called instead of the fulfilledHandler. If a link in the chain depends on the results of earlier links, then you should write an if statement to check your condition. Here's an example: viz.getWorkbook().activateSheetAsync("Sheet 1") .then(function (sheet) { // I’m returning a Promise return sheet.selectMarksAsync("Product", "NoProduct", "replace"); }) .then(function () { return viz.getWorkbook().getActiveSheet().getSelectedMarksAsync (); }) .then(function (marks) { // The getSelectedMarksAsync call succeeded, but no marks were selected // because there are not any marks corresponding to "NoProduct". if (marks.length === 0) { throw new Error("No marks selected"); } var firstMarkValue = marks[0].getPairs().get("Product").value; return sheet.applyFilterAsync("Product", firstMarkValue, "replace"); }) .then(function (filterName) { // applyFilterAsync succeeded }, function(err) { if (err.message === "No marks selected") { alert("This was caused by the first link above"); } }) .otherwise(function (err) { alert("We handled the error above, so it’s not propagated to this handler."); }); If a callback is not provided (or is null or undefined), then the results are passed to the next link in the chain: viz.getWorkbook().activateSheetAsync("Sheet 1") .then() .then(function (sheet) { // this is called }); In this way, you can specify a single otherwise function to handle all errors in the chain. The always function works the same way, but it is called regardless of success or failure. The then/otherwise/always functions work similarly to a try/catch/finally block. viz.getWorkbook().activateSheetAsync("Sheet 1") .then(function () { return sheet.selectMarksAsync(...); }) .then(function (marks) { // Do something with the marks. }) .otherwise(function (err) { // I’m handling all errors in one place. console.log(err.message); }) .always(function () { // Do some cleanup or logging }); Collections Many classes have collections of items, where each item has a key (typically an ID or a name). Examples include a collection of sheets keyed by name or the list of parameters on a sheet keyed by name. Collections are publicly immutable, exposing read-only functionality. Each Collection array is keyed with its elements’ identifiers. For example, the result of Workbook.getPublishedSheetsInfo() is an array with the index corresponding to the position of the sheet in the workbook. It is also keyed by the sheet name so that you can access it like this: var sheet = workbook.getPublishedSheetsInfo()[0]; var sameSheet = workbook.getPublishedSheetsInfo().get("Sheet 1"); Collection Interface Name Return Type get(key : Collection string) item type has(key bool : string) Description Gets the element in the collection associated with the key, or undefined if there is nothing associated with it. Returns true if there is an element in the collection associated with the key; otherwise, false. Events The Viz class acts as the central event hub. This way you only have to go to one place for all events. It also means that events can be raised on an object that may not have been created yet. For example, the marksselection event can be raised for a particular sheet even though the Sheet object hasn't been created yet. Each event contains an anonymous object with information pertaining to that event, such as the sheet the event occurred on. Listening to an event is done by calling Viz.addEventListener(type, callback) and passing in a function callback. Here's an example of listening to an event: viz.addEventListener("marksSelection", function (marks) { changeMySelectionUI(marks); }); Removing a listener is done by calling Viz.removeEventListener(type, listener) and passing in the same callback function that was passed into Viz.addEventListener(). For example: function changeMySelectionUI(marks) { viz.removeEventListener("marksSelection", changeMySelectionUI); } viz.addEventListener("marksSelection", changeMySelectionUI); Events are multicast delegates, meaning that multiple listeners are supported. The order in which notifications are called is not specified. Every event callback takes a single object containing a pointer to the Viz that raised the event. Each event also adds additional fields to the event, as specified in the API Reference. Filtering When you program filtering you are mimicking the user behavior of clicking a filter in a view to narrow down the data that is displayed. Here's an example of filtering on a single value: worksheet.applyFilterAsync("Container", "Jumbo Box", tableauSoftware.FilterUpdateType.REPLACE); There is a difference between querying existing filter state and setting new or existing filters. Querying filters is done via Worksheet.getFiltersAsync() which returns a collection of Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its variants) and is a function call that doesn't require you to instantiate a Filter class. When you specify fields in a filter, you should use the caption as shown in the user interface, not the database field name. For example, you should use Container (the caption) instead of Product Container (the actual field name). In some cases, Tableau Desktop renames fields after they've been dragged to a shelf. For example the Date field might be renamed to YEAR (Date) after being dragged to the rows shelf. In this case, you should use YEAR(Date) as the parameter. The exception is hierarchical filters, which use the full hierarchical name (for example, [Product].[All Product].[Espresso]). Captions can use the optional [] delimiters around names. Here are samples for many types of filtering: var worksheet; viz.getWorkbook().activateSheetAsync("Sheet 4").then(function (sheet) { worksheet = sheet; }) // Single value .then(function () { return worksheet.applyFilterAsync("Product Type", "Coffee", tableauSoftware.FilterUpdateType.REPLACE); }) // Multiple values .then(function () { return worksheet.applyFilterAsync( "Product Type", ["Coffee", "Tea"], tableauSoftware.FilterUpdateType.REPLACE); }) // Multiple Values - adding and removing .then(function () { return worksheet.applyFilterAsync("Product", ["Lemon", "Mint"], tableauSoftware.FilterUpdateType.ADD); }) .then(function () { return worksheet.applyFilterAsync("Product", ["Caffe Latte", "Green Tea"], tableauSoftware.FilterUpdateType.REMOVE); }) // All values .then(function () { return worksheet.applyFilterAsync("Product Type", "", tableauSoftware.FilterUpdateType.ALL); }) // Date Range .then(function () { return; worksheet.applyRangeFilterAsync("Date", { min: new Date(Date.UTC(2010, 3, 1)), max: new Date(Date.UTC(2010, 12, 31)) }); }) // Clearing a Filter .then(function () { return worksheet.clearFilterAsync("Date"); }) // Relative Date .then(function () { return worksheet.applyRelativeDateFilterAsync("Date", { anchorDate: new Date(Date.UTC(2011, 5, 1)), periodType: tableauSoftware.PeriodType.YEAR, rangeType: tableauSoftware.DateRangeType.LASTN, rangeN: 1 }); }) // Quantitative Filters // SUM(Sales) > 2000 and SUM(Sales) < 4000 .then(function () { return worksheet.applyRangeFilterAsync("SUM(Sales)", { min: 2000, max: 4000 }); }) // SUM(Sales) > 1000 .then(function () { return worksheet.applyRangeFilterAsync("SUM(Sales)", { min: 1000 }); }) // Hierarchical Filters - selecting all on a level .then(function () { return worksheet.applyHierarchicalFilterAsync("[Product]. [Product Categories]", { levels: [0, 1] }, tableauSoftware.FilterUpdateType.ADD); }, function (err) { /* ignore errors */ }) // Hierarchical Filters - adding one item .then(function () { return worksheet.applyHierarchicalFilterAsync( "[Product].[Product Categories].[Product Name]", "Accessories.Bike Racks.Hitch Rack - 4-Bike", tableauSoftware.FilterUpdateType.REPLACE); }, function (err) { /* ignore errors */ }) // Hierarchical Filters - adding multiple items .then(function () { return worksheet.applyHierarchicalFilterAsync( "[Product].[Product Categories].[Product Name]", [ "Accessories.Bike Racks.Hitch Rack - 4-Bike", "Accessories.Bike Stands.All-Purpose Bike Stand" ], tableauSoftware.FilterUpdateType.REPLACE); }, function (err) { /* ignore errors */ }) .otherwise(function (err) { console.log(err); }); Selecting Marks Selecting marks is almost identical to filtering. For filtering,you use one of the Worksheet.applyFilterAsync() methods. For selecting marks, you use Worksheet.selectMarksAsync(). The parameters for mark selection are almost identical to those used for filtering. worksheet.selectMarksAsync("Product", "Caffe Latte", tableauSoftware.SelectionUpdateType.REPLACE); Here are samples of other types of selecting you can use: var worksheet; viz.getWorkbook().activateSheetAsync("Sheet 4").then(function (sheet) { worksheet = sheet; }) // Single dimensions work just like filtering // Single dimension - single value .then(function () { return worksheet.selectMarksAsync("Product", "Mint", tableauSoftware.SelectionUpdateType.REPLACE); }) // Single dimension - Multiple values .then(function () { return worksheet.selectMarksAsync( "Product", ["Chamomile", "Mint"], tableauSoftware.SelectionUpdateType.REPLACE); }) // Single dimension - Multiple values (delta) .then(function () { return worksheet.selectMarksAsync("Product", ["Lemon", "Earl Grey"], tableauSoftware.SelectionUpdateType.ADD); }) .then(function () { return worksheet.selectMarksAsync( "Product", ["Chamomile", "Earl Grey"], tableauSoftware.SelectionUpdateType.REMOVE); }) // Quantitative selection .then(function () { return worksheet.selectMarksAsync({ "State": ["Florida", "Missouri"], "SUM(Sales)": { min: 3000, max: 4000 } }, tableauSoftware.SelectionUpdateType.REPLACE); }) // Hierarchical dimensions .then(function () { return worksheet.selectMarksAsync( "[Product].[Product Categories].[Category]", "Bikes", tableauSoftware.SelectionUpdateType.REPLACE); }, function (err) { /* ignore errors */ }) // Multiple dimensions - multiple values // ((State = Washington OR Oregon) AND Product = Lemon) // OR // (State = Oregon AND Product = Chamomile) .then(function () { return worksheet.selectMarksAsync({ "State": ["Washington", "Oregon"], "Product": "Lemon" }, tableauSoftware.SelectionUpdateType.REPLACE); }) .then(function () { return worksheet.selectMarksAsync({ "State": "Oregon", "Product": "Chamomile" }, tableauSoftware.SelectionUpdateType.ADD); }) // Round-tripping selection .then(function () { return worksheet.selectMarksAsync( "Product", "Lemon", tableauSoftware.SelectionUpdateType.REPLACE); }) .then(function () { return worksheet.getSelectedMarksAsync(); }).then(function (marks) { // filter out only the Washington and Oregon marks var onlyWashingtonAndOregon = []; for (var i = 0, len = marks.length; i < len; i++) { var m = marks[i]; var pair = m.getPairs().get("State"); if (pair && (pair.value === "Washington" || pair.value === "Oregon")) { onlyWashingtonAndOregon.push(m); } } return worksheet.selectMarksAsync( onlyWashingtonAndOregon, tableauSoftware.SelectionUpdateType.REPLACE); }) .otherwise(function (err) { console.log(err); }); API Reference Style and Conventions Tableau's JavaScript API follows these JavaScript standards: l l l l Classes are PascalCase (initial capital letter, with each subsequent word capitalized) Namespaces, methods, parameters, and variables are camelCase (initial lowercase letter, with each subsequent word capitalized) Constants and enum values are UPPERCASE_UNDERSCORE_DELIMITED Protected variables or methods start with an initial underscore '_' character, indicating that it should not be referenced by the programmer. Top-Level Class Diagram The following class diagram shows the relationships between the top-level classes, as well as the inheritance hierarchy for the Sheet, Dashboard, and Worksheet classes. Note that there's always a way to traverse back up the containment hierarchy with parent pointers, with the exception of VizManager, as it's a static class and always accessible. Asynchronous and Error Classes Promise Class Represents a promise to return a value from an asynchronous method in the future. The Tableau JavaScript API implements the Promises/A specification. Methods Name then (callback: Function, errback: Function) always (callback: Function) otherwise (errback: Function) Return Description Type Promise Creates a link in the asynchronous callable chain. The callback function is called on success. The errback function is called when there is an error. Both parameters are optional. Promise Registers a callback that will be called when a promise is resolved or rejected. Shortcut for then(callback, callback). Promise Registers a rejection handler. Shortcut for then(null, errback). TableauException Class The TableauException class is not a real class, but simply adds an id field to the standard JavaScript Error object when an exception is thrown from within the API. As the programmer, this allows you to uniquely identify the error without having to parse the error string. It also allows you to add localized messages. Constructor There is no public constructor. The only way to get a reference to a TableauException is within a catch block. Fields Name Type Description tableauSoftwareErrorCode ErrorCode Represents an ErrorCode enum value. message string This is already defined on the standard Error object, but the message will contain a description of the exception that the API code specifies. ErrorCode Enum Here's a list of the different exceptions that the API can throw: Name BROWSER_ NOT_ CAPABLE DOWNLOAD_ WORKBOOK_ NOT_ ALLOWED FILTER_ CANNOT_BE_ PERFORMED INDEX_OUT_ OF_RANGE Return Type browserNotCapable INTERNAL_ ERROR internalError INVALID_ CUSTOM_ VIEW_NAME INVALID_ DATE_ PARAMETER INVALID_ invalidCustomViewName downloadWorkbookNotAllowed filterCannotBePerformed indexOutOfRange invalidDateParameter invalidFilterFieldName Description The browser is not capable of supporting the Tableau JavaScript API. The permissions on a workbook or a view do not allow downloading the workbook. An error occurred while attempting to perform a filter operation. Attempted to switch to a sheet by index that does not exist in the workbook. An error occurred within the Tableau JavaScript API. Contact Tableau Support. An operation was attempted on a custom view that does not exist. An invalid date was specified in a method that required a date parameter. A filter operation was attempted FILTER_ FIELDNAME INVALID_ FILTER_ FIELDNAME_ OR_VALUE on a field that does not exist in the data source. invalidFilterFieldNameOrValue Either a filter operation was attempted on a field that does not exist in the data source, or the value supplied in the filter operation is the wrong data type or format. INVALID_ invalidFilterFieldValue A filter operation was attempted FILTER_ using a value that is the wrong FIELDVALUE data type or format. INVALID_ invalidParameter A parameter is not the correct PARAMETER data type or format. The name of the parameter is specified in the Error.message field. INVALID_ invalidSelectionDate An invalid date value was SELECTION_ specified in a Sheet.selectMarksAsync DATE () call for a date field. INVALID_ invalidSelectionFieldName A field was specified in a Sheet.selectMarksAsync SELECTION_ FIELDNAME () call that does not exist in the data source. INVALID_ invalidSelectionValue An invalid value was specified in SELECTION_ a Sheet.selectMarksAsync VALUE () call. INVALID_SIZE invalidSize A negative size was specified or the maxSize value is less than minSize in Sheet.changeSizeAsync(). INVALID_ invalidSizeBehaviorOnWorkshe- A behavior other than SheetSizeBehavior.AUTOSIZE_ et MATIC was specified in BEHAVIOR_ Sheet.changeSizeAsync ON_ () when the sheet is a WORKSHEET Worksheet instance. INVALID_URL invalidUrl The URL specified in the Viz class constructor is not valid. MISSING_ missingMaxSize The maxSize field is missing in Sheet.changeSizeAsync MAX_SIZE () when specifying SheetSizeBehavior.ATMOST. MISSING_ missingMinSize The minSize field is missing in MIN_SIZE Sheet.changeSizeAsync () when specifying SheetSizeBehavior.ATLEAST. MISSING_ missingMinMaxSize Either or both of the minSize MINMAX_SIZE or maxSize fields is missing in Sheet.changeSizeAsync () when specifying SheetSizeBehavior.RANGE. MISSING_ missingRangeNForRelativeDat- The rangeN field is missing for RANGEN_ eFilters a relative date filter of type FOR_ LASTN or NEXTN. RELATIVE_ DATE_ FILTERS NO_URL_ noUrlForHiddenWorksheet An attempt was made to access FOR_ Sheet.getUrl() on a HIDDEN_ hidden sheet. Hidden sheets do WORKSHEET not have URLs. NO_URL_OR_ noUrlOrParentElementNotFoun- One or both of the PARENT_ d parentElement or the URL ELEMENT_ parameters is not specified in NOT_FOUND the Viz constructor. NOT_ notActiveSheet An operation was attempted on ACTIVE_ a sheet that is not active or SHEET embedded within the active dashboard. NULL_OR_ nullOrEmptyParameter A required parameter was not EMPTY_ specified, null, or an empty PARAMETER string/array. SERVER_ serverError A general-purpose server error ERROR occurred. Details are contained in the Error object. SHEET_NOT_ sheetNotInWorkbook An operation was attempted on IN_ a sheet that does not exist in the WORKBOOK workbook. STALE_ staleDataReference An operation is performed on a DATA_ CustomView object that is no REFERENCE longer valid (it has been removed). UNSUPPORT- unsupportedEventName An unknown event name was ED_EVENT_ specified in the call to NAME Viz.addEventListener or Viz.removeEventListene- VIZ_ ALREADY_ IN_MANAGER vizAlreadyInManager r. A Viz object has already been created as a child of the parentElement specified in the Viz constructor. Viz Classes Class Diagram VizManager Class Manages all of the Viz instances on the page, but does not manage vizzes (views) earlier than version 8.1. This is a static class, meaning that all properties and methods are static and there is only a single instance of the class. Properties Name getVizs() Type Viz[] Description Collection of version 8.1 views on the hosting page. Viz Class Wraps an <iframe> showing one or more sheets in a Tableau workbook. Contains all of the chrome surrounding the view. Constructor Signature Viz (parentElement: domNode, url: Description Creates a new Tableau Viz inside of the given HTML container, which is typically a <div> element. Each option as well as the options parameter is optional. If there is already a string, options: Viz associated with the parentElement, an exception is VizCreateOptions thrown. Before reusing the parentElement you must first call ) dispose(). Properties Name getAreTabsHidden() Type bool Description Indicates whether the tabs are displayed in the UI. It does not actually hide individual tabs. getIsToolbarHidden() bool Indicates whether the toolbar is displayed. getIsHidden() bool Indicates whether the viz is displayed on the hosting page. getParentElement() domNode Returns the node that was specified in the constructor. getUrl() string The URL of the viz, as specified in the constructor getWorkbook() Workbook One Workbook is supported per viz. getAreAutomaticUpdatesPaused bool Indicates whether automatic () updates are currently paused. Events Events are added or removed via the following two calls. Name addEventListener( type: TableauEventName, listener: Function) removeEventListener( type: TableauEventName, listener: Function) Return Type None Description None Removes an event listener from the specified event. Adds an event listener to the specified event. Methods Name show() hide() dispose() Type None None Description Shows or hides the <iframe> hosting the viz. Cleans up any resources associated with the viz, removes the viz from the VizManager, and removes any DOM elements from parentElement. Basically, it restores the page to what it was before instantiating a new Viz object. Pauses or resumes layout updates. This is useful if you are resizing the viz or performing multiple calls that could affect the layout. pauseAutomaticUpdatesAsync() None resumeAutomaticUpdatesAsync () toggleAutomaticUpdatesAsync () revertAllAsync() Promise Equivalent to clicking on the Revert All toolbar button, which restores the workbook to its starting state. refreshDataAsync() None Equivalent to clicking on the Refresh Data toolbar button. showDownloadWorkbookDialog None Equivalent to clicking on the () Download toolbar button, which downloads a copy of the original workbook. showExportImageDialog() None Equivalent to clicking on the Export Image toolbar button, which creates a PNG file of the current viz. showExportPDFDialog() None Equivalent to clicking on the Export PDF toolbar button, which shows a dialog allowing the user to select options for the export. showExportDataDialog( None Shows the Export Data dialog, worksheetInDashboard: Sheet which is currently a popup window. or SheetInfo or string) The worksheetInDashboard parameter is optional. If not specified, the currently active Worksheet is used. showExportCrossTabDialog( None Shows the Export CrossTab dialog. worksheetInDashboard: Sheet The worksheetInDashboard or SheetInfo or string) parameter is optional. If not specified, the currently active Worksheet is used. showShareDialog() None Equivalent to clicking on the Share toolbar button, which displays a dialog allowing the user to share the viz by email or by embedding its HTML in a web page. setFrameSize(width: int, height: None Sets the size of the iFrame, which int) causes the viz to expand or collapse to fit the iFrame if the viz’s current sheet’s size is set to AUTOMATIC. VizCreateOptions Record These are the options that are specified in the Viz constructor. Fields Name hideTabs hideToolbar Type bool bool Description Indicates whether tabs are hidden or shown. Indicates whether the toolbar is hidden or shown. toolbarPosition ToolbarPosition Indicates where the toolbar should be placed if hideToolbar is false. height string Can be any valid CSS size specifier. If not specified, defaults to 600px. width string Can be any valid CSS size specifier. If not specified, defaults to 800px. onFirstInteractive callback(e: Callback when the viz first becomes TableauEvent) interactive. This is only called once, but it’s guaranteed to be called. If the viz is already interactive, it will be called immediately, but on a separate "thread." ToolbarPosition Enum Enumeration Name TOP BOTTOM Description Positions the toolbar along the top of the viz. Positions the toolbar along the bottom of the viz. Viz Event Classes TableauEventName Enum These are strings passed to Viz.addEventListener/removeEventListener. Note that the value of the enums are all lowercase strings with no underscores. For example, CUSTOM_VIEW_ LOAD is customviewload. Either the fully-qualified enum (tableauSoftware.TableauEventName.FILTER_CHANGE) or the raw string (filterchange) is acceptable. Name CUSTOM_VIEW_ LOAD CUSTOM_VIEW_ REMOVE CUSTOM_VIEW_ SAVE Event Class Passed in the Callback CustomViewEvent CustomViewEvent CustomViewEvent Description Raised when a custom view has finished loading. Raised when the user removes a custom view. Raised when the user saves a new or existing custom view. CUSTOM_VIEW_ SET_DEFAULT FILTER_ CHANGE MARKS_ SELECTION PARAMETER_ VALUE_ CHANGE TAB_SWITCH CustomViewEvent FilterEvent MarksEvent ParameterEvent TabSwitchEvent Raised when a custom view has been made the default view for this viz. Raised when any filter has changed state. The viz may not be interactive yet. Raised when marks are selected or deselected. Raised when any parameter has changed state. Raised after the tab switched, but the viz may not yet be interactive. TableauEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getEventName TableauEventName Gets the name of the event which is a string, () but is also one of the items in the TableauEventName enum. CustomViewEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getEventName TableauEventName Gets the name of the event which is a string, () but is also one of the items in the TableauEventName enum. Methods Name Return Type getCustomViewAsync Promise< () CustomView> Description Gets the CustomView object associated with the event. FilterEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getWorksheet Worksheet Gets the Worksheet object associated () with the event. getEventName TableauEventName Gets the name of the event which is a string, () getFieldName () string but is also one of the items in the TableauEventName enum. Gets the name of the field. Methods Name Return Type Description getFilterAsync() Promise<Field> Gets the Field object associated with the event. MarksEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getWorksheet Worksheet Gets the Worksheet object associated () with the event. getEventName TableauEventName Gets the name of the event which is a string, () but is also one of the items in the TableauEventName enum. Methods Name Return Type Description getMarksAsync Promise<Mark Gets the selected marks on the Worksheet that () []> triggered the event. ParameterEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getEventName() TableauEventName Gets the name of the event which is a string, but is also one of the items in the TableauEventName enum. getParameterName string Gets the name of the parameter that () changed. Methods Name Return Type Description getParameterAsync Promise<Parameter> Gets the Parameter object that () triggered the event. TabSwitchEvent Class Properties Name getViz() Type Viz Description Gets the Viz object associated with the event. getEventName() TableauEventName Gets the name of the event which is a string, but is also one of the items in the TableauEventName enum. getOldSheetName string Gets the name of the sheet that was () active before the tab switch event occurred. getNewSheetName string Gets the name of the sheet that is () currently active. Workbook Classes Class Diagram Workbook Class A Workbook has a collection of Sheets represented as tabs. It also has associated objects like DataSources and CustomViews. Properties Name getViz() Type Viz Description Gets the Viz object that contains the workbook. getActiveSheet() Sheet Gets the currently active sheet (the active tab) getActiveCustomView() CustomView Gets the currently active custom view, or null if no custom view is active. getPublishedSheetsInfo SheetInfo[] Note that this is synchronous, meaning () that all of the sheets are expected when loaded. getName() string Gets the name of the workbook saved to the server. Note that this is not necessarily the file name. Methods Name revertAllAsync() Return Type Promise getParametersAsync() Promise<Parameter[]> changeParameterValueAsync( name: string, value: object) Promise<Parameter> getCustomViewsAsync() Promise<CustomView[] > showCustomViewAsync( customViewName: string) Promise< CustomView> removeCustomViewAsync( customViewName: string) Promise< CustomView> rememberCustomViewAsync( customViewName: string) Promise<CustomView> Description Reverts the workbook to its last saved state. Fetches the parameters for this workbook. Changes the value of the Parameter with the given name and returns the new Parameter. Gets the collection of CustomView objects associated with the workbook. Changes the viz to show the named saved state. Removes the named custom view. Remembers setActiveCustomViewAsDefaultAsync() None the current state of the workbook by assigning a custom view name. Sets the active custom view as the default. DataSource Class The Workbook contains one or more data sources. Each Worksheet will have a primary data source and can have multiple secondary data sources. Properties Name getName() getIsPrimary () getFields() Type Description string The name of the DataSource as seen in the UI. bool Indicates whether this DataSource is a primary or a secondary data source. Field Gets an array of Fields associated with the DataSource. [] Field Class A field contains information about what data source it belongs to, its role, and the ability to fetch the domain values. Properties Name Type getName() string getAggregation FieldAggregationType () getDataSource () getRole() DataSource FieldRoleType Description Gets the field name (i.e. caption). Gets the type of aggregation, which is one of the following values: SUM, AVG, MIN, MAX, STDEV, STDEVP, VAR, VARP, COUNT, COUNTD, MEDIAN, ATTR, NONE, YEAR, QTR, MONTH, DAY, HOUR, MINUTE, SECOND, WEEK, WEEKDAY, MONTHYEAR, MDY, END, TRUNC_YEAR, TRUNC_QTR, TRUNC_ MONTH, TRUNC_WEEK, TRUNC_DAY, TRUNC_HOUR, TRUNC_MINUTE, TRUNC_SECOND, QUART1, QUART3, SKEWNESS, KURTOSIS, INOUT, USER Gets the data source to which this field belongs. One of the following values: DIMENSION, MEASURE, UKNOWN CustomView Class Represents a named snapshot of the workbook at a specific moment. Properties Name getName() setName() getAdvertised() setAdvertised() getDefault() getOwnerName () getUrl() getWorkbook() Type string Description User-friendly name for the custom view bool Indicates whether the custom view is public or private. Gets or sets whether this is the default custom view. Gets the user that created the custom view. bool string string Unique URL to load this view again. Workbook Gets the Workbook to which this CustomView belongs. Methods Name Return Type Description saveAsync Promise<CustomView> After saveAsync() is called, the result of () the getUrl method is no longer blank. Sheet Classes Class Diagram SheetInfo Class Contains information about a Worksheet or a Dashboard and no methods. Returned as part of Workbook.getPublishedSheetsInfo(). Constructor There is no public constructor. You can only get instances of this class from Workbook.getPublishedSheetsInfo(). Properties Name getName() getIndex() Type string int Description Gets the name of the sheet. Gets the index of the sheet within the published tabs. Note that hidden tabs are still counted in the ordering, as long as they are published. getIsActive() bool Gets a value indicating whether the sheet is the currently active sheet.Due to a technical limitation in version 8.0, this will always return false if the object is a Worksheet instance that is part of a Dashboard. getIsHidden() bool Gets a value indicating whether the sheet is hidden in the UI. Note that if the entire tab control is hidden, it does not affect the state of this flag. This sheet may still report that it is visible even when the tabs control is hidden. getSheetType SheetType Gets the type of the sheet. SheetType is an enum () with the following values: WORKSHEET and DASHBOARD. getSize() SheetSize Gets the size information that the author specified when publishing the workbook. getUrl() string Gets the URL for this sheet. getWorkbook Workbook Gets the Workbook to which this Sheet belongs. () Sheet Class Constructor There is no public constructor. You can only get instances of this class from Workbook.getActiveSheet()or Dashboard.getObjects(). Properties Name getName() getIndex() Type string int getIsActive() bool Description Gets the name of the sheet. Gets the index of the sheet within the published tabs. Note that hidden tabs are still counted in the ordering, as long as they are published. Gets a value indicating whether the sheet is the currently active sheet. getIsHidden() bool Gets a value indicating whether the sheet is hidden in the UI. Note that if the entire tab control is hidden, it does not affect the state of this flag. This sheet may still report that it is visible even when the tabs control is hidden. getSheetType SheetType Gets the type of the sheet. SheetType is an enum () with the following values: WORKSHEET and DASHBOARD. getSize() SheetSize Gets the size information that the author specified when publishing the workbook. getUrl() string Gets the URL for this sheet. getWorkbook Workbook Gets the Workbook to which this Sheet belongs. () Methods Name Return Type changeSizeAsync Promise< (size: SheetSize) SheetSize > Description Sets the size information on a sheet. Note that if the sheet is a Worksheet, only SheetSizeBehavior.AUTOMATIC is allowed since you can’t actually set a Worksheet to a fixed size. SheetSize Record Describes the way a Sheet should be sized. Fields Name Type Description behavior SheetSizeBehavior Contains an enumeration value of one of the following: AUTOMATIC, EXACTLY, RANGE, ATLEAST, and ATMOST. maxSize int This is only defined when behavior is EXACTLY, RANGE or ATMOST. This is only defined when behavior is EXACTLY, minSize int RANGE, or ATLEAST. Worksheet Class Represents a worksheet tab in the workbook or a dashboard object. These are two separate concepts: a worksheet and a worksheet instance. However, for simplicity in the API, they are both combined into the Worksheet class. Constructor There is no public constructor. You can only get instances of this class from Workbook.getPublishedSheets() or Dashboard.getObjects(). Properties Name Type Description getParentDashboard Dashboard Returns the Dashboard object to which this () Worksheet belongs (if it’s on a dashboard). Otherwise, it returns null. Methods Name Return Type Description getDataSourcesAsync Promise<DataSource Gets the primary and all of the () []> secondary data sources for this worksheet. Note that by convention the primary data source should always be the first element. Filtering methods are described in Worksheet Class (Filtering). Marks selection methods are described in Worksheet Class (Selecting Marks). Dashboard Class Contains a collection of DashboardObject instances and a notion of the active object. Constructor There is no constructor. You get an instance of this from Workbook.getPublishedSheets(). Properties Name getObjects () getWorksheets() Type Description DashboardOb- Gets the collection of objects. ject[] Worksheet[] Gets the collection of worksheets contained in the dashboard. Note that this is a helper method and is equivalent to looping through getObjects() and collecting all of the DashboardObject.Worksheet pointers when DashboardObject.getType() === tableauSoftware.DashboardObjectType.WORKSHEET. DashboardObject Class Represents one of a series of different areas of the dashboard. Constructor There is no constructor. You get an instance of this from Dashboard.getObjects(). Properties Name Type Description getObjectType DashboardObjectType Gets what the object represents, which is () an enum with the following values: BLANK, WORKSHEET, QUICK_FILTER, PARAMETER_CONTROL, PAGE_ FILTER, LEGEND, TITLE, TEXT, IMAGE, WEB_PAGE. getDashboard Dashboard Gets the Dashboard object that contains () this object. getWorksheet Worksheet If getType() returns WORKSHEET, this () contains a pointer to the Worksheet object. getPosition() Point Gets the coordinates relative to the topleft corner of the dashboard of the object. getSize() Size Gets the size of the object. Parameter Classes Class Diagram Parameter Class Contains information about a workbook parameter. To actually set a parameter’s value, call workbook.changeParameterValueAsync(). Properties Name getName() Type string getCurrentValue() DataValue getDataType() ParameterDataType Description A unique identifier for the parameter, as specified by the user. The current value of the parameter. The data type of the parameter can be one of the following: FLOAT, INTEGER, STRING, BOOLEAN, DATE, DATETIME. getAllowableValuesT- ParameterAllowableValuesype() Type getAllowableValues() DataValue[] getMinValue() DataValue getMaxValue() DataValue getStepSize() Number getDateStepPeriod() PeriodType The type of allowable values that the parameter can accept. It can be one of the following enumeration items: ALL, LIST, RANGE. If the parameter is restricted to a list of allowable values, this property contains the array of those values. Note that this is not a standard collection, but a JavaScript array. If getAllowableValuesType is RANGE, this defines the minimum allowable value, inclusive. Otherwise it’s undefined/null. If getAllowableValuesType is RANGE, this defines the maximum allowable value, inclusive. Otherwise it’s undefined/null. If getAllowableValuesType is RANGE, this defines the step size used in the parameter UI control slider. Otherwise it’s undefined/null. If getAllowableValuesType is RANGE and getDataType is DATE or DATETIME, this defines the step date period used in the Parameter UI control slider. Otherwise it’s undefined/null. Filtering There is a difference between querying existing filter state and setting new or existing filters. Querying filters is done via Worksheet.getFiltersAsync() which returns a collection of Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its variants) and is a function call that doesn't require you to instantiate a Filter class. When you specify fields in a filter, you should use the caption as shown in the UI, not the database field name. For example, use Container (the caption) instead of Product Container (the actual field name). The exception is hierarchical filters, which use the full hierarchical name (for example, [Product].[All Product].[Espresso]). Captions can use the optional [] delimiters around names. Class Diagram Worksheet Class (Filtering) These methods are on the Worksheet class, but are listed here for convenience. Methods Name getFiltersAsync() applyFilterAsync( fieldName: string, values: object[] or object, updateType: FilterUpdateType, options?: FilterOptions) applyRangeFilterAsync( fieldName: string, range: RangeFilterOptions) Return Type Promise<Filter []> Promise<string> Description Fetches the collection of filters used on the sheet. Applies a simple categorical filter (non-date). See the filtering examples for more details on these functions. Returns the fieldName that was filtered. Promise<strin- Applies a quantitative filter. If g> a range is specified that is outside of the domain min/max values, no error is raised and the command is allowed. Subsequent calls to getFiltersAsync[] will return these values even if applyRelativeDateFilterAsync( fieldName: string, options: RelativeDateFilterOptions) applyHierarchicalFilterAsync( fieldName: string, values: object, options: HierarchicalFilterOptions) clearFilterAsync(fieldName: string) they are outside of the bounds of the domain. This is equivalent to the behavior in Tableau Desktop. Promise<strin- Applies a relative date filter. g> Promise<strin- Applies a hierarchical filter. g> The values parameter is either a single value, an array of values, or an object { levels: ["1", "2"] }. Promise<strin- Clears the filter, no matter g> what kind of filter it is. Note that the filter is removed as long as no associated quick filter is showing for the field. If there is a quick filter showing, then the filter is kept, but it’s reset to the “All” state (effectually canceling the filter). For relative date filters, however, an error is returned since there is no “All” state for a relative date filter. To clear a relative date filter with a quick filter showing, you can call applyRelativeDateFilter() instead using a range that makes sense for the specific field. FilterOptions Record Passed into the applyFilter methods to control advanced filtering options. Fields Name isExcludeMode Type bool Description Determines whether the filter will apply in exclude mode or include mode. The default is include, which means that you use the fields as part of a filter. Exclude mode means that you include everything else except the specified fields. RangeFilterOptions Record Passed into the applyRangeFilterAsync method to control advanced filtering options. Fields Name min Type int max int nullOption NullOption Description Minimum value for the range (inclusive). Optional. Leave blank if you want a <= filter. Maximum value for the range (inclusive). Optional. Leave blank if you want a >= filter. The null values to include. RelativeDateFilterOptions Record Passed into the applyRelativeDateFilterAsync method to control advanced filtering options. Fields Name anchorDate periodType rangeType rangeN Type Date PeriodType DateRangeType int Description The UTC date from which to filter. Year, quarter, month, etc. LAST, LASTN, NEXT, etc. The number used when the rangeType is LASTN or NEXTN. Filter Class An abstract base class for all of the various filter types. Properties Name getWorksheet () getFilterType () getFieldName () Type Description Worksheet Gets the parent worksheet FilterType string Gets the type of the filter. See FilterType Enum for the values in the enum. Gets the name of the field being filtered. Note that this is the caption as shown in the UI and not the actual database field name. Methods Name getFieldAsync() Return Type Promise<Field> Description Gets the field that is currently being filtered. NullOption Enum An enumeration that indicates what to do with null values for a given filter or mark selection call. Enumeration Name NULL_VALUES NON_NULL_VALUES ALL_VALUES Description Only include null values in the filter. Only include non-null values in the filter. Include null and non-null values in the filter. CategoricalFilter Class Properties Name getIsExcludeMode () getAppliedValues () Type bool Description Gets a value indicating whether the filter is exclude or include (default). DataValue Gets the collection of values that are currently set [] on the filter. Note that this is a native JavaScript array and not a keyed collection. QuantitativeFilter Class Properties Name getDomainMinValue () getDomainMaxValue () getMinValue() Type Description DataValue Gets the minimum value as specified in the domain. DataValue Gets the maximum value as specified in the domain. DataValue Gets the minimum value, inclusive, applied to the filter. getMaxValue() DataValue Gets the maximum value, inclusive, applied to the filter. getIncludeNullValues bool Indicates whether null values are included in () the filter. RelativeDataFilter Class Properties Name Type getPeriod() PeriodType Description The date period of the filter. See PeriodType Enum for the values in the enum. getRange() DateRangeType The range of the date filter (years, months, etc.). See DateRangeType Enum for the values in the enum. getRangeN int When getRange returns LASTN or NEXTN, this is () the N value (how many years, months, etc.). DataValue Record A DataValue contains both the raw and formatted value for a filter or parameter. Date values are always expressed in UTC dates. Properties Name value Type Description object Contains the raw native value as a JavaScript type, which is one of String, Number, Boolean, or Date formattedValue string The value formatted according to the locale and the formatting applied to the field or parameter. FilterType Enum An enumeration of the valid types of filters that can be applied. Enumeration Name CATEGORICAL Description Categorical filters are used to filter to a set of values within the domain. QUANTITATIVE Quantitative filters are used to filter to a range of values from a continuous domain. HIERARCHICAL Hierarchical filters are used to filter to a set of values organized into a hierarchy within the domain. RELATIVE_ Relative date filters are used to filter a date/time domain to a DATE range of values relative to a fixed point in time. FilterUpdateType Enum An enumeration of the valid types of filtering that can be done. Enumeration Name ALL Description Adds all values to the filter. Equivalent to checking the (All) value in a quick filter. REPLACE Replaces the current filter values with new ones specified in the call. ADD Adds the filter values as specified in the call to the current filter values. Equivalent to checking a value in a quick filter. REMOVE Removes the filter values as specified in the call from the current filter values. Equivalent to unchecking a value in a quick filter. PeriodType Enum An enumeration of a date period used in filters and in parameters. Enumeration Name YEARS QUARTERS MONTHS WEEKS DAYS HOURS MINUTES SECONDS DateRangeType Enum An enumeration of the valid date ranges for a relative date filter. Enumeration Name LAST LASTN NEXT NEXTN CURRENT TODATE Description Refers to the last day, week, month, etc. of the date period. Refers to the last N days, weeks, months, etc. of the date period. Refers to the next day, week, month, etc. of the date period. Refers to the next N days, weeks, months, etc. of the date period. Refers to the current day, week, month, etc. of the date period. Refers to everything up to and including the current day, week, month, etc. of the date period. Marks Selection Selecting marks is almost identical to filtering. For filtering, you use one of the Worksheet.applyFilterAsync() methods. For selecting marks, you use Worksheet.selectMarksAsync(). The parameters for marks selection are almost identical to those used for filtering.This provides a very simple, easy to learn, and consistent way to accomplish the two most common use cases for the API: filtering and selection. Worksheet Class (Selecting Marks) These methods are on the Worksheet class, but are shown here for convenience. Methods Name Return Type clearSelectedMarksAsync void () getSelectedMarksAsync() Promise<Mark []> Description Clears the selection for this worksheet. Gets the collection of marks that are currently selected. selectMarksAsync( fieldName: string, value: object or object[], updateType: SelectionUpdateType) selectMarksAsync( fieldValuesMap: object, updateType: SelectionUpdateType) void Selects the marks and returns them. void Allows selection based on this syntax for the first parameter: { "Field1": value, "Field2": [1, 2, 3] } selectMarksAsync( marks: Mark[], updateType: SelectionUpdateType) void Mark Class A mark represents a single data point on the viz. It is independent of the type of viz (bar, line, pie, etc.). Constructor Signature Description Pair(fieldName: string, value: Creates a new Pair with the specified field object) name/value pairing Properties Name getPairs () Type Description Pair[] Gets a collection of field name/value pairs associated with the mark. Pair Class A pair contains a field name and a value (both the raw and formatted values). Constructor Signature Mark(pairs: Pair[]) Description Creates a new Mark with the specified pairs. Fields Name fieldName value Type Description string The field name to which the value is applied. object Contains the raw native value for the field as a JavaScript type, which is one of String, Number, Boolean, or Date. formattedValue string The value formatted according to the locale and the formatting applied to the field. SelectionUpdateType Enum An enumeration of the valid types of marks selection that can be done. Enumeration Name Description REPLACE Replaces the current marks values with new ones specified in the call. ADD Adds the values as specified in the call to the current selection. Equivalent to control-clicking in desktop. REMOVE Removes the values as specified in the call from the current selection. Equivalent to control-clicking an already selected mark in desktop. Other Classes Size Record Represents a width and height in pixels. This is implemented as a plain JavaScript object (it’s not a class). Fields Name width height Type int int Description Expressed in pixel units. Expressed in pixel units. Point Record Represents an x/y coordinate in pixels. This is implemented as a plain JavaScript object (it’s not a class). Fields Name x y Type int int Description Expressed in pixel units. Expressed in pixel units. Contato Em caso de dúvidas sobre vendas, contate [email protected]. Para obter suporte ao cliente, contate [email protected]. Para tirar outras dúvidas, contate [email protected]. Telefone: (206) 633-3400 Copyright ©2013 Tableau Software, Incorporated e seus licenciantes. Todos os direitos reservados. Patente www.tableausoftware.com/ip. Partes do código copyright ©2002 The Board of Trustees of the Leland Stanford Junior University. Todos os direitos reservados. A instalação do Tableau inclui uma versão executável não modificada do banco de dados Firebird. O código de origem desse banco de dados pode ser encontrado em http://www.firebirdsql.org Para obter uma listagem de avisos de copyright de terceiros, consulte o arquivo a seguir que é instalado com o Tableau Server: C:\Program Files\Tableau\Tableau Server\8.1\COPYRIGHTS.rtf Observação: Se você tiver instalado o Tableau Server 32 bits em um sistema operacional 64 bits, ele estará em C:\Program Files (x86) \Tableau\Tableau Server\8.1\COPYRIGHTS.rtf Este produto inclui software desenvolvido por Andy Clark. Este produto inclui software desenvolvido pela Apache Software Foundation (http://www.apache.org/). Este produto é Client Software, conforme definido no Acordo de Licença de Software do Usuário Final do Tableau Software.
