Los archivos OneRoster deben ser archivos de texto en formato CSV, codificados en UTF-8. Para generar estos archivos, acceda a los datos del SIS mediante sus herramientas de exportación, siguiendo las instrucciones de su proveedor. Comuníquese con su proveedor del SIS para obtener orientación sobre la extracción de datos en el formato CSV de OneRoster.
Brightspace es compatible con la especificación OneRoster v1.1. Los administradores pueden cargar paquetes OneRoster 1.1 compatibles con los datos de la lista requerida, como escuelas, clases, usuarios e inscripciones, y ver los resultados en Brightspace.
CSV de OneRoster admite los siguientes archivos y los procesa en el orden indicado:
- manifest.csv
- academicsessions.csv
- orgs.csv
- courses.csv
- classes.csv
- users.csv
- enrollments.csv
Uso de los archivos CSV de OneRoster
Las siguientes secciones proporcionan una descripción de alto nivel de los archivos CSV de OneRoster. Para obtener más información, consulte Asignaciones de datos de CSV de OneRoster.
Uso del archivo manifiesto de CSV
Debe incluir un archivo de manifiesto con cada paquete. El manifiesto contiene la versión y la lista de archivos que se están enviando a Brightspace e indica si los datos de la lista señalan si el paquete incluye contenido delta (solo cambios desde la última actualización) o por lote (todos los archivos).
Uso de los archivos CSV de sesiones académicas, organizaciones, cursos y clases
La integración en CSV de OneRoster puede crear y actualizar los niveles de organización que se indican en la sección Comprender la asignación de tipos de datos entre OneRoster y Brightspace del tema Preparación para la integración con OneRoster. Debe administrar cualquier nivel de organización que no aparezca en la lista fuera de la integración de OneRoster.
Siga las convenciones de nombre (nombre/código) definidas en su SIS para unidades de organización. Brightspace acepta cualquier cantidad de unidades de organización y puede incluir sus nombres y códigos en archivos CSV, siempre que cumplan con las restricciones de Brightspace sobre caracteres no válidos.
Envíe niveles de organización al menos una vez para especificar qué unidades de organización puede controlar IPSIS. Reenvíe los archivos de la unidad de organización solo cuando necesite agregarlos o actualizarlos en la estructura de organización del entorno de aprendizaje.
CSV de OneRoster puede:
- Crear una nueva unidad de organización, si no existe
- Asociarse con una unidad de organización existente si esta se creó por otro medio distinto
- Actualizar el nombre o código de la unidad de organización que controla
- Plantilla de curso: asignar y actualizar las escuelas principales de acuerdo con el código de escuela
- Oferta de cursos: asignar y actualizar las escuelas principales de acuerdo con el código de escuela
- Oferta de cursos: asignar o actualizar la plantilla de curso principal y el semestre en función del código principal
- Oferta de cursos: actualizar todos los detalles de los cursos, incluidos el nombre de la oferta de cursos
- Actualizar los códigos de unidades de organización
- Copiar contenidos del curso al nuevo curso
- Eliminar una unidad de organización si el archivo delta se envía con el estado tobedeleted y la unidad de organización no tiene inscripciones
CSV de OneRoster no puede hacer lo siguiente:
- Eliminar manualmente las unidades de organización creadas, a menos que se hayan asignado con CSV de OneRoster
- Eliminar una unidad de organización con elementos secundarios conectados con ella (se debe eliminar estos primero)
Uso del archivo CSV de usuarios
El procesamiento del tipo de usuario crea, actualiza o desactiva usuarios en Brightspace. Enviar datos de los usuarios al menos una vez para explicar al IPSIS qué perfiles de usuario puede crear o actualizar, y cuáles inscripciones puede administrar. Brightspace inscribe automáticamente a los usuarios en la escuela.
CSV de OneRoster puede:
- Crear un nuevo usuario
- Si existe un usuario con el mismo OrgDefinedID o Nombre de usuario, se puede asignar a un usuario existente
- Actualizar el nombre, el apellido, la contraseña y el correo electrónico
- Actualizar el rol del nivel de organización
- Activar o desactivar un usuario
- Actualice la ID definida por organización o el Nombre de usuario
- Inscriba o anule la inscripción de usuarios de unidades superiores de la organización
CSV de OneRoster no puede:
Usar el archivo CSV de Inscripciones
Mediante el procesamiento del tipo de inscripción se puede inscribir o cancelar la inscripción de usuarios en Brightspace a nivel de secciones del curso. Envíe inscripciones solo cuando se produzcan cambios en su sistema de información para mantener Brightspace actualizado. Envíe una cancelación de inscripción solo una vez, ya que si la vuelve a enviar, generará advertencias en el registro del IPSIS.
CSV de OneRoster puede:
- Inscribir o anular la inscripción de usuarios en la oferta de cursos y secciones
CSV de OneRoster no puede:
- Inscribir usuarios en otros niveles de organización (excepto mediante el uso del registro de usuario como se indicó anteriormente)
Limitaciones y supuestos
Anulaciones de inscripciones en las unidades de organización superiores
El término unidad de organización superior se refiere a cualquier unidad de organización en la jerarquía superior a una oferta de cursos, como la escuela donde se ofrece el curso. Normalmente, los usuarios están inscritos tanto en la oferta de cursos como en la escuela correspondiente, lo que sirve como la unidad de organización superior.
- Para habilitar las anulaciones de inscripción mediante la integración de OneRoster, en la página Administración de IPSIS, seleccione Anular inscripción de usuarios de SIS Orgs si ya no están asociados con ellos en el SIS.
- La integración de OneRoster no puede anular la inscripción de los usuarios de unidades de organización superiores creadas antes de la versión 20.24.6 de junio de 2024 o de inscripciones creadas manualmente en Brightspace.
- Anular la inscripción de un usuario con un rol en cascada de una unidad de organización superior puede hacerlo perder el acceso a numerosas unidades de organización secundaria.
Caracteres no admitidos
El código de la unidad de organización proviene de los siguientes campos CSV:
- Sesiones académicas: título
- Cursos: título o courseCode
- Clases: título o classCode
- Organizaciones: nombre o identificador
Los siguientes caracteres no son compatibles para el código de la unidad de organización:
- \ (barra invertida)
- : (dos puntos)
- * (asterisco)
- ? (signo de interrogación)
- “ ”(comillas de apertura y cierre)
- < > (símbolos “menor que” y “mayor que”)
- | (barra vertical)
- ‘ (apóstrofo)
- # (numeral/símbolo de libra)
- , (coma)
- % (símbolo de porcentaje)
- & (signo et)
todos los códigos de la unidad de organización se truncan a una longitud máxima de 50 caracteres.
Procesamiento de archivos CSV
Comprimir archivos CSV antes de cargarlos en Brightspace. Puede cargar el archivo ZIP:
- Manualmente: arrastre y suelte el archivo en la interfaz Administración de IPSIS > Panel.
- Automáticamente: cargue el archivo ZIP en el sitio SFTP establecido durante su configuración inicial. Brightspace verifica el sitio SFTP cada diez minutos.