Vorlageninformationen zum Importieren von Einträgen in Apple School Manager
Apple stellt sechs Vorlagen zum Hinzufügen von Daten zu deinem Standort zur Verfügung:
Students (Schüler/Studenten): Enthält die Account-Informationen für Schüler/Studenten.
Staff (Mitarbeiter): Enthält die Account-Informationen für Mitarbeiter, wie z. B. Lehrkräfte.
Courses (Kurse): Legt Kurse fest.
Klassen: Enthält Informationen zu Kursen und Lehrkräften (Mitarbeitern).
Rosters (Teilnehmerlisten): Enthält Informationen zu Klassen, Schülern/Studenten und Standorten.
Locations (Standorte): Enthält Standortinformationen.
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 einen Schüler/Student sein. Bestimmte Werte dieses Schülers/Studenten 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 eines früheren Uploads fehlt, wird der Account deaktiviert und nach 120 Tagen automatisch gelöscht, es sei denn, der Account hat Inhalte in großen Mengen gekauft.
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.
Feld | Vorlagen | Zeichenbegrenzung |
|---|---|---|
first_name | Schüler/Studenten, Mitarbeiter | 32 |
middle_name | Schüler/Studenten, Mitarbeiter | 32 |
last_name | Schüler/Studenten, Mitarbeiter | 64 |
grade_level | Schüler/Studenten | 64 |
email_address | Schüler/Studenten | 256 |
person_number | Schüler/Studenten, Mitarbeiter | 64 |
person_id | Schüler/Studenten, Mitarbeiter, Klassen, Teilnehmerlisten | 256 |
sis_username | Schüler/Studenten, Mitarbeiter | 256 |
class_id | Klassen, Teilnehmerlisten | 256 |
class_number | Klassen | 64 |
course_id | Kurse, Klassen | 256 |
course_name | Kurse | 128 |
course_number | Kurse | 64 |
location_name | Standorte | 256 |
location_id | Schüler/Studenten, Mitarbeiter, Kurse, Klassen, Standorte | 256 |