SDS (klassisch) V2.1 CSV-Dateiformat
Kern-SDS-Funktionen und Microsoft 365-Features nach Erfassungsmethode
Sie können CSV-Dateien (durch Trennzeichen getrennte Werte) im SDS V2.1-Format verwenden, um Ihr Schulinformationssystem (SIS) mit Office 365 zu synchronisieren. Wenn Sie das CSV-Dateiformat SDS V2.1 zum Erfassen der Datenkategorien verwenden, können Sie die wichtigsten SDS-Funktionen für die Bereitstellung erweitern. Es hilft Ihnen auch, die Erfahrungen für die aufgeführten Microsoft 365-Produkte und -Features zu verbessern.
Hinweis
Aktuelle Kunden im CSV V2-Format können weiterhin bis Mai 2022 verwenden. Es wird empfohlen, das CSV V2.1-Format mit den zusätzlichen Funktionen zu verwenden.
SDS V2.1-Dateien müssen entsprechend formatiert sein. Laden Sie alle fünf Dateien hoch, die genau wie detailliert benannt sind. Bei Dateien und Spaltenüberschriften wird die Groß-/Kleinschreibung beachtet. CSV-Dateien müssen im UTF-8-Format vorliegen. Informationen zum Überprüfen und Herunterladen eines Beispielsatzes von SDS V2.1-CSV-Dateien finden Sie im SDS-GitHub-Repository.
Jede CSV-Datei muss alle erforderlichen Felder enthalten, die grün hervorgehoben sind . Die nicht hervorgehobenen Felder sind optional. Während der Inhalt bestimmter Attribute optional sein kann, sind die Spaltenüberschriften erforderlich. Die Attribute mit definierten Aufzählungswerten, wie in der Spalte Typen markiert, verfügen über einen bestimmten Satz von Werten, die sie unterstützen. Der unterstützte Satz von Enumerationswerten für jedes Attribut befindet sich im nächsten Abschnitt.
*So filtern Sie nur nach "Schule".
Beim Erstellen von Benutzern:
Das Feld "Benutzername " erfordert die Domäne, um von SDS akzeptiert zu werden. Beispiel: cbean@domain.com.
FamilyName, givenName und email sind für Benutzer erforderlich, die in relationships.csv über Die Rolle "Erziehungsberechtigte" verfügen. Benutzern, die Mitarbeiter, aber auch Kontakte sind, wird empfohlen, zwei Benutzerdatensätze aufgelistet zu haben, wobei der Benutzerdatensatz kontakte ihrer privaten E-Mail-Adresse zugeordnet ist.
Erwarten Sie, dass Telefon und SMS in E.164 sind. Bei der SDS-Bereitstellung tritt kein Telefon- oder SMS-Fehler auf, wenn sie nicht auf E.164 ausgerichtet ist. Die Validierung entfernt () -, Leerzeichen, Punkte (.) und behält + bei, wenn es am Anfang des angegebenen Werts vorhanden ist.
*Synchronisiert nur einen Wert mit der SDS-Bereitstellung, wenn mehrere Werte im Datensatz gefunden werden.
Unterstützte Aufzählungswerte
Im SDS V2.1-Format gibt es Attribute, die als Aufzählungswerte definiert sind, was bedeutet, dass Sie nur einen ausgewählten Satz von Werten innerhalb der CSV-Dateien bereitstellen können. Alles, was nicht die angegebenen Werte ist, führt während der Synchronisierungsverarbeitung zu einem Fehler. Der Abschnitt definiert die aufgelisteten Werte, die im SDS V2.1-Format unterstützt werden.
Die users.csv enthält das Attribut "role" und unterstützt die Enumerationswerte.
| Benutzer-Organisationsrollen | ||
|---|---|---|
| Student | TeacherAssistant | Principal |
| Proctor | Stab | SpecialServices |
| Lehrer | Professor | Trainer |
| ItAdmin | Recherche | Assistent |
| OfficeStaff | Dozent | Stuhl |
| Krankenschwester | Affiliate | Ergänzung |
| Berufstherapist | Alumni | Wechseln |
| Instructor | Berater | Paraprofessionell |
| PhysicalTherapist | Fakultät | Administrator |
| SpeechTherapist | VisionTherapist | Andere |
Die orgs.csv enthält das Attribut "type" und unterstützt die Enumerationswerte.
| Organisationstypen | ||
|---|---|---|
| Schule | MinistryOfEducation | LocalAuthority |
| Department | Universität | Region |
| Bezirk | College | Division |
| Lokal | Campus | Provinz |
| State | AdultEducation | Forschungszentrum |
| Nationalen | Gemeinde | Programm |
| DepartmentOfEducation | AcademicTrust |
Die demographics.csv enthält das Attribut "Geburtszustand" und unterstützt die Enumerationswerte.
| State | ||
|---|---|---|
| AK | LA | ODER |
| AL | MA | PA |
| AR | MD | PR |
| AS | ICH | PW |
| AZ | MH | RI |
| CA | MI | SC |
| CO | MN | SD |
| CT | MO | TN |
| Gleichstrom | MP | TX |
| DE | MS | UT |
| FL | MT | VA |
| FM | NC | VI |
| Allgemein verfügbar | ND | VT |
| GU | NE | WA |
| HALLO | NH | WI |
| IA | NJ | WV |
| ID | NM | WY |
| IL | NV | AA |
| IN | NY | AE |
| KS | OH | LD |
| KY | OK |
Die academicSessions.csv enthält das "type"-Attribut der akademischen Sitzung und unterstützt die Enumerationswerte.
| Akademische Sitzungstypen | ||
|---|---|---|
| SchoolYear | Semester | Begriff |
Die demographics.csv enthält das Attribut "sex" und unterstützt die Enumerationswerte.
| Sex | ||
|---|---|---|
| Männlich | Weiblich | Nicht ausgewählt |
Die academicSessions.csv enthält das Attribut "Schuljahr" und unterstützt die Enumerationswerte.
| Schuljahr | ||
|---|---|---|
| 2021 | 2025 | 2029 |
| 2022 | 2026 | 2030 |
| 2023 | 2027 | 2031 |
| 2024 | 2028 |
Die relationships.csv enthält das Attribut "Beziehungsrolle" und unterstützt die Enumerationswerte.
| Beziehungsrollen | ||
|---|---|---|
| Parent | Wächter | Aide |
| Relativ | Untergeordnet | Administrator |
| Arzt | Andere |
Die enrollments.csv enthält das Attribut "role" und unterstützt die Enumerationswerte.
| Registrierungsrollen | ||
|---|---|---|
| Student | VisionTherapist | Wechseln |
| Aide | Paraprofessionell | Principal |
| Proctor | TeacherAssistant | SpecialServices |
| Lehrer | Professor | Berater |
| Administrator | Dozent | Trainer |
| Berufstherapist | Affiliate | Vorstandsassistent |
| PhysicalTherapist | Ergänzung | Stab |
| SpeechTherapist | Instructor |
Die Courses.csv enthält das "Subject"-Attribut der akademischen Sitzung und unterstützt die Enumerationswerte.
| Kursbetreff | Beschreibung |
|---|---|
| 01 | Englische Sprache und Literatur |
| 02 | Mathematik |
| 03 | Life and Physical Sciences |
| 04 | Sozialwissenschaften und Geschichte |
| 05 | Bildende und darstellende Kunst |
| 07 | Religionsunterricht und Theologie |
| 08 | Körper-, Gesundheits- und Sicherheitserziehung |
| 09 | Militärwissenschaft |
| 10 | Informationstechnologie |
| 11 | Kommunikations- und Audio-/Bildtechnik |
| 12 | Business und Marketing |
| 13 | Fertigung |
| 14 | Gesundheitswissenschaften |
| 15 | Öffentlicher Dienst, Schutz- und Behördendienst |
| 16 | Gastgewerbe und Tourismus |
| 17 | Architektur und Bauwesen |
| 18 | Landwirtschaft, Ernährung und natürliche Ressourcen |
| 19 | Human Services |
| 20 | Transport, Distribution und Logistik |
| 21 | Technik und Technologie |
| 22 | Sonstiges |
| 23 | Nicht fachspezifisch |
| 24 | Weltsprachen |
Die userFlags.csv enthält das Attribut "flag" und unterstützt die Enumerationswerte.
| Benutzerflags | Beschreibung |
|---|---|
| FreeLunch | Kostenloses Mittagessen |
| ReducedLunch | Reduziertes Mittagessen |
| Obdachlosen | Obdachlosen |
| GiftedOrTalented | Begabt oder talentiert |
| 504 | § 504 Platzierung |
| ELL | Englischlerner |
| LEP | Eingeschränkte Englischkenntnisse |
| IEP | Sonderpädagogische Dienstleistungen / Unabhängiger Bildungsplan berechtigt |
Die demographics.csv enthält das Attribut "ethnicity" und unterstützt die Enumerationswerte.
| Ethnizität | Beschreibung |
|---|---|
| HispanicOrLatinoEthnicity | Hispanische oder Latino-Ethnie |
Die demographics.csv enthält das Attribut "race" und unterstützt die Enumerationswerte.
| Rennen | Beschreibung |
|---|---|
| AmericanIndianOrAlaskaNative | Amerikanisch-Indianer oder Alaska Native |
| NativeHawaiianOrOtherPacificIslander | Native Hawaiianer oder andere pazifische Insulanser |
| BlackOrAfricanAmerican | Schwarz oder Afroamerikaner |
| DemographicRaceTwoOrMoreRaces | Bestimmt mehrere Rassen |
| Asiatisch | Asiatisch |
| Weiß | Weiß |
Die roles.csv enthält das Attribut "grade" und unterstützt die Enumerationswerte.
Die Courses.csv enthält das "grade"-Attribut der akademischen Sitzung und unterstützt die Enumerationswerte.
| Klasse | Beschreibung |
|---|---|
| IT-Abteilung | Kleinkind/Kleinkind |
| PR | Vorschule |
| PK | Prekindergarten |
| TK | Übergangskindergarten |
| KG | Kindergarten |
| 01 | Erste Klasse |
| 02 | Zweite Klasse |
| 03 | Dritte Klasse |
| 04 | Vierte Klasse |
| 05 | Fünfte Klasse |
| 06 | Sechste Klasse |
| 07 | Siebte Klasse |
| 08 | Achte Klasse |
| 09 | Neunte Klasse |
| 10 | Zehnte Klasse |
| 11 | Elfte Klasse |
| 12 | Zwölfte Klasse |
| 13 | Besoldungsgruppe 13 |
| 14 | Besoldungsgruppe 14 |
| PS | Portal |
| UG | Sortierter |
| Andere | Andere |
| PS1 | Postsecondary Freshman |
| PS2 | Postsecondary sophomore |
| PS3 | Postsecondary junior |
| PS4 | Postsecondary Senior |
| Undergraduate | Undergraduate |
| Absolvent | Absolvent |
| Postgraduate | Absolvent mit Schwerpunkt Forschung |
| Alumni | Alumni |
| AdultEducation | Erwachsenenbildung |