Cuando configuración de la lista de turnosPara la integración de OneRoster, debe admitir ambas configuraciones de servicio de programación y observar las pautas de mejores prácticas.
Seguir las pautas de mejores prácticas para su integración garantiza transferencias correctas de datos de registro y elimina las conjeturas sobre la corrección de la inscripción.
Nota:Instructure es un consumidor de OneRoster. Para conocer las definiciones de consumidor y proveedor de OneRoster, consulteIntroducción a OneRoster.
Sesiones académicas/Términos
Si su SIS utiliza un ID de término común para agrupar términos, inclúyalo en la respuesta de la API. Este ID puede utilizarse para identificar términos si es necesario fusionarlos en Canvas.
Obtenga más información sobre OneRosterespecificaciones de la sesión académica.
Ejemplo |
|---|
{
"title": "A 707 07/08",
"sourcedId": "{hash}-{schoolId}-{termIdentifer}",
...
}
|
Conjunto de datos disponible
Configure los puntos finales de extracción de datos de OneRoster para el año escolar actual, incluyendo todos los datos históricos y futuros del año escolar, según lo definido por su sistema. Además, incluya todos los objetos de datos en la extracción de datos con las fechas de finalización necesarias para evitar la eliminación no deseada de datos en los sistemas de destino.
Obtenga más información sobre OneRosterpuntos finales de lista y cumplimiento de los puntos finales de la lista.
Registros de inscripción duplicados
Si un usuario tiene varios registros de inscripción para la misma clase, proporcione solo el registro de inscripción actual.
Por ejemplo, si el estudiante A de la clase 123 está inscripto en la clase, es eliminado y luego vuelve a inscribirse, proporcione el estado de inscripción más apropiado en el momento en que se realiza la llamada API en lugar de los múltiples registros de inscripción del estudiante A.
Fechas de inicio y fin de la inscripción
Cada registro de inscripción debe incluir una fecha de inicio y una fecha de finalización, incluso si coinciden con las fechas del trimestre. Al comparar las fechas de inscripción y del trimestre, Canvas puede mantener los estados de inscripción correctos.
obtenerTodosLosUsuarios/usuarios
Si su institución admite el uso del rol de observador de Canvas (para padres, tutores, etc.), se recomienda que incluya estos perfiles de usuario en su configuración de implementación.
Sincronizaciones de datos incrementales
En lugar de utilizar extracciones de datos completas, puede configurar sincronizaciones de datos incrementales mediante unfecha de última modificaciónfiltro de consulta
Nota:Para implementar sincronizaciones de datos incrementales de forma fiable, debe incluir el estado de eliminación o la fecha de finalización de cada registro de inscripción. Sin esta información, las bajas de inscripciones solo se pueden calcular comparando una nueva sincronización de datos completa con otra sincronización de datos completa.