Freigeben über


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.