Ajuda do Tableau Cloud

Este tópico aborda os detalhes do próprio arquivo CSV. Para importar usuários usando o CSV, você pode:

• Usar a página de administração do site. Para obter informações, consulte Importar usuários
• Usar o utilitário tabcmd. Para obter mais informações, consulte createsiteusers filename.csv.
• Usar o Tableau Cloud Manager. Para obter mais informações, consulte Gerenciar usuários com o Tableau Cloud Manager.

Requisitos de formato do arquivo CSV

O arquivo CSV para importação de usuários tem os seguintes requisitos de formatação:

• Sem cabeçalhos de coluna. Tableau Cloud pressupõe que cada linha no arquivo representa um usuário.
• Formato UTF-8 com a marca de ordem de byte (BOM).
  • As codificações de caracteres, como BIG-5, devem ser convertidas em UTF-8. Isso é possível abrindo o arquivo em um editor de texto e usando o comando Salvar como.
  • Se o caractere @ estiver presente no campo nome de usuário para qualquer coisa que não seja um separador de domínio, ele deverá estar no formato hexadecimal: \0x40. Por exemplo, user@fremont@mycompany.com deve ser user\0x40fremont@mycompany.com.

Estrutura de coluna necessária no arquivo CSV

O arquivo não deve conter uma linha de cabeçalho. Nem todas as colunas precisam ser preenchidas, mas a estrutura de coluna necessária deve ser preservada, incluindo todos os delimitadores de vírgula esperados.

A estrutura da coluna varia por produto e por ferramenta de importação. Verifique se você está usando a estrutura apropriada para seu ambiente:

• Tableau Cloud: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
• Tableau Cloud with Tableau Cloud Manager (TCM): URI do locatário ou do site, nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, capacidade de publicação, endereço de e-mail, tipo de autenticação
• Tableau Server: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
• Tableau Server usando pools de identidades: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail, nome do pool de identidades, identificador

Consulte a seção de detalhes da coluna abaixo para obter mais informações sobre os valores possíveis para cada coluna.

Importante: a ordem da coluna é importante. A primeira coluna é tratada como o nome de usuário, a segunda como a senha, a terceira como nome de exibição etc., independentemente do conteúdo das colunas. Mesmo que você opte por omitir os valores de um campo, ainda será necessário incluir o delimitador de vírgula desse campo.

Detalhes de coluna para CSV do Tableau Cloud

Se o arquivo CSV contiver somente valores de nomes de usuário (endereços de e-mail), os usuários receberão o convite para o site por e-mail. Os usuários podem ingressar no site para criar suas contas, mas elas permanecerão sem licença até que um administrador as configure (nome de exibição, nível de licença etc.). O endereço de e-mail de um usuário no site pode ser exibido no site com um ponto à esquerda (como .user@domain.com) até que ele faça login pela primeira vez.

Estrutura de coluna para o arquivo CSV: nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail

Detalhes da coluna:

Nome de usuário: obrigatório. O endereço de e-mail do usuário.

Senha: ignorada. Como prática recomendada, deixe esta coluna em branco.

• Novos usuários devem selecionar uma senha e um nome de exibição ao entrarem pela primeira vez no Tableau Cloud. Se um usuário já tem uma conta do Tableau, é possível que ele já tenha uma senha.

Nome de exibição: ignorado. Como prática recomendada, deixe esta coluna em branco.

Nível de licença: pode ser Creator (Criador), Explorer (Explorador), Viewer (Visualizador) ou Não licenciado. Se deixado em branco, o nível de licença será Não licenciado.

Nível do administrador: pode ser Site ou Nenhum. Se deixado em branco, o nível de administrador será Nenhum.

• Site = administrador do site, Nenhum = não é administrador.
• Observação: Cloud é apenas um valor relevante ao usar o Tableau Cloud Manager. Para obter mais informações, consulte Gerenciar usuários com o Tableau Cloud Manager.

Recurso de publicação: pode ser Yes/True/1 ou No/False/0. Se deixado em branco, o recurso de publicação será false.

• Se o nível de licença for Creator, o recurso de publicação deverá ser Yes/True/1
• Se o nível de licença for Explorer, o valor do recurso de publicação será o que distingue a função no site entre Explorer (pode publicar) e Explorer
• Se o nível de licença for Viewer ou Não licenciado, o usuário não poderá publicar, independentemente do valor desta coluna

