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:

Usar las páginas de administración del servidor o del sitio. Para obtener más información, consulte Importar usuarios.
Usar la utilidad tabcmd. Para obtener información, consulte createsiteusers filename.csv.

Puede importar usuarios a nivel de sitio o de servidor. Si importa usuarios en el servidor (y no en un sitio específico), los usuarios no se asignarán a ningún sitio y se importarán como "Sin licencia".

Nota: A menos que se indique lo contrario, las pautas especificadas en este tema se aplican a Tableau Server cuando se configura con o sin grupos de identidad(El enlace se abre en una ventana nueva).

Requisitos del formato de archivo CSV

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

Sin encabezados de columna. Tableau Server 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 Tableau Server

Nota: Si no ha iniciado sesión en un sitio específico y está importando usuarios en el nivel del servidor, puede asignar únicamente los roles en el sitio sin licencia y los de administrador de servidor.

Estructura de columnas para el archivo CSV: username, password, display name, license level, admin level, publishing capability, email address

Detalles de la columna:

Nombre de usuario: Requerido. Nombre del usuario.

Si el servidor está configurado para usar Active Directory, este valor debe coincidir con un usuario definido en Active Directory. Si el nombre de usuario no es único en los dominios, debe incluir el dominio como parte del nombre de usuario (por ejemplo, example\Adam or adam@example).
Si agrega usuarios a un grupo de identidades(El enlace se abre en una ventana nueva), asegúrese de lo siguiente:

Si agrega un usuario a un grupo de identidades que usa AD como su almacén de identidades, asegúrese de usar el valor AD sAMAccountName para el nombre de usuario.
Si agrega un usuario a un grupo de identidades que usa LDAP como su almacén de identidades, asegúrese de usar el valor de nombre de usuario de LDAP para el nombre de usuario.

Contraseña: La contraseña del usuario. Si esta columna es necesaria o no, depende de la configuración del servidor:

Autenticación local: Requerido. La aplicación del campo de contraseña requerido comenzó en Tableau Server 2024.2. Para obtener más información, consulte el artículo de Knowledge Se produce un "código de error = 134" inesperado al intentar agregar usuarios a través de tabcmd en Tableau Server 2024.2.
Active Directory: Ignorado. Se recomienda que deje esta columna en blanco.

Nombre para mostrar: El nombre de visualización forma parte de la información que se usa para identificar a un usuario en el servidor. El uso o no de esta columna dependerá de la configuración del servidor:

Autenticación local: Si el nombre de visualización del usuario ya está en uso, Tableau Server actualiza la información existente del usuario con la configuración que hay en el archivo CSV.
Active Directory: Ignorado. Se recomienda que deje esta columna en blanco.

Nivel de licencia: Este nivel puede ser Creator, Explorer, Viewer o Sin licencia.

Si el nivel de licencia es Creator, la capacidad de publicación debe ser Yes/True/1.
Si tiene una instalación de servidor basada en usuarios y al agregar usuarios superaría el número de usuarios permitidos por su licencia, los usuarios se agregan como “Sin licencia”.
Si usa tabcmd y especifica la licencia, pero la importación de usuarios conllevaría que se superaran los límites de la licencia, los usuarios se importarán como “Sin licencia”.

Nivel de administrador: Puede ser System, Site o None y determina si el usuario se importa como administrador.

Servidor = Administrador de la Sistema, Site = Administrador del sitio y None = No es administrador.
Si no ha iniciado sesión en un sitio específico y está importando usuarios en el nivel del servidor, puede asignar únicamente los roles en el sitio sin licencia y los de administrador de servidor.
Si usa la interfaz de usuario web para importar usuarios, puede establecer el rol en el sitio de administrador en Sistema únicamente si importa el archivo en el nivel del servidor (Todos los sitios). Si ha iniciado sesión en un sitio específico y la columna de administrador de un usuario indicado en el archivo CSV está establecido en Sistema, Tableau Server importará el usuario como administrador de sitio.

Capacidad de publicar: Los valores válidos son Yes/True/1 o No/False/0. Si usa la interfaz de usuario web, la capacidad de publicar solo se usa si efectúa la importación con la sesión iniciada en un sitio concreto.

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: La dirección de correo electrónico forma parte de la información que se usa para identificar a un usuario en el servidor. Si la dirección de correo electrónico ya está en uso, Tableau Server actualiza la información existente del usuario con la configuración que hay en el archivo CSV.

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

Grupos de identidad

Si agrega usuarios a un grupo de identidades, se necesitan las siguientes columnas además de las columnas estándar:

Estructura de columnas para el archivo CSV: username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

Detalles adicionales de la columna:

