Pautas de archivos de importación CSV
Puede automatizar la adición de usuarios 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.
Para importar usuarios puede usar la página de administración del sitio o la utilidad tabcmd
. El uso de tabcmd
ofrece una opción para asignar un rol en el sitio a todos los usuarios del archivo CSV. Para obtener más información, consulte Importar usuarios o createsiteusers filename.csv.
Requisitos del formato de archivo CSV
Al crear el archivo CSV para importar usuarios, asegúrese de que cumpla los requisitos de formato siguientes:
El archivo no incluye encabezados de columna. Tableau Cloud presupone que cada una de las líneas del archivo representa a un usuario.
El archivo está en formato UTF-8 e incluye la marca de orden de bytes (BOM).
Las codificaciones de caracteres, como BIG-5, se han convertido a UTF-8. Esto se hace abriendo el archivo en un editor de texto y usando el comando Guardar como.
Si un nombre de usuario incluye el carácter @ y este no representa un separador de dominio, deberá hacer referencia al símbolo con el formato hexadecimal:
\0x40
Así,
user@fremont@mycompany.com
seráuser\0x40fremont@mycompany.com
Columnas requeridas en el archivo CSV
Los siguientes campos se requieren para cada usuario:
Nombre de usuario: la dirección de correo electrónico del usuario.
Contraseña. Tableau Cloud no utiliza este campo, pero tiene que delimitarlo en cada fila para que los campos siguientes se coloquen correctamente.
Opciones adicionales de columna CSV
Para cada usuario, el archivo CSV puede contener los siguientes campos además de las columnas obligatorias. Es necesario incluir en el archivo todos los campos que se enumeran a continuación aunque, como se indica en la descripción, Tableau Cloud no los utiliza todos.
URI del sitio (solo Tableau Cloud Manager): el identificador uniforme de recursos para el sitio. Para importar un usuario como administrador de la nube, incluya la columna URI del sitio pero déjela en blanco.
Nombre de visualización. Tableau Cloud no utiliza este campo, pero tiene que delimitarlo en cada fila para que los campos siguientes se coloquen correctamente.
Nivel de licencia. Este nivel puede ser Creador, Explorador, Observador o Sin licencia.
Nivel de administrador: el valor puede ser Cloud, Site o Ninguno. Cloud = Administrador de la nube, Site = Administrador del sitio y None = No es administrador.
Nota: El valor del administrador de la nube solo está disponible al importar usuarios a Tableau Cloud Manager. No está diseñado para usarse con sitios de Tableau Cloud. Para obtener más información, consulte Administrar usuarios con Tableau Cloud Manager.
Capacidad de publicar. Los valores válidos son Yes/True/1 o No/False/0. Si el nivel de licencia es Creator, la capacidad de publicación debe ser Yes/True/1.
Tipo de autenticación (solo Tableau Cloud Manager): el tipo de autenticación del usuario para acceder a un sitio o a Tableau Cloud Manager.
Entradas de muestra de archivo .csv
Sitio de Tableau Cloud
En el siguiente ejemplo se muestra un usuario con el rol en el sitio Explorer 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
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
Tableau Cloud Manager
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.
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
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.
,cloudadminuser@domain.com,,,,Cloud,,Salesforce
Notas
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.).
Tableau Cloud no usa los campos de contraseña (segundo valor) y nombre de visualización (tercer valor). Se ignoran los valores que especifique para estos campos.
Sin embargo, si quiere establecer la licencia y el acceso de publicación para los usuarios, el archivo aún necesita incluir delimitadores para estos campos, tal y como se muestra en el ejemplo anterior.
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 los usuarios ya tienen una cuenta de Tableau (por ejemplo, para los foros de la comunidad de Tableau), ya disponen de una contraseña.
El archivo CSV no incluye un campo para establecer el tipo de autenticación (Tableau, Google o SAML). Esto se especifica en Tableau Cloud al importar el archivo. Esta configuración se aplica a todos los usuarios importados, pero puede cambiar el tipo de autenticación para usuarios individuales más adelante.
Nota: también puede utilizar
tabcmd
para importar usuarios y establecer el tipo de autenticación y el rol en el sitio que se aplica a todos los usuarios del archivo .csv. Para obtener información, consulte createsiteusers filename.csv.
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. La tabla siguiente muestra la conversión de las configuraciones en roles de sitio.
Configuración de CSV | Rol de sitio |
---|---|
Nivel de licencia=Sin licencia Administrator=Cloud Publicador=false | Administrador de la nube. Esta configuración solo es válida si va a importar usuarios mientras tengan las sesiones de Tableau Cloud Manager iniciadas (es decir, que hayan iniciado sesión en un sitio concreto). |
Nivel de licencia=Creator o Explorer Administrador=Site Publicador=true | Administrador de sitio Creator o Administrador de sitio Explorer. Esta configuración solo es válida si va a importar usuarios mientras ha iniciado sesión en un sitio concreto. |
Nivel de licencia=Creator Administrador=None Publicador=true | Creator |
Nivel de licencia=Explorer Administrador=None Publicador=true | Explorer (puede publicar) |
Nivel de licencia=Explorer Administrador=None Publicador=false | Explorer |
Nivel de licencia=Viewer (Observador) Administrador=None Publicador=false | Viewer |
Nivel de licencia=Sin licencia Administrador=None Publicador=false | Sin licencia |