Utilice este tema con el fin de comprender las convenciones y los requisitos para los formatos de archivo D2L Standard CSV.
Formatos aceptados para archivos D2L Standard CSV
A continuación, se detallan los formatos de archivo aceptados por CSV estándar de D2L:
- 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)
Archivos de muestra de D2L Standard CSV
Los archivos CSV de muestra están disponibles para su descarga en el Curso del Centro de aprendizaje del IPSIS. Este curso proporciona ejemplos actualizados y orientación para ayudarlo a comenzar con D2L Standard CSV.
Recomendamos visitar el curso para acceder a los últimos archivos de muestra y a los recursos relacionados.
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) al Protocolo de transferencia segura de archivos (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 del Sistema de información de estudiantes (SIS) diferenciales (deltas) en vez de almacenamientos de datos SIS completos.
- El envío de una acción ACTUALIZAR cuando el objeto no existe da como resultado una solicitud CREAR. Por lo general, solo se utilizan 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 identifica la versión de D2L Standard CSV que se usa. Para obtener más información, consulte el tema Manifiesto.
- 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 (unidades de organización personalizadas fuera de la estructura de organización de D2L estándar; compatible con la versión 2.0 o superior)
- Departamentos
- Semestres
- Plantillas de cursos
- 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. Después de que la integración controla una unidad de organización, todos los cambios futuros deben realizarse a través de la integración.
- 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 (por ejemplo, envíe departamentos antes de las plantillas de curso).
- Si se envían relaciones de usuario, asegúrese de que se respete la jerarquía (por ejemplo, envíe a los padres o tutores antes que a los estudiantes).
- 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 códigos de las unidades de organización pueden utilizarse tal cual si cumplen con los requisitos de los caracteres de Brightspace y son únicos.
- Los códigos de unidad de organización se limitan a 50 caracteres. Los valores más largos se truncan y pueden causar duplicaciones o fallas.
- Los códigos de unidad de organización no admiten los caracteres siguientes: , : % & # * ? < > | \ " ' o 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 la asignación está habilitada en la configuración.
- Actualizar el nombre de la unidad de organización que controla.
- Asignar y eliminar relaciones principales entre unidades de organización.
- Asignar y actualizar el departamento principal para las plantillas de cursos.
- Asignar y actualizar la plantilla de curso principal y el semestre para las ofertas de cursos.
- Actualizar los detalles de la oferta de cursos, incluidos el nombre y las fechas, y desactivar ofertas.
- Eliminar secciones de curso y anular la inscripción de los usuarios de forma 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 las unidades de organización que se crearon de forma manual, a menos que estén asignadas.
- Eliminar una unidad de organización que tiene unidades secundarias vinculadas a ella.
Reglas para los usuarios
Los registros de usuario pueden crear, actualizar, desactivar o eliminar usuarios en Brightspace y administrar relaciones.
Reglas:
- Los usuarios deben enviarse al menos una vez para establecer la administración mediante la integración.
- El nombre y el apellido no admiten los siguientes caracteres: \ / : * ? " < > | @ , ;
- El nombre de usuario y la ID definida por la organización no admiten los siguientes caracteres: / : * ? " < > | ' , ;
- Las direcciones de correo electrónico no admiten los siguientes caracteres: ( ) < > [ ] | \ ; : , “
D2L Standard CSV puede hacer lo siguiente:
- Crear usuarios e inscribirlos.
- Asignar usuarios a cuentas existentes.
- Actualizar detalles del usuario.
- Actualizar los nombres preferidos y clasificables (según la versión).
- Actualizar los pronombres (versión 3.0 o superior).
- Activar, desactivar o eliminar usuarios.
- Administrar las relaciones con los padres o tutores.
- Actualizar las relaciones del auditor.
D2L Standard CSV no realiza lo siguiente:
- Actualizar la ID definida por organización a través de CSV.
- Eliminar usuarios creados de forma manual, a menos que estén asignados.
Reglas para inscripciones
El procesamiento de registros de inscripción inscribe o anula la inscripción de usuarios en unidades de organización.
Reglas:
- Enviar registros de inscripción cuando se produzcan cambios en el sistema de origen.
- Enviar una anulación de inscripción solo una vez.
- Cuando utilice secciones, proporcione registros de inscripción solo para las secciones.
- Evite enviar diferentes roles para las secciones bajo la misma oferta.
- Los clientes deben evitar enviar diferentes roles para las secciones bajo la misma oferta. Hacerlo provocará que el rol se sobrescriba en la oferta y en una de las secciones, ya que el LMS no permite que el rol de la sección sea diferente del rol de la oferta.
D2L Standard CSV puede hacer lo siguiente:
- Inscribir o anular la inscripción de usuarios en la unidad de organización y secciones.
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 estructuras de informes.
- Habilitar reglas de membresía automáticas en Grupos de aprendizaje.
Los atributos del Panel del administrador y de los Grupos de aprendizaje a través de D2L Standard CSV no permiten:
- Crear cuentas para nuevos usuarios.