Bereitstellen von School Data Sync mithilfe von CSV-DateienHow to deploy School Data Sync by using CSV files

Sie können CSV-Dateien (Comma Separated Value) mit School Data Sync (SDS) verwenden, um Ihre SIS-Daten (Student Information System) in Office 365 zu importieren und zu synchronisieren.You can use Comma Separated Value (CSV) files with School Data Sync (SDS) to import and synchronize your Student Information System (SIS) data to Office 365. SDS kann Schüler, Lehrer, Schulen, Abschnitte und Dienstplan Informationen aus Ihrem SIS mit Azure Active Directory und Office 365 synchronisieren.SDS can sync students, teachers, schools, sections, and roster information from your SIS to Azure Active Directory and Office 365. Mit dieser Methode exportieren oder erstellen Sie CSV- Dateien für School Data Sync aus ihren SIS-Daten, richten ein Synchronisierungsprofil ein und laden das csvs in SDS zur Verarbeitung hoch.Using this method, you will export or create CSV files for School Data Sync from your SIS data, set up a synchronization profile, and upload the CSVs into SDS for processing.

Inhalt dieses Themas:In this topic:

Bevor Sie loslegenBefore you get started

Bevor Sie mit der Synchronisierung mit SDS mithilfe der CSV-Import Methode beginnen, lesen Sie die Übersicht über School Data Sync.Before you start synchronizing with SDS using the CSV Import method, read the Overview of School Data Sync.

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:Make sure you meet the following prerequisites:

  • Ein Office 365 für Education-MandantenAn Office 365 for Education tenant

  • Globales Admininstrator-KontoGlobal Admininstrator Account

  • School Data Sync (Plan 1) aktiviertSchool Data Sync (Plan 1) enabled

Hinweis

Die Daten, die Sie über School Data Sync bereitstellen, sind möglicherweise über ihre Apps für Drittanbieter-Anwendungsanbieter zugänglich, daher sollten Sie nur die Daten synchronisieren, die Sie diesen Drittanbietern zur Verfügung stellen möchten.The data that you provide through School Data Sync may be accessible to third-party application providers through their apps, so you should sync only the data that you want to make available to these third parties.

Erstellen eines Synchronisierungsprofils und Importieren der CSV-DateienCreate a Sync Profile and Import your CSV files

Video ansehen: Bereitstellen der School Data SyncWatch the video: Deploy School Data Sync

Stellen Sie sicher, dass Sie Ihre sechs CSV-Dateien erstellt haben und Sie bereit sind zu verwenden.Make sure you've created your six CSV files and they're ready to use. Führen Sie dann die folgenden Schritte aus, um die Dateien zu importieren und Ihr Synchronisierungsprofil zu erstellen.Then follow these steps to import the files and create your sync profile. Ein Synchronisierungsprofil ist nur eine Gruppe von Optionen und Einstellungen, die von SDS zum Synchronisieren der CSV-Daten verwendet werden, die Sie hochladen möchten.A sync profile is just a group of options and settings used by SDS to sync the CSV data which you plan to upload. Sie können mehrere Synchronisierungsprofile in einem einzelnen Office 365 Mandanten erstellen.You can create multiple sync profiles within a single Office 365 tenant.

SDS-Zugriff und erstmalige AnmeldungSDS Access and First Time Login

  1. Um auf das Administrator Portal School Data Sync zuzugreifen, starten Sie einen privaten Webbrowser, navigieren Sie zu SDS.Microsoft.com, klicken Sie auf anmelden, und geben Sie Ihre Anmeldeinformationen für das globale O365-Administratorkonto ein.To access the School Data Sync Admin Portal launch a private web browser, navigate to sds.microsoft.com, click Sign-In, then enter your O365 Global Admin account credentials.

Erstellen eines Synchronisierungsprofils und Hochladen der CSV-DateienCreate a Sync Profile and Upload your CSV Files

  1. Nachdem Sie sich angemeldet haben, klicken Sie + im linken Navigationsbereich auf Profil hinzufügen , um ein Synchronisierungsprofil zu erstellen.After logging in, click + Add Profile in the left hand navigation pane to create a Sync Profile.

how-to-deploy-SDS-using-CSV-files.PNG

  1. Füllen Sie auf der Seite Verbindungstyp auswählen das Formular nach Bedarf aus.On the Choose Connection Type page, complete the form as appropriate. Klicken Sie nach Abschluss des Vorgangs auf Start.Once complete, click Start.