Nombre de la agrupación de identidad: El nombre la agrupación de identidad al que desea añadir al usuario. Si agrega usuarios a un grupo de identidades y no especifica el nombre del grupo de identidades, los usuarios se agregan al grupo inicial (TSM configurado), que es el conjunto de usuarios que se aprovisionaron en TSM durante la configuración de Tableau Server.

Identificador: El identificador del usuario que desea agregar. Los identificadores solo se utilizan con fines de coincidencia de identidad. Para obtener más información, consulte Nombres de usuario e identificadores en Tableau.

Autenticación local: Opcional
Active Directory o LDAP: Requerido

Agregar usuarios de forma masiva con grupos de identidades

Puede utilizar el proceso de importación CSV para:

Agregar usuarios de forma masiva a grupos de identidades adicionales. Nota: No puede utilizar el proceso de importación CSV para reemplazar el grupo de identidades al que ya pertenece un usuario por otro grupo de identidades. Si agrega un usuario existente con un valor de grupo de identidades diferente, se agregará a ese grupo de identidades adicional.
Agregar identificadores de forma masiva para los usuarios que aún no los tienen. Nota: Si agrega un identificador diferente para un usuario en el mismo grupo, no reemplazará el identificador existente para ese usuario. En su lugar, se creará un nuevo registro de identificador para ese usuario.

Ejemplos de importación CSV para Tableau Server

Consejo: Recuerde que la estructura es username, password, display name, license level, admin level, publishing capability, email address.

El ejemplo siguiente muestra un archivo CSV que contiene información para varios usuarios.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

Si importa este archivo al administrar un sitio, se agregan cuatro usuarios a ese sitio. La opción Administrator del usuario Michelle es System. Sin embargo, dado que va a importar los usuarios a un sitio, Tableau Server concede al usuario Michelle el rol en el sitio de administrador de sitio Creator. Tres de los usuarios tienen permiso para publicar.
Si importa este archivo al administrar el servidor, se agregan cuatro usuarios al servidor, pero no se agregan a ningún sitio. Solo se importa un usuario como administrador del servidor; el resto de los usuarios se establecen como "Sin licencia".

Ejemplos de grupos de identidades

Consejo: Recuerde que la estructura es username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier.

El ejemplo siguiente muestra un archivo CSV que contiene información de dos usuarios añadidos a un grupo de identidad.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

El ejemplo siguiente muestra un archivo CSV que contiene información de dos usuarios añadidos a un grupo de identidad adicional.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

El ejemplo siguiente muestra un archivo CSV que contiene información de dos usuarios sin identificadores.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez

Mejorar el rendimiento de archivos CSV de gran tamaño que se pasan mediante tabcmd

Nota: Estos ajustes se aplican a Tableau Server versión 2022.1 y anteriores. El servicio de búsqueda e índice al que afectan quedó obsoleto a partir de la versión 2022.3 y se retiró (eliminó por completo) en la 2023.3.

Un administrador de servidor puede habilitar opciones que permitan mejorar el rendimiento a la hora de importar archivos CSV de gran tamaño que se pasan mediante comandos tabcmd. Puede hacerlo usando el comando tsm configuration set con las siguientes opciones:

vizportal.csv_user_mgmt.index_site_users
vizportal.csv_user_mgmt.bulk_index_users
searchserver.index.bulk_query_user_groups

Básicamente, estas opciones indexan los usuarios una vez procesado el archivo CSV, en vez de indexarlos uno a uno a medida que se añaden a la base de datos del servidor. De esta manera se reduce el número de llamadas efectuadas a la base de datos, así como la memoria necesaria para procesar el archivo. Estas opciones de tsm configuration set se aplican a los comandos tabcmd createsiteusers, deletesiteusers, addusers y removeusers.

Consulte las descripciones de estas configuraciones en Opciones de tsm configuration set.

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 sitio	Nivel de licencia	Nivel de administrador	Capacidad de publicar
Administrador de servidor Este rol solo es válido si va a importar usuarios mientras se administra el servidor (es decir, que no hayan iniciado sesión en un sitio concreto).	Cualquiera, pero el rol en el sitio de administrador de servidor siempre toma una licencia Creator en caso de estar disponible. Si no hay ninguna licencia Creator disponible, consulte Solucionar problemas relacionados con las licencias para conocer cómo aborda este problema Tableau Server.	Sistema	Verdadero
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 Explorer	Sitio	Verdadero
Creator	Creator	Ninguno	Verdadero
Explorer (puede publicar)	Explorer	Ninguno	Verdadero
Explorer	Explorer	Ninguno	False
Viewer	Viewer	Ninguno	False
Sin licencia	Sin licencia	Ninguno	False

Volver arriba

¡Gracias por sus comentarios!

Sus comentarios se han enviado correctamente. ¡Gracias!

Ayuda de Tableau Server en Windows