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 e 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 de administración de IPSIS, revise la siguiente información de configuración, asignación y ajustes básicos que se encuentra en este tema.
Configurar los roles
Antes de configurar la integración de OneRoster en el área de administración de IPSIS, debe configurar los roles que desea utilizar. Los siguientes roles están disponibles en OneRoster:
- Administrador
- Ayudante
- Tutor
- Elemento principal
- Supervisor
- Relativo
- Estudiante
- Profesor
- Revise los roles que están configurados en su SIS.
- Para cualquiera de los roles que desee enviar a la plataforma Brightspace, realice una de las siguientes acciones:
- Verifique que existan los roles que desea incluir en la plataforma Brightspace.
- Si algunos de los roles no existen en Brightspace, créelos en la herramienta Roles y permisos antes de configurar su sistema SIS. Para obtener más información, consulte Administración de roles y permisos.
Configurar tipos de unidad de organización
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. Los siguientes tipos de unidad de organización están disponibles en OneRoster:
- Nacional
- Estado
- Local
- Distrito
- Escuela (obligatorio)
- Departamento
- Revise los tipos de unidad de organización que están configurados en su SIS.
- Para cualquiera de los tipos de unidad de organización que desee enviar a la plataforma Brightspace, realice una de las siguientes acciones:
- Verifique que existan los tipos de unidad de organización que desea incluir en la plataforma Brightspace.
- Si algunos de los tipos de unidad de organización no existen en Brightspace, créelos en la herramienta Editor de unidades de organización antes de configurar su sistema SIS. Para obtener más información, consulte Crear y eliminar tipos de unidades de organización.
Asignar 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: Configure los tipos de unidad de organización en Brightspace antes de configurar su integración en OneRoster. Para obtener más información, consulte Crear y eliminar tipos de unidades de organización.
* 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, sección del 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 |
|
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.
|
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.
Descripción general de las integraciones de OneRoster
Existen dos tipos de integraciones de OneRoster: OneRoster Rest y OneRoster CSV. Esta sección del tema proporciona información básica sobre estas dos integraciones. Para obtener más información, consulte Acerca de la integración de OneRoster REST o Acerca de la integración de OneRoster CSV
Integración de OneRoster REST: Flujo de trabajo básico
Los siguientes pasos describen la secuencia de alto nivel para ayudarlo a comprender la integración de OneRoster REST. Para obtener información más detallada sobre el flujo de trabajo, consulte Acerca de la integración de OneRoster REST.
- En el sistema de información de estudiantes (SIS) de su organización, usted genera un consumidor de OneRoster para Brightspace con el que llamará a su SIS desde Brightspace.
| Nota: El proceso para crear este rol varía según el SIS. Para obtener más información, consulte a su representante de SIS. |
- Registre las credenciales de OAuth desde su SIS y la URL terminal de SIS. Por ejemplo, https://www.sis.com/school/api.
| Nota: No incluya ims/oneroster/v1p1 al final de la URL. D2L hace esto en el servicio de IPSIS. |
- Complete la configuración en Brightspace en el área de administración del IPSIS. Para hacer coincidir los registros existentes con los datos de OneRoster, seleccione las opciones adecuadas para vincular los datos de Brightspace con equivalentes de SIS.
- Establezca un horario para que su integración de REST se sincronice con su SIS.
Después de guardar su integración, puede esperar a la siguiente actualización programada o puede ejecutar la integración inmediatamente con el botón Ejecutar actualización ahora en la página Lotes.
Integración de OneRoster CSV: Flujo de trabajo básico
Los siguientes pasos describen la secuencia de alto nivel para ayudarlo a comprender la integración de OneRoster CSV. Para obtener información más detallada sobre el flujo de trabajo, consulte Acerca de la integración de OneRoster CSV
- Cree un archivo CSV con información relacionada de la lista.
- Complete la configuración en el área Administración de IPSIS del entorno de aprendizaje de Brightspace. Para hacer coincidir los registros existentes con los datos de OneRoster, seleccione las opciones adecuadas para vincular los datos de Brightspace con equivalentes de SIS.
- En la página Lotes, arrastre y suelte, o busque el archivo ZIP en el que se incluye el archivo CSV con los datos relacionados de la lista.
La integración comienza a procesarse automáticamente.
Verificar una integración de OneRoster
Existen varias maneras de comprobar 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.
<<<<<<<<<<<<<EL BORRADOR COMIENZA AQUÍ
Solución de problemas de una integración de OneRoster
Si en la primera ejecución de cualquier tipo de integración de OneRoster se produce un error, intente volver a procesar la integración.
Para volver a procesar una integración CSV:
- En la página Lotes, vuelva a arrastrar y soltar el archivo ZIP de CSV en el área designada.
- Si el archivo ZIP de CSV está dañado, genere un nuevo archivo en el SIS y arrástrelo y suéltelo en la interfaz para procesarlo nuevamente.
Para volver a procesar una integración de REST:
- En la página Lotes, en el botón Actualizar ahora, seleccione cualquiera de las siguientes opciones:
- Volver a sincronizar actualizaciones: puede seleccionar la fecha más antigua para sincronizar solo las actualizaciones realizadas a los datos. A continuación, haga clic en Volver a sincronizar.
- Volver a sincronizar todos los registros del SIS: puede extraer todos los datos del SIS nuevamente, sin limitación de tiempo.
<<<<<<<EL CONTENIDO DEL BORRADOR DE ORIGEN COMIENZA AQUÍ
Valores de asignación de REST
Valores de asignación de CSV
Sesiones académicas
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
|
Sí |
|
|
Estado
|
activo, tobedeleted
|
|
No |
El campo para los archivos en modo delta es obligatorio.
|
|
Fecha de última modificación
|
|
|
No |
El campo para los archivos en modo delta es obligatorio.
Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
|
|
Título
|
|
Nombre de la unidad de organización y código de la unidad de organización
|
Sí |
|
|
Tipo
|
|
|
Sí |
Tipo de unidad de organización
|
|
StartDate
|
|
|
Sí |
AAAA-MM-DD
|
|
EndDate
|
|
|
Sí |
AAAA-MM-DD
|
|
ParentSourcedId
|
|
|
No |
Sin utilizar
|
|
SchoolYear
|
|
|
No |
Sin utilizar
|
Organizaciones
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
|
Sí
|
|
|
Estado
|
activo, tobedeleted
|
|
No
|
El campo para los archivos en modo delta es obligatorio. |
|
Fecha de última modificación
|
|
|
No
|
El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ |
|
Nombre
|
|
Nombre de la unidad de organización y código de la unidad de organización
|
Sí
|
Si el campo Identificador está vacío, el nombre se copia en el código de la unidad de organización en Brightspace |
|
Tipo
|
nacional, estatal, local, distrito, escuela, departamento
|
|
Sí
|
Define OrgUnitType en Brightspace.
http://www.imsglobal.org/oneroster-v11-final-specification#_Toc480452024
|
|
Identificador
|
|
Código de la unidad de organización (si lo hubiera)
|
No
|
|
|
ParentSourcedId
|
|
|
No
|
Este campo especifica la unidad de organización principal. |
Cursos
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
|
Sí
|
|
|
Estado
|
activo, tobedeleted
|
|
No
|
El campo para los archivos en modo delta es obligatorio. |
|
Fecha de última modificación
|
|
|
No
|
El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ |
|
SchoolYearSourcedId
|
|
|
No
|
Sin utilizar |
|
Título
|
|
Nombre de la unidad de organización y código de la unidad de organización
|
Sí
|
Crea una plantilla de cursos de Brightspace. Si el campo CourseCode está vacío, el título se copia en OrgUnitCode. |
|
Código del curso
|
|
Código de unidad de organización
|
No
|
Si se proporciona |
|
Calificaciones
|
|
|
No
|
Sin utilizar |
|
OrgSourcedId
|
|
|
Sí
|
Este campo especifica la unidad de organización principal. |
|
Asuntos
|
|
|
No
|
Sin utilizar |
|
SubjectCodes
|
|
|
No
|
Sin utilizar |
Clases
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
|
Sí
|
|
|
Estado
|
activo, tobedeleted
|
|
No
|
El campo para los archivos en modo delta es obligatorio. |
|
Fecha de última modificación
|
|
|
No
|
El campo para los archivos en modo delta es obligatorio.
Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
|
|
Título
|
|
Nombre de la unidad de organización y código de la unidad de organización
|
Sí
|
Crea una sección de Brightspace y una oferta de cursos. Si el campo ClassCode está vacío, el título se copia en el código de la unidad de organización. |
|
Calificaciones
|
|
|
No
|
Sin utilizar |
|
CourseSourcedId
|
|
|
Sí
|
Este campo especifica la unidad de organización principal |
|
ClassCode
|
|
Código de la unidad de organización (si lo hubiera)
|
No
|
Si se proporciona |
|
ClassType
|
|
|
Sí
|
Sin utilizar |
|
Ubicación
|
|
|
No
|
Sin utilizar |
|
SchoolSourcedId
|
|
|
Sí
|
Sin utilizar |
|
TermsSourcedIds
|
|
|
No
|
Sin utilizar |
|
Asuntos
|
|
|
No
|
Sin utilizar |
|
SubjectCodes
|
|
|
No
|
Sin utilizar |
|
Períodos
|
|
|
No
|
Sin utilizar |
Usuarios
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
OrgDefinedId
|
Sí
|
Si el campo Identificador está vacío, SourcedId se copia en OrgDefinedId. |
|
Estado
|
activo, tobedeleted
|
|
No
|
El campo para los archivos en modo delta es obligatorio. |
|
Fecha de última modificación
|
|
|
No
|
El campo para los archivos en modo delta es obligatorio.
Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
|
|
EnabledUser
|
|
|
Sí
|
Sin utilizar |
|
OrgSourcedIds
|
|
Inscripciones superiores de la unidad de organización (con rol en la organización)
|
Sí |
Inscripción en las unidades de organización de escuela |
| Rol |
administrador, ayudante, tutor, padre, supervisor, pariente, estudiante, docente |
|
Sí |
Rol en la organización |
|
UserName
|
|
UserName
|
Sí
|
|
|
UserIds
|
|
|
No
|
Sin utilizar |
|
GivenName
|
|
FirstName
|
Sí
|
|
|
FamilyName
|
|
LastName
|
Sí
|
|
|
MiddleName
|
|
MiddleName
|
No
|
|
|
Identificador
|
|
OrgDefinedId
|
No
|
Si se proporciona |
|
Correo electrónico
|
|
ExternalEmail
|
No
|
|
|
Sms
|
|
MobilePhone
|
No
|
|
|
Teléfono
|
|
HomePhone
|
No
|
|
|
AgentSourcedIds
|
|
|
No
|
Se utiliza para Brightspace Parent & Guardian. Este campo asevera la relación padre-hijo. Tanto la fila de padre como la de hijo deben hacer referencia a los sourcedIds mutuos. |
|
Calificaciones
|
|
|
No
|
Sin utilizar |
|
Contraseña
|
|
Contraseña
|
No
|
|
Inscripciones
| OneRoster |
Valores compatibles |
Asignaciones de Brightspace |
Obligatorio |
Notas |
|---|
|
SourcedId
|
|
|
Sí
|
|
|
Estado
|
activo, tobedeleted
|
|
No
|
El campo para los archivos en modo delta es obligatorio. |
|
Fecha de última modificación
|
|
|
No
|
El campo para los archivos en modo delta es obligatorio.
Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
|
|
UserSourcedId
|
|
|
Sí
|
Usuario que se inscribirá |
|
ClassSourcedId
|
AAAA-MM-DD
|
|
Sí
|
Inscripción de Brightspace |
|
SchoolSourcedId
|
|
|
No
|
Sin utilizar |
|
Rol
|
administrador, ayudante, tutor, padre, supervisor, pariente, estudiante, docente
|
Rol
|
Sí
|
|
|
Principal
|
|
|
No
|
Sin utilizar |
|
BeginDate
|
|
|
No
|
AAAA-MM-DD |
|
EndDate
|
|
|
No
|
AAAA-MM-DD |