Vorlageninformationen zum Importieren von Daten in Apple School Manager
Um Daten in Apple School Manager hinzuzufügen, kannst du die .csv-Vorlagendateien im Apple-Format oder OneRoster-Format verwenden.
Namen der .csv-Vorlagen von Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen), Courses (Kurse), Classes (Klassen), Rosters (Teilnehmerlisten), Locations (Standorte)
Namen der .csv-Dateien von OneRoster: Users (Benutzer:innen), Courses (Kurse), Classes (Klassen), Enrollments (Anmeldungen), Orgs (Organisationen)
Apple-Dateiname | OneRoster-Dateiname | Inhalte | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Enthält Informationen zum Account von Schüler:innen/Studierenden. OneRoster: Enthält Informationen zum Account von Schüler:innen/Studierenden, Lehrkräften und Mitarbeiter:innen. | |||||||||||
N/A | Enthält Informationen zu Mitarbeiter:innen-Accounts, z. B. von Lehrkräften. | ||||||||||
Enthält Informationen zu Kursen. | |||||||||||
Enthält Informationen zu Klassen und Lehrkräften (Mitarbeiter:innen). | |||||||||||
Enthält Informationen zu Klassen, Schüler:innen/Studierenden und Standorten (Teilnehmerlisten). | |||||||||||
Enthält Informationen zum Standort (Schule oder Abteilung). | |||||||||||
Vorlagen und verwaltete Apple Accounts
Wenn ein optionales Feld wie „person_number“ oder „sis_username“ in dem Format für deinen verwalteten Apple Account enthalten ist, wird es zum Pflichtfeld. Wird das Feld leer gelassen, schlägt der SFTP-Upload mit dem Fehler MANAGED_ID_GENERATION_FAILED fehl.
Vorlagen vorbereiten
Bei der Vorlagenvorbereitung müssen die folgenden Kriterien erfüllt sein:
Struktur
Die Namen der .csv-Dateien müssen genau mit den ursprünglichen Dateinamen übereinstimmen.
Ändere den Namen der Kopfzeile in keiner Datei.
Lösche keine Spalte, auch wenn die Spalte leer ist.
Du kannst Spalten zu den Vorlagen für Schüler:innen/Studierende, Mitarbeiter:innen und Klassen hinzufügen.
In jeder Vorlage muss jede Zeile einen eindeutigen Wert darstellen. Zum Beispiel muss jede Zeile in der Datei „students.csv“ für genau eine:n Schüler:in/Studierende:n sein.
Bei den Vorlagen „students.csv“ und „staff.csv“ muss die „person_id“ für alle Standorte eindeutig sein.
Wichtig: Wenn du eine:n neue:n Benutzer:in per SFTP-Upload hinzufügst und die von dir zugewiesene „person_id“ bereits einem:einer anderen Benutzer:in zugewiesen ist, überschreibt der:die neue Benutzer:in den:die bestehende:n Benutzer:in in Apple School Manager. Nach dem Überschreiben kannst du diese:n Benutzer:in nur per SFTP aktualisieren.
Bestimmte Werte können leer sein. Zum Beispiel kann in der students.csv-Datei der zweite Vorname leer sein.
Ersetze die Beispieldaten mit eigenen Daten.
Formatieren
Literale Werte – wie z. B. ein Zeilenumbruch oder ein Anführungszeichen innerhalb eines Namens – müssen mit einem umgekehrten Schrägstrich (\) maskiert werden. Beispiel: \". Alle eingegebenen Kennungen müssen alphanumerisch sein und dürfen einen Bindestrich (-) enthalten.
Wenn dein Wert ein Leerzeichen ( ) oder ein Komma (,) enthält, setze diese in gerade Anführungszeichen ("). Wenn dein Wert keine dieser Sonderzeichen enthält, verwende keine Anführungszeichen. Wenn du keine Anführungszeichen verwendest, obwohl diese erforderlich sind, oder wenn du geschwungene Anführungszeichen verwendest, erhältst du beim Hochladen Fehlermeldungen.
Unabhängig davon, wie du die Datei erstellt hast, müssen die Werte in deinen Dateien durch Komma (,) oder Semikolon (;) getrennt sein. Zwischen einem Komma oder Semikolon und dem nächsten Wert dürfen keine Leerzeichen oder Tabulatoren stehen. Jede Datei muss in UTF-8 kodiert sein. Markiere das Ende einer Zeile mit dem UNIX-Code \n für einen Zeilenumbruch.
Alle Fremdschlüsselverweise auf andere .csv-Dateien müssen in der referenzierten Datei definiert sein.
Hochladen
Wenn ein Eintrag aus einem früheren Upload fehlt, wird der Benutzeraccount deaktiviert und nach 120 Tagen automatisch gelöscht, es sei denn:
Der:die Benutzer:in hat eine Funktion, mit der Apps oder Bücher in großen Mengen gekauft wurden
Der:die Benutzer:in wurde vor Ablauf der 120-Tage-Grenze manuell gelöscht
Alle Dateien müssen in eine .zip‑Archivdatei komprimiert werden, die hochgeladen wird.
Keine der Dateien darf in der .zip-Archivdatei in einen Ordner platziert werden.
Zeichenbegrenzungen in .csv-Vorlagen
Für einige Felder in den .csv-Vorlagen ist die Anzahl der zulässigen Zeichen begrenzt.
Name des Attributs | Vorlagen | Zeichenbegrenzung |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen) OneRoster: Users (Benutzer:innen) | 32 |
Apple: middle_name OneRoster: middleName | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen) OneRoster: Users (Benutzer:innen) | 32 |
Apple: last_name OneRoster: familyName | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen) OneRoster: Users (Benutzer:innen) | 64 |
Apple: grade_level OneRoster: grades | Apple: Students (Schüler:innen/Studierende) OneRoster: Users (Benutzer:innen) | 64 |
Apple: email_address OneRoster: email | Apple: Students (Schüler:innen/Studierende) OneRoster: Users (Benutzer:innen) | 256 |
Apple: person_number OneRoster: identifier | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen) OneRoster: Users (Benutzer:innen) | 64 |
Apple: person_id OneRoster: sourcedID | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen), Classes (Klassen), Rosters (Teilnehmerlisten) OneRoster: Users (Benutzer:innen), Classes (Klassen), Enrollments (Anmeldungen) | 256 |
Apple: sis_username OneRoster: username | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen) OneRoster: Users (Benutzer:innen) | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Classes (Klassen), Rosters (Teilnehmerlisten) OneRoster: Classes (Klassen), Enrollments (Anmeldungen) | 256 |
Apple: class_number OneRoster: classCode | Apple: Students (Schüler:innen/Studierende), Classes (Klassen) OneRoster: Classes (Klassen) | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Courses (Kurse), Classes (Klassen) OneRoster: Courses (Kurse), Classes (Klassen) | 256 |
Apple: course_name OneRoster: title | Apple: Courses (Kurse) OneRoster: Courses (Kurse) | 128 |
Apple: course_number OneRoster: courseCode | Apple: Courses (Kurse) OneRoster: Courses (Kurse) | 64 |
Apple: location_name OneRoster: name | Apple: Locations (Standorte) OneRoster: Orgs (Organisationen) | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Students (Schüler:innen/Studierende), Staff (Mitarbeiter:innen), Courses (Kurse), Classes (Klassen), Locations (Standorte) OneRoster: Users (Benutzer:innen), Courses (Kurse), Classes (Klassen), Orgs (Organisationen) | 256 |