--- schema_version: "1" id: d1aea0279d53c3366f60d52418eb129aac0744b2709fe16772d4f396a7d8590c title: Diretrizes do arquivo de importação CSV collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/online/csvguidelines.md canonical_url: https://help.tableau.com/current/online/pt-br/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: d25a33e72a7de4f1328fd92b132e77941f2df9acfb8717b6daf3424573631a71 description: CSV file format guidelines for bulk importing users into Tableau Cloud and Tableau Cloud Manager, with required columns. --- [Pular para o conteúdo principal](#main-content) # Diretrizes do arquivo de importação CSV Você pode adicionar usuários em massa ao criar um arquivo de valores separados por vírgula (CSV) com informações do usuário e ao 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. 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](https://help.tableau.com/current/online/pt-br/users_import.htm) - Usar o utilitário `tabcmd`. Para obter mais informações, consulte [createsiteusers filename.csv](https://help.tableau.com/current/online/pt-br/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894). - Usar o Tableau Cloud Manager. Para obter mais informações, consulte [Gerenciar usuários com o Tableau Cloud Manager](https://help.tableau.com/current/online/pt-br/cloud_manager_users.htm). ## 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. - O formato UTF-8 com a marca de ordem de byte (BOM) só é compatível ao importar para sites. Se estiver importando para o Tableau Cloud Manager, use o formato UTF-8 e remova qualquer BOM de seus arquivos. - 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. > [!WARNING] > > **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: _username, password, display name, license level, administrator level, publishing capability, email address_ ### Detalhes da coluna As colunas deixadas em branco ainda devem ser delimitadas com vírgulas para preservar a estrutura da coluna. **Username:** _obrigatório_. O endereço de e-mail do usuário. **Password:** _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. **Display name:** _ignorado_. Como prática recomendada, deixe esta coluna em branco. **License level:** pode ser **Creator (Criador)**, **Explorer (Explorador)**, **Viewer (Visualizador)** ou **Unlicensed**. Se deixado em branco, o nível de licença será Unlicensed. **Administrator level:** pode ser **Site** ou **None**. Se deixado em branco, o nível de administrador será None. - Site = administrador do site, None = 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](https://help.tableau.com/current/online/pt-br/cloud_manager_users.htm). **Publishing capability:** 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 Unlicensed, o usuário não poderá publicar, independentemente do valor desta coluna **Email address:** a partir de julho de 2025 (Tableau 2025.2), você poderá especificar um endereço de e-mail se ele for 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. Por motivos de segurança, você só pode especificar o endereço de e-mail de um usuário que seja membro de apenas um site. ### 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](https://help.tableau.com/current/online/pt-br/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894). 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](https://help.tableau.com/current/online/pt-br/cloud_manager_users.htm). ### Estrutura de exemplo de CSV do Tableau Cloud > [!TIP] > > **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 **Tenant or site URI:** o identificador uniforme de recursos do site. **Username:** _obrigatório_. O endereço de e-mail do usuário. **Password:** _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. **Display name:** _ignorado_. Como prática recomendada, deixe esta coluna em branco. **License level:** pode ser **Creator (Criador)**, **Explorer (Explorador)**, **Viewer (Visualizador)** ou **Unlicensed** para o site. Se deixado em branco, o nível de licença será Unlicensed. **Administrator level:** pode ser **Site**, **Cloud** ou **None**. Se deixado em branco, o nível de administrador será None. - Site = administrador de site, None = não é administrador, Cloud = administrador da nuvem. **Publishing capability:** 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 Unlicensed, o usuário não poderá publicar, independentemente do valor desta coluna **Authentication type:** 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 > [!TIP] > > **Dica:** lembre-se de que a estrutura é: `tenant or site URI, username, password, display name, license level, administrator level, publishing capability, 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. TCM,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. TCM,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 ## 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 seguir, é mostrado como as funções no site devem ser capturadas no CSV.
Função no siteLicense levelAdministrator levelPublishing capability

Administrador de nuvem

Essa funçã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).

UnlicensedCloudFalse

Creator (Administrador de site) ou Explorer (Administrador de site)

Essas funções serão válidas somente se você estiver importando usuários quando estiver conectado a um site específico.

Creator ou ExplorerSiteTrue
CreatorCreatorNoneTrue
Explorer (pode publicar)ExplorerNoneTrue
ExplorerExplorerNoneFalse
ViewerViewerNoneFalse
UnlicensedUnlicensedNoneFalse