SDS V1 CSV-Dateiformat
Wichtig
SDS (klassisch) TRANSITION CUSTOMERS: Nicht alle Felder werden unterstützt, um Daten basierend auf dem v1-Format in die neue SDS-Benutzeroberfläche zu übertragen. Sie finden sie unter SDS v1 CSV-Dateiformat in der Spalte Erforderlich? als daten nicht unterstützt.
Wichtig
Außerdem müssen die übergebenen Benotungswerte und Kursfachwerte an den entsprechenden ENUM-Codes (List of Values) ausgerichtet sein. Verwenden Sie bei Bedarf Verwalten der Werteliste , um Notenwerte und Kursbetreff zu erweitern, um Codewerte zu unterstützen, die standardmäßig nicht unterstützt werden.
Sie können CSV-Dateien (durch Trennzeichen getrennte Werte) im SDS V1-Format verwenden, um Ihr Schulinformationssystem (SIS) mit Office 365 zu synchronisieren. Die Verwendung des SDS V1-CSV-Dateiformats zum Erfassen der folgenden Datenkategorien ermöglicht Es Ihnen, die wichtigsten SDS-Funktionen für die Bereitstellung zu erweitern. Es hilft Ihnen auch, die Erfahrungen für die Microsoft 365-Produkte und -Features zu verbessern.
Wenn Sie das SDS V1-Format verwenden, müssen die Dateien entsprechend formatiert sein. Laden Sie die Dateien hoch, die genau wie unten beschrieben benannt sind. Bei Spaltenüberschriften wird die Groß-/Kleinschreibung beachtet. CSV-Dateien müssen im UTF-8-Format und RFC-kompatibel sein. Außerdem akzeptieren wir keine Zeilenumbrüche in eingehenden Daten. Informationen zum Überprüfen und Herunterladen eines Beispielsatzes von SDS V1-CSV-Dateien finden Sie im SDS-GitHub-Repository.
Wichtig
Nach dem ersten Upload während der Erstellung Ihres eingehenden Datenflusses müssen Sie immer denselben Satz von Dateien für nachfolgende Uploads bereitstellen, unabhängig von Datenänderungen, die in den optionalen Dateien vorgenommen wurden oder nicht. Wenn Sie dies nicht tun, ermittelt das System, dass die Datensätze nicht mehr aktiv sind, und markiert sie als solche.
Erforderlich: Die drei unten aufgeführten Dateien müssen ausgewählt werden, bevor Sie den Vorgang ausführen können. Wenn Sie nur Benutzer und keine Klassen verwalten, müssen Sie nur diese Dateien bereitstellen.
school.csv
student.csv
teacher.csv
Optional/Erforderlich: Nicht erforderlich, wenn Sie nur Benutzer verwalten. Wenn Sie auch Klassen und Klassenregistrierungen verwalten, müssen Sie die drei unten aufgeführten Dateien zusammen mit den drei oben aufgeführten Dateien bereitstellen. Wenn Sie dies nicht getan haben, wählen Sie keine Dateien mit diesen Namen aus.
section.csv
studentenrollment.csv
teacherroster.csv
Optional: Diese sind nicht erforderlich, um fortzufahren, können aber die Benutzerfreundlichkeit verbessern. Wenn eine der folgenden Dateien ausgewählt ist, muss auch die andere ausgewählt werden, um fortzufahren.
user.csv
guardianrelationship.csv (Erfordert benutzer- und kursteilnehmerdatensatz zum Erstellen einer Kontaktzuordnung.)
Jede CSV-Datei muss Daten für die Felder enthalten, die unter "Erforderlich" mit "Ja" angegeben sind. Die felder mit "Nein" sind "Optional"-Daten. Die als "Erforderlich" gekennzeichneten Feldüberschriften müssen in den angegebenen Dateien vorhanden sein, andernfalls werden sie nicht akzeptiert. Die als "Optional" markierten Feldüberschriften müssen nicht in den Dateien vorhanden sein, wenn die entsprechenden optionalen Daten nicht übergeben werden.
Die Felder mit definierten Aufzählungswerten, die in der Spalte "Datentypen" markiert sind, verfügen über einen bestimmten Satz von Werten, die sie unterstützen. Die unterstützten Standardwerte für Enumerationsfelder finden Sie unter Standardliste der Werte.
school.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| SIS-ID | Ja | 456789 | Eindeutige ID |
| Name | Ja | Contoso High School | Zeichenfolge |
| NCES-ID der Schule | Nein | 456789 | Zeichenfolge |
| Schulnummer | Daten werden nicht unterstützt | ||
| Untere Klasse | Daten werden nicht unterstützt | ||
| Höhere Klasse | Daten werden nicht unterstützt | ||
| Bundesstaat-ID | Daten werden nicht unterstützt | ||
| SIS-ID des Schulleiters | Daten werden nicht unterstützt | ||
| Name des Schulleiters | Daten werden nicht unterstützt | ||
| Zweite E-Mail-Adresse des Schulleiters | Daten werden nicht unterstützt | ||
| Adresse | Daten werden nicht unterstützt | ||
| Stadt | Daten werden nicht unterstützt | ||
| State | Daten werden nicht unterstützt | ||
| Zip | Daten werden nicht unterstützt | ||
| Land | Daten werden nicht unterstützt | ||
| Telefon | Daten werden nicht unterstützt | ||
| Zone | Daten werden nicht unterstützt |
- Alle aufgeführten Organisationen werden auf den organization Typ "Schule" festgelegt.
student.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| SIS-ID | Ja | 123456 | Eindeutige ID |
| SCHUL-SIS-ID | Ja | 456789 | Eindeutige ID |
| Benutzername | Ja | jsmith@contoso.edu | Zeichenfolge |
| Vorname | Ja (nur beim Erstellen von Benutzern) | John | Zeichenfolge |
| Nachname | Ja (nur beim Erstellen von Benutzern) | Smith | Zeichenfolge |
| Zweiter Vorname | Nein | William | Zeichenfolge |
| Zweite E-Mail-Adresse | Nein | jsmith@contoso.edu | E-Mails |
| Schülernummer | Nein | 123456 | Zeichenfolge |
| Klasse | Nein | 8 | Enum |
| Geburtsdatum | Nein | 2009-12-19 | Datum |
| Status | Daten werden nicht unterstützt | ||
| Kennwort | Daten werden nicht unterstützt | ||
| Abschlussjahr | Daten werden nicht unterstützt | ||
| Bundesstaat-ID | Daten werden nicht unterstützt |
- Erfordert einen Verweis auf die zugeordnete Schule mithilfe des Felds "Schul-SIS-ID". Dadurch entsteht eine Abhängigkeit von der school.csv-Datei.
- Alle aufgeführten Benutzer werden auf den Rollentyp "Student" festgelegt.
- Es wird erwartet, dass Datumswerte in ISO8601 Format angegeben werden.
teacher.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| SIS-ID | Ja | 654321 | Eindeutige ID |
| SCHUL-SIS-ID | Ja | 456789 | Eindeutige ID |
| Benutzername | Ja | jcook@contoso.edu | Zeichenfolge |
| Vorname | Ja (nur beim Erstellen von Benutzern) | Jane | Zeichenfolge |
| Nachname | Ja (nur beim Erstellen von Benutzern) | Kochen | Zeichenfolge |
| Zweiter Vorname | Nein | Meredith | Zeichenfolge |
| Lehrernummer | Nein | 654321 | Zeichenfolge |
| Klasse | Nein | 8 | Enum |
| Zweite E-Mail-Adresse | Nein | jcook@contoso.edu | E-Mails |
| Status | Daten werden nicht unterstützt | ||
| Kennwort | Daten werden nicht unterstützt | ||
| Position | Daten werden nicht unterstützt | ||
| Bundesstaat-ID | Daten werden nicht unterstützt | ||
| Qualifikation | Daten werden nicht unterstützt |
- Erfordert einen Verweis auf die zugeordnete Schule mithilfe des Felds "Schul-SIS-ID". Dadurch entsteht eine Abhängigkeit von der school.csv-Datei.
- Alle aufgeführten Benutzer werden auf den Rollentyp "teacher" festgelegt.
section.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| SIS-ID | Ja | 334455 | Eindeutige ID |
| SCHUL-SIS-ID | Ja | 456789 | Eindeutige ID |
| Abschnittsname | Ja | Periode 1 - Weltgeschichte | Zeichenfolge |
| Bereichsnummer | Nein | 334466 | Zeichenfolge |
| Kurs-SIS-ID | Nein | 123456789 | Eindeutige ID |
| Kursname | Nein | Weltgeschichte 10 | Zeichenfolge |
| Kursnummer | Nein | 123456789 | Zeichenfolge |
| Kursbeschreibung | Nein | Geschichte der Welt | Zeichenfolge |
| Kursbetreff | Nein | 54999 | Enum |
| Semester-SIS-ID | Daten werden nicht unterstützt | ||
| Semestername | Daten werden nicht unterstützt | ||
| Semester-Startdatum | Daten werden nicht unterstützt | ||
| Semester-Enddatum | Daten werden nicht unterstützt | ||
| Status | Daten werden nicht unterstützt | ||
| Zeiten | Daten werden nicht unterstützt |
- Erfordert einen Verweis auf die zugeordnete Schule mithilfe des Felds "Schul-SIS-ID". Dadurch entsteht eine Abhängigkeit von der school.csv-Datei.
- Wenn Term-Informationen erforderlich sind, empfehlen Sie, in das SDS v2.1-CSV-Format zu wechseln und auch academicSessions.csv-Datei bereitzustellen.
studentenrollment.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| Abschnitt SIS-ID | Ja | 334455 | Eindeutige ID |
| SIS-ID | Ja | 123456 | Eindeutige ID |
- Dies erfordert einen Verweis auf den zugeordneten Abschnitt mithilfe des Felds "Abschnitts-SIS-ID". Dadurch entsteht eine Abhängigkeit von der section.csv-Datei.
- Dies erfordert einen Verweis auf den zugeordneten Benutzer, der das Feld "SIS-ID" verwendet. Dadurch entsteht eine Abhängigkeit von der student.csv-Datei.
teacherroster.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| Abschnitt SIS-ID | Ja | 334455 | Eindeutige ID |
| SIS-ID | Ja | 654321 | Eindeutige ID |
- Dies erfordert einen Verweis auf den zugeordneten Abschnitt mithilfe des Felds "Abschnitts-SIS-ID". Dadurch entsteht eine Abhängigkeit von der section.csv-Datei.
- Dies erfordert einen Verweis auf den zugeordneten Benutzer, der das Feld "SIS-ID" verwendet. Dadurch entsteht eine Abhängigkeit von der teacher.csv-Datei.
user.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| E-Mails | Ja | jsmith@outlook.com | E-Mails |
| Vorname | Ja | John | Zeichenfolge |
| Nachname | Ja | Smith | Zeichenfolge |
| Telefon | Nein | +1234567890 | Telefon |
| SIS-ID | Nein | P_123456 | Eindeutige ID |
- Wenn Sie auch Kontaktbeziehungen (Erziehungsberechtigte) synchronisieren, müssen Sie einen Datensatz für diese in die user.csv aufnehmen.
- Erwarten Sie, dass das Telefonfeld basierend auf dem E.164-Standard formatiert ist, bei dem das Pluszeichen verwendet und von der Telefonnummer oder eher dem Pluszeichen gefolgt von Landesvorwahl, Ortsvorwahl, Telefonpräfix und Zeilennummer verwendet wird.
guardianrelationship.csv
| Feld | Pflichtfeld? | Beispiel | Datentyp |
|---|---|---|---|
| SIS-ID | Ja | 123456 | Eindeutige ID |
| E-Mails | Ja | jsmith@outlook.com | E-Mails |
| Rolle | Nein | Parent | Enum |
- Wenn Sie auch Kontaktbeziehungen (Erziehungsberechtigte) synchronisieren, müssen Sie einen Datensatz für diese in die user.csv aufnehmen.
- Dies erfordert einen Verweis auf den zugeordneten Benutzer, der das Feld "Email" verwendet. Dadurch entsteht eine Abhängigkeit von der user.csv-Datei.
- Dies erfordert einen Verweis auf den zugeordneten Benutzer, der das Feld "SIS-ID" verwendet. Dadurch entsteht eine Abhängigkeit von der student.csv-Datei.
- Wenn der Role-Wert nicht angegeben wird, wird der Beziehungswert standardmäßig auf "userContact" festgelegt.