Diretrizes do arquivo de importação CSV

Você pode automatizar a adição de usuários ao criar um arquivo de valores separados por vírgula (CSV) com informações do usuário e importar o arquivo. Você pode incluir atributos no arquivo CSV, como o nível de licença e o acesso de publicação, para serem aplicados aos usuários ao mesmo tempo que são importados.

Para importar usuários, use as páginas de administração do site ou use o utilitário tabcmd. Usar o tabcmd oferece uma opção para atribuir uma função no site a todos os usuários no arquivo CSV. Para obter informações, consulte Importar usuários ou createsiteusers filename.csv.

Requisitos de formato do arquivo CSV

Quando você criar o arquivo CSV para importação dos usuários, certifique-se de que o arquivo atenda aos requisitos de formatação:

  • O arquivo não inclui os cabeçalhos da coluna. Tableau Cloud pressupõe que cada linha no arquivo representa um usuário.

  • O arquivo está no formato UTF-8 e inclui a marca de ordem de byte (BOM).

  • Codificações de caracteres, como BIG-5, foram convertidas para UTF-8. Isso é possível abrindo o arquivo em um editor de texto e usando o comando Salvar como.

  • Se um nome de usuário incluir um caractere @ que representa qualquer forma que não seja um separador de domínio, será necessário fazer referência ao símbolo usando o formato hexadecimal: \0x40

    Por exemplo, user@fremont@mycompany.com deve ser user\0x40fremont@mycompany.com

Colunas exigidas no arquivo CSV

Os campos a seguir são necessários para cada usuário:

  • Nome de usuário: o endereço de e-mail do usuário.

  • Senha. O Tableau Cloud não usa esse campo, mas é preciso delimitá-lo em cada linha para posicionar os campos subsequentes corretamente.

Opções adicionais da coluna CSV

Para cada usuário, o arquivo CSV pode conter os seguintes campos além das colunas necessários. Onde indicado, o Tableau Cloud não usa o campo, mas ele deve ser contabilizado no arquivo.

  • URI do site (somente Tableau Cloud Manager): o identificador uniforme de recursos do site. Para importar um usuário como administrador de nuvem, inclua a coluna URI do site, mas deixe-a em branco.

  • Nome de exibição. O Tableau Cloud não usa esse campo, mas é preciso delimitá-lo em cada linha para posicionar os campos subsequentes corretamente.

  • Nível de licença. Isso pode ser Creator (Criador), Explorer (Explorador), Viewer (Visualizador) ou Não licenciado.

  • Nível de administrador: o valor pode ser Nuvem, Site, ou Nenhum. Nuvem = administrador da nuvem, Site = administrador do site e Nenhum = Não é administrador.

    Observação: o valor do administrador de nuvem só está disponível ao importar usuários para o Tableau Cloud Manager. Ele não se destina ao uso com sites do Tableau Cloud. Para obter mais informações, consulte Gerenciar usuários com o Tableau Cloud Manager.

  • Capacidade de publicação. Os valores aceitáveis são Yes/True/1 ou No/False/0. Se o nível de licença for Creator, a capacidade de publicação deverá ser Sim/Verdadeiro/1.

  • Tipo de autenticação (somente Tableau Cloud Manager): o tipo de autenticação do usuário para acessar um site ou o Tableau Cloud Manager.

Entradas de amostra do arquivo CSV

Site Tableau Cloud

O exemplo a seguir mostra um usuário que receberá a função no site de Explorer, 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

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

Tableau Cloud Manager

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.

,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA

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.

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

Observações

  • 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.).

  • Os campos de senha (segundo valor) e o nome de exibição (terceiro valor) não são usados pelo Tableau Cloud. Os valores que você especifica para esses campos são ignorados.

    Entretanto, se desejar definir a licença e o acesso de publicação para os usuários, o arquivo ainda precisará incluir os delimitadores para esses campos, conforme demonstrado no exemplo anterior.

  • Novos usuários devem selecionar uma senha e um nome de exibição ao entrarem pela primeira vez no Tableau Cloud. Se os usuários já possuírem uma conta do Tableau, como para o Fórum da comunidade do Tableau, eles já têm senhas.

  • O arquivo CSV não inclui um campo para configuração do tipo de autenticação (Tableau, Google ou SAML). Você especifica isso no Tableau Cloud quando importa o arquivo. A configuração se aplica a todos os usuários importados, e você poderá alterar o tipo de autenticação para usuários individuais posteriormente.

    Observação: como opção, é possível usar o tabcmd para importar usuários e definir o tipo de autenticação e função no site que se aplicam a todos os usuários no arquivo CSV. Para obter mais informações, consulte createsiteusers filename.csv.

Configurações de CSV e funções no site

As configurações de nível de licença, administrador e publicação de um usuário determinam como a função no site do usuário é definida durante o processo de importação. A tabela a seguir mostra como as configurações são convertidas a funções do site.

Configurações do CSVFunção de site

Nível de licença=Não licenciado

Administrador=Nuvem

Publicador=falso

Administrador de nuvem. Essa configuração será válida somente se você estiver importando usuários enquanto estiver conectado ao Tableau Cloud Manager (ou seja, sem estar conectado a um site específico).

Nível de licença=Creator ou Explorer

Administrado=Site

Publicador=verdadeiro

Creator (Administrador de site) ou Explorer (Administrador de site) Essa configuração é válida somente se você estiver importando usuários quando estiver conectado a um site específico.

Nível de licença=Criator

Administrador=Nenhum

Publicador=verdadeiro

Creator

Nível de licença=Explorer

Administrador=Nenhum

Publicador=verdadeiro

Explorer (pode publicar)

Nível de licença=Explorer

Administrador=Nenhum

Publicador=falso

Explorer

Nível de licença=Viewer (Visualizador)

Administrador=Nenhum

Publicador=falso

Viewer

Nível de licença=Não licenciado

Administrador=Nenhum

Publicador=falso

Não licenciado

Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!