Inhaltsverzeichnis
Export: Apple School Manager (ASM)
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
Daten exportieren
Der ASM-Export wird in 'LehrerOffice Zusatz' wie folgt aufgerufen:
- Modul 'Schülerdaten' markieren
- über das Menü 'Schüler' den Punkt 'Exportieren' wählen
- Den Eintrag 'Apple School Manager' wählen
- Dem Assistenten folgen und den Export abschliessen
Bitte beachten Sie, dass Sie für diesen Vorgang mit einem Admin-Login eingeloggt sein müssen oder über die entsprechenden Berechtigungen verfügen müssen, um Zugriff auf alle Klassen zu haben. Dies stellt sicher, dass der Export vollständig und korrekt durchgeführt werden kann.
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).
Filter Schuleinheit (ab LehrerOffice Service 2020.1)
Dieser Export kann bei einer Automatisierung via 'LehrerOffice Service' auf eine oder mehrere Schuleinheiten eingegrenzt werden.
- Mehr zur Automatisierung unter Eigenständige Aufgaben
- Mehr zum Einrichten des Schuleinheit-Filters unter Tricks für Abfragen und Exports
locations.csv
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“ |
Schlüssel der Schuldatenbank einsehen:
- Befehl 'Einstellungen' wählen
- In das Register 'Datenbank' wechseln
- In der Auswahlliste 'Bereich' den Eintrag 'Informationen' auswählen
- Im Abschnitt 'Datei' den Punkt 'Schlüssel' markieren
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
Schlüssel und Namen der Schuleinheit einsehen oder bearbeiten:
- Modul 'Schuleinheiten' markieren
- Auf gewünschter Schuleinheit doppelklicken
- In das Register 'Grunddaten' wechseln
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
- Im Textfeld 'Bezeichnung' kann der Name der Schuleinheit definiert werden
courses.csv
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“ |
Schlüssel, Name und Schuleinheit der Klasse einsehen und bearbeiten:
- Modul 'Klassen' markieren
- In das Register 'Schulklassen' wechseln
- Auf gewünschter Klasse doppelklicken
- In das Register 'Grunddaten' wechseln
- Im Textfeld 'Klassenkürzel' kann die Bezeichnung der Klasse geändert werden. Feldnamen werden beim Export interpretiert.
- Im Textfeld 'Schuleinheit' kann die Zuordnung der Schuleinheit angepasst werden*
- In das Register 'Einstellungen' wechseln
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
Schlüssel, Name und Schuleinheit der Gruppe einsehen und bearbeiten:
- Modul 'Gruppen' markieren
- In das Register 'Gruppen' wechseln
- Auf gewünschter Gruppe doppelklicken
- In das Register 'Grunddaten' wechseln
- Im Textfeld 'Name' kann die Bezeichnung der Gruppe geändert werden. Feldnamen werden beim Export interpretiert.
- In das Register 'Einstellungen' wechseln
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
- In das Register 'Weiteres' wechseln*
- Die Checkboxen der gewünschten Schuleinheiten markieren. Es wird aber nur eine Schuleinheit exportiert. Daher empfehlen wir nur eine Schuleinheit zuzuweisen und bei Bedarf eine weitere Gruppe für die andere Schuleinheit zu erfassen.
*) Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und wird deshalb nicht angezeigt
staff.csv
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
Schlüssel, Name, Rufname, Personalnummer und E-Mail-Adresse der Person (Adresse) einsehen und bearbeiten:
- Modul 'Adressen' markieren
- In das Register 'Adressen' wechseln
- Auf gewünschter Adresse (Namen) doppelklicken
- In das Register 'Grunddaten' wechseln
- Im Textfeld 'Vorname' kann dieser bearbeitet werden
- Über das Icon rechts des Textfeldes 'Vorname' kann der Rufname des Vornamens eingetragen werden
- Im Textfeld 'Name' kann der Nachname bearbeitet werden
- Über das Icon rechts des Textfeldes 'Name' kann der Rufname des Nachnamens eingetragen werden
- Im Textfeld 'Personal-Nr' kann die Personalnummer hinterlegt werden
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
- In das Register 'Schule' wechseln
- Im Textfeld 'E-Mail' kann die E-Mail-Adresse eingesehen und bearbeitet werden
- In das Register 'Sichtbarkeit' wechseln*
- Die Checkboxen der gewünschten Schuleinheiten markieren. Es werden alle Zuweisungen zu aktiven Schuleinheiten exportiert
*) Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und dieser Abschnitt wird deshalb nicht angezeigt
classes.csv
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“ |
Zuweisung der Lehrpersonen einer Klasse ändern
Zuweisung der Lehrpersonen einer Gruppe ändern
- Modul 'Gruppen' markieren
- Auf gewünschter Gruppe doppelklicken
- In das Register 'Unterricht' wechseln
- In der Auswahlliste 'Lehrperson' die gewünschte Lehrperson auswählen
- Fenster mit 'OK' schliessen
Zuweisung der Lehrpersonen für ein Schulfach ändern
- Modul 'Schulfächer' markieren
- In das Register 'Schulfächer der Klassen' wechseln
- Gewünschte Klasse markieren
- Auf gewünschtem Fach doppelklicken
- In das Register 'Unterricht' wechseln
- In der Auswahlliste 'Fachlehrperson' die gewünschte Lehrperson auswählen
- Fenster mit 'OK' schliessen
students.csv
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“ |
Passwortrichtlinie für Lernende anpassen
Welches Feld wird als sis_username geliefert
siehe Felder bei Schülerdaten
Schlüssel, Name, Rufname, E-Mail-Adresse und Schulstufe der Schüler (Schülerdaten) einsehen und bearbeiten:
- Modul 'Schülerdaten' markieren
- Gewünschte Klasse markieren
- Auf gewünschtem Schüler doppelklicken
- In das Register 'Daten' wechseln
- Im Textfeld 'Vorname' kann dieser bearbeitet werden
- Über das Icon rechts des Textfeldes 'Vorname' kann der Rufname des Vornamens eingetragen werden
- Im Textfeld 'Name' kann der Nachname bearbeitet werden
- Über das Icon rechts des Textfeldes 'Name' kann der Rufname des Nachnamens eingetragen werden
- Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
- In das Register 'Schüler' wechseln
- Im Textfeld 'E-Mail' kann die E-Mail-Adresse eingesehen und bearbeitet werden
- In das Register 'Status' wechseln
- Funktion 'Zuteilung' ausführen
- Im Register 'Klasse & Niveau' wird unter 'Pensum' die Schulstufe des Schülers angezeigt
rosters.csv
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.
Zuweisung eines Schülers zu einer Klasse
siehe Modul 'Schülerdaten'