Formatos de archivo D2L Standard CSV
A continuación, se detallan los formatos de archivo aceptados por CSV estándar de D2L:
- Organizaciones
- Usuarios
- Inscripciones
- Manifesto (se exige cuando se utiliza la versión 1.1 o superior de CSV estándar de D2L)
- Atributos del panel del administrador y de los grupos de aprendizaje
Los archivos se cargan en un archivo ZIP, mediante la siguiente convención de nomenclatura recomendada:
- D2LStdCSV-{YYYYmmddHHMMSS}.zip
Nota: Solo los archivos .zip (que distinguen mayúsculas de minúsculas, solo minúsculas) se pueden cargar a SFTP.
Los archivos se procesan en orden alfabético. D2L recomienda enviar los archivos en el siguiente orden:
- organizaciones
- usuarios
- inscripciones
- atributos
La convención de nomenclatura recomendada para los archivos CSV es la siguiente:
- 01-Other- {YYYYmmddHHMMSS}.csv
- 02-Departments- {YYYYmmddHHMMSS}.csv
- 03-Semesters- {YYYYmmddHHMMSS}.csv
- 04-Templates-{YYYYmmddHHMMSS}.csv
- 05-Offerings-{YYYYmmddHHMMSS}.csv
- 06-Sections-{YYYYmmddHHMMSS}.csv
- 07-Users-{YYYYmmddHHMMSS}.csv
- 08-Enrollments-{YYYYmmddHHMMSS}.csv
- 09-Attributes-{YYYYmmddHHMMSS}.csv
- manifest.json
Reglas comunes para el contenido de archivo
- Los valores de los archivos distinguen mayúsculas y minúsculas. En las instrucciones, se detalla si es obligatorio escribir en mayúscula o minúscula.
- Un valor vacío se representa con dos comas, sin espacios entre ellas. (por ejemplo, “,,” indica un valor vacío, mientras que “, ,” indica un carácter de espacio, que se traduce como un valor no válido).
- Los archivos CSV deben tener un encabezado (primera línea) que coincida de manera exacta (uso de mayúsculas, minúsculas y comas) con los encabezados que se indican en los ejemplos de las secciones que aparecen a continuación.
- Las líneas subsiguientes del archivo contienen los datos que se deben procesar (crear, actualizar o eliminar)
- Los archivos CSV deben estar codificados en UTF-8.
- Los archivos CSV y el manifiesto deben estar en un archivo ZIP.
- Los archivos CSV deben contener datos SIS diferenciales (deltas) en vez de almacenamientos de datos SIS completos.
- El envío de una acción ACTUALIZAR cuando el recurso no existe da como resultado una solicitud CREAR. El comportamiento común es utilizar solo las acciones ACTUALIZAR y ELIMINAR.
- 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 nombres o los números de seguro social de los usuarios, en los ID de origen.
Unidades de organización
En la integración se admiten los siguientes tipos de unidades de organización:
- Otras unidades de organización (unidades de organización personalizadas fuera de la estructura de organización estándar de D2L)
- Departamentos
- Semestres
- Plantillas de curso
- Ofertas de cursos
- Secciones
Mediante la integración de CSV estándar de D2L, se pueden crear, actualizar y eliminar unidades de organización en los niveles mencionados en la lista anterior.
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.
Las convenciones de nombramiento de las unidades de organización (nombre o código) deben seguir las descritas en su SIS. Brightspace puede aceptar tantas unidades de organización como sea necesario, y los nombres y códigos de las unidades de organización se deben proporcionar a través de los archivos csv sin realizarles cambios, siempre y cuando los nombres o códigos respeten los requisitos de caracteres prohibidos de Brightspace y sean únicos en todas las unidades de organización. Los códigos de la unidad de organización se truncarán si hay más de 50 caracteres, lo que podría causar la duplicación de códigos de unidad de organización en Brightspace o impedir la creación de una unidad de organización.
Caracteres prohibidos: ,:%&#*?|\”’ y los espacios iniciales y finales.
Otras unidades de organización, departamentos, semestres, plantillas de cursos, ofertas de cursos y secciones de cursos
El procesamiento de estas unidades de organización crea la estructura de organización en la instancia de Brightspace. Estas se deben enviar al menos una vez para indicar al CSV estándar de D2L 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 CSV estándar de D2L para garantizar la propiedad precisa de los datos.
Solo debe reenviar las unidades de organización cuando recién se crean o actualizan en el SIS/HRIS.
CSV estándar de D2L 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 diferente de CSV estándar de D2L y la opción para asignar está seleccionada en la configuración.
- Actualizar el nombre de la unidad de organización que controla.
- 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.
CSV estándar de D2L no realiza 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).
- Excepción: 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 ella.
Usuarios
El procesamiento del tipo de usuario crea, actualiza, desactiva o elimina usuarios en Brightspace. El tipo de usuario también puede crear, actualizar o eliminar la relación padre-hijo en Brightspace. Se deben enviar los usuarios al menos una vez para indicar a la integración qué usuarios puede crear, actualizar o eliminar y cuáles inscripciones puede administrar.
Los caracteres prohibidos constan de: \ / : ? " < > | ' , ;
CSV estándar de D2L puede hacer lo siguiente:
- Crear un nuevo usuario si todavía no existe e inscribirlo en la organización.
- Actualizar el nombre de usuario, el nombre, el apellido, el nombre preferido, el apellido preferido, el apellido clasificable (opcional), la contraseña y el correo electrónico.
- 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.
- Si existe un usuario con el mismo OrgDefinedID, se puede asignar al usuario existente.
- Actualizar una relación padre o tutor-hijo para Brightspace Parent & Guardian.
- Actualizar una relación de auditor-auditado.
- Si existe un usuario con el mismo “Nombre de usuario”, se puede asignar al usuario existente
CSV estándar de D2L no realiza lo siguiente:
- Actualizar OrgDefinedId; 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 CSV estándar de D2L.
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.
Inscripciones
El procesamiento de los registros del tipo de inscripción inscribe o anula la inscripción de usuarios en una unidad de organización específica en Brightspace. Se deben enviar las inscripciones cuando se hagan cambios en el sistema de información para mostrar de manera precisa los cambios en Brightspace. Solo se deben enviar las cancelaciones de inscripciones una vez. El reenvío de la misma anulación de inscripción registra advertencias en el registro de IPSIS.
CSV estándar de D2L puede hacer lo siguiente:
- Inscribir usuarios en unidades de organización.
- Anular inscripción de usuarios en unidades de organización.
Atributos del panel del administrador y de los grupos de aprendizaje
Con CSV estándar de D2L, 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
- Proporcionar atributos a fin de 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 CSV estándar de D2L no permiten:
- Crear cuentas para nuevos usuarios