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 seruser\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 CSV | Funçã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 |