Wann Dienstplan konfigurierenFür Ihre OneRoster-Integration sollten Sie sowohl Dienstplanungs- als auch Dienstplankonfigurationen unterstützen und die Best-Practice-Richtlinien beachten.
Die Einhaltung bewährter Vorgehensweisen bei der Integration gewährleistet eine korrekte Übertragung der Teilnehmerdaten und beseitigt unnötige Rätselraten bei der Korrektur von Anmeldungen.
Notiz:Instructure ist ein OneRoster-Nutzer. Definitionen von OneRoster-Nutzern und -Anbietern finden Sie hier:Einführung in OneRosterDie
Akademische Semester/Trimester
Wenn Ihr SIS eine gemeinsame Begriffs-ID zur Gruppierung von Begriffen verwendet, fügen Sie diese gemeinsame Begriffs-ID in die API-Antwort ein. Mithilfe der gemeinsamen Begriffs-ID können Begriffe identifiziert werden, falls diese in Canvas zusammengeführt werden müssen.
Erfahren Sie mehr über OneRosterSpezifikationen für akademische Sitzungen.
Beispiel |
|---|
{
"title": "A 707 07/08",
"sourcedId": "{hash}-{schoolId}-{termIdentifer}",
...
}
|
Verfügbarer Datensatz
Legen Sie die OneRoster-Datenextraktionspunkte für das aktuelle Schuljahr fest, einschließlich aller historischen und zukünftigen Daten innerhalb des Schuljahres, wie in Ihrem System definiert. Fügen Sie außerdem alle Datenobjekte mit den erforderlichen Enddaten in die Datenextraktion ein, um ein ungewolltes Löschen von Daten in den Zielsystemen zu vermeiden.
Erfahren Sie mehr über OneRosterEndpunkte für die Kaderplanung Und Einhaltung der Dienstplan-EndpunkteDie
Doppelte Einschreibungsunterlagen
Falls ein Benutzer mehrere Einschreibungsdatensätze für denselben Kurs hat, geben Sie nur den aktuellen Einschreibungsdatensatz an.
Wenn beispielsweise Student A in Klasse 123 in die Klasse eingeschrieben, abgemeldet und dann wieder eingeschrieben wird, soll der zum Zeitpunkt des API-Aufrufs aktuellste Einschreibungsstatus anstelle der verschiedenen Einschreibungsdatensätze von Student A angegeben werden.
Anmeldebeginn und -ende
Jeder Immatrikulationsdatensatz muss sowohl ein Start- als auch ein Enddatum enthalten, selbst wenn diese Daten mit den Semesterdaten übereinstimmen. Durch den Abgleich von Immatrikulations- und Semesterdaten kann Canvas korrekte Immatrikulationsstatus gewährleisten.
getAllUsers/users
Wenn Ihre Institution die Verwendung der Canvas-Beobachterrolle (für Eltern, Erziehungsberechtigte usw.) unterstützt, wird empfohlen, diese Benutzerprofile in Ihre Implementierungskonfiguration aufzunehmen.
Inkrementelle Datensynchronisierung
Anstatt vollständige Datenabfragen zu verwenden, können Sie inkrementelle Datensynchronisierungen mithilfe von ... konfigurieren.Datum der letzten ÄnderungAbfragefilter.
Notiz:Für eine zuverlässige Implementierung inkrementeller Datensynchronisierungen müssen Sie den Löschstatus oder das Enddatum für jeden Registrierungsdatensatz angeben. Ohne diese Information lassen sich Registrierungsabbrüche nur durch den Vergleich einer neuen vollständigen Datensynchronisierung mit einer früheren vollständigen Datensynchronisierung berechnen.