Mae integreiddio pas-yn-ôl gradd (GPB) Instructure OneRoster yn cefnogi naill ai'r ffurfweddiadau pwynt terfynol GPB Safonol neu Addasedig. Oherwydd ei fod yn dilyn OneRoster yn fwy llym.manylebau ffurfweddu pwynt terfynol, argymhellir y ffurfweddiad GPB Safonol.
Yn ogystal, i wella perfformiad, cynhwyswch derfynbwynt Perfformiad yn eich ffurfweddiad GPB.
Dysgu mwy am OneRostercydymffurfiaeth â phwynt terfyn y llyfr graddau.
Nodyn:Mae Instructure yn Ddefnyddiwr OneRoster. Am ddiffiniadau Defnyddiwr a Darparwr OneRoster, gweler yCyflwyniad i OneRoster.
Pasiad yn ôl Gradd Safonol
Mae'r pwynt terfyn integreiddio GPB Safonol yn cynnwys yr aseiniad sourcedId wrth gysoni data llyfr graddau o Canvas i'ch SIS.
Galwad Gwasanaeth | Pwynt Terfynol | Berf HTTP | Angenrheidiol |
|---|
caelPobCategorïau | /categorïau | CAEL | ✓ |
caelPobEitemLlinell | /eitemau llinell | CAEL | ✓ |
caelCanlyniadauArGylch y Dosbarth | /dosbarthiadau/{id_dosbarth}/canlyniadau | CAEL | ✓ |
caelEitemauLlinellAr Gyfer y Dosbarth | /dosbarthiadau/{id_dosbarth}/eitemau_llinell | CAEL | ✓ |
caelCanlyniadauAr gyferEitemLlinellAr gyfer y Dosbarth | /dosbarthiadau/{class_id}/lineItems/{li_id}/canlyniadau | CAEL | ✓ |
caelCanlyniadauAr gyferMyfyriwrAr gyfer Dosbarth | /dosbarthiadau/{id_dosbarth}/myfyrwyr/{id_myfyriwr}/canlyniadau | CAEL | ✓ |
rhoiCategori | /categorïau/{id} | RHOWCH | 𝗫 |
EitemLlinellrhoi | /eitemau llinell/{id} | RHOWCH | ✓ |
rhoiCanlyniad | /canlyniadau/{id} | RHOWCH | ✓ |
Pasiad yn ôl Gradd wedi'i Addasu
Mae'r pwynt terfyn GPB wedi'i Addasu yn hepgor yr aseiniad sourcedId wrth gysoni data llyfr graddau o Canvas i'ch SIS.
Yn yr ymateb i'r alwad PUT am gofnodion newydd, rhaid i'r darparwr OneRoster ddychwelyd y sourcedId. Yna mae'r integreiddiad yn storio'r data hwn i'w ddefnyddio yn y dyfodol wrth gynnal galwadau API.
Galwad Gwasanaeth | Pwynt Terfynol | Berf HTTP | Angenrheidiol |
|---|
caelPobCategorïau | /categorïau | CAEL | ✓ |
caelPobEitemLlinell | /eitemau llinell | CAEL | ✓ |
caelCanlyniadauArGylch yDosbarth | /dosbarthiadau/{id_dosbarth}/canlyniadau | CAEL | ✓ |
caelEitemauLlinellAr Gyfer y Dosbarth | /dosbarthiadau/{id_dosbarth}/eitemau_llinell | CAEL | ✓ |
caelCanlyniadauAr gyferEitemLlinellAr gyfer Dosbarth | /dosbarthiadau/{class_id}/lineItems/{li_id}/canlyniadau | CAEL | ✓ |
caelCanlyniadauArFyfyriwrArFyDosbarth | /dosbarthiadau/{id_dosbarth}/myfyrwyr/{id_myfyriwr}/canlyniadau | CAEL | ✓ |
rhoiCategori | /categorïau/{id} | RHOWCH | 𝗫 |
EitemLlinellrhoi | /eitemau llinell/{id} | RHOWCH | ✓ |
rhoiCanlyniad | /canlyniadau/{id} | RHOWCH | ✓ |
rhoiCategori* | /categorïau* | RHOWCH | 𝗫 |
rhoiLlinellEitem* | /eitemau llinell* | RHOWCH | ✓ |
rhoiCanlyniad* | /canlyniadau* | RHOWCH | ✓ |
*sourcedId wedi'i hepgor o'r galwadau API hyn
Pwyntiau Terfynol Pasio'n Ôl Gradd Perfformiad
Dylid gweithredu o leiaf un o'r dulliau pwynt terfyn integreiddio Passback Gradd Perfformiad canlynol.
Galwad Gwasanaeth | Pwynt Terfynol | Berf HTTP | Angenrheidiol |
|---|
caelCategoriDosbarthHidledig | /categorïau?hidlydd=metadata.classId='{class_id}' | CAEL | 𝗫* |
caelCategorïauAr GyferDosbarth | /dosbarthiadau/{id_dosbarth}/categorïau | CAEL | ✓** |
*Er nad oes angen llwyr amdano, mae gweithredu'r hidlydd hwn yn atal yr angen i dynnu a storio pob categori mewn storfa.
**Os na fyddwch yn gweithredu'r categorimetadata.classid, mae'r gweithrediad hwn yn ofynnol. Mae hyn yn caniatáu i ddosbarthiadau gysylltu â chategori.