Bereitstellen von School Data Sync (klassisch) mithilfe von OneRoster 1.0-CSV-Dateien
Wichtig
School Data Sync (klassisch) wird bis Ende 2024 durch die neue School Data Sync-Benutzeroberfläche ersetzt. Wir empfehlen Ihnen, ihren Übergang zur neuen Benutzeroberfläche für Ihr nächstes Schuljahr zu planen.
Sie können CSV-Dateien (Comma Separated Value) mit School Data Sync (SDS) verwenden, um Ihre SIS-Daten (Student Information System) mit Office 365 zu importieren und zu synchronisieren. SDS kann Schüler, Lehrer, Schulen, Abschnitte und Listeninformationen aus Ihrem SIS mit Microsoft Entra ID und Office 365 synchronisieren. Mit dieser Methode exportieren oder erstellen Sie OneRoster-CSV-Dateien für School Data Sync aus Ihren SIS-Daten, richten ein Synchronisierungsprofil ein und laden die CSV-Dateien zur Verarbeitung in SDS hoch.
Inhalt dieses Artikels:
Bevor Sie beginnen
Bevor Sie mit der Synchronisierung mit SDS mithilfe der CSV-Importmethode beginnen, lesen Sie die Übersicht über SDS. Um diesen Vorgang abzuschließen, müssen Sie außerdem das Microsoft SDS Toolkit installieren. Dieses Tool hilft Ihnen, Ihren CSV-Export zu konvertieren, hinzuzufügen und ihre Benutzer zu aktualisieren, die zwischen SIS und Office 365 synchronisiert werden, und kann auch verwendet werden, um die CSV-Dateidaten zu überprüfen. Weitere Informationen finden Sie unter Installieren des SDS-Toolkits.
Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:
Ein Office 365 for Education-Mandant
Anmeldeinformationen für globale Admin
School Data Sync (Plan 1) aktiviert
Hinweis
Die Daten, die Sie über SDS bereitstellen, können für Drittanbieteranwendungsanbieter über deren Apps zugänglich sein. Daher sollten Sie nur die Daten synchronisieren, die Sie diesen Drittanbietern zur Verfügung stellen möchten.
Konvertieren Ihrer OneRoster 1.0-CSV-Dateien in das SDS-Format
Bevor Sie ein SDS-Synchronisierungsprofil erstellen und Ihre CSV-Dateien importieren können, müssen Sie zuerst Ihre CSV-Dateien im OneRoster-Format in das SDS-Format konvertieren. Führen Sie die folgenden Schritte aus, um diesen Konvertierungsprozess abzuschließen.
Speichern Sie Ihre OneRoster 1.0-CSV-Dateien im Verzeichnis C:\temp.
Installieren Sie das SDS-Toolkit.
Erstellen Sie einen Unterordner namens c:\temp\csvs.
Erstellen Sie einen Unterordner namens c:\temp\sdslogs.
Führen Sie den Befehl Convert-OneRosterToMicrosoftSDS mit der folgenden Syntax aus:
Convert-OneRosterToMicrosoftSDS -onerosterfolderpath "c:\\temp" -sdsfolderpath "c:\\temp\\csvs" -logpath "c:\\temp\\logs"Wechseln Sie zu Ihrem Verzeichnis c:\temp\csvs, und überprüfen Sie, ob die neuen konvertierten SDS-Dateien vorhanden sind.
Erstellen eines Synchronisierungsprofils und Importieren der konvertierten CSV-Dateien
Führen Sie die folgenden Schritte aus, um Ihre konvertierten Dateien zu importieren und Ihr Synchronisierungsprofil zu erstellen. Ein Synchronisierungsprofil ist eine logische Gruppe von Optionen und Einstellungen, die von SDS zum Synchronisieren der CSV-Daten verwendet werden, die Sie hochladen möchten. Sie können mehrere Synchronisierungsprofile innerhalb eines einzelnen Office 365 Mandanten erstellen.
SDS-Zugriff und erstmalige Anmeldung
- Um auf das SDS-Admin-Portal zuzugreifen, starten Sie einen Webbrowser, navigieren Sie zu sds.microsoft.com, wählen Sie Anmelden aus, und geben Sie dann die Anmeldeinformationen Für Ihr Microsoft 365 Global Admin-Konto ein.
Erstellen eines Synchronisierungsprofils und Hochladen Ihrer OneRoster 1.0-CSV-Dateien
Wählen Sie nach der Anmeldung im linken Navigationsbereich + Profil hinzufügen aus, um ein Synchronisierungsprofil zu erstellen.
Füllen Sie auf der Seite Verbindungstyp auswählen das Formular nach Bedarf aus. Wählen Sie nach Abschluss des Vorgangs Start aus.
Hinweis
Es gibt keine Option für OneRoster CSV. Wenn Sie das OneRoster-Dateiformat verwenden, wählen Sie CSV-Dateien: SDS-Format aus.
Wählen Sie auf der Seite Synchronisierungsoptionen die entsprechende Option aus, um neue Benutzer zu erstellen oder vorhandene Benutzer zu synchronisieren. Wählen Sie dann Dateien hochladen aus, um Ihre sechs SDS-CSV-Dateien hochzuladen. Schließen Sie nach dem Hochladen Ihre Auswahl auf der Seite nach Bedarf ab, und wählen Sie Weiter aus.
Hinweis
Wenn sie mit der Option zum Erstellen neuer Benutzer ausgeführt werden und V2.1-CSV einführen möchten, haben wir ein Tool veröffentlicht, mit dem Sie sich auf die Unterstützung des V2.1-CSV-Formats als Teil Ihres Übergangs zur Schule vorbereiten können. Weitere Informationen finden Sie unter Aktualisieren von Anker-IDs vor dem Erstellen von Benutzern.
Vorhandene Benutzer : Wählen Sie diese Option aus, wenn Sie bereits Benutzerkonten in Ihrem O365-Mandanten für jeden kursteilnehmer und lehrer in Ihren CSV-Dateien erstellt haben.
Neue Benutzer : Wählen Sie diese Option aus, wenn SDS Benutzerkonten für jeden Ihrer Schüler und Lehrer erstellen soll, die in Ihren CSV-Dateien enthalten sind.
Schaltfläche "Dateien hochladen" : Wählen Sie diese Schaltfläche aus, um Ihre sechs CSV-Dateien hochzuladen. Beim Hochladen führt SDS einige kurze Überprüfungstests durch, um sicherzustellen, dass die Dateien richtig formatiert sind. Wenn die Überprüfung erfolgreich ist, werden Ihre Dateien in das Synchronisierungsprofil hochgeladen.
Schuleigenschaften : Nach dem Hochladen Ihrer CSV-Dateien werden die attribute, die in Ihrem School.csv enthalten sind, automatisch ausgewählt. Überprüfen Sie, ob es sich bei den hier ausgewählten Attributen um dieselben Attribute handelt, die in Ihrem School.csv
Abschnittseigenschaften : Nach dem Hochladen Ihrer CSV-Dateien werden die in Ihrem Student.csv enthaltenen Attribute automatisch ausgewählt. Überprüfen Sie, ob es sich bei den hier ausgewählten Attributen um dieselben Attribute handelt, die in Ihrem School.csv
Teamerstellungsoption : Wenn Sie dieses Kontrollkästchen aktivieren, wird sichergestellt, dass SDS sowohl die Microsoft 365-Gruppe als auch das Klassenteam für jede synchronisierte Klasse erstellt. Wenn Sie das Kontrollkästchen deaktiviert lassen, erstellt SDS nur die Microsoft 365-Gruppen.
Nicht unterstützte Sonderzeichen ersetzen: Wenn Sie dieses Kontrollkästchen aktivieren, kann SDS nicht unterstützte Sonderzeichen automatisch ersetzen, während die Synchronisierung ausgeführt wird. Sonderzeichen werden durch ein "_" ersetzt und führen nicht mehr zu einem Fehler während des Synchronisierungsvorgangs für dieses Objekt.
Synchronisierungsoption für den Anzeigenamen der Klassengruppe : Wenn Sie dieses Kontrollkästchen aktivieren, können Lehrkräfte den Abschnittsanzeigenamen nach der ersten Synchronisierung steuern und verhindern, dass SDS section displayName-Änderungen, die von Lehrern vorgenommen wurden, überschrieben wird.
Zugriff auf Kursteilnehmer verzögern : Wenn Sie diese Option aktivieren, können Sie ein Datum für SDS festlegen, um Mitgliedschaften zu synchronisieren und Kursteilnehmern das Anzeigen ihrer Kurse zu ermöglichen. Deaktivieren Sie diese Option, um Kursteilnehmer sofort zu synchronisieren.
Wann sollten wir die Synchronisierung beenden? - In der Regel möchten Sie dies am Ende des Schuljahres oder Der Semesters tun. Sobald SDS die Synchronisierung des Profils beendet, haben Sie die Möglichkeit, die diesem Profil zugeordneten Klassen nach Bedarf zu sauber.
Wählen Sie auf der Seite Lehreroptionen die entsprechenden Identitätsabgleichsoptionen aus, vergewissern Sie sich, dass die Eigenschaften des Lehrers ausgewählt sind, und wählen Sie dann Weiter aus.
SDS überprüft, um sicherzustellen, dass Sie Attribute und Optionen im richtigen Format auswählen. Wenn Sie z. B. einen UserPrincipalName abgleichen, müssen Sie ein Quellverzeichnis-Attribut auswählen, das im Format userPrincipalName (prefix@domain.com) vorliegt, oder Sie müssen eine Domäne an das Quellverzeichnis-Attribut anfügen, um eine ordnungsgemäße Formatierung sicherzustellen. Wenn Ihre Auswahl nicht das richtige Format aufweist, um eine Übereinstimmung abzuschließen, wird auf der Seite ein roter Fehler angezeigt.
Primärschlüssel (Quellverzeichnis): Dies ist das Lehrer-Attribut in der CSV-Datei, die für den SDS-Identitätsabgleich verwendet wird. Sehen Sie sich das Video zum Identitätsabgleich an, um weitere Informationen zum Auswählen des entsprechenden Quellverzeichnis-Attributs und zum ordnungsgemäßen Konfigurieren der Identitätsabgleichseinstellungen für den Lehrer zu finden.
Primärschlüssel (Zielverzeichnis): Dies ist das Benutzerattribute in Microsoft Entra ID, das für den SDS-Identitätsabgleich verwendet wird. Sehen Sie sich das Video zum Identitätsabgleich an, um weitere Informationen zum Auswählen des entsprechenden Zielverzeichnis-Attributs und zum ordnungsgemäßen Konfigurieren der Identitätsabgleichseinstellungen für den Lehrer zu finden.
Domäne (optional): Dies ist ein optionaler Domänenwert, den Sie dem ausgewählten Quellverzeichnis-Attribut hinzufügen können, um den Abgleich Ihrer Lehreridentität abzuschließen. Wenn Sie mit einem UserPrincipalName- oder Mail-Attribut übereinstimmen müssen, muss in der Zeichenfolge eine Domäne enthalten sein. Ihr Quellattribute muss entweder die Domäne bereits enthalten, oder Sie können die entsprechende Domäne über das Dropdownmenü an das Quellattribute anfügen.
Wählen Sie auf der Seite Student-Optionen die entsprechenden Identitätsabgleichsoptionen aus, vergewissern Sie sich, dass die Eigenschaften des Kursteilnehmers ausgewählt sind, und wählen Sie dann Weiter aus.
SDS überprüft, um sicherzustellen, dass Sie Attribute und Optionen im richtigen Format auswählen. Wenn Sie z. B. einen UserPrincipalName abgleichen, müssen Sie ein Quellverzeichnis-Attribut auswählen, das im Format userPrincipalName (prefix@domain.com) vorliegt, oder Sie müssen eine Domäne an das Quellverzeichnis-Attribut anfügen, um eine ordnungsgemäße Formatierung sicherzustellen. Wenn Ihre Auswahl nicht das richtige Format aufweist, um eine Übereinstimmung abzuschließen, wird auf der Seite ein roter Fehler angezeigt.
Primärschlüssel (Quellverzeichnis): Dies ist das Student-Attribut in der CSV-Datei, die für den SDS-Identitätsabgleich verwendet wird. Sehen Sie sich das Video zum Identitätsabgleich an, um weitere Informationen zum Auswählen des entsprechenden Quellverzeichnis-Attributs und zum ordnungsgemäßen Konfigurieren der Identitätsabgleichseinstellungen für den Lehrer zu finden.
Primärschlüssel (Zielverzeichnis): Dies ist das Benutzerattribute in Microsoft Entra ID, das für den SDS-Identitätsabgleich verwendet wird. Sehen Sie sich das Video zum Identitätsabgleich an, um weitere Informationen zum Auswählen des entsprechenden Zielverzeichnis-Attributs und zum ordnungsgemäßen Konfigurieren der Identitätsabgleichseinstellungen für den Kursteilnehmer zu finden.
Domäne (optional): Dies ist ein optionaler Domänenwert, den Sie dem ausgewählten Quellverzeichnis-Attribut hinzufügen können, um den Abgleich Ihrer Studentenidentität abzuschließen. Wenn Sie mit einem UserPrincipalName- oder Mail-Attribut übereinstimmen müssen, muss in der Zeichenfolge eine Domäne enthalten sein. Ihr Quellattribute muss entweder die Domäne bereits enthalten, oder Sie können die entsprechende Domäne über dieses Dropdownmenü an das Quellattribute anfügen.
Stellen Sie auf der Seite Überprüfen sicher, dass Sie die entsprechende Auswahl getroffen haben. Wenn keine weiteren Änderungen erforderlich sind, wählen Sie Profil erstellen aus. Nachdem Sie ein Synchronisierungsprofil erstellt haben, startet SDS einen Überprüfungsprozess vor der Synchronisierung. Wenn während dieses Vorgangs Fehler gefunden werden, haben Sie die Möglichkeit, diese zu beheben und Dateien erneut hochzuladen, bevor Sie auf die Schaltfläche "Synchronisierung fortsetzen" klicken und den echten Synchronisierungsprozess starten. Wenn Sie Fehler erhalten und diese nicht aktualisieren möchten, können Sie die Synchronisierung trotzdem fortsetzen, ohne die Fehler zu beheben.
Um den Synchronisierungsprozess nach dem Einrichten Ihres Synchronisierungsprofils zu automatisieren, können Sie das SDS-Toolkit installieren. Dieses Tool hilft Ihnen beim Erstellen eines automatisierten Synchronisierungszeitplans zwischen OneRoster-CSV-Dateien und Office 365 und kann auch zum Überprüfen der CSV-Dateidaten verwendet werden. Weitere Informationen finden Sie unter Installieren des Microsoft School Data Sync Toolkits.
Video: Abgleichen von Quell- und Zielattributen für die Synchronisierung
Verschiedene Beispiele für erfolgreiche und fehlerhafte Übereinstimmungslogik für die Synchronisierung watch das Video zum Identitätsabgleich:
Verwandte Themen
Bereitstellen von SDS mithilfe von CSV-Dateien im CSV v2.1-Format
Bereitstellen von SDS mithilfe von CSV-Dateien im CSV V1-Format
Bereitstellen von SDS mithilfe von CSV-Dateien im CSV V2-Format
Bereitstellen von SDS mithilfe von CSV-Dateien im Clever-Format