lEndereço de e-mai: a partir de julho de 2025 (Tableau 2025.2), especifique um endereço de e-mail, se diferente do nome de usuário. Os endereços de e-mail são usados apenas para fins de notificação. Se nenhum valor de endereço de e-mail for fornecido, o Tableau Cloud usará o valor no campo de nome de usuário obrigatório para enviar notificações

As colunas deixadas em branco ainda devem ser delimitadas com vírgulas para preservar a estrutura da coluna.

Tipo de autenticação sem TCM

Se você não estiver usando o Tableau Cloud Manager, só poderá definir um único tipo de autenticação padrão durante o carregamento. Você pode alterar o tipo de autenticação para usuários individuais posteriormente.

• Ao carregar um arquivo CSV diretamente no Tableau Cloud, especifique o tipo de autenticação ao importar o arquivo e esse tipo se aplica a todos os usuários importados.
• Ao usar tabcmd para importar usuários, defina o tipo de autenticação e a função no site que se aplica a todos os usuários no arquivo CSV durante o carregamento. Para obter mais informações, consulte createsiteusers filename.csv.

Para definir um tipo de autenticação específico por usuário no momento do carregamento, use o Tableau Cloud Manager. Para obter mais informações, consulte Gerenciar usuários com o Tableau Cloud Manager.

Estrutura de exemplo de CSV do Tableau Cloud

Dica: lembre-se de que a estrutura é: username, password, display name, license level, administrator level, publishing capability, email address sem nada entre as vírgulas quando uma coluna é deixada em branco.

O exemplo a seguir mostra um usuário que receberá a função no site Explorer (pode publicar), não será um administrador de site e poderá publicar em projetos nos quais tenha as permissões de conteúdo adequadas.

user1@domain.com,,,Explorer,None,true,user1@domain2.com

Com a alteração da coluna de nível de administrador, você poderá importar o seguinte usuário como administrador de site com a função no site de Explorer (Administrador de site).

adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com

Detalhes de coluna para CSV do TCM

Se o arquivo CSV contiver apenas valores de nome de usuário (endereço de e-mail), os usuários receberão um convite por e-mail para o site. Os usuários podem ingressar no site para criar suas contas, mas elas permanecerão sem licença até que um administrador as configure (nome de exibição, nível de licença etc.).

Lembre-se de que as colunas deixadas em branco ainda devem ser delimitadas com vírgulas para preservar a estrutura da coluna.

Estrutura de coluna para o arquivo CSV: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type

Detalhes da coluna: 

URI de locatário ou site: o identificador uniforme de recursos do site.

Nome de usuário: obrigatório. O endereço de e-mail do usuário.

Senha: ignorada. Como prática recomendada, deixe esta coluna em branco.

• Novos usuários devem selecionar uma senha e um nome de exibição ao entrarem pela primeira vez no Tableau Cloud. Se um usuário já tem uma conta do Tableau, é possível que ele já tenha uma senha.

Nome de exibição: ignorado. Como prática recomendada, deixe esta coluna em branco.

Nível de licença: pode ser Creator (Criador), Explorer (Explorador), Viewer (Visualizador) ou Não licenciado para o site. Se deixado em branco, o nível de licença será Não licenciado.

Nível do administrador: pode ser Site, Nuvem ou Nenhum. Se deixado em branco, o nível de administrador será Nenhum.

• Site = administrador de site, Nenhum = não é administrador, Nuvem = administrador da nuvem.

Capacidade de publicação: pode ser True ou False para o site. Se deixado em branco, o recurso de publicação será false.

• Se o nível de licença for Creator, o recurso de publicação deverá ser True
• Se o nível de licença for Explorer, o valor do recurso de publicação será o que distingue a função no site entre Explorer (pode publicar) e Explorer
• Se o nível de licença for Viewer ou Não licenciado, o usuário não poderá publicar, independentemente do valor desta coluna

Tipo de autenticação: o tipo de autenticação do usuário para acessar o locatário ou site. Pode ser Google, OpenID, Salesforce, SAML, TableauIDWithMFA, ou DEFAULT.

estrutura de exemplo de CSV de TCM

Dica: lembre-se de que a estrutura é: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type sem nada entre as vírgulas quando uma coluna é deixada em branco.

O exemplo a seguir mostra um usuário que recebe a função de administrador de nuvem no Tableau Cloud Manager e se autentica usando o Tableau com MFA.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA

Ao alterar a coluna de autenticação, você pode importar o usuário a seguir com um tipo de autenticação alternativo, se configurado nas configurações do Tableau Cloud Manager.

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce

No exemplo a seguir, é possível importar o usuário com a função de site Explorer - pode publicar com Tableau e autenticação MFA.

MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA