Pautas de archivos de importación CSV

Puede añadir usuarios en bloque creando un archivo de valores separados por comas (CSV) con información de usuario e importando luego el archivo. En el archivo CSV puede incluir atributos (por ejemplo, un nivel de licencia y el acceso de publicación) para aplicarlos a los usuarios al mismo tiempo que los importa.

Este tema cubre los detalles del archivo CSV en sí. Para importar usuarios usando el CSV, puede:

Requisitos del formato de archivo CSV

El archivo CSV para importar usuarios tiene los siguientes requisitos de formato:

  • Sin encabezados de columna. Tableau Cloud presupone que cada una de las líneas del archivo representa a un usuario.
  • Formato UTF-8 con la marca de orden de bytes (BOM).
    • Las codificaciones de caracteres, como BIG-5, se deben convertir a UTF-8. Esto se hace abriendo el archivo en un editor de texto y usando el comando Guardar como.
    • Si el carácter @ está presente en el campo de nombre de usuario para cualquier cosa que no sea un separador de dominio, debe estar en formato hexadecimal: \0x40. Por ejemplo, user@fremont@mycompany.com debería ser user\0x40fremont@mycompany.com.

Estructura de columnas requerida en el archivo CSV

El archivo no debe contener una fila de encabezado. No es necesario rellenar todas las columnas, pero debe conservarse la estructura de columnas requerida incluyendo todos los delimitadores de comas esperados.

La estructura de columnas varía según el producto y la herramienta de importación. Asegúrese de usar la estructura adecuada para su entorno:

  • Tableau Cloud: nombre de usuario, contraseña, nombre para mostrar, nivel de licencia, nivel de administrador, capacidad de publicación, dirección de correo electrónico
  • Tableau Cloud con Tableau Cloud Manager (TCM): URI de inquilino o sitio, nombre de usuario y contraseña, nombre para mostrar, nivel de licencia, nivel de administrador, capacidad de publicar, dirección de correo electrónico y tipo de autenticación.
  • Tableau Server: nombre de usuario, contraseña, nombre para mostrar, nivel de licencia, nivel de administrador, capacidad de publicación, dirección de correo electrónico
  • Tableau Server con agrupaciones de identidades: nombre de usuario, contraseña, nombre para mostrar, nivel de licencia, nivel de administrador, capacidad de publicación, dirección de correo electrónico, nombre del grupo de identidades, identificador

Consulte la sección Detalles de columna a continuación para obtener más información sobre los posibles valores de cada columna.

Importante: El orden de las columnas es importante. La primera columna se trata como el nombre de usuario; la segunda, como la contraseña; la tercera, como el nombre de visualización, etc., independientemente del contenido de las columnas. Si omite valores en un campo, deberá seguir incluyendo el delimitador de comas del campo.

Detalles de columnas para CSV de Tableau Cloud

Si el archivo CSV únicamente contiene valores de nombre de usuario (direcciones de correo electrónico), los usuarios recibirán una invitación al sitio por correo electrónico. Los usuarios se pueden unir al sitio para crear sus cuentas, pero estas seguirán sin tener licencia hasta que un administrador las configure (nombre de visualización, nivel de licencia, etc.). La dirección de correo electrónico de un usuario en el sitio puede mostrarse en el sitio con un punto inicial (como .user@domain.com) hasta que inicie sesión por primera vez.

Estructura de columnas del archivo CSV: nombre de usuario, contraseña, nombre para mostrar, nivel de licencia, nivel de administrador, capacidad de publicación y dirección de correo electrónico

Detalles de la columna:

Nombre de usuario: Requerido. La dirección de correo electrónico del usuario.

ContraseñaSe ha ignorado. Se recomienda que deje esta columna en blanco.

  • La primera vez que inician sesión en Tableau Cloud, los usuarios nuevos deben seleccionar una contraseña y un nombre de visualización. Si un usuario ya tiene una cuenta de Tableau, ya tiene contraseña.

Nombre para mostrar: Se ha ignorado. Se recomienda que deje esta columna en blanco.

Nivel de licencia: Este nivel puede ser Creator, Explorer, Viewer o Sin licencia. Si se deja en blanco, el nivel de licencia será Sin licencia.

Nivel de administrador: Puede ser Site o None. Si se deja en blanco, el nivel de administrador será Ninguno.

Capacidad de publicar: Los valores válidos son Yes/True/1 o No/False/0. Si se deja en blanco, la capacidad de publicación será false.

  • Si el nivel de licencia es Creator, la capacidad de publicación debe ser Yes/True/1.
  • Si el nivel de licencia es Explorer, el valor de la capacidad de publicación es lo que distingue el rol en el sitio entre Explorer (puede publicar) y Explorer
  • Si el nivel de licencia es Viewer o Sin licencia, el usuario no podrá publicar independientemente del valor de esta columna

Dirección de correo electrónico: a partir de marzo de 2025 (Tableau 2025.2), especifique una dirección de correo electrónico si es diferente del nombre de usuario. Las direcciones de correo electrónico se utilizan únicamente con fines de notificación. Si no se proporciona ningún valor de dirección de correo electrónico, Tableau Cloud utiliza el valor en el campo de nombre de usuario requerido para enviar notificaciones

Las columnas que se dejen en blanco deben delimitarse con comas para preservar la estructura de columnas.

