Clever Format CSV-Dateien für SDSClever format CSV files for SDS

Sie können CSV-Dateien (Comma Separated Value) im clever-Format verwenden, um Ihr School Information System (SIS) mit Office 365 zu synchronisieren.You can use CSV (comma separated value) files in the Clever format to synchronize your School Information System (SIS) with Office 365. Bei Verwendung von CSV-Dateien mit cleverem Format für School Data Sync müssen die Dateien entsprechend formatiert sein.When using Clever format CSV Files for School Data Sync, the files must be appropriately formatted. In diesem Abschnitt werden die Formatierungsanforderungen für die Verwendung mit SDS beschrieben.This section describes the formatting requirements for use with SDS. In diesem Abschnitt werden die Formatierungsanforderungen für die Verwendung mit SDS beschrieben.This section describes the formatting requirements for use with SDS. Die einzigen absolut erforderlichen Felder werden unten grün hervorgehoben.The only absolutely required fields are highlighted in green below. Dies knüpft auch an die Beispiel Informationen auf unserer CSV-Datei Samples -Seite an.This also ties over to the example information on our CSV File Samples page. Die folgenden 5 CSV-Dateien müssen genau so benannt sein wie unten beschrieben.You must have the following 5 CSV files named exactly as detailed below. Die admins.csv wird für die Verwendung in SDS nicht akzeptiert.The admins.csv is not accepted for use in SDS.

Wichtig

Die von uns akzeptierten CSV-Dateien und die exportierten CSV-Standarddateien weisen einige Unterschiede auf.The CSV files that we accept and the default CSV files exported have some differences. Um diese CSV-Dateien hochzuladen und erfolgreich zu synchronisieren, müssen Sie das hier aufgeführte Format befolgen.In order to upload these CSV files and sync successfully, they must follow the format listed here. Weitere Informationen finden Sie unten auf dieser Seite.More information can be located at the bottom of this page.

students.csvstudents.csv

teachers.csvteachers.csv

schools.csvschools.csv

sections.csvsections.csv

enrollments.csvenrollments.csv

Clever-format-CSV-files-for-SDS-1.png

Jede CSV-Datei muss alle erforderlichen Felder enthalten, die unten grün hervorgehoben sind.Each CSV file must contain all required fields highlighted in green below. Jede CSV-Datei kann auch eines der optionalen Felder enthalten, die ebenfalls aufgeführt sind.Each CSV file may also contain any of the optional fields listed as well. Wenn Ihre CSV-Dateien nicht unterstützte Zeichen enthalten, können Sie während der Synchronisierung Inline ersetzt werden, indem Sie im SDS Sync profile Setup Wizard die Option "nicht unterstützte Sonderzeichen ersetzen" auswählen.If your CSV files contain any unsupported characters, they can be replaced inline during sync by selecting the "Replace Unsupported Special Characters" option within the SDS Sync Profile Setup Wizard. Dadurch werden "Leerzeichen" jedoch nicht entfernt, die ebenfalls ungültig sind.This however will not remove "white spaces" which are also not valid. In den folgenden Tabellen werden die erforderlichen und optionalen Attribute für eine Datei nach Dateibasis aufgelistet:The tables below list the required and optional attributes on a file by file basis:

Hinweis

Microsoft empfiehlt die Verwendung des ISO 8601-Formats für alle Datumsfelder in den SDS-CSV-Dateien in Form von yyyy-mm-dd oder JJJJMMTT.Microsoft recommends using the ISO 8601 format for all dates fields in the SDS CSV files, in the form of YYYY-MM-DD or YYYYMMDD. SDS plant die Einführung von Features in den kommenden Monaten, in denen dieses Format innerhalb der unten aufgeführten Semester Start-und Enddatums Felder erforderlich ist.SDS is planning to introduce features in coming months which will require this format within the Term Start and End Date fields noted below.

  • Students.csv > GeburtsdatumStudents.csv > Birthdate
  • Sections.csv > Term StartDateSections.csv > Term StartDate
  • Sections.csv > Term EndDateSections.csv > Term EndDate

Clever-format-CSV-files-for-SDS-updated-2.png

Clever-format-CSV-files-for-SDS-4.png

Hinweis

Wenn Sie Sync to Insights – Preview verwenden und Notenwerte für Schüler und/oder Lehrer übergeben möchten, müssen Sie die richtige Enumverwenden.If you are using Sync to Insights – Preview and you wish to pass grade values for Student and/ or Teachers, you must use the correct ENUM. Wenn Sie nicht die richtige Enum verwenden, wird eine Fehlermeldung angezeigt.If you do not use the correct ENUM, you will receive an error. Weitere Informationen finden Sie unter SDS Errors.For more information, please see SDS Errors.

Clever-format-CSV-files-for-SDS-3.png

Clever-format-CSV-files-for-SDS-5.png

Clever-format-CSV-files-for-SDS-6.png

Unterschiede zwischen standardmäßigen CSV-Dateien mit cleverem Format und von SDS akzeptiertDifferences between default Clever format CSV files and those accepted by SDS

Es gibt einige discrepencies zwischen den cleveren CSV-Dateien, die von SDS akzeptiert werden, und den von Clever exportierten Standard CSV-Dateien, die zu Verwirrung führen können.There are some discrepencies between the Clever CSV files accepted by SDS and the default CSV files exported by Clever that may cause some confusion. Die größten Unterschiede sind die Spalten für username und Password in der Student.csv Datei.The largest differences are the columns for Username and Password in the Student.csv file.

Das Feld Username ist in erster Linie für die Übereinstimmungskriterien bei der Profilerstellung erforderlich.The Username field is required primarily for the matching criteria during profile creation. Dies kann in Schritt 5 auf der Seite " How to deploy with Smart Format CSV Files " angezeigt werden.This can be viewed on step 5 on the How to deploy with Clever format CSV files page.

Die Spalte username wird zusammen mit der Spalte Password beim Erstellen von brandneuen Benutzern für ein Profil verwendet.The Username column, along with the Password column, are used when creating brand new users for a profile.

Die anderen Unterschiede sind optionale synchronisierte Attribute.The other differences are optional synced attributes. SDS synchronisiert nur Erweiterungsattribute auf relevante-Gruppen und-Benutzer, die oben aufgeführt sind.SDS will only sync extension attributes onto relevent groups and users that are listed above. Wenn eine dieser Dateien zusätzliche Informationen enthält, wird die Synchronisierung weiterhin verarbeitet, aber die zusätzlichen Informationen werden nicht an den Benutzer oder die Gruppe gebunden.If any of these files contain additional information, the sync will still process but the additional information will not be tied to the user or group. Dies ist das erwartete Verhalten und gilt für alle synchronisierten CSV-Profile.This is expected behavior and is true for all CSV profile syncs.

Beispiel: Wenn eine student.csv Datei mit der Spalte "Gender" hochgeladen wurde, wie in der cleveren Dokumentation festgelegt, verarbeitet SDS die Datei weiterhin und synchronisiert die zusätzlichen Attribute auf die angestrebten Kursteilnehmer, aber es wird kein Attribut für das Geschlecht synchronisiert.Example: If a student.csv file was uploaded with the "Gender" column as stipulated in the Clever documentation, SDS will still process the file and sync the additional attributes onto the targetted students but there will not be an attribute synced for Gender.