L'integrazione del passback dei voti (GPB) di Instructure OneRoster supporta le configurazioni degli endpoint GPB Standard o Modificate. Poiché segue più rigorosamente OneRosterspecifiche di configurazione dell'endpoint, si consiglia la configurazione GPB standard.
Inoltre, per migliorare le prestazioni, includi un endpoint Performance nella configurazione GPB.
Scopri di più su OneRosterconformità dell'endpoint del registro dei voti.
Nota:Instructure è un consumatore OneRoster. Per le definizioni di consumatore e fornitore OneRoster, consultareIntroduzione a OneRoster.
Passback di grado standard
L'endpoint di integrazione GPB standard include l'attributo sourcedId dell'assegnazione durante la sincronizzazione dei dati del registro dei voti da Canvas al SIS.
Chiamata di servizio | Punto finale | Verbo HTTP | Necessario |
|---|
ottieni tutte le categorie | /categorie | OTTENERE | ✓ |
ottieniTuttiGliElementiDiLinea | /lineItems | OTTENERE | ✓ |
Ottieni risultati per la classe | /classi/{class_id}/risultati | OTTENERE | ✓ |
getLineItemsForClass | /classi/{class_id}/lineItems | OTTENERE | ✓ |
ottieniRisultatiPerElementoDiLineaPerClasse | /classi/{class_id}/lineItems/{li_id}/risultati | OTTENERE | ✓ |
Ottieni risultati per studenti per classi | /classi/{class_id}/studenti/{student_id}/risultati | OTTENERE | ✓ |
mettereCategoria | /categorie/{id} | METTERE | 𝗫 |
inserisciLineItem | /lineItems/{id} | METTERE | ✓ |
putResult | /risultati/{id} | METTERE | ✓ |
Passback di grado modificato
L'endpoint GPB modificato omette l'attributo sourcedId dell'assegnazione durante la sincronizzazione dei dati del registro dei voti da Canvas al SIS.
Nella risposta alla chiamata PUT per i nuovi record, il provider OneRoster deve restituire il sourcedId. L'integrazione memorizza quindi questi dati per un utilizzo futuro durante l'esecuzione di chiamate API.
Chiamata di servizio | Punto finale | Verbo HTTP | Necessario |
|---|
ottieni tutte le categorie | /categorie | OTTENERE | ✓ |
ottieniTuttiGliElementiDiLinea | /lineItems | OTTENERE | ✓ |
Ottieni risultati per la classe | /classi/{class_id}/risultati | OTTENERE | ✓ |
getLineItemsForClass | /classi/{class_id}/lineItems | OTTENERE | ✓ |
ottieniRisultatiPerElementoDiLineaPerClasse | /classi/{class_id}/lineItems/{li_id}/risultati | OTTENERE | ✓ |
Ottieni risultati per studenti per classi | /classi/{class_id}/studenti/{student_id}/risultati | OTTENERE | ✓ |
mettereCategoria | /categorie/{id} | METTERE | 𝗫 |
inserisciLineItem | /lineItems/{id} | METTERE | ✓ |
putResult | /risultati/{id} | METTERE | ✓ |
inserisciCategoria* | /categorie* | METTERE | 𝗫 |
inserisciLineItem* | /lineItems* | METTERE | ✓ |
inserisciRisultato* | /risultati* | METTERE | ✓ |
*sourcedId omesso da queste chiamate API
Endpoint di passback del grado di prestazione
Dovrebbe essere implementato almeno uno dei seguenti metodi di endpoint di integrazione Performance Grade Passback.
Chiamata di servizio | Punto finale | Verbo HTTP | Necessario |
|---|
getFilteredClassCategory | /categorie?filter=metadata.classId='{class_id}' | OTTENERE | 𝗫* |
ottieniCategoriePerClasse | /classi/{class_id}/categorie | OTTENERE | ✓** |
*Sebbene non sia strettamente necessario, l'implementazione di questo filtro evita la necessità di estrarre e memorizzare nella cache tutte le categorie.
**Se non si implementa la categoriametadati.classid, questa implementazione è obbligatoria. Ciò consente alle classi di associarsi a una categoria.