En este tema, se explican las convenciones y los requisitos para los formatos de archivo D2L Standard CSV.
Formatos aceptados para archivos D2L Standard CSV
Los formatos de archivo aceptados por CSV estándar de D2L son los siguientes:
- Organizaciones
- Usuarios
- Inscripciones
- Atributos del panel del administrador y de los grupos de aprendizaje
- Manifesto (se exige cuando se utiliza la versión 1.1 o superior de D2L Standard CSV)
Formato de archivo ZIP para archivos D2L Standard CSV
Los archivos CSV deben combinarse en un archivo zip. La convención de nomenclatura recomendada para un archivo zip es la siguiente:
- D2LStdCSV-{YYYYmmddHHMMSS}.zip
|
Nota: Solo puede cargar archivos .zip (que distinguen mayúsculas de minúsculas, solo minúsculas) a SFTP. |
Los archivos se procesan en orden alfabético. D2L recomienda que los archivos individuales en el archivo se ordenen de la siguiente manera:
- organizaciones
- usuarios
- inscripciones
- atributos
Las convenciones de nomenclatura recomendadas para archivos D2L Standard CSV
La convención de nomenclatura recomendada para archivos individuales dentro un archivo .zip es la siguiente:
- 01 - Otro- {YYYYmmddHHMMSS}.csv
- 02 - Departamentos - {YYYYmmddHHMMSS}.csv
- 03 - Semestres - {YYYYmmddHHMMSS}.csv
- 04 - Plantillas - {YYYYmmddHHMMSS}.csv
- 05 - Ofertas - {YYYYmmddHHMMSS}.csv
- 06 - Secciones - {YYYYmmddHHMMSS}.csv
- 07 - Usuarios - {YYYYmmddHHMMSS}.csv
- 08 - Inscripciones - {YYYYmmddHHMMSS}.csv
- 09 - Atributos - {YYYYmmddHHMMSS}.csv
- manifest.json
|
Nota: El archivo CSV 01 - Otro se utiliza para procesar unidades de organización personalizadas fuera de la estructura de organización de D2L estándar y requiere la versión 2.0 o posterior de D2L Standard CSV. |
Reglas de contenido de archivos CSV comunes
- Los valores de los archivos distinguen mayúsculas y minúsculas.
- Un valor vacío se representa con dos comas, sin espacios entre ellas. Por ejemplo:
- ,, indica un valor en blanco
- , , indica un carácter de espacio, que se analiza como un valor no válido.
-
Los archivos CSV deben tener un encabezado (primera línea) que sea una coincidencia exacta (uso de mayúsculas y comas).
- Los archivos CSV deben estar codificados en UTF-8.
- Los archivos CSV deben contener datos SIS diferenciales (deltas) en lugar de almacenamientos de datos SIS completas.
-
El envío de una acción ACTUALIZAR cuando el objeto no existe da como resultado una solicitud CREAR. El comportamiento común es utilizar solo las acciones ACTUALIZAR y ELIMINAR.
- Los archivos CSV y el manifiesto deben estar en un archivo ZIP.
- Se exige un manifiesto cuando se utiliza la versión 1.1 o superior de CSV estándar de D2L. El manifiesto es un archivo JSON en el que se anuncia la versión de CSV estándar de D2L que está usando. Para obtener más información, consulte el tema Manifesto.
-
Como práctica recomendada, no incluya ningún tipo de información de identificación personal (PII), como los números de seguro social, en las ID definidas por organización de los usuarios.
Reglas para las unidades de organización
Los tipos de unidades de organización que se enumeran a continuación son compatibles con D2L Standard CSV:
- Otras unidades de organización (las unidades de organización personalizadas fuera de la estructura de organización de D2L estándar se admiten en D2L Standard CSV versión 2.0 o superior).
- Departamentos
- Semestres
- Plantillas de curso
- Ofertas de cursos
- Secciones
El procesamiento de estas unidades de organización crea la estructura de organización en la instancia de Brightspace.
Reglas:
- Brightspace puede aceptar tantas unidades de organización como sea necesario.
- Las organizaciones se deben enviar al menos una vez para indicar al D2L Standard CSV qué unidades de organización puede controlar. Una vez que la integración controle una unidad de organización, todos los cambios futuros a aquella unidad de organización se deben realizar solo a través de la integración de D2L Standard CSV para garantizar la propiedad precisa de los datos.
- Si se realiza un envío de muchos tipos de unidad de organización en un archivo CSV, asegúrese de que se respete la jerarquía en él (por ejemplo, los departamentos deben enviarse antes de las plantillas de curso). Si no envía una unidad de organización principal antes de la creación de una secundaria, la unidad de organización secundaria fallará.
- Si desea enviar relaciones de usuario, compruebe que en el archivo se respete la jerarquía de auditores, padres o tutores (por ejemplo, se deben enviar los padres o tutores antes que los estudiantes). De lo contrario, la relación falla.
- La convención de nomenclatura para el nombre y el código de la unidad de organización debe seguir lo descrito en su SIS.
- Los nombres y los códigos de las unidades de organización se deben proporcionar a través de los archivos CSV si respetan los requisitos de caracteres prohibidos de Brightspace y son únicos en todas las unidades de organización.
- Los códigos de unidad de organización se limitan a 50 caracteres. Si son más largos, el código de unidad de organización se trunca automáticamente a 50 y podría dar lugar a la duplicación de códigos de unidad de organización en Brightspace o a la imposibilidad de crear una unidad de organización.
- Los códigos de unidad de organización no admiten los caracteres siguientes: , : % & # * ? < > | \ " ' y espacios iniciales o finales.
D2L Standard CSV puede hacer lo siguiente:
- Crear una nueva unidad de organización, si no existe.
- Asignar a una unidad de organización existente si fue creada por una fuente distinta de D2L Standard CSV y la opción para asignar está a esta existente seleccionada en la configuración.
- Actualizar el nombre de la unidad de organización que controla.
- Asignar y eliminar unidades de organización personalizadas como principales de otras unidades de organización personalizadas, departamentos, semestres, plantillas de curso, ofertas de cursos y secciones de cursos (aplicable a D2L Standard CSV versión 2.0 o superior).
- Plantilla de curso: asignar y actualizar el departamento principal según el código del departamento.
- Oferta de cursos: asignar o actualizar la plantilla de curso principal y el semestre según el código principal.
- Oferta de cursos: actualizar todos los detalles de los cursos, incluidos el nombre de las ofertas de cursos y las fechas. Desactivar las ofertas de curso.
- Sección de cursos: cuando se elimina una sección de cursos, la inscripción de los usuarios en dicha sección se anula de manera automática.
- Eliminar una unidad de organización que controla.
D2L Standard CSV no puede hacer lo siguiente:
- Actualizar los códigos de la unidad de organización.
- Eliminar manualmente las unidades de organización creadas, a menos que se asignaran a CSV estándar de D2L.
- Eliminar una unidad de organización con elementos secundarios vinculados a ella (se deben eliminar estos primero). Una excepción se produce si las secciones están configuradas para su eliminación en la interfaz: se pueden eliminar las ofertas de cursos si hay una sección vinculada a esta.
Reglas para los usuarios
Los registros de usuario pueden crear, actualizar, desactivar o eliminar usuarios en Brightspace. El tipo de registro de usuario también puede crear, actualizar o eliminar las relaciones padre-hijo en Brightspace.
Reglas
- Se deben enviar los usuarios al menos una vez para indicar a la integración cuáles puede crear, actualizar o eliminar y cuáles inscripciones puede administrar.
- El nombre y el apellido no admiten los siguientes caracteres: \ / : * ? " < > | @ , ;
- El nombre de usuario y la ID definida por organización no admiten los siguientes caracteres: / : * ? " < > | ' , ;
- La dirección de correo electrónico no admite los siguientes caracteres: ( ) < > [ ] | \ ; : , “
D2L Standard CSV puede hacer lo siguiente:
- Crear un nuevo usuario e inscribirlo en la organización.
- Asignar un usuario a un usuario existente con la misma ID definida por organización o nombre de usuario.
- Actualizar el nombre de usuario, el nombre, el apellido, la contraseña y el correo electrónico.
- Actualizar el nombre preferido y el apellido preferido (D2L Standard CSV versión 2.0 o superior).
- Actualizar el apellido clasificable (D2L Standard CSV versión 2.1 o superior).
- Actualizar los pronombres (D2L Standard CSV versión 3.0 o superior).
- No es obligatoria la contraseña y se recomienda no enviarla si se utiliza el inicio de sesión único (SSO).
- Actualizar el rol a nivel de organización.
- Activar, desactivar o eliminar un usuario.
- Crear, actualizar o eliminar relaciones padre/tutor-hijo de Brightspace para padres y tutores (D2L Standard CSV versión 1.1 o superior).
- Actualizar una relación auditor-auditado (D2L Standard CSV versión 2.0 o superior).
D2L Standard CSV no realiza lo siguiente:
- Actualizar la ID definida por organización; sin embargo, esto se puede realizar manualmente en la interfaz de Administración de IPSIS.
- Eliminar los usuarios creados manualmente, a menos que se asignaran a D2L Standard CSV.
|
Nota: Para usuarios en países como los Países Bajos, Bélgica y Sri Lanka, algunos apellidos (como Van der Speigle o Van Gogh) tienen uno o más prefijos (conocidos en holandés como Tussenvoegsel) que forman parte del apellido formal. En algunos casos, el apellido clasificable no debe incluir esos prefijos. Los administradores pueden indicar si el apellido legal de un usuario difiere del apellido clasificable. Si los clientes incluyen un apellido clasificable, Brightspace utiliza el apellido clasificable cuando se alfabetizan las listas de usuarios. Apellido clasificable está disponible en D2L Standard CSV versión 2.1 o superior. |
Reglas para inscripciones
El procesamiento de los registros de inscripción inscribe o anula la inscripción de usuarios en una unidad de organización específica en Brightspace.
Reglas:
Los registros de inscripción deben enviarse cuando se realicen cambios en el sistema de información.
- La anulación de inscripción debe enviarse solo una vez. El reenvío de la misma anulación de inscripción genera una advertencia en el registro de IPSIS.
- Cuando utilice secciones en ofertas de cursos, proporcione registros de inscripción solo para las secciones. La inscripción a la oferta de cursos es implícita y es gestionada por IPSIS.
- El envío de registros de inscripción para ambas ofertas de cursos y secciones, pero el envío de las anulaciones de inscripción para solo secciones puede provocar que los usuarios se vuelvan a inscribir incorrectamente en las ofertas de cursos durante la fusión de cursos.
D2L Standard CSV puede hacer lo siguiente:
- Inscribir y anular la inscripción de usuarios en unidades de organización (versión 2.0 o superior), ofertas de cursos y secciones.
- Inscribir y anular la inscripción de secciones del curso (versión 1.0 y 1.1) solamente.
Reglas para atributos del panel del administrador y de los grupos de aprendizaje
Con D2L Standard CSV, los atributos del Panel del administrador y de los Grupos de aprendizaje permiten realizar las siguientes tareas:
- Establecer la estructura de informes que se utiliza en el Panel del administrador.
- Permitir la creación de reglas de membresía automáticas en los Grupos de aprendizaje.
Los atributos del Panel del administrador y de los Grupos de aprendizaje a través de D2L Standard CSV no permiten realizar las siguientes tareas:
- Crear cuentas para nuevos usuarios.