Für diesen Export wird eine LehrerOffice Zusatz-Lizenz benötigt.
Der Export für den ASM beinhaltet 6 CSV-Dateien, die gemäss der Anleitung von Apple als Zip (ohne Unterordner) in den ASM importiert werden können.
Die genaue Spezifikation seitens Apple finden Sie über den folgenden Link:
SFTP zum Hochladen von Schüler-/Studenten-, Mitarbeiter- und Klassendaten in Apple School Manager verwenden
Der ASM-Export wird in 'LehrerOffice Zusatz' wie folgt aufgerufen:
In den folgenden Abschnitten erfahren Sie was genau aus LehrerOffice in welche Felder der Export-Files geschrieben wird.
Sobald der Import einmal ausgeführt wurde, sind die CSV-Files (und somit das LehrerOffice) der Master.
Wird jedoch ein importierter Account im ASM deaktiviert oder gelöscht, kann dieser nur wieder hergestellt werden, in dem der betroffene Eintrag in LehrerOffice ausgeblendet, exportiert und danach wieder eingeblendet und erneut exportiert wird. Es sollten somit wenn möglich alle Aktionen, wie aktivieren und deaktivieren von Lehrpersonen und Schüler in LehrerOffice vorgenommen werden und nicht direkt im ASM.
Im Apple School Manager können Daten nicht aus zwei Quellen (zwei Datenbanken) sich ergänzend importiert werden.
Importiert man die Daten aus einer zweiten Quelle (Datenbank), werden die Daten des ersten Imports ausgeblendet. Möchte man im Apple School Manager Daten von mehreren Quellen verwalten, müssen die CSV-Files vorab zusammengeführt werden. Der umgekehrte Fall, Daten aus einer Quelle (Datenbank) auf mehrere Accounts im Apple School Manager aufzuteilen, ist möglich, sofern in der Datenbank entsprechende Schuleinheiten vorhanden sind und der Export automatisiert wird (siehe folgender Abschnitt).
Dieser Export kann bei einer Automatisierung via 'LehrerOffice Service' auf eine oder mehrere Schuleinheiten eingegrenzt werden.
Als 'Location' werden alle aktiven Schuleinheiten exportiert.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
location_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Schuleinheit. | „MATDGABCD12345-COMMUNITY-DG3JFABC123“ | ||
location_name | Bezeichnung der Schuleinheit. | „Primarschule Oberdorf“ |
Es werden alle aktiven Klassen und aktive Gruppen des aktiven Semesters mit mindestens einer aktiven Lehrperson exportiert. In ASM ist eine Klasse nur einer Schuleinheit zugewiesen. Sind aber in LehrerOffice mehrere Schuleinheiten einer Gruppe zugewiesen, wird nur die Schuleinheit mit der tieferen ID für die 'location_id' genommen.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
course_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Klasse oder Gruppe. | „MATDGABCD12345-CLASS-1PRIMAR“ | ||
course_number | wird leer geliefert | |||
course_name | Anzeigename der Klasse oder Gruppe | „1. Primar“ | ||
location_id | Die location_id der zugewiesenen Schuleinheit (siehe locations.csv) | „MATDGABCD12345-COMMUNITY-DG3JFABC123“ |
*) Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und wird deshalb nicht angezeigt
Es werden alle aktiven Adressen der Kategorie 'Lehrpersonen' und 'Schulbetrieb' geliefert, die einer aktiven Schuleinheit zugewiesen sind.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
person_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Adresse. | „MATDGABCD12345-ADDRESS-SIV7GABC789“ | ||
person_number | Personalnummer des Mitarbeiters | „17“ | ||
first_name | Ruf-Vorname und wenn nicht vorhanden der Vorname | „Evi“ | ||
middle_name | wird leer geliefert | |||
last_name | Ruf-Nachname und wenn nicht vorhanden der Nachname | „Mustermann“ | ||
email_address | Hinterlegte E-Mail-Adresse. In LehrerOffice wird das Format nicht geprüft. Ungültige Adressen führen aber im ASM zu Fehler. | „eveline.mustermann@schule-beispielikon.ch“ | ||
sis_username | wird leer geliefert | |||
location_id bis location_id_15 | Die location_id der zugewiesenen Schuleinheiten (siehe locations.csv) | „MATDGABCD12345-COMMUNITY-DG3JFABC123“ |
Bei mehreren Vornamen oder langen doppelten Nachnamen, kann der Rufname benutzt werden, damit in den iPads kürzere Namen erscheinen.
Beispiel: Evi Mustermann anstelle von Eveline Naomi Sara Kathrin Mustermann
*) Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und dieser Abschnitt wird deshalb nicht angezeigt
Beinhaltet die gleichen Klassen und Gruppen wie in der Datei courses.csv. In dieser Datei werden zusätzlich alle Lehrpersonen geliefert, die zu eine Klasse oder Gruppe zugewiesen sind. Die Fachlehrperson, die einem Fach zugewiesen ist, wird mit der jeweiligen Klasse geliefert.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
class_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Klasse oder Gruppe. Ist identisch mit der course_id (siehe courses.csv) | „MATDGABCD12345-CLASS-1PRIMAR“ | ||
class_number | wird leer geliefert | |||
course_id | gleicher Wert wie die class_id | „MATDGABCD12345-CLASS-1PRIMAR“ | ||
instructor_id bis instructor_id_15 | Die person_id der jeweiligen Lehrpersonen (siehe staff.csv) | „MATDGABCD12345-ADDRESS-SIV7GABC789“ | ||
location_id | Die location_id der zugewiesenen Schuleinheit (siehe locations.csv) | „MATDGABCD12345-COMMUNITY-DG3JFABC123“ |
Es werden alle aktiven Schüler exportiert, die einer aktiven Klasse mit mindestens einer Lehrperson zugewiesen sind.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
person_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel des Schülers | „MAMCL6DD8O5EC2-STUDENT-MAMCL6DE8ATP459“ | ||
person_number | wird leer geliefert | |||
first_name | Ruf-Vorname und wenn nicht vorhanden der Vorname | „Nik“ | ||
middle_name | wird leer geliefert | |||
last_name | Ruf-Nachname und wenn nicht vorhanden der Nachname | „Muster“ | ||
grade_level | Aktuelle Schulstufe des Schülers | „6. Primar“ | ||
email_address | Hinterlegte E-Mail-Adresse. In LehrerOffice wird das Format nicht geprüft. Ungültige Adressen führen aber im ASM zu Fehler. | „nikolas.muster@schule-beispielikon.ch“ | ||
sis_username | Wert aus den Schülerdaten. Defaultwert ist leer | |||
password_policy | Wert aus den Eigenschaften. Defaultwert ist leer | |||
location_id bis location_id_15 | Die location_id der Schuleinheiten, die den Klassen und Gruppen zugewiesen sind, in der sich die Schüler befinden (siehe locations.csv) | „MATDGABCD12345-COMMUNITY-DG3JFABC123“ |
siehe Felder bei Schülerdaten
Die Zuweisung der Schüler zu den jeweiligen Klassen und Gruppen erfolgt in dieser Datei.
Spaltenname ASM-Export | Angaben in LehrerOffice | Beispiel | ||
---|---|---|---|---|
roster_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank, dem Schlüssel der Klasse oder Gruppe und dem Schlüssel des Schülers | „MAMCL6DD8O5EC2-ROSTER-GROUP-MAXCP84DE4GA46-MAACL6EF7E4EZ1“ | ||
class_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Klasse oder Gruppe. Ist identisch mit der course_id (siehe courses.csv) | „MAMCL6DD8O5EC2-GROUP-MAXCP84DE4GA46“ | ||
student_id | Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Schüler (siehe person_id in students.csv) | „MAMCL6DD8O5EC2-STUDENT-MAACL6EF7E4EZ1“ |
Ist ein Schüler keiner aktiven Klasse zugewiesen aber einer manuellen Gruppe, erscheint dieser in der rosters.csv aber nicht in der student.csv.
In diesem Fall muss die Zuordnung von Schülern zu den Gruppen bereinigt werden, damit im Apple School Manager kein Fehler angezeigt wird.
siehe Modul 'Schülerdaten'