Hvornårkonfiguration af vagtplanlægningFor din OneRoster-integration bør du understøtte begge konfigurationer af vagtplanlægningstjenester og overholde retningslinjerne for bedste praksis.
Følg retningslinjerne for bedste praksis for din integration, så du sikrer korrekt overførsel af vagtplanlægningsdata og fjerner gætværk vedrørende korrektion af tilmeldinger.
Note:Instructure er en OneRoster-forbruger. For definitioner af OneRoster-forbrugere og -udbydere, seIntroduktion til OneRoster.
Akademiske sessioner/semester
Hvis dit SIS bruger et fælles term-ID til at gruppere termer, skal du inkludere det fælles term-ID i API-svaret. Det fælles term-ID kan bruges til at identificere termer, hvis de skal flettes sammen i Canvas.
Lær mere om OneRosterspecifikationer for akademiske sessioner.
Eksempel |
|---|
{
"titel": "A 707 07/08",
"sourcedId": "{hash}-{skoleId}-{termIdentifer}",
...
}
|
Tilgængeligt datasæt
Angiv dine OneRoster-dataudtrækningsslutpunkter for det aktuelle skoleår, inklusive alle historiske og fremtidige data inden for skoleåret som defineret af dit system. Medtag desuden alle dataobjekter i dataudtrækket med nødvendige slutdatoer for at undgå uønsket sletning af data i målsystemerne.
Lær mere om OneRosterslutpunkter for vagtplanlægningogOverholdelse af slutpunkter for vagtplanlægning.
Duplikerede tilmeldingsregistreringer
Hvis en bruger har flere tilmeldingsposter for den samme klasse, skal du kun angive den aktuelle tilmeldingspost.
Hvis f.eks. elev A i klasse 123 er tilmeldt klassen, fjernet og derefter gentilmeldt, skal du angive den mest passende tilmeldingsstatus på det tidspunkt, hvor API-kaldet foretages, i stedet for elev A's flere tilmeldingsposter.
Start- og slutdatoer for tilmelding
Hver tilmeldingspost skal indeholde både en startdato og en slutdato, selvom disse datoer er de samme som semesterdatoerne. Ved at sammenligne tilmeldings- og semesterdatoer kan Canvas opretholde korrekte tilmeldingsstatusser.
hentAlleBrugere/brugere
Hvis din institution understøtter brugen af Canvas-observatørrollen (for forældre, værger osv.), anbefales det, at du inkluderer disse brugerprofiler i din implementeringskonfiguration.
Trinvise datasynkroniseringer
I stedet for at bruge fulde datahentninger kan du konfigurere trinvise datasynkroniseringer ved hjælp af endatoSidst ændretforespørgselsfilter.
Note:For pålideligt at implementere trinvise datasynkroniseringer skal du inkludere slettestatus eller slutdato for hver tilmeldingspost. Uden disse oplysninger kan tilmeldingsfald kun beregnes ved at sammenligne en ny fuld datasynkronisering med en fuld datasynkronisering.