how-to-deploy-SDS-using-CSV-files-1.PNG

  • Name dieses Profils – geben Sie einen Namen für Ihr Synchronisierungsprofil ein.Name this profile - Enter a name for your sync profile. Dieser Name wird verwendet, um das Synchronisierungsprofil im SDS-Dashboard zu identifizieren, und kann nicht mehr geändert werden, nachdem die Profileinrichtung abgeschlossen ist.This name will be used to identify the sync profile in the SDS Dashboard, and cannot be changed once the profile setup is complete.

  • Wählen Sie Ihre Sync-Methode – wählen Sie zwischen den beiden angezeigten Synchronisierungsmethoden CSV oder API aus.Choose your sync method - Choose between the 2 available sync methods shown, CSV or API. Wenn Sie die Synchronisierung mit CSV-Dateien durchführen, wählen Sie CSV aus, und wählen Sie dann die Option für das SDS-Format aus.If you're syncing using CSV files, select CSV, then select the option for the SDS format.

  1. Wählen Sie auf der Seite Synchronisierungsoptionen die entsprechende Option zum Erstellen neuer Benutzer oder zum Synchronisieren vorhandener Benutzer aus.On the Sync Options page, select the appropriate option to create new users or sync existing users. Klicken Sie dann auf Dateien hochladen, um Ihre 6 CSV-Dateien hochzuladen.Then click upload files to upload your 6 CSV files. Nachdem Sie hochgeladen haben, müssen Sie Ihre Auswahl auf der Seite entsprechend abschließen.Once uploaded, complete your selections on the page as appropriate.

how-to-deploy-SDS-using-CSV-files-2.PNG

  • Vorhandene Benutzer : Wählen Sie diese Option aus, wenn Sie bereits über Benutzerkonten verfügen, die in Ihrem O365-Mandanten für jeden der in ihren CSV-Dateien enthaltenen Schüler und Lehrer erstellt wurden.Existing Users - Select this option if you already have user accounts created within your O365 tenant for each of the students and teachers contained within your CSV files.

  • Neue Benutzer : Wählen Sie diese Option aus, wenn SDS Benutzerkonten für jeden Schüler und Lehrer erstellen soll, der in ihren CSV-Dateien enthalten ist.New Users - Select this option if you want SDS to create user accounts for each of your students and teachers contained within your CSV files.

  • Schaltfläche "Dateien hochladen" – klicken Sie auf diese Schaltfläche, um Ihre 6 CSV-Dateien hochzuladen.Upload Files button - Click this button to upload your 6 CSV files. Beim Hochladen von SDS werden einige kurze Validierungstests durchgeführt, um sicherzustellen, dass die Dateien ordnungsgemäß formatiert sind.Upon upload SDS will perform some brief validation tests to ensure the files are formatted correctly. Wenn die Überprüfung erfolgreich verläuft, werden Ihre Dateien in das Synchronisierungsprofil hochgeladen.If the validation passes, your files will be uploaded into the sync profile.

  • Schul Eigenschaften – nach dem Hochladen der CSV-Dateien werden die in Ihrem School.csv enthaltenen Attribute automatisch ausgewählt.School properties - After uploading your CSV files, the attributes contained within your School.csv will be auto- selected. Sie sollten überprüfen, ob die hier ausgewählten Attribute dieselben Attribute sind, die in ihrer School.csv enthalten sind.You should validate the attributes selected here are the same attributes contained in your School.csv

  • Abschnittseigenschaften : nach dem Hochladen der CSV-Dateien werden die in Ihrem Student.csv enthaltenen Attribute automatisch ausgewählt.Section Properties - After uploading your CSV files, the attributes contained within your Student.csv will be auto-selected. Sie sollten überprüfen, ob die hier ausgewählten Attribute dieselben Attribute sind, die in ihrer School.csv enthalten sind.You should validate the attributes selected here are the same attributes contained in your School.csv

  • Team Erstellungs Option – durch Aktivieren dieses Kontrollkästchens wird sichergestellt, dass SDS sowohl die M365-Gruppe als auch das Klassen Team für jede synchronisierte Klasse erstellt.Team Creation Option – Checking this box will ensure SDS creates both the M365 Group and Class Team for each class synced. Wenn Sie das Kontrollkästchen deaktiviert lassen, erstellt SDS nur die M365-Gruppen.If you leave the box unchecked, SDS will only create the M365 Groups.

  • Nicht unterstützte Sonderzeichen ersetzen– durch das Aktivieren dieses Kontrollkästchens kann SDS beim Ausführen der Synchronisierung automatisch nicht unterstützte Sonderzeichen ersetzen.Replace unsupported special characters- Checking this box will allow SDS to automatically replace unsupported special characters while the sync is running. Sonderzeichen werden durch ein "" ersetzt und führen nicht mehr zu einem Fehler während des Synchronisierungsprozesses für dieses Objekt.Special characters will be replaced with an "", and no longer result in an error during the sync process for that object.

  • Synchronisierungsoption für Abschnittsgruppen Anzeigename – durch das Aktivieren dieses Kontrollkästchens können Lehrer den Abschnitt Anzeigenamen nach der ersten Synchronisierung steuern und SDS daran hindern, Änderungen durch den Abschnitt DisplayName zu überschreiben, die von Lehrern vorgenommen wurden.Sync option for Section Group Display Name - Checking this box will allow teachers to control the section display name after the first sync, and prevent SDS from overwriting Section DisplayName changes made by teachers.

  • Studenten Zugriff verzögern – durch Aktivieren dieser Option können Sie ein zukünftiges Datum für Schüler festlegen, um Ihre Klassen anzuzeigen.Delay Student Access - Enabling this option will allow you to set a future date for students to view their classes. Deaktivieren Sie diese Option, um Teilnehmern die Möglichkeit zu geben, Ihre Klassen sofort anzuzeigen.Disable this option to allow students view their classes immediately.

  • Wann sollten wir die Synchronisierung beenden?When should we stop syncing? -Normalerweise möchten Sie dies am Ende des Schuljahres tun.- You will typically want to do this at the end of the school year. Wenn die Synchronisierung dieses Profils nicht mehr möglich ist, können Sie die mit diesem Profil verknüpften Klassen zurückziehen.Once we stop syncing this profile, you will have the option to retire the classes associated with this profile.

  1. Wählen Sie auf der Seite Lehrer Optionen die entsprechenden Optionen für den Identitäts Abgleich aus, bestätigen Sie, dass die Lehrer Eigenschaften ausgewählt sind, und klicken Sie dann auf weiter.On the Teacher options page, select the appropriate identity matching options, confirm the teacher properties are selected, then click Next.

