Para garantizar una correcta importación de la lista de participantes en la plataforma Cyber Guru, es importante seguir las instrucciones indicadas en el artículo señalado.
La lista debe incluir a todos los participantes en el programa formativo y debe proporcionarse en un archivo CSV con codificación UTF-8.
SE ADJUNTA UN EJEMPLO DE LISTA DE USUARIOS
Campos obligatorios para cada usuario
Para cada usuario es necesario incluir los siguientes campos:
Nombre: el nombre del usuario.
Apellido: el apellido del usuario.
Email: la dirección de correo electrónico del usuario, utilizada para recibir comunicaciones de la plataforma y, si corresponde, simulaciones de phishing. El email también puede usarse como credencial de acceso.
Idioma: el idioma preferido del usuario para el acceso a los contenidos formativos, que debe indicarse en formato ISO 639-1 de dos letras minúsculas (ej. italiano →
it).-
Username*: identificador único e inmodificable del usuario (ej. número de empleado o SID). Debe contener entre 3 y 255 caracteres. En caso de SSO, debe coincidir con el valor mapeado como username (ej.
objectID).El username puede contener:
- letras
- números
- caracteres especiales permitidos:
- guion bajo (
_) - guion (
-) - punto (
.) - arroba (
@)
- guion bajo (
Se trata de un subconjunto de los caracteres permitidos en una dirección de correo electrónico: por ejemplo, la comilla simple (
') es válida en un email, pero no está permitida en el username.Nota importante El username es un campo no modificable. Una vez creado el usuario, el username no se puede editar. En caso de error o necesidad de modificar el username, será necesario eliminar el usuario existente y crearlo de nuevo. Se recomienda revisar cuidadosamente el username antes de crear el usuario, ya que cualquier corrección implicará la recreación completa de la cuenta, con posible impacto en el historial del usuario.
Country: el país donde se encuentra el usuario, expresado según el estándar ISO 3166-1 alpha-2 de dos letras mayúsculas (ej. Italia →
IT).Authmode: en caso de SSO híbrido, especifica el modo de acceso:
0para acceso con credenciales,1para acceso por SSO.Rol: el rol asignado al usuario dentro de la plataforma (ver "Rol en la plataforma")
Información Adicional del Usuario (llamada "Organization")
Para cada usuario es posible incluir información adicional, como por ejemplo:
Departamento al que pertenece
Rango de edad
Área geográfica
Función organizativa
Rol empresarial
Estos datos opcionales pueden ser mapeados dentro de la plataforma como “Nueva Organization”.
Para que la importación sea exitosa, la columna que define una nueva organization debe contener solo caracteres alfanuméricos. El único carácter especial permitido es el guion bajo (_)
Rol en la plataforma
Para cada usuario es necesario especificar el rol que tendrá dentro de la plataforma.
El campo debe indicarse como
rolespara permitir el mapeo automático.Si no se especifica el rol, el usuario será importado por defecto como “studente”.
Roles disponibles
studente: perfil individual con visibilidad exclusiva sobre su propio recorrido formativo.
teamleader: activable en caso de gamificación por equipos, identifica al responsable del equipo, encargado de motivar y monitorear el desempeño. Tiene acceso a la vista de su propio equipo.
supervisor: puede acceder a los reportes sobre el progreso de los cursos para toda la población de la empresa, tanto a nivel agregado como detallado.
- company admin : está reservado para el referente de la empresa, quien puede gestionar de forma autónoma la lista de usuarios, organizar campañas de simulación y configurar las opciones a nivel empresarial
Asignación de roles múltiples
Es posible asignar varios roles a un mismo usuario. Para hacerlo:
incluir varias columnas en el archivo CSV,
mapear cada columna al campo rol durante la importación.
Formato correcto de los roles (distingue mayúsculas y minúsculas)
Los roles deben aparecer en el archivo CSV UTF-8 exactamente como sigue:
studenteteamleadersupervisor
⚠️ Todos los demás roles (ej. company admin) no pueden ser importados mediante CSV, sino que deben ser asignados manualmente. En caso de roles con privilegios especiales, es necesario contactar con el soporte de Cyber Guru.
Equipos y gamificación por equipos
Si el cliente decide activar la gamificación por equipos, es necesario definir con precisión qué valor se utilizará para identificar los equipos y asegurarse de que dicha información esté incluida en el archivo CSV. El equipo puede definirse a partir de un campo ya existente, como por ejemplo el Department, o crearse específicamente, incluso con un nombre inventado. En cualquier caso, el equipo se mapea como Nueva Organization, pero al cargarlo en la plataforma debe indicarse claramente el criterio utilizado para definir la composición de los equipos.
Las clasificaciones por equipos se calculan relacionando la suma de los puntos de todos los miembros con el número total de integrantes, de modo que cada equipo, independientemente de su tamaño, pueda competir en igualdad de condiciones con los demás. Además, se prevé que un usuario pueda cambiar de equipo durante el programa formativo, por ejemplo, tras una reorganización empresarial; en este caso, su rendimiento acumulado hasta ese momento se transfiere al nuevo equipo al que pertenezca.
Controles previos a la importación en la plataforma
Antes de enviar la lista de usuarios, se recomienda realizar las siguientes comprobaciones:
- Verificar que todos los correos electrónicos sean válidos y estén correctamente formateados.
- Comprobar que no haya espacios en las columnas de email y username.
- Asegurarse de que no haya duplicados en los emails o usernames.
- Revisar que todos los campos obligatorios estén presentes para cada usuario.
- Verificar que el archivo esté guardado en formato CSV UTF-8.
Siguiendo estas indicaciones, podrán garantizar una correcta importación de la lista de usuarios en la plataforma, facilitando la gestión de su programa formativo.