Importar usuarios

Importa usuarios de forma masiva desde un archivo CSV cuando necesites añadir o actualizar más de unos pocos a la vez. Cada usuario importado lleva la etiqueta de origen csv, y volver a subir un archivo actualizado los mantiene sincronizados. La importación CSV funciona bien para cargas iniciales y actualizaciones puntuales. Si tu sistema de RR. HH. es la fuente de verdad continua, usa en su lugar la sincronización con RR. HH.. También puedes incluir como columnas del archivo los atributos personalizados que hayas definido. En Directory → Users, selecciona la flecha junto a + User y, después, elige Import via CSV.

​

Requisitos del archivo

​

Columnas

El cuadro de diálogo de importación muestra todas las columnas que puede incluir tu archivo: columnas principales obligatorias, columnas principales opcionales y cualquier columna de atributo personalizado de tu esquema. Usa el ejemplo de Download sample.csv como plantilla de encabezado. Cuando los nombres de tus columnas coinciden con el ejemplo, los valores de cada fila rellenan los campos de perfil correspondientes del usuario identificado por externalId.

​

Obligatorias

Cada fila debe incluir un valor no vacío para cada una de estas columnas.

​

Opcionales

Deja una celda vacía, u omite la columna por completo, cuando no se necesite un valor. Si domain está vacío, Iru lo obtiene de la dirección de correo electrónico.

​

Atributos personalizados

Después de definir atributos personalizados en tu esquema, el cuadro de diálogo de importación los muestra en Custom attribute columns, con el nombre categorySlug.attributeSlug formado a partir del slug de la categoría y el slug del atributo. Por ejemplo, department y title en una categoría cuyo slug es extrainfo aparecen como extrainfo.department y extrainfo.title. Añade una columna por atributo al encabezado de tu CSV. Los nombres de las columnas principales deben coincidir exactamente; los nombres de las columnas de atributos personalizados ignoran las mayúsculas y los espacios.

​

Archivo de ejemplo

En el cuadro de diálogo de importación, selecciona Download sample.csv para obtener un archivo inicial con todas las columnas principales y un usuario de ejemplo. Si tu esquema incluye atributos personalizados, selecciona la flecha junto a Download sample.csv y, después, elige With custom attributes. Ese ejemplo añade una columna por cada atributo personalizado de tu esquema y deja esas celdas vacías en la fila de ejemplo para que puedas rellenarlas. Las columnas principales y el usuario de ejemplo no cambian. Sustituye el usuario de ejemplo por tus propias filas y mantén los nombres de encabezado sin cambios.

Mostrar Variaciones de columnas opcionales

No necesitas todas las columnas opcionales en cada fila. Una fila puede incluir solo las columnas obligatorias, una dirección parcial o un número de teléfono con o sin código de país. Deja domain vacío cuando deba coincidir con la dirección de correo electrónico, y deja vacías las celdas de atributos personalizados cuando no tengas un valor para un usuario.

​

Comportamiento de los campos

​

Obtención del dominio

• Si domain está vacío, Iru lo toma de la dirección de correo electrónico (jane.doe@example.com se convierte en example.com).
• Si se proporciona domain, ese valor se usa tal cual.
• Un dominio que todavía no existe se crea automáticamente.

​

Números de teléfono

Los valores de teléfono se normalizan a E.164 (un + inicial, el código de país y, después, los dígitos, sin espacios ni signos de puntuación), de la misma forma en que se almacenan los números de teléfono en el resto de Iru Identity.

​

Direcciones

Iru almacena una dirección siempre que cualquier columna de dirección tenga un valor. Una dirección parcial (solo locality y country, por ejemplo) es válida; las partes que faltan quedan vacías. Si todas las columnas de dirección están vacías, no se almacena ninguna dirección.

​

Ejecutar la importación

El cuadro de diálogo Import users via CSV muestra las columnas principales obligatorias y opcionales, cualquier columna de atributo personalizado de tu esquema y Download sample.csv con una flecha para With custom attributes. Arrastra un archivo al área de subida o examina para seleccionar uno. Después de subirlo, Iru valida el archivo completo. Si la validación falla, no se importa nada. Corrige los problemas indicados y vuelve a subirlo. Cuando la validación es correcta, las filas se aceptan y se preparan, y los usuarios se crean o actualizan en segundo plano. Comprueba la importación en tu historial para confirmar cada fila. Una fila todavía puede fallar en el momento de aplicarse después de que se acepte el archivo; corrige esas filas y vuelve a importarlas. Consulta Validación y errores para conocer las dos etapas de comprobación.

​

Crear frente a actualizar: volver a subir

Los usuarios se hacen coincidir por externalId dentro del origen csv:

• Un externalId nuevo crea un usuario nuevo con el rol end-user.
• Un externalId existente actualiza el perfil de ese usuario a partir de la fila. El rol y la pertenencia a grupos no cambian.

Vuelve a subir un CSV corregido o ampliado en cualquier momento para mantener sincronizados los usuarios importados. Cada externalId de un archivo debe ser único.

​

Validación y errores

La validación se realiza en dos etapas. Hasta que el archivo se acepta por completo, no se importa nada.

​

Cuándo usar en su lugar la sincronización con RR. HH.

Vuelve a subir un CSV siempre que tu lista cambie e Iru volverá a comprobar cada fila. Para un aprovisionamiento continuo y sin intervención, conecta en su lugar tu sistema de RR. HH. como registro de referencia.

​

Próximos pasos