Nårkonfigurering av vaktlisteFor OneRoster-integrasjonen din bør du støtte begge konfigurasjonene for rostertjeneste og følge retningslinjene for beste praksis.
Å følge retningslinjene for beste praksis for integrasjonen sikrer korrekt overføring av vaktlistedata og fjerner gjetting knyttet til korrigering av påmelding.
Note:Instructure er en OneRoster-forbruker. For definisjoner av OneRoster-forbrukere og -leverandører, seIntroduksjon til OneRoster.
Akademiske økter/semester
Hvis SIS-systemet ditt bruker en felles term-ID for å gruppere termer, må du inkludere den felles term-ID-en i API-svaret. Den felles term-ID-en kan brukes til å identifisere termer hvis de må slås sammen i Canvas.
Lær mer om OneRosterspesifikasjoner for akademiske økter.
Eksempel |
|---|
{
"tittel": "A 707 07/08",
"kilde-ID": "{hash}-{skole-ID}-{termIdentifer}",
...
}
|
Tilgjengelig datasett
Angi OneRoster-datauttrekkingssluttpunktene dine for inneværende skoleår, inkludert alle historiske og fremtidige data innenfor skoleåret slik det er definert av systemet ditt. I tillegg må du inkludere alle dataobjekter i datauttrekkingen med nødvendige sluttdatoer for å unngå uønsket sletting av data i målsystemene.
Lær mer om OneRostersluttpunkter for oppstilling av vaktlisterogsamsvar med sluttpunktene for bemanning.
Dupliserte registreringsoppføringer
Hvis en bruker har flere registreringsoppføringer for samme klasse, oppgi kun den gjeldende registreringsoppføringen.
Hvis for eksempel student A i klasse 123 er registrert i klassen, fjernet og deretter registrert på nytt, oppgi den mest passende registreringsstatusen på det tidspunktet API-kallet foretas i stedet for student As flere registreringsposter.
Start- og sluttdatoer for påmelding
Hver registreringsoppføring må inneholde både en startdato og en sluttdato, selv om disse datoene er de samme som semesterdatoene. Ved å sammenligne registrerings- og semesterdatoer kan Canvas opprettholde korrekt registreringsstatus.
hentAlleBrukere/brukere
Hvis institusjonen din støtter bruk av Canvas-observatørrollen (for foreldre, foresatte osv.), anbefales det at du inkluderer disse brukerprofilene i implementeringskonfigurasjonen din.
Inkrementelle datasynkroniseringer
I stedet for å bruke fullstendige datahentinger, kan du konfigurere trinnvise datasynkroniseringer ved hjelp av endatoSist endretspørrefilter.
Note:For å implementere trinnvise datasynkroniseringer på en pålitelig måte, må du inkludere slettestatusen eller sluttdatoen for hver registreringsoppføring. Uten denne informasjonen kan registreringsfall bare beregnes ved å sammenligne en ny fullstendig datasynkronisering med en fullstendig datasynkronisering.