SDS prüft, ob Sie Attribute und Optionen im richtigen Format auswählen.SDS will check to ensure you're selecting attributes and options within the correct format. Wenn Sie beispielsweise einer userPrincipalName entsprechen, müssen Sie ein Quellverzeichnis Attribut auswählen, das im Format eines userPrincipalName (prefix@Domain.com) liegt, oder Sie müssen eine Domäne an das Quellverzeichnis Attribut anfügen, um eine ordnungsgemäße Formatierung sicherzustellen.If matching a UserPrincipalName for example, you must select a source directory attribute which is in the format of a UserPrincipalName (prefix@domain.com) or you must choose to append a domain to the source directory attribute to ensure proper formatting. Wenn Ihre Auswahl nicht das richtige Format aufweist, um eine Übereinstimmung abzuschließen, wird auf der Seite ein roter Fehler angezeigt.If your selections are not in the proper format to complete a match, you'll see a red error displayed on the page.

how-to-deploy-SDS-using-CSV-files-3.PNG

  • Primärschlüssel (Quellverzeichnis) : Dies ist das Teacher-Attribut in der CSV-Datei, die für die SDS-Identitäts Übereinstimmung verwendet wird.Primary Key (Source Directory) - This is the Teacher attribute in the CSV file used for SDS Identity Matching. Sehen Sie sich das Identitäts Übereinstimmungs Video an, um weitere Informationen zum Auswählen des entsprechenden Quellverzeichnis Attributs zu erhalten und die Identitäts Übereinstimmungs Einstellungen für Lehrer ordnungsgemäß zu konfigurieren.Watch the Identity Matching video for additional information on how to select the appropriate source directory attribute, and properly configure the identity matching settings for teacher.

  • Primärschlüssel (Zielverzeichnis) : Dies ist das Benutzerattribut in Azure AD, das für die SDS-Identitäts Übereinstimmung verwendet wird.Primary Key (Target Directory) - This is the User attribute in Azure AD used for SDS Identity Matching. Sehen Sie sich das Identitäts Übereinstimmungs Video an, um weitere Informationen zum Auswählen des entsprechenden Zielverzeichnis Attributs zu erhalten und die Identitäts Übereinstimmungs Einstellungen für den Lehrer ordnungsgemäß zu konfigurieren.Watch the Identity Matching video for additional information on how to select the appropriate target directory attribute, and properly configure the identity matching settings for the teacher.

  • Domain (optional) : Dies ist ein optionaler Domänenwert, den Sie dem ausgewählten Quellverzeichnis Attribut hinzufügen können, um den Lehrer Identitäts Abgleich abzuschließen.Domain (optional) - This is an optional domain value that you can add to the selected Source Directory attribute to complete your Teacher Identity Matching. Wenn Sie mit einem userPrincipalName-oder Mail-Attribut übereinstimmen müssen, müssen Sie eine Domäne in der Zeichenfolge enthalten.If you need to match to a UserPrincipalName or Mail attribute, you must have a domain included in the string. Das Source-Attribut muss entweder die Domäne bereits enthalten, oder Sie können die entsprechende Domäne mithilfe dieses Dropdownmenüs an das Source-Attribut anfügen.Your source attribute must either include the domain already or you can append the appropriate domain to the source attribute using this dropdown menu.

  1. Wählen Sie auf der Seite Kursteilnehmer Optionen die entsprechenden Optionen für den Identitäts Abgleich aus, bestätigen Sie, dass die Kursteilnehmer Eigenschaften ausgewählt sind, und klicken Sie dann auf weiter.On the Student options page, select the appropriate identity matching options, confirm the student properties are selected, and then click Next. SDS prüft, ob Sie Attribute und Optionen im richtigen Format auswählen.SDS will check to ensure you're selecting attributes and options within the correct format. Wenn Sie beispielsweise einer userPrincipalName entsprechen, müssen Sie das Quellverzeichnis Attribut auswählen, das im Format eines userPrincipalName (prefix@Domain.com) liegt, oder Sie müssen eine Domäne an das Quellverzeichnis Attribut anfügen, um eine ordnungsgemäße Formatierung sicherzustellen.If matching a UserPrincipalName for example, you must selecta source directory attribute which is in the format of a UserPrincipalName (prefix@domain.com) or you must choose to append a domain to the source directory attribute to ensure proper formatting. Wenn Ihre Auswahl nicht das richtige Format aufweist, um eine Übereinstimmung abzuschließen, wird auf der Seite ein roter Fehler angezeigt.If your selections are not in the proper format to complete a match, you'll see a red error displayed on the page.

