Presentación
Al trabajar con cursos ILT (formación guiada por un instructor) y VILT (formación virtual guiada por un instructor), puede importar sesiones y eventos en bloque mediante archivos CSV, con lo cual se agilizará la creación de sesiones y eventos en su plataforma.
Requisitos y limitaciones
- Algunos sistemas externos, como Zoom (se abre en una nueva pestaña) pueden aplicar limitaciones sobre el número de eventos creados en un periodo determinado. Recuerde comprobar si estas limitaciones están vigentes antes de importar.
¿Qué son los archivos CSV (.csv)?
Un archivo de valores separados por comas (CSV) almacena datos tabulares en texto sin formato. Cada línea de un archivo CSV es un registro o una fila de datos. Cada registro/fila consta de campos o columnas separados por un delimitador.
Los archivos CSV se pueden crear con diferentes programas, como por ejemplo Excel, Google Sheets, Notepad, TextEdit o Emacs. El contenido del archivo debe ceñirse al formato CSV estándar y el archivo debe tener la extensión ".csv".
¿Qué formato deben tener por norma general los archivos CSV?
Los archivos CSV deben ceñirse a un formato estándar:
- Los campos/columnas están separados por un solo delimitador de caracteres, normalmente una coma o un punto y coma.
- Cada registro/fila termina cuando se pasa a una nueva línea.
- Todos los registros o filas tienen el mismo número de campos/columnas y el mismo orden.
- El primer registro o la primera fila pueden ser un encabezado que contenga el nombre de campo/columna de cada campo/columna.
- Los datos dentro de cada campo se interpretan como una secuencia de caracteres o de texto sin formato.
- Se puede entrecomillar cualquier campo con comillas dobles.
- Se debe entrecomillar un campo cuando contenga uno o varios caracteres especiales.
- Los espacios del principio y del final se consideran parte de los datos de un campo.
Importación de sesiones mediante CSV
Para importar sesiones en bloque mediante CSV, inicie sesión como Superadministrador en su plataforma. Acceda al Menú de administrador pasando el puntero del ratón por el icono de engranaje de la esquina superior derecha de la página. En la sección E-Learning, pulse el elemento Gestión de cursos.
Cuando esté en la página Gestión de cursos, localice el curso ILT/VILT para el que desee importar sesiones mediante CSV, haga clic en su descripción y, una vez en el área del curso, vaya a la pestaña Sesiones. Desde aquí, haga clic en el botón más y seleccione la opción Nueva sesión a través de CSV.
En el panel Importar sesiones ILT, arrastre y suelte el archivo CSV en la sección de subida o pulse el botón Examinar para localizarlo en su dispositivo.
Para que se suba correctamente, es importante crear un archivo CSV con el formato adecuado. Consulte la siguiente tabla para conocer los valores admitidos para los campos de datos de las sesiones. Para más información, véase Creación y gestión de cursos ILT y VILT.
| Nombre del campo CSV | Descripción |
|---|---|
course_id |
El identificador interno del curso en una base de datos concreta de la plataforma es un valor que determina la plataforma y no se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID o el UUID del curso para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Valores admitidos: |
course_uuid |
El identificador alfanumérico único del curso: la plataforma lo calcula automáticamente cuando se crea el curso. No se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID o el UUID del curso para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Valores admitidos: |
instructors_username |
La lista de instructores de las sesiones, identificados por sus nombres de usuario. Los campos del ID y de los nombres de usuario de los instructores son opcionales y no pueden estar en la misma fila del CSV o se producirá un error de importación. Valores admitidos: Ejemplo: |
instructors_id |
La lista de instructores de las sesiones, identificados por sus ID de usuarios. Los campos del ID y de los nombres de usuario de los instructores son opcionales y no pueden estar en la misma fila del CSV o se producirá un error de importación. Valores admitidos: Ejemplo: |
id_session |
El identificador de sesión interno en una base de datos de la plataforma: lo determina la plataforma y no se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID o el UUID de la sesión para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Valores admitidos: |
session_uuid |
El identificador alfanumérico único de la sesión: la plataforma lo calcula automáticamente cuando se crea el curso. No se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID o el UUID de la sesión para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Este campo distingue entre mayúsculas y minúsculas. Valores admitidos: |
name |
El nombre de la sesión. Valores admitidos: |
code |
El código de la sesión. Valores admitidos: |
description |
La descripción de la sesión. Valores admitidos: |
min_enroll |
El número mínimo de alumnos que deben estar inscritos en la sesión. Valores admitidos: |
max_enroll |
El número máximo de alumnos que pueden estar inscritos en la sesión. Valores admitidos: |
score_base |
La puntuación máxima para la evaluación de la sesión. Debe ser igual o superior a Valores admitidos: |
enrollment_deadline |
La fecha límite para que un alumno se autoinscriba en una sesión. Los campos Fecha límite de autoinscripción y Fecha límite dinámica de autoinscripción no pueden estar en la misma fila del CSV o se producirá un error de importación. Para más información, véase Gestión de autoinscripciones y listas de espera. Formato: Valores admitidos: Ejemplo: |
custom_deadline_days |
El número de días previos a la fecha de inicio de la sesión que tiene el alumno para autoinscribirse en la sesión. La fecha de inicio de la sesión es el primer día del primer evento de la sesión, en orden cronológico. Los campos Fecha límite de autoinscripción y Fecha límite dinámica de autoinscripción no pueden estar en la misma fila del CSV o se producirá un error de importación. Para más información, véase Gestión de autoinscripciones y listas de espera. Valores admitidos: |
evaluation_type |
El tipo de evaluación de la sesión. Estos son los posibles valores:
Valores admitidos: |
min_attended_dates_for_completion |
El número mínimo de eventos a los que los alumnos tienen que asistir en una sesión para marcarla Si no se define este campo, el valor se establecerá en Todos los eventos. Configure el campo Asistencia mínima a eventos con un número superior o igual a Este campo solo se puede usar cuando el tipo de evaluación de la sesión está establecido en Valores admitidos: |
| Indefinido |
Los campos adicionales obligatorios de las sesiones. Si no los rellena, no podrá importar la sesión. Valores admitidos: |
Para ver un ejemplo de CSV correcto, seleccione el elemento Descargue el CSV de ejemplo en el panel deslizante. Recuerde que, aunque las fechas tengan el formato AAAA-MM-DD, su hoja de cálculo puede mostrarlas de otra forma, según el programa que utilice para abrir el CSV de ejemplo.
El tamaño máximo de un archivo CSV que puede importar a su plataforma para cargar usuarios es de 3 MB.
Después de seleccionar el archivo, haga clic en la sección Ajustes avanzados para ver y configurar los ajustes adicionales. El sistema está configurado para detectar automáticamente el separador de campos, que es necesario para organizar la información por columnas. La información se puede organizar, además, mediante una coma, un punto y coma o de forma manual, dependiendo de sus necesidades.
Marque la opción de que la primera fila se considere un encabezado solo si esto se ajusta al formato de su archivo CSV y seleccione el conjunto de caracteres del archivo en el menú desplegable. En cuanto al conjunto de caracteres del archivo, recomendamos UTF-8, que es el estándar. No olvide utilizar comillas para delimitar el contenido de texto. Pulse Confirmar para subir su archivo CSV.
A continuación, el sistema procesará su archivo CSV. Cuando esté listo, se le redirigirá a la página que se utiliza para asignar los campos incluidos en su archivo CSV con los campos disponibles de Docebo.
La sección Vista previa mostrará una vista preliminar del archivo CSV tal y como lo lee el sistema. Arrastre y suelte los campos en la sección Campos Docebo de la izquierda para que coincidan con los nombres de las columnas de su archivo CSV.
Cuando haya hecho coincidir los campos de todas sus columnas, revise la información de la página de importación. Antes de continuar, puede guardar los campos que haya asignado como valores predeterminados para que se use la misma asignación en futuras importaciones de CSV. Para ello, en el área Valor predeterminado del panel izquierdo, haga clic en Guardar este valor predeterminado como nuevo. En el cuadro emergente, introduzca un nombre para el valor predeterminado y, a continuación, pulse Guardar. Si se crea un valor predeterminado, no se puede eliminar; no obstante, puede sobrescribirlo haciendo clic en Sobrescribir el valor predeterminado actual.
Cuando lo tenga todo listo, haga clic en el botón Importar de la parte inferior de la página. El botón Importar solo está habilitado si se asignan campos obligatorios (ID del curso, Nombre de la sesión, Inscripciones máximas, Tipo de evaluación, Puntuación máxima si el tipo de evaluación es Basada en la evaluación). Lea la información del mensaje emergente que aparecerá y, a continuación, pulse Importar sesiones ILT.
La tarea de importación se lleva a cabo en segundo plano. En caso de errores, se proporcionará un archivo de errores para descargar. Para localizar dicho archivo, acceda al Menú de administrador y seleccione el elemento Tareas en segundo plano. Para descargar el archivo, busque la tarea en la lista.
Todas las sesiones que se hayan importado a la plataforma aparecerán en la pestaña Sesiones del curso.
No olvide que los Usuarios avanzados solo pueden importar sesiones para los cursos a los que están asignados.
Importación de eventos mediante CSV
Para importar eventos en bloque a través de CSV, cuando esté en la página Gestión de cursos, localice el curso ILT/VILT para el que desee importar eventos mediante CSV, haga clic en su descripción y, una vez en el área del curso, vaya a la pestaña Sesiones. Una vez en ella, haga clic en el nombre de la sesión y pase a la pestaña Eventos y asistencia. Haga clic en el botón más de la esquina superior derecha y seleccione la opción Nuevo evento a través de CSV.
En el panel Importar eventos ILT, arrastre y suelte el archivo CSV en la sección de subida o pulse el botón Examinar para localizarlo en su dispositivo.
Para que la subida se complete correctamente, es importante crear un archivo CSV con el formato adecuado. En la siguiente tabla tiene los valores válidos para los campos de datos de los eventos. Para más información, véase Creación y gestión de sesiones ILT y VILT.
| Nombre del campo CSV | Descripción |
|---|---|
id_session |
El identificador interno de la sesión en una base de datos concreta de la plataforma: lo determina la plataforma y no se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID de la sesión o el UUID de la sesión para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Valores admitidos: |
session_uuid |
El identificador alfanumérico único de la sesión: la plataforma lo calcula automáticamente cuando se crea el curso. No se puede modificar ni eliminar. Debe incluir en el archivo CSV el ID de la sesión o el UUID de la sesión para que la importación se lleve a cabo correctamente, pero no pueden estar los dos campos en la misma fila del CSV o el procedimiento de importación dará error. Este campo distingue entre mayúsculas y minúsculas. Valores admitidos: |
instructors_username |
La lista de instructores de los eventos, identificados por sus nombres de usuario. Los campos ID del instructor y Nombre de usuario del instructor son opcionales y no pueden estar en la misma fila del CSV o se producirá un error de importación. Este campo distingue entre mayúsculas y minúsculas. Valores admitidos: |
instructors_id |
La lista de instructores de los eventos, identificados por su ID de usuario. Los campos ID del instructor y Nombre de usuario del instructor son opcionales y no pueden estar en la misma fila del CSV o se producirá un error de importación. Valores admitidos: Ejemplo: |
event_id |
El identificador único del evento: la plataforma lo calcula automáticamente cuando se crea el curso. No se puede modificar ni eliminar. Si se configura este campo, el proceso de importación actualizará el evento con los datos del CSV. Valores admitidos: |
name |
El nombre del evento. Valores admitidos: |
description |
Texto que describe el evento en cuestión. Valores admitidos: |
day |
La fecha en que tiene lugar el evento. Formato: Valores admitidos: Ejemplo: |
time_begin |
La hora a la que comienza el evento. Formato: Valores admitidos: Ejemplo: |
time_end |
La hora a la que termina el evento. Formato:
Valores admitidos: Ejemplo: |
break_begin |
La hora a la que comienza el descanso. Los descansos son opcionales, pero en caso de que se utilicen, se deben definir los campos Hora de inicio del descanso y Hora de finalización del descanso. La hora de inicio del descanso debe ser posterior a la hora de inicio del evento y anterior a la hora de finalización del descanso. Formato: Valores admitidos: Ejemplo: |
break_end |
La hora a la que finaliza el descanso. Los descansos son opcionales, pero en caso de que se utilicen, se deben definir los campos Hora de inicio del descanso y Hora de finalización del descanso. La hora de finalización del descanso debe ser posterior a la hora de inicio del descanso y anterior a la hora de finalización del evento. Formato: Valores admitidos: Ejemplo: |
timezone |
Este campo debe coincidir con el formato de nombre de la zona horaria (sin GMT + XX:XX) de la plataforma. Ejemplo: El formato de zona horaria para Jerusalén sería Este campo distingue entre mayúsculas y minúsculas. Para más información, consulte Gestión de la zona horaria de su plataforma. Valores admitidos: |
id_classroom |
El identificador del aula: lo determina la plataforma y no se puede modificar ni eliminar. Este campo es opcional y puede definirse al establecer el ID de la ubicación. Para más información, consulte Gestión de ubicaciones y aulas para cursos ILT en aulas. Valores admitidos: |
id_location |
El identificador de la ubicación: lo determina la plataforma y no se puede modificar ni eliminar. Todos los eventos deben tener un ID de ubicación, una herramienta de videoconferencia o ambos. Para más información, consulte Gestión de ubicaciones y aulas para cursos ILT en aulas. Valores admitidos: |
collaboration_tool |
Texto opcional para especificar una herramienta de colaboración externa mediante la que los alumnos pueden contactar e interactuar respecto al tema del curso. Valores admitidos: |
webinar_tool |
Utilice este campo para establecer la herramienta de videoconferencia del evento VILT. Estos son los valores admitidos:
Si no utiliza una de las herramientas para seminarios web admitidas, establezca este valor como Valores admitidos: |
id_tool_account |
El identificador interno de la cuenta del seminario web: lo determina la plataforma y no se puede editar ni eliminar. Se convierte en un campo obligatorio si el campo Herramienta de videoconferencia tiene un valor y no está establecido como Valores admitidos: |
password |
La contraseña para acceder al seminario web. Se convierte en un campo obligatorio si está activada la opción Herramienta de videoconferencia y no está establecida como Si no se especifica, el sistema generará automáticamente una contraseña para el evento VILT. Valores admitidos: A tener en cuenta: Si esta fila se está utilizando para importar un evento de Zoom V3, el valor del campo de la contraseña deberá cumplir con los requisitos de contraseña de Zoom. Para más información, consulte Docebo VILT para Zoom, version 3. |
custom_url |
Este campo es obligatorio si está activada la opción Herramienta de videoconferencia y no está establecida como Valores admitidos: |
allow_recording_completion |
Si está establecido como Este campo es obligatorio si se ha especificado una herramienta de videoconferencia. Valores admitidos: Ejemplo: ( |
allow_join_completion |
Si está establecido como Este campo es obligatorio si se ha especificado una herramienta de videoconferencia. Valores admitidos: Ejemplo: ( |
join_in_advance_time_user |
Especifica la cantidad de tiempo antes de la hora de inicio programada en que un alumno puede unirse a una videoconferencia. Este campo es opcional y puede utilizarse solo si se ha especificado una herramienta de videoconferencia y configurando las Opciones del botón "Unirse" para alumnos e instructores. El tiempo de unión anticipada para los alumnos no puede ser anterior al valor Tiempo de unión anticipada para el instructor. Por ejemplo: Un valor de Formato: Valores admitidos: Ejemplo: Un valor de |
join_in_advance_time_teacher |
Especifica la cantidad de tiempo antes de la hora de inicio programada en que un instructor puede unirse a una videoconferencia. Este campo es opcional y puede utilizarse solo si se ha especificado una herramienta de videoconferencia y configurando las Opciones del botón "Unirse" para alumnos e instructores. El tiempo de unión anticipada para el instructor no puede ser posterior al valor Tiempo de unión anticipada para los alumnos. Por ejemplo: Un valor de Formato: Valores admitidos: Ejemplo: Un valor de |
xapi_oauth_account |
La cuenta OAuth de xAPI (TinCan). Para más información acerca de xAPI, véase Subida de contenido xAPI (anteriormente Tin Can API). Valores admitidos: |
xapi_url |
La URL xAPI (Tin Can) de contenido externo. Más información acerca de la Subida de contenido xAPI (anteriormente Tin Can API). Valores admitidos: |
required_completion_percentage |
Este campo es opcional y solo se puede usar cuando la herramienta de videoconferencia está establecida como Más información acerca de Docebo para la versión 2 de Adobe Connect. Valores admitidos: |
adobe_connect_v2_template |
Este campo representa el SCO-ID de la plantilla de la cuenta de Adobe Connect V2. Es opcional y puede establecerse como una cadena vacía. Más información acerca de Docebo para la versión 2 de Adobe Connect. Valores admitidos: |
adobe_connect_v2_folder |
Este campo representa el SCO-ID de la carpeta de la cuenta de Adobe Connect V2. Es opcional y puede establecerse como una cadena vacía. Más información acerca de Docebo para la versión 2 de Adobe Connect. Valores admitidos: |
adobe_connect_v2_room |
Este campo representa el Es opcional y puede establecerse como una cadena vacía, pero se convierte en obligatorio si se usa Valores admitidos: |
zoom_v3_account_id |
Este campo representa el ID de la cuenta de la versión 3 de Zoom asociado a la integración. Más información acerca de Docebo VILT para la versión 3 de Zoom. Valores admitidos: |
zoom_v3_host |
Este campo representa al anfitrión de Zoom V3. Acepta el ID del usuario anfitrión como valor. Más información acerca de Docebo VILT para la versión 3 de Zoom. Valores admitidos: |
zoom_v3_settings_template |
El ID asociado a la plantilla de Zoom. Más información acerca de Docebo VILT para la versión 3 de Zoom. Valores admitidos: |
zoom_v3_percentage |
El porcentaje de tiempo que el alumno necesita pasar en el evento de Zoom para que se le marque como presente en el evento. Este puede ser un valor del Más información acerca de Docebo VILT para la versión 3 de Zoom. Valores admitidos: |
zoom_v3_registration_enabled |
Habilita el registro obligatorio para todos los usuarios. Estableciéndose como Debe establecerse como
A tener en cuenta: Docebo solo puede registrar los progresos y la asistencia de un alumno si este tiene la sesión iniciada en Zoom mientras asiste a una reunión. Si un alumno no tiene la sesión iniciada en Zoom, establecer este valor como
Un valor vacío indica Más información acerca de Docebo VILT para la versión 3 de Zoom. Valores admitidos: Ejemplo: ( |
zoom_v3_alternative_hosts |
La lista de anfitriones de Zoom alternativos del evento, identificados por su ID de usuario. Este campo es opcional. Valores admitidos: Ejemplo: |
Para ver un ejemplo de cómo hacerlo, seleccione el elemento Descargue el CSV de ejemplo del panel deslizante. Recuerde que, aunque las fechas tengan el formato AAAA-MM-DD, su hoja de cálculo puede mostrarlas de otra forma, según el programa que utilice para abrir el CSV de ejemplo.
El tamaño máximo de un archivo CSV que puede importar a su plataforma para cargar usuarios es de 3 MB.
Después de seleccionar el archivo, haga clic en la sección Ajustes avanzados para ver y configurar los ajustes adicionales. El sistema está configurado para detectar automáticamente el separador de campos, que es necesario para organizar la información por columnas. La información se puede organizar, además, mediante una coma, un punto y coma o de forma manual, dependiendo de sus necesidades.
Marque la opción de que la primera fila se considere un encabezado solo si esto se ajusta al formato de su archivo CSV y seleccione el conjunto de caracteres del archivo en el menú desplegable. En cuanto al conjunto de caracteres del archivo, recomendamos UTF-8, que es el estándar. No olvide utilizar comillas para delimitar el contenido de texto. Pulse Confirmar para subir su archivo CSV.
A continuación, el sistema procesará su archivo CSV. Cuando esté listo, se le redirigirá a la página que se utiliza para asignar los campos incluidos en su archivo CSV con los campos disponibles de Docebo.
La sección Vista previa mostrará una vista preliminar del archivo CSV tal y como lo lee el sistema. Arrastre y suelte los campos en la sección Campos Docebo de la izquierda para que coincidan con los nombres de las columnas de su archivo CSV.
Cuando haya hecho coincidir los campos de todas sus columnas, revise la información de la página de importación. Antes de continuar, puede guardar los campos que haya asignado como valores predeterminados para que se use la misma asignación en futuras importaciones de CSV. Para ello, en el área Valor predeterminado del panel izquierdo, haga clic en Guardar este valor predeterminado como nuevo. En el cuadro emergente, introduzca un nombre para el valor predeterminado y, a continuación, pulse Guardar. Si se crea un valor preestablecido, no se puede eliminar; no obstante, puede sobrescribirlo haciendo clic en Sobrescribir valor predeterminado actual.
Cuando lo tenga todo listo, haga clic en el botón Importar de la parte inferior de la página. El botón Importar solo estará habilitado si se asignan los campos obligatorios (ID de sesión, Fecha, Nombre, Día, Hora de inicio, Hora de finalización, Zona horaria y los campos obligatorios del evento). Lea la información del mensaje emergente que aparecerá y, a continuación, pulse Importar eventos ILT.
El proceso de importación se lleva a cabo en segundo plano. Si se produjera algún error, puede descargar un archivo de error. Para localizar dicho archivo, acceda al Menú de administrador y, a continuación, seleccione el elemento Tareas en segundo plano. Para descargar el archivo, busque la tarea en la lista.
Todos los eventos que se hayan importado a la plataforma aparecerán en la pestaña Eventos y asistencia de la sesión del curso.
No olvide que los Usuarios avanzados solo pueden importar eventos para los cursos a los que están asignados.