La integración de la devolución de calificaciones (GPB) de Instructure OneRoster admite las configuraciones de punto final de GPB estándar o modificada. Esto se debe a que sigue de forma más estricta las normas de OneRoster.especificaciones de configuración del punto finalSe recomienda la configuración GPB estándar.
Además, para mejorar el rendimiento, incluya un punto final de rendimiento en su configuración de GPB.
Obtenga más información sobre OneRosterCumplimiento de los puntos finales del libro de calificaciones.
Nota:Instructure es un consumidor de OneRoster. Para conocer las definiciones de consumidor y proveedor de OneRoster, consulteIntroducción a OneRoster.
Devolución de grado estándar
El punto final de integración estándar de GPB incluye el sourcedId de la tarea al sincronizar los datos del libro de calificaciones de Canvas con su SIS.
Llamada de servicio | Punto final | Verbo HTTP | Requerido |
|---|
obtenerTodasLasCategorías | /categorías | CONSEGUIR | ✓ |
obtenerTodosLosElementosDeLínea | /elementos de línea | CONSEGUIR | ✓ |
obtenerResultadosParaClase | /clases/{id_de_clase}/resultados | CONSEGUIR | ✓ |
obtenerElementosDeLíneaParaClase | /clases/{id_de_clase}/elementosDeLínea | CONSEGUIR | ✓ |
obtenerResultadosParaElementoDeLíneaParaClase | /clases/{id_de_clase}/elementos_de_línea/{id_de_línea}/resultados | CONSEGUIR | ✓ |
obtenerResultadosParaEstudianteParaClase | /clases/{id_de_clase}/estudiantes/{id_de_estudiante}/resultados | CONSEGUIR | ✓ |
ponerCategoría | /categorías/{id} | PONER | 𝗫 |
ponerLíneaDeArtículo | /elementos de línea/{id} | PONER | ✓ |
ponerResultado | /resultados/{id} | PONER | ✓ |
Devolución de calificaciones modificada
El punto final GPB modificado omite el sourcedId de la tarea al sincronizar los datos del libro de calificaciones de Canvas con su SIS.
En respuesta a la llamada PUT para nuevos registros, el proveedor de OneRoster debe devolver el sourcedId. La integración almacena estos datos para su uso futuro al realizar llamadas a la API.
Llamada de servicio | Punto final | Verbo HTTP | Requerido |
|---|
obtenerTodasLasCategorías | /categorías | CONSEGUIR | ✓ |
obtenerTodosLosElementosDeLínea | /elementos de línea | CONSEGUIR | ✓ |
obtenerResultadosParaClase | /clases/{id_de_clase}/resultados | CONSEGUIR | ✓ |
obtenerElementosDeLíneaParaClase | /clases/{id_de_clase}/elementosDeLínea | CONSEGUIR | ✓ |
obtenerResultadosParaElementoDeLíneaParaClase | /clases/{id_de_clase}/elementos_de_línea/{id_de_línea}/resultados | CONSEGUIR | ✓ |
obtenerResultadosParaEstudianteParaClase | /clases/{id_de_clase}/estudiantes/{id_de_estudiante}/resultados | CONSEGUIR | ✓ |
ponerCategoría | /categorías/{id} | PONER | 𝗫 |
ponerLíneaDeArtículo | /elementos de línea/{id} | PONER | ✓ |
ponerResultado | /resultados/{id} | PONER | ✓ |
ponerCategoría* | /categorías* | PONER | 𝗫 |
ponerLineItem* | /elementos de línea* | PONER | ✓ |
ponerResultado* | /resultados* | PONER | ✓ |
*sourcedId se omitió en estas llamadas API
Puntos finales de devolución de grado de rendimiento
Se debe implementar al menos uno de los siguientes métodos de punto final de integración de devolución de grado de rendimiento.
Llamada de servicio | Punto final | Verbo HTTP | Requerido |
|---|
obtenerCategoríaClaseFiltrada | /categorías?filter=metadata.classId='{class_id}' | CONSEGUIR | 𝗫* |
obtenerCategoríasParaClase | /clases/{class_id}/categorías | CONSEGUIR | ✓** |
*Si bien no es estrictamente necesario, implementar este filtro evita la necesidad de extraer y almacenar en caché todas las categorías.
**Si no implementa la categoríametadatos.classidEsta implementación es obligatoria. Permite que las clases se asocien a una categoría.