Närkonfigurera schemaläggningFör din OneRoster-integration bör du stödja båda konfigurationerna för rostertjänster och följa riktlinjer för bästa praxis.
Att följa riktlinjerna för bästa praxis för din integration säkerställer korrekta överföringar av registreringsdata och eliminerar gissningar kring korrigering av registreringar.
Notera:Instructure är en OneRoster-konsument. För definitioner av OneRoster-konsumenter och leverantörer, seIntroduktion till OneRoster.
Akademiska sessioner/terminer
Om ditt SIS använder ett gemensamt term-ID för att gruppera termer, inkludera det gemensamma term-ID:t i API-svaret. Det gemensamma term-ID:t kan användas för att identifiera termer om de behöver slås samman i Canvas.
Läs mer om OneRosterspecifikationer för akademiska sessioner.
Exempel |
|---|
{
"titel": "A 707 07/08",
"sourcedId": "{hash}-{skolaId}-{termIdentifer}",
...
}
|
Tillgänglig datamängd
Ställ in dina OneRoster-datautdragningsslutpunkter för innevarande läsår, inklusive all historisk och framtida data inom läsåret enligt definitionen i ditt system. Inkludera dessutom alla dataobjekt i datautdraget med nödvändiga slutdatum för att undvika oönskad radering av data i målsystemen.
Läs mer om OneRosterslutpunkter för schemaläggningochefterlevnad av slutpunktsregistrering.
Duplicerade registreringsuppgifter
Om en användare har flera registreringsposter för samma klass, ange endast den aktuella registreringsposten.
Om till exempel elev A i klass 123 är inskriven i klassen, borttagen och sedan återinskriven, ange den lämpligaste inskrivningsstatusen vid tidpunkten då API-anropet görs istället för elev A:s flera inskrivningsposter.
Inskrivningens start- och slutdatum
Varje registreringspost måste innehålla både ett startdatum och ett slutdatum, även om dessa datum är desamma som terminsdatumen. Genom att jämföra registrerings- och terminsdatum kan Canvas upprätthålla korrekt registreringsstatus.
hämtaAllaAnvändare/användare
Om din institution stöder användningen av Canvas-observatörsrollen (för föräldrar, vårdnadshavare etc.) rekommenderas att du inkluderar dessa användarprofiler i din implementeringskonfiguration.
Stegvisa datasynkroniseringar
Istället för att använda fullständiga datahämtningar kan du konfigurera stegvisa datasynkroniseringar med hjälp av endatumSenast ändradfrågefilter.
Notera:För att implementera stegvisa datasynkroniseringar på ett tillförlitligt sätt måste du inkludera borttagningsstatus eller slutdatum för varje registreringspost. Utan denna information kan registreringsminskningar endast beräknas genom att jämföra en ny fullständig datasynkronisering med en fullständig datasynkronisering.