how-to-deploy-SDS-using-CSV-files-4.PNG

  • Primärschlüssel (Quellverzeichnis) : Dies ist das Student-Attribut in der CSV-Datei, die für die SDS-Identitäts Übereinstimmung verwendet wird.Primary Key (Source Directory) - This is the Student attribute in the CSV file used for SDS Identity Matching. Sehen Sie sich das Identitäts Übereinstimmungs Video an, um weitere Informationen zum Auswählen des entsprechenden Quellverzeichnis Attributs zu erhalten und die Identitäts Übereinstimmungs Einstellungen für Lehrer ordnungsgemäß zu konfigurieren.Watch the Identity Matching video for additional information on how to select the appropriate source directory attribute, and properly configure the identity matching settings for teacher.

  • Primärschlüssel (Zielverzeichnis) : Dies ist das Benutzerattribut in Azure AD, das für die SDS-Identitäts Übereinstimmung verwendet wird.Primary Key (Target Directory) - This is the User attribute in Azure AD used for SDS Identity Matching. Sehen Sie sich das Identitäts Übereinstimmungs Video an, um weitere Informationen zum Auswählen des entsprechenden Zielverzeichnis Attributs zu erhalten und die Identitäts Übereinstimmungs Einstellungen für den Kursteilnehmer ordnungsgemäß zu konfigurieren.Watch the Identity Matching video for additional information on how to select the appropriate target directory attribute, and properly configure the identity matching settings for the student.

  • Domain (optional) – Dies ist ein optionaler Domänenwert, den Sie dem ausgewählten Quellverzeichnis Attribut hinzufügen können, um den Kursteilnehmer-Identitäts Abgleich abzuschließen.Domain (optional) - This is an optional domain value that you can add to the selected Source Directory attribute to complete your Student Identity Matching. Wenn Sie mit einem userPrincipalName-oder Mail-Attribut übereinstimmen müssen, müssen Sie eine Domäne in der Zeichenfolge enthalten.If you need to match to a UserPrincipalName or Mail attribute, you must have a domain included in the string. Das Source-Attribut muss entweder die Domäne bereits enthalten, oder Sie können die entsprechende Domäne mithilfe dieses Dropdownmenüs an das Source-Attribut anfügen.Your source attribute must either include the domain already or you can append the appropriate domain to the source attribute using this dropdown menu.

  1. Stellen Sie auf der Seite Überprüfung sicher, dass Sie die entsprechenden Auswahl getroffen haben.On the Review page, ensure you've made the appropriate selections. Wenn keine weiteren Änderungen erforderlich sind, klicken Sie auf Profil erstellen.If no additional changes are needed, click Create Profile. Nachdem Sie ein Synchronisierungsprofil erstellt haben, startet SDS einen Validierungsprozess vor der Synchronisierung.Once you create a sync profile, SDS will begin a pre-sync validation process. Während dieses Prozesses stellt SDS sicher, dass keine offensichtlichen Fehler mit ihren CSV-Dateien vorliegen.During this process, SDS will ensure there are no obvious errors with your CSV files. Wenn während der Überprüfung vor der Synchronisierung Fehler gefunden werden, haben Sie die Möglichkeit, diese zu beheben und die Dateien erneut hochzuladen, bevor Sie auf die Schaltfläche Synchronisierung fortsetzen klicken und mit dem tatsächlichen Synchronisierungsprozess beginnen.If any errors are found during the pre-sync validation process, you will have the option to fix them and re-upload the files before clicking the resume sync button and begin the real synchronization process. Wenn Fehler angezeigt werden und Sie Sie nicht aktualisieren möchten, können Sie weiterhin die Synchronisierung fortsetzen, ohne die Fehler zu beheben.If you receive errors and choose not to update them, you can still choose to resume sync without fixing the errors. Beachten Sie, dass SDS nur bis zu 15.000 Fehler aufrecht erhalten kann, bevor das Profil in den Quarantänestatus eingeht.Just be aware that SDS can only sustain up to 15,000 errors before the profile will enter a quarantine status. how-to-deploy-SDS-using-CSV-files-5.PNGhow-to-deploy-SDS-using-CSV-files-5.PNG

