Pan fyddwch chi'n ffurfweddu eich integreiddiad Instructure OneRoster, adolygwch ystyriaethau integreiddio pasio'n ôl gradd. Mae integreiddiad pasio'n ôl gradd (GPB) Instructure OneRoster yn cynnwys amrywiadau o'r manylebau OneRoster, fel sy'n ofynnol gan wahanol ddarparwyr SIS.
Categorïau Graddio
Yn dibynnu ar gyfluniad eich llyfr graddau SIS, gallwch addasu'rcaelCategorïauymholiad i gysoni aseiniadau'n gywir o Canvas i'ch llyfr graddau SIS.
Cyfnodau Graddio
Gan fod y rhan fwyaf o ddarparwyr SIS yn cyfrifo cyfnodau graddio yn awtomatig yn seiliedig ar ddyddiad dyledus aseiniad, efallai na fydd angen i chi gynnwys y pwynt terfyn hwn yn eich ffurfweddiad pasio'n ôl gradd.
Llwyth Talu Eitem Llinell
Gallwch chi ffurfweddu eich ceisiadau am eitemau llinell. Dysgu mwy am yr OneRosterstrwythur data categori eitem llinell.
Llwyth Canlyniadau
Gallwch chi ffurfweddu eich ceisiadau am eitemau llinell. Dysgu mwy am yr OneRostercanlyniadau.
Nodyn:Mae Instructure yn Ddefnyddiwr OneRoster. Am ddiffiniadau Defnyddiwr a Darparwr OneRoster, gweler yCyflwyniad i OneRoster.
Categorïau Graddio
Pan fydd integreiddiad Instructure OneRoster yn rhedeg cysoni graddau, y caelPobCategorïauMae'r cais yn dychwelyd pob categori graddio llyfr graddau SIS.
Unrhyw gategori graddio nad yw'n cynnwys y metadata.classIdYstyrir bod maes yn gategori byd-eang y gellir ei gymhwyso a'i ddefnyddio ym mhob dosbarth.
Categorïau Byd-eang
Os mai dim ond categorïau graddio byd-eang y mae eich llyfr graddau SIS yn eu cefnogi, yna dylai'r integreiddio weithio'n iawn heb y meysydd metadata.
Estyniad Gwrthrych Categori: metadata.classId
Er mwyn caniatáu i'r OneRoster API v1.1 gysylltu categorïau a gwrthrychau eraill yn fwy cywir yn y fanyleb pasio'n ôl gradd, mae angen maes categori.
Mae'r estyniad isod yn caniatáu i'r integreiddio nodi'n gywir y categorïau graddio SIS sydd eu hangen ar gyfer pasio'n ôl gradd. Unrhyw gategorïau nad oes ganddynt hynmetadata.classIdtybir bod meysydd yn fyd-eang, a defnyddir yr enw categori cyntaf sy'n cyfateb i enw grŵp aseiniadau Canvas ar gyfer GPB.
Os dewiswch gefnogimetadata.classId, dylech hefyd gynnwys ymholiad hidlo ar gyfer y caelCategorïaupwynt terfynol. Mae hyn yn caniatáu i'r integreiddiad dynnu categorïau ar gyfer un adran.
Estyniad Gwrthrych Categori |
|---|
{
"categorïau": [
{
"statws": "actif",
"title": "Asesiadau",
“sourcedId": "guid",
"href": "URI i'r adnodd yn SIS",
"metadata": {
"classId": "{class_id}”
},
"dateLastModified": null
}…
]
} |
Dewis Pwynt Terfynol: caelCategoriauArGylchDdosbarth
Wrth ragweld manyleb OneRoster API 1.2, gallwch ychwanegu cefnogaeth ar gyfer un newyddcaelCategorïauAr GyferDosbarthpwynt terfyn. Mae hyn yn caniatáu i'r integreiddiad nodi categorïau graddio SIS sydd ar gael ar gyfer adran yn ystod cydamseru pasio yn ôl gradd.
Nodyn:Os byddwch chi'n gweithredu'r dull hwn, does dim angen i chi ffurfweddu cefnogaeth ar gyfer ymetadata.classIdmaes.
Dim Categorïau Cyfatebol
Efallai bod eich integreiddiad Instructure OneRoster wedi'i ffurfweddu i gysoni aseiniadau Canvas i gategorïau graddio SIS. Yn ystod cysoni graddau, os na chanfyddir unrhyw gategorïau cyfatebol, bydd neges gwall yn ymddangos yn nodi nad yw'r un o enwau categori graddio SIS yn cyfateb i enwau grŵp aseiniadau Canvas.
Categori Diofyn
Efallai y bydd eich SIS yn cynnwys rhagosodiadIDFfynhonnellcategori graddio sy'n cael ei gefnogi ym mhob un o lyfrau graddau SIS. Yn ystod cysoni graddau o Canvas, os na ellir paru aseiniad â chategori graddio SIS, mae'n cysoni â'r categori graddio diofyn.
Os yw categori cyffredinIDFfynhonnellos nad yw ar gael, gellir anfon y gwerth hwn hefyd feldim.
Ddim yn Anfon Categorïau
Os yw system wybodaeth systematig (SIS) eich sefydliad yn cefnogi llyfrau graddau heb gategorïau graddio, gellir ffurfweddu eich integreiddiad Instructure OneRoster i anfon JSON lineItem yr aseiniad heb y maes categori neu gyda“categori”: dimGall yr integreiddiad ddewis anfon bob amserdim, neu anfon yn unigdimos na cheir categori cyfatebol.
Fel arall, gall eich integreiddiad presennol gysoni Eitemau llinell aseiniad heb eu categoreiddio yn awtomatig â chategori graddio heb ei gategoreiddio llyfr graddau SIS. Os yw hyn yn wir am eich integreiddiad, gall hyfforddwyr symud yr aseiniad i'r categori graddio SIS priodol. Er mwyn atal yr aseiniad rhag ail-gysoni â'r maes heb ei gategoreiddio, dylid ffurfweddu eich integreiddiad i adnabod y categori a neilltuwyd â llaw fel maes gludiog.
Categori Gor-redol
Gall llyfr graddau SIS eich sefydliad fod wedi'i ffurfweddu gyda chategori graddio rhagosodedig a ddefnyddir bob amser. Er mwyn darparu ar gyfer y ffurfweddiad hwn, gall eich integreiddiad Instructure OneRoster gynnwys categori caled-godio.IDFfynhonnellRhaid i bob llyfr graddau hyfforddwr yn eich SIS gynnwys y categori hwn. Fel arall, gellir ffurfweddu'r integreiddio gyda gor-redoldimgwerth categori.
Cyfnodau Graddio
Yn ystod cysoni graddau o Canvas, mae'r rhan fwyaf o systemau gwybodaeth systemig (SIS) yn cyfrifo ac yn cysylltu cyfnod graddio cywir aseiniad yn awtomatig gan ddefnyddio'rDyddiad Dyleduseitem llinell. Mae'r cyfrifiad awtomatig hwn yn golygu bod yCyfnod graddiogellir hepgor eitem llinell neu ei hanfon feldim.
Os yw'ch integreiddio yn ei gwneud yn ofynnol, aCyfnod graddioGellir ffurfweddu eitem llinell. Fodd bynnag, os yw wedi'i ffurfweddu'n anghywir, bydd gwallau cysoni graddau yn digwydd yn amlach.
Dysgu mwy amSesiynau academaidd OneRoster.
Ystyriaethau Llwyth Talu Eitemau Llinell
Gallwch ffurfweddu ceisiadau eitemau llinell i'w cynnwys yn eich llwyth tâl cysoni GPB.
Mae'r siart isod yn dangos ceisiadau llinell y gellir eu ffurfweddu. Fel rhan o'r broses ffurfweddu cleient unigol, gallwch addasu'r rhan fwyaf o'r gwerthoedd diofyn. Gallwch hefyd hepgor unrhyw un o'r gwerthoedd hyn o'r llwyth tâl. Fel arall, os yw'r data cyfatebol ar gael yn y dyfyniad data Canvas, gallwch hefyd ffurfweddu meysydd metadata ychwanegol.
Dysgu mwy am yr OneRosterstrwythur data categori eitem llinell.
Enw Maes OneRoster LineItem | Gwerth Diofyn |
|---|
IDFfynhonnell
| UUIDv4 |
teitl
| {enw.aseiniad} |
statws
| "gweithredol" |
disgrifiad
| Wedi'i fewnforio o Canvas:https://school.instructure.com/courses/{course_id}/assignments/{assignment_id} |
GwerthCanlyniadUchafswm
| {aseiniad.pwyntiau_possible} |
GwerthCanlyniadMin
| 0 |
DyddiadAseinio
| {assignment.unlock_at} NEU {assignment.due_at} |
Dyddiad Dyledus
| {aseiniad.dyledus_yn} |
dosbarth
| {Gwrthrych cyfeirio dosbarth OneRoster} |
categori
| {Gwrthrych cyfeirio categori OneRoster} NEU null* |
Cyfnod graddio
| null NEU {Gwrthrych cyfeirio academicSession OneRoster}** |
*gweldnodiadau gweithredu pasio yn ôl gradd ar gyfer categorïau
**gweler nodiadau gweithredu pasio yn ôl gradd ar gyfer gradingPeriods**
Ffurfweddiadau Llwyth Talu Enghreifftiol
Enghraifft Llwyth Talu gyda SourceID |
|---|
{
"lineItem": {
"sourcedId": "799e2caf-728d-4ef6-8ff9-5325e64cecd5”
"status": "actif”,
"title": "Aseiniad Prawf Canvas 1”,
"description": "Wedi'i fewnforio o Canvas:https://school.instructure.com/courses/5582/assignments/135”,
"GwerthCanlyniadUchaf": 10,
"GwerthCanlyniadIsaf": 0,
"DyddiadAseinio": "2021-03-10T23:59:59”,
"DyddiadCau": "2021-03-10T23:59:59”,
"metadata": {
"IDGwerthwr": “"
},
"dosbarth": {
"href": "~/ims/oneroster/v1p1/dosbarthiadau/100453379”,
"IDGyrchu": "100453379”,
"math": “dosbarth"
},
"categori": {
"href": "~/ims/oneroster/v1p1/categorïau/C5C3AC8C-8D0F-48EB-96F4-31437B640D16”,
"sourcedId": "C5C3AC8C-8D0F-48EB-96F4-31437B640D16”,
"math": “categori"
},
"graddingPeriod": null
}
} |
Enghraifft Llwyth Talu Heb SourceID |
|---|
{
"lineItem": {
"status": "actif”,
"title": "Aseiniad Prawf Canvas 1”,
"description": "Wedi'i fewnforio o Canvas:https://school.instructure.com/courses/5582/assignments/135”,
"GwerthCanlyniadUchaf": 10,
"GwerthCanlyniadIsaf": 0,
"DyddiadAseinio": "2021-03-10T23:59:59”,
"DyddiadDyddiadCyflawni": "2021-03-10T23:59:59”,
"metadata": {
"IDGwerthwr": “"
},
"dosbarth": {
"href": "~/ims/oneroster/v1p1/dosbarthiadau/100453379”,
"IDFfynhonnell": "100453379”,
"math": “dosbarth"
},
"categori": {
"href": "~/ims/oneroster/v1p1/categorïau/C5C3AC8C-8D0F-48EB-96F4-31437B640D16”,
"sourcedId": "C5C3AC8C-8D0F-48EB-96F4-31437B640D16”,
"math": “categori"
},
"graddingPeriod": null
}
} |
Ystyriaethau Llwyth Talu Canlyniad
Gallwch chi ffurfweddu llwythi canlyniad sydd wedi'u cynnwys yn eich cysoniad GPB.
Mae'r siart isod yn dangos ceisiadau llinell y gellir eu ffurfweddu. Fel rhan o'r broses ffurfweddu cleient unigol, gallwch addasu'r rhan fwyaf o'r gwerthoedd diofyn. Gallwch hefyd hepgor unrhyw un o'r gwerthoedd hyn o'r llwyth tâl. Fel arall, os yw'r data cyfatebol ar gael yn y dyfyniad data Canvas, gallwch hefyd ffurfweddu meysydd metadata ychwanegol.
Dysgu mwy am yr OneRostercanlyniadau.
Enw Maes OneRoster | Gwerth Diofyn |
|---|
IDFfynhonnell | {sourcedId} |
EitemLlinell | {Gwrthrych cyfeirio lineItem OneRoster} |
myfyriwr | {Gwrthrych cyfeirio defnyddiwr OneRoster} |
Statws sgôr | "wedi'i raddio'n llawn" neu "heb ei gyflwyno" neu "wedi'i eithrio" |
sgôr | {sgôr.cyflwyniad} |
sylw | wedi'i hepgor yn ddiofyn* |
DyddiadSgorio | wedi'i hepgor yn ddiofyn** |
*gweler y nodiadau gweithredu pasio'n ôl gradd am sylwadau
**gweler nodiadau gweithredu pasio yn ôl gradd ar gyfer sgôrDyddiad
Enghraifft Llwyth Talu |
|---|
{
"canlyniad": {
"sourcedId": "0031e9ee-5bd0-4d80-a5f7-5c14fe75acc0”,
"lineItem": {
"href": "~/ims/oneroster/v1p1/lineItems/0ea49ae5-4a6b-45d5-a0c2-b01facbfbc5f”,
"sourcedId": "0ea49ae5-4a6b-45d5-a0c2-b01facbfbc5f”,
"math": “lineItem"
},
"myfyriwr": {
"href": "~/ims/oneroster/v1p1/myfyrwyr/S100051158”,
"sourcedId": "S100051158”,
"math": “myfyriwr"
},
"scoreStatus": "wedi'i raddio'n llawn",
"sgôr": 10
}
} |
Sgorau
Yn Canvas gall hyfforddwr neilltuo gwerthoedd sgôr negyddol yn ogystal â rhagori ar y gwerth sgôr uchaf. Ystyriwch sut y bydd eich integreiddiad yn ymdrin â'r sefyllfaoedd posibl hyn.
Mewn rhai achosion, fel eithriedigStatws sgôr, dylai eich integreiddiad gael ei ffurfweddu i basio adimgwerth sgôr, fel arall0Mae gwerth y sgôr yn cael ei drosglwyddo i'r SIS.
Gwerth Statws Sgôr o Ganfas | Nodiadau |
|---|
wedi'i raddio'n llawn |
cyflwyniad.llif_gwaith_cyfnodol = wedi'i raddioDylai fod sgôr gysylltiedig bob amser.
|
heb ei gyflwyno |
cyflwyniad.ar goll = gwir
Yn bennaf dim ond os oes sgôr gysylltiedig y bydd yn llwyddo, ond mae'n bosibl caelsgôr=null
|
wedi'i eithrio |
cyflwyniad.esgusoddwyd = gwir
Bydd y sgôr yndimyn ddiofyn neu0
|