OneRoster es la especificación estándar de IMS Global diseñada para permitir el intercambio seguro de las listas de clase y los datos relacionados entre un sistema de información de estudiantes (SIS) y cualquier otro sistema.
La implementación de OneRoster de Brightspace es compatible con la importación de hojas de cálculo (CSV), así como intercambios directos de sistemas que utilizan API REST.
La implementación de Brightspace de la especificación OneRoster v1.1 permite a los administradores programar los datos que se sacarán de su SIS para completar los datos relacionados con la lista, como escuelas, clases, usuarios o inscripciones, en Brightspace.
La interfaz de usuario de IPSIS OneRoster REST incluye una programación que permite a los administradores configurar la hora del día en que se realiza la extracción de datos. Para un SIS que admita devolución de calificaciones, los administradores pueden configurar las calificaciones para que se devuelvan con la sincronización diaria de datos o permitir que un miembro del equipo académico inicie una sincronización manual.
Antes de configurar la integración de OneRoster en el área Administración de IPSIS, revise las siguientes instrucciones de configuración.
Configure las funciones de OneRoster
Primero debe revisar los roles configurados en el SIS y asegurarse de que haya roles correspondientes adecuados en Brightspace.
Para revisar las funciones de OneRoster
- Revise los roles que están configurados en su SIS. Los siguientes roles están disponibles en OneRoster:
- Administrador
- Ayudante
- Tutor
- Elemento principal
- Supervisor
- Relativo
- Estudiante
- Profesor
-
Para cualquiera de los roles anteriores que desee enviar a Brightspace, si aún no hay roles apropiados en Brightspace, créelos en Roles y permisos antes de configurar la integración de SIS. Para obtener más información, consulte Administración de roles y permisos.
Configurar tipos de unidad de organización
También debe revisar los tipos de unidades de organización configurados en el SIS y asegurarse de que los tipos correspondientes estén configurados en Brightspace.
Para revisar los tipos de unidades de organización
-
Revise los tipos de unidad de organización que están configurados en su SIS. Los siguientes tipos de organización están disponibles en OneRoster:
-
Nacional
-
Estado
-
Local
-
Distrito
-
Escuela (obligatorio)
-
Departamento
- Para cualquiera de los tipos de unidades de organización anteriores que desee enviar a Brightspace, si aún no hay tipos de unidades de organización adecuados en Brightspace, créelos en el Editor de unidades de organización antes de configurar la integración de SIS. Se le pedirá que configure asignaciones entre los tipos de unidad de organización en el SIS y en Brightspace cuando cree la integración de SIS. Para obtener más información, consulte Crear y eliminar tipos de unidades de organización.
Comprender la asignación de tipos de datos entre OneRoster y Brightspace
Los tipos de recurso de OneRoster no coinciden exactamente con los de Brightspace. La siguiente tabla muestra la relación de asignación entre los tipos de recurso de OneRoster y Brightspace.

|
Nota: Los tipos de unidad de organización, por lo general, son tipos de unidades de organización personalizados que puede asignar durante el proceso de configuración.
|
Tipo de datos de OneRoster |
Tipo de datos de D2L Brightspace |
---|
Sesiones académicas |
Unidades de organización |
Org |
Unidades de organización |
Escuela |
Unidades de organización |
Curso |
Plantilla de curso |
Clase |
Oferta de cursos y sección de curso |
User |
User |
Inscripción |
Inscripción |
Categorías de elementos de línea |
Categorías de calificación |
Elementos de línea |
Elementos de calificación |
Resultados |
Calificaciones/puntajes |
Responsabilidades de las relaciones con los padres/tutores

|
Nota: esta información es para clientes de educación primaria y secundaria que desean usar Brightspace Parent & Guardian. |
Su institución es responsable de mantener la precisión de las relaciones de usuarios en el Sistema de información de estudiantes (SIS). Consulte con sus asesores para garantizar que cumple con las políticas de seguridad y privacidad de su institución y las leyes aplicables. Por ejemplo, la institución o la jurisdicción podrían tener una política o ley que especifique que, cuando el joven cumple 18 años, el padre o el tutor legal deben dejar de tener acceso al contenido del joven, a menos que este consienta que lo tengan; este caso debe tratarse mientras se generan y envían las relaciones padre o tutor-hijo a Brightspace.
Configuración básica de una integración de OneRoster REST
En los siguientes pasos, se describe la secuencia de alto nivel para contribuir a la comprensión. Para realizar la configuración básica de OneRoster REST, se deben seguir los pasos generales que se indican a continuación:
- En el SIS de la organización, genere un consumidor de OneRoster para Brightspace con el que se llame al SIS. El proceso para esto varía según el SIS. Comuníquese con el representante del SIS para obtener más información.
- Registre las credenciales de OAuth desde SIS.
- Registre la URL del extremo de OneRoster del SIS. Por ejemplo, https://www.sis.com/school/api.
Importante: No incluya ims/oneroster/v1p1 al final de la URL. D2L hace esto en el servicio de IPSIS.
- Complete la configuración en la nueva área Administración de IPSIS. Si tiene registros existentes que desea hacer coincidir con los datos de OneRoster, asegúrese de seleccionar las opciones apropiadas para los asuntos relativos a la vinculación de los datos de Brightspace con los equivalentes de SIS.
- En el campo Actualizaciones programadas, seleccione la hora del día en que desea que la integración REST se sincronice automáticamente con el SIS.
- Después de guardar la integración, esta comenzará a procesarse cuando se produzca la siguiente actualización programada. Si desea ejecutar la integración inmediatamente, en la página Lotes, haga clic en Ejecutar actualización ahora y seleccione Volver a sincronizar todos los registros del SIS.
Configuración básica de la integración de OneRoster CSV
En los siguientes pasos, se describe la secuencia de alto nivel para contribuir a la comprensión. Para realizar la configuración básica de OneRoster CSV, se deben seguir los pasos generales que se indican a continuación:
- Crear un archivo CSV con los datos relacionados de lista.
- Complete la configuración en el área Administración de IPSIS. Si desea correlacionar registros existentes con los datos de OneRoster, asegúrese de seleccionar las opciones adecuadas para las preguntas relacionadas con la vinculación de los datos de Brightspace con sus equivalentes del SIS.
- En la página Lotes, arrastre y suelte, o busque y seleccione el archivo ZIP en el que se incluye el archivo CSV con los datos relacionados de lista.
La integración comienza a procesarse automáticamente.
Verificar una integración de OneRoster
Los administradores pueden verificar una integración de OneRoster con los siguientes métodos.
Para verificar una integración de OneRoster
- Para determinar si se ha completado una integración de REST, vaya a Administración de IPSIS > Registro de auditoría. Actualice la página para verificar si se han ejecutado todos los tipos de registro esperados (como usuario, unidad de organización, etc.).
- Para determinar si se completó una integración de CSV, realice una de las siguientes acciones:
Página Lotes: después de cargar un archivo ZIP de CSV, el indicador de procesamiento aparece en la página Lotes en el sistema de origen. Actualice la página para confirmar que el indicador muestre Finalizado.
Registro de auditoría: actualice el Registro de auditoría para verificar que se hayan procesado todos los tipos de registro esperados.
- Para determinar si alguno de los tipos está completo, haga lo siguiente:
- Unidades de organización: utilice el Editor de unidades de organización para revisar todas las unidades de organización que se crearon y actualizaron, si es necesario.
- Usuarios: utilice la herramienta Usuarios para revisar todos los usuarios que se crearon y actualizaron, si es necesario.