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 zum Mitarbeiter:innen-Account, z. B. Lehrkräfte. | ||||||||||
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 zum Standort (Teilnehmerlisten). | |||||||||||
Enthält Informationen zum Standort (Schule oder Abteilung). |
Vorlagen und verwaltete Apple‑IDs
Wenn ein optionales Feld wie „person_number“ oder „sis_username“ in dem Format für deine verwaltete Apple-ID 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:
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.
Wenn du die Vorlagen bearbeitest, ersetze die Beispieldaten mit deinen eigenen Daten. Die Inhalte der Kopfzeile der Dateien dürfen nicht geändert werden. Erstelle in keiner der Dateien doppelte Spalten. Du kannst bestimmten Vorlagen Spalten 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. Bestimmte Werte dieses/dieser Schülers/Schülerin bzw. Studierenden können leer sein. 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.
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.
Die Namen der .csv‑Dateien müssen genau mit den ursprünglichen Dateinamen übereinstimmen.
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.
Alle Fremdschlüsselverweise auf andere .csv-Dateien müssen in der referenzierten Datei definiert sein.
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 |