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)
Los archivos se cargan en un archivo zip. La convención de nombre recomendada es:
- 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 archivos de D2L Standard CSV individuales son:
- 01 - Otros - {YYYYmmddHHMMSS}.csv
- El procesamiento de unidades de organización personalizadas fuera de la estructura de organización estándar de D2L se admite en D2L Standard CSV 2.0 o superior.
- 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
Reglas de contenido de archivos CSV comunes
- Los valores de los archivos distinguen mayúsculas y minúsculas. En las instrucciones, se detalla si se debe 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 lo indicado en <enlace a la página que define cada archivo con ejemplos>. Las líneas subsiguientes del archivo contienen los datos que se deben procesar (creados, actualizados o eliminados).
- 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 o 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 nombres o los números de seguro social de los usuarios, en las ID definidas por organización (sourcedIds) de los usuarios.
Reglas para tipos de unidades de organización admitidos
En la integración se admiten los siguientes tipos de unidades de organización:
- 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
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, si 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 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.
|
Nota: Los códigos de unidad de organización no admiten los caracteres siguientes: % & # * ? < > | \ " ' y espacios iniciales o finales. |
Reglas para otros tipos de unidades de organización admitidos
También se admiten departamentos, semestres, plantillas de curso, ofertas de cursos y secciones de curso. 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 D2L Standard CSV para garantizar la propiedad precisa de los datos.
|
Advertencia: Solo debe reenviar las unidades de organización cuando recién se crean o actualizan en su SIS/HRIS. |
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 ella.
Reglas para tipos de usuario
El procesamiento del tipo de usuario crea, actualiza, desactiva o elimina usuarios en Brightspace. El tipo de usuario también podría crear, actualizar o eliminar la relación padre-hijo en Brightspace (D2L Standard CSV versión 1.1 o superior). 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.
|
Nota: Los El nombre y el apellido del usuario 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 de los usuarios no admite los siguientes caracteres: ( ) < > [ ] | \ ; : , “ |
CSV estándar de D2L puede hacer lo siguiente:
- Crear un nuevo usuario si todavía no existe 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).
CSV estándar de D2L 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 registros de tipo de inscripción
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 y anular inscripción de usuarios en unidades de organización (versión 2.0 o superior) o solo secciones de curso (versión 1.0 y 1.1).
Reglas para 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.