Tipo de autenticación sin TCM

Si no utiliza Tableau Cloud Manager, solo puede establecer un único tipo de autenticación predeterminado durante la carga. Puede cambiar el tipo de autenticación de cada usuario más adelante.

  • Al cargar un archivo CSV directamente en Tableau Cloud, especifique el tipo de autenticación al importar el archivo y ese tipo se aplicará a todos los usuarios importados.
  • Al utilizar tabcmd para importar usuarios, establezca el tipo de autenticación y el rol en el sitio que se aplica a todos los usuarios del archivo .csv durante la carga. Para obtener información, consulte createsiteusers filename.csv.

Para establecer un tipo de autenticación específico por usuario en el momento de la carga, debe utilizar Tableau Cloud Manager. Para obtener más información, consulte Administrar usuarios con Tableau Cloud Manager.

Estructura de ejemplo de CSV de Tableau Cloud

Consejo: Recuerde, la estructura es username, password, display name, license level, administrator level, publishing capability, email address sin nada entre las comas cuando una columna se deja en blanco.

En el siguiente ejemplo se muestra un usuario con el rol en el sitio Explorer (puede publicar) concedido, no será administrador de sitio, y podrá publicar proyectos sobre los que tenga los permisos de contenido apropiados.

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

Al cambiar la columna en el nivel de administrador, puede importar el siguiente usuario como administrador de sitio con el rol en el sitio de administrador de sitio Explorer.

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

Detalles de columnas CSV de TCM

Si el archivo CSV únicamente contiene valores de nombre de usuario (direcciones de correo electrónico), los usuarios recibirán una invitación al sitio por correo electrónico. Los usuarios se pueden unir al sitio para crear sus cuentas, pero estas seguirán sin tener licencia hasta que un administrador las configure (nombre de visualización, nivel de licencia, etc.).

Recuerde que las columnas que quedan en blanco deben delimitarse con comas para preservar la estructura de columnas.

Estructura de columnas para el archivo CSV: tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type

Detalles de la columna: 

URI del inquilino o sitio: El identificador uniforme de recursos para el inquilino o sitio.

Nombre de usuario: Requerido. La dirección de correo electrónico del usuario.

ContraseñaSe ha ignorado. Se recomienda que deje esta columna en blanco.

  • La primera vez que inician sesión en Tableau Cloud, los usuarios nuevos deben seleccionar una contraseña y un nombre de visualización. Si un usuario ya tiene una cuenta de Tableau, ya tiene contraseña.

Nombre para mostrar: Se ha ignorado. Se recomienda que deje esta columna en blanco.

Nivel de licencia: Este nivel puede ser Creator, Explorer, Viewer o Sin licencia para el sitio. Si se deja en blanco, el nivel de licencia será Sin licencia.

Nivel de administrador: Puede ser Site, Cloud o None. Si se deja en blanco, el nivel de administrador será Ninguno.

  • Site = Administrador del sitio, None = No es administrador, Cloud = Administrador de la nube.

Capacidad de publicar: Puede ser True o False para el sitio. Si se deja en blanco, la capacidad de publicación será false.

  • Si el nivel de licencia es Creator, la capacidad de publicación debe ser True.
  • Si el nivel de licencia es Explorer, el valor de la capacidad de publicación es lo que distingue el rol en el sitio entre Explorer (puede publicar) y Explorer
  • Si el nivel de licencia es Viewer o Sin licencia, el usuario no podrá publicar independientemente del valor de esta columna

Tipo de autenticación: El tipo de autenticación de usuario para acceder al inquilino o sitio. Puede ser Google, OpenID, Salesforce, SAML, TableauIDWithMFA o DEFAULT.

Estructura de ejemplo de CSV de TCM

Consejo: Recuerde, la estructura es tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type sin nada entre las comas cuando una columna se deja en blanco.

El siguiente ejemplo muestra un usuario al que se le otorga el rol de administrador de la nube en Tableau Cloud Manager y se autentica mediante Tableau con MFA.

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

Al cambiar la columna de autenticación, puede importar el siguiente usuario con un tipo de autenticación alternativo si está configurado en Tableau Cloud Manager.

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

En el siguiente ejemplo, puede importar el usuario con el rol en el sitio Explorer (puede publicar) con Tableau y autenticación multifactor.

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

Configuración de CSV y roles en el sitio

El nivel de licencia, el administrador y las opciones de publicación para un usuario determinan cómo se configura el rol en el sitio de dicho usuario durante el proceso de importación. A continuación se muestra cómo se deben capturar los roles en el sitio en el CSV.

Rol en el sitioNivel de licenciaNivel de administradorCapacidad de publicar

Administrador de la nube

Este rol solo es válido si va a importar usuarios mientras tengan las sesiones de Tableau Cloud Manager iniciadas (es decir, que no hayan iniciado sesión en un sitio concreto).

Sin licenciaNubeFalse

Creator del administrador de sitio o Explorer del administrador de sitio

Estos roles solo son válidos si va a importar usuarios mientras ha iniciado sesión en un sitio concreto.

Creator o ExplorerSitioVerdadero
CreatorCreatorNingunoVerdadero
Explorer (puede publicar)ExplorerNingunoVerdadero
ExplorerExplorerNingunoFalse
ViewerViewerNingunoFalse
Sin licenciaSin licenciaNingunoFalse
¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!