Zur Unterstützung der Automatisierung des Synchronisierungsprozesses nach dem Einrichten Ihres Synchronisierungsprofils können Sie Microsoft Flow zum Hochladen von CSV-Dateien in SDS verwenden.To help automate the sync process after setting up your sync profile, you can Use Microsoft Flow to upload CSV files to SDS. Auf diese Weise können Sie den gesamten Uploadprozess über die Benutzeroberfläche in der Cloud verwalten, was wesentlich einfacher zu handhaben ist als PowerShell-Skripts.This enables you manage the entire upload process via UI in the cloud, which is much simpler to use than PowerShell scripts.

Video: Abgleichen von Quell-und Zielattributen für die SynchronisierungVideo: How to match source and target attributes for sync

Verschiedene Beispiele für die Übereinstimmung von Logik Erfolg und Fehler bei der Synchronisierung finden Sie im Video zur Identitäts Übereinstimmung:For various examples of matching logic success and failure for sync, watch the Identity Matching video:


##Verwandte Themen

Übersicht über School Data SyncOverview of School Data Sync

CSV-Dateien für School Data SyncCSV files for School Data Sync

Bereitstellen von School Data Sync mithilfe von PowerSchool SyncHow to deploy School Data Sync by using PowerSchool Sync

Vorgehensweise Bereitstellen von School Data Sync mithilfe von CSV-Dateien im clever-FormatHow to deploy School Data Sync by using CSV files in the Clever format

Bereitstellen von School Data Sync mithilfe von CSV-Dateien im OneRoster-FormatHow to deploy School Data Sync by using OneRoster CSV files

SDS-FehlerSDS Errors

SDS-ProblembehandlungSDS Troubleshooting

SDS-CSV-Datei ÜberprüfungsprozessSDS CSV File Validation Process