Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
lehreroffice:zusatz:export:activedirectory_gesamtexport [2019/05/22 08:31] – angelegt Martin Hengärtnerlehreroffice:zusatz:export:activedirectory_gesamtexport [2020/04/03 08:36] (aktuell) Martin Hengärtner
Zeile 1: Zeile 1:
  
 ====== Export: Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen) ====== ====== Export: Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen) ======
-Der Import von Benutzern und Gruppen ins Activ Directory ist sehr individuell. Wir generieren dafür 7 CSV-Dateien, die je nach Bedarf importiert werden können. +Für diesen Export wird eine **[[https://www.lehreroffice.ch/lehreroffice-zusatz/beschreibung/|LehrerOffice Zusatz]]**-Lizenz benötigt. 
-Brauchen Sie nur einzelne Schüler oder Lehrpersonen kann vielleicht auch der folgende Export weiterhelfen: + 
-  * AD Benutzer+Der Import von Benutzern und Gruppen ins Active Directory ist sehr individuell. Wir generieren dafür 7 CSV-Dateien, die je nach Bedarf importiert werden können. 
 +Für den Export/Import einzelner Benutzer gibt es für Lehrpersonen und Schüler auch jeweils einen separaten Export. 
  
      
-===== Vorbereiten ===== +===== Datenbank vorbereiten ===== 
-Die Konstellation einer Lehrperson zu Schülern bleibt oft bis zu 3 Jahren bestehen. +==== eindeutige ID der Klassen ==== 
-Deshalb sollen in Office 365 auch Gruppen und Ordner den Klassenwechsel mitmachen.+Ob die Konstellation einer Lehrperson zu Schülern bestehen bleibt, bestimmen Sie mit dem Festlegen der eindeutigen ID der zu exportierenden Klasse: 
 +  * [[lehreroffice:zusatz:export:kursid|Eindeutige ID einer Klasse bestimmen]] 
 Sie dürfen sich gerne per E-Mail (oder mit Support-Abo per Telefon) bei uns melden, damit wir Sie optimal beraten können. Sie dürfen sich gerne per E-Mail (oder mit Support-Abo per Telefon) bei uns melden, damit wir Sie optimal beraten können.
  
 +==== Domainname ====
 +Für Office 365 Importe muss der Domainname der Office 365 - E-Mail-Adressen oder der Onmicrosoft-Domainname hinterlegt werden:
 +  * [[lehreroffice:zusatz:export:domainname|Domainname festlegen]]
  
-===== Daten exportieren ===== +{{:lehreroffice:grafiken:icons:tips_32.png?nolink  |TIPP}} //Ab Version 2020.4: Ist der Domainname leer, wird jeweils die E-Mail-Adresse als UserPrincipalName genommenDies setzt voraus, dass die Emailadresse vollständig mit dem Anmeldenamen in Office365 oder Windows korrespondiert.//\\
-Für diesen Export wird eine **[[https://www.lehreroffice.ch/lehreroffice-zusatz/beschreibung/|LehrerOffice Zusatz]]**-Lizenz benötigt.+
  
 +==== Office 365 E-Mail-Adressen hinterlegen ====
 +Damit der Abgleich mit Office 365 funktioniert müssen die Office 365 E-Mail-Adressen hinterlegt werden:
 +  * [[lehreroffice:zusatz:export:office365emailadressen|Office 365 E-Mail-Adresse hinterlegen]]
 +
 +===== Daten exportieren =====
 Der Active Directory Gesamtexport wird in LehrerOffice Zusatz wie folgt aufgerufen: Der Active Directory Gesamtexport wird in LehrerOffice Zusatz wie folgt aufgerufen:
   - Modul 'Schülerdaten' markieren   - Modul 'Schülerdaten' markieren
   - über das Menü 'Schüler' den Punkt 'Exportieren' wählen   - über das Menü 'Schüler' den Punkt 'Exportieren' wählen
   - Den Eintrag 'Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen)' wählen   - Den Eintrag 'Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen)' wählen
 +  - Dem Assistenten folgen und den Export abschliessen
 +  
 +Der Export für einzelne Adressen / Lehrpersonen ist wie folgt aufrufbar:
 +  - Modul 'Adressen' markieren
 +  - über das Menü 'Adresse' den Punkt 'Exportieren' wählen
 +  - Den Eintrag 'Active Directory - Mitarbeitende' wählen
 +  - Dem Assistenten folgen und den Export abschliessen
 +  
 +Der Export für einzelne Schülerdaten ist wie folgt aufrufbar:
 +  - Modul 'Schülerdaten' markieren
 +  - über das Menü 'Schüler' den Punkt 'Exportieren' wählen
 +  - Den Eintrag 'Active Directory - Lernende' wählen
 +  - Die gewünschten Klassen und Schüler markieren
   - Dem Assistenten folgen und den Export abschliessen   - Dem Assistenten folgen und den Export abschliessen
 +
  
 In den folgenden Abschnitten erfahren Sie was genau aus LehrerOffice in welche Felder der Export-Files geschrieben wird. In den folgenden Abschnitten erfahren Sie was genau aus LehrerOffice in welche Felder der Export-Files geschrieben wird.
 +
 +
 +===== Filter Schuleinheit (ab LehrerOffice Service 2019.6)=====
 +Dieser Export kann bei einer Automatisierung via 'LehrerOffice Service' auf eine oder mehrere Schuleinheiten eingegrenzt werden.
 +  * Mehr zur Automatisierung unter [[lehreroffice:zusatzprogramme:service-schnittstelle:aufgaben:aufgaben|Eigenständige Aufgaben]] 
 +  * Mehr zum Einrichten des Schuleinheit-Filters unter [[lehreroffice:zusatzprogramme:service-schnittstelle:aufgaben:aufgaben_export|Tricks für Abfragen und Exports]]
 +  
  
  
 ===== school.csv ===== ===== school.csv =====
 +Es werden alle aktiven Schuleinheiten exportiert.
 +
 ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^
 |SchoolId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Schuleinheit.||"MATDGABCD12345-COMMUNITY-DG3JFABC123"| |SchoolId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Schuleinheit.||"MATDGABCD12345-COMMUNITY-DG3JFABC123"|
Zeile 45: Zeile 79:
  
 ===== group.csv ===== ===== group.csv =====
 +Es werden alle aktiven Klassen und aktive Gruppen des aktiven Semesters mit einer KursID und mindestens einer aktiven Lehrperson exportiert.
 +
 ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^
 |GroupId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und die KursId der Klasse oder Gruppe.*||"MATDGABCD12345-CLASS-1PRIMAR"| |GroupId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und die KursId der Klasse oder Gruppe.*||"MATDGABCD12345-CLASS-1PRIMAR"|
Zeile 73: Zeile 109:
  
 ==== Fehlende KursID mit generiertem Schlüssel befüllen ==== ==== Fehlende KursID mit generiertem Schlüssel befüllen ====
-Nach einem Schuljahreswechsel gibt es Klassen und Gruppen, die eine leere KursID besitzen. Diese kann wie folgt generiert werden: +Siehe [[lehreroffice:zusatz:export:kursid_generieren|Fehlende KursID mit generiertem Schlüssel befüllen]]
-  - Modul 'Klassen' markieren +
-  - In das Register 'Schulklassen' wechseln +
-  - Im Menü 'Ansicht' den Punkt 'Klassendefinition' wählen +
-  - In der Spalte 'KursId' auf dem Spaltentitel die rechte Maustaste drücken +
-  - Die Option 'leere KursID's ausfüllen' wählen +
-  - mit 'Ausfüllen' bestätigen +
-Nun wird ein zufälliger Wert bei allen leeren KursID's generiert.+
  
-Soll eine Klasse nicht exportiert werden, kann die KursID leer gelassen werden. +----  
- +\\
 (1)  Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und wird deshalb nicht angezeigt\\ (1)  Existiert nur eine Schuleinheit kann die Zuordnung nicht geändert werden und wird deshalb nicht angezeigt\\
-(2) Alternativ kann der exportierte Schlüssel auch auf den Schlüssel oder den Fremdschlüssel gewechselt werden. Informieren Sie sich dazu bei unserem Support.+(2)  Alternativ kann der exportierte Schlüssel auch auf den Schlüssel oder den Fremdschlüssel gewechselt werden: [[lehreroffice:zusatz:export:kursid|Eindeutige ID einer Klasse bestimmen]]
  
  
 +===== employee.csv (gesamt) / activedirectory_employee.csv (einzeln) =====
 +Es werden alle aktiven Adressen der Kategorie 'Lehrpersonen' und 'Schulbetrieb' geliefert, die einer aktiven Schuleinheit zugewiesen sind und eine Emailadresse hinterlegt haben.
  
 +^Spaltenname Export^^Angaben in LehrerOffice^^gesamt ¹^^einzeln ²^^Beispiel^
 +|EmployeeId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Adresse.||  **X**  ||  **X**  ||"MATDGABCD12345-ADDRESS-SIV7GABC789"|
 +|SamAccountName||Der linke Teil der E-Mail-Adresse||  **X**  ||  **X**  ||"tina.vonmuster"|
 +|UserPrincipalName||Der linke Teil der E-Mail-Adresse + @ + Domainname*||  **X**  ||  **X**  ||"tina.vonmuster@schulexyz.onmicrosoft.com"|
 +|Usertype||Name der Adresskategorie||  **X**  ||  **X**  ||"Lehrperson"|
 +|FirstName||Ruf-Vorname und wenn nicht vorhanden der Vorname||  **X**  ||  **X**  ||"Tina"|
 +|LastName||Ruf-Nachname und wenn nicht vorhanden der Nachname||  **X**  ||  **X**  ||"von Muster"|
 +|DisplayName||Vorname + " " + Nachname||  **X**  ||  **X**  ||"Tina von Muster"|
 +|JobTitle||Die Funktion des Mitarbeitenden||  **X**  ||  **X**  ||"Primarlehrer/in"|
 +|SchoolName_1 bis _5||Bezeichnung der Schuleinheit|| ||  **X**  ||"Primarschule Oberdorf"|
 +¹) Im Export 'Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen)' verfügbar\\
 +²) Im Export 'Active Directory - Mitarbeitende' verfügbar\\
 +*) Ab Version 2020.4: Ist der Domainname leer, wird die E-Mail-Adresse als UserPrincipalName genommen. Dies setzt voraus, dass die E-Mail-Adresse vollständig mit dem Anmeldenamen in Office365 oder Windows korrespondiert.
  
-===== employee.csv ===== +==== Schlüssel, Name, Rufname, Funktion und E-Mail-Adresse der Person (Adresse) einsehen und bearbeiten: ====
-^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ +
-|EmployeeId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel der Adresse.||"MATDGABCD12345-ADDRESS-SIV7GABC789"+
-|SamAccountName||Der linke Teil der E-Mail-Adresse||"tina.vonmuster"+
-|UserPrincipalName||Der linke Teil der E-Mail-Adresse + @ + Domainname*||"tina.vonmuster@schulexyz.onmicrosoft.com"+
-|Usertype||Name der Adresskategorie||"Lehrperson"+
-|FirstName||Ruf-Vorname und wenn nicht vorhanden der Vorname||"Tina"+
-|LastName||Ruf-Nachname und wenn nicht vorhanden der Nachname||"von Muster"+
-|DisplayName||Vorname + " " + Nachname||"Tina von Muster"+
-|JobTitle||Die Funktion des Mitarbeitenden||"Primarlehrer/in"+
- +
-==== Schlüssel, Name, Rufname und E-Mail-Adresse der Person (Adresse) einsehen und bearbeiten: ====+
   - Modul 'Adressen' markieren   - Modul 'Adressen' markieren
   - In das Register 'Adressen' wechseln   - In das Register 'Adressen' wechseln
Zeile 110: Zeile 143:
     - Im Textfeld 'Name' kann der Nachname bearbeitet werden     - Im Textfeld 'Name' kann der Nachname bearbeitet werden
     - Über das Icon rechts des Textfeldes 'Name' kann der Rufname des Nachnamens eingetragen werden     - Über das Icon rechts des Textfeldes 'Name' kann der Rufname des Nachnamens eingetragen werden
 +    - Im Textfeld 'Funktion' kann die Funktion des Mitarbeitenden eingetragen werden
     - Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden     - Im Textfeld 'Schlüssel' kann dieser eingesehen und bearbeitet werden
   - In das Register 'Schule' wechseln   - In das Register 'Schule' wechseln
     - Im Textfeld 'E-Mail' kann die E-Mail-Adresse eingesehen und bearbeitet werden     - Im Textfeld 'E-Mail' kann die E-Mail-Adresse eingesehen und bearbeitet werden
  
 +===== student.csv (gesamt) / activedirectory_student.csv (einzeln) =====
 +Es werden alle aktiven Schüler exportiert, die einer aktiven Klasse zugewiesen sind und eine E-Mail-Adresse hinterlegt haben.
  
- +^Spaltenname Export^^Angaben in LehrerOffice^^gesamt ¹^^einzeln ²^^Beispiel^ 
-===== student.csv ===== +|StudentId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel des Schülers.||  **X**  ||  **X**  ||"MAMCL6DD8O5EC2-STUDENT-MAMCL6DE8ATP459"
-^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ +|SamAccountName||Der linke Teil der E-Mail-Adresse||  **X**  ||  **X**  ||"nikolas.example"
-|StudentId||Zusammengesetzter Schlüssel aus dem Schlüssel der Schuldatenbank und dem Schlüssel des Schülers.||"MAMCL6DD8O5EC2-STUDENT-MAMCL6DE8ATP459"+|UserPrincipalName||Der linke Teil der E-Mail-Adresse + @ + Domainname*||  **X**  ||  **X**  ||"nikolas.example@schulexyz.onmicrosoft.com"
-|SamAccountName||Der linke Teil der E-Mail-Adresse||"nikolas.example"+|Usertype||Fixer Wert für Lernende||  **X**  ||  **X**  ||"Lernende"
-|UserPrincipalName||Der linke Teil der E-Mail-Adresse + @ + Domainname*||"nikolas.example@schulexyz.onmicrosoft.com"+|FirstName||Ruf-Vorname und wenn nicht vorhanden der Vorname||  **X**  ||  **X**  ||"Nik"
-|Usertype||Fixer Wert für Lernende||"Lernende"+|LastName||Ruf-Nachname und wenn nicht vorhanden der Nachname||  **X**  ||  **X**  ||"Example"
-|FirstName||Ruf-Vorname und wenn nicht vorhanden der Vorname||"Nik"+|DisplayName||Vorname + " " + Nachname||  **X**  ||  **X**  ||"Nik Example"
-|LastName||Ruf-Nachname und wenn nicht vorhanden der Nachname||"Example"+|EntranceDate||Eintrittsdatum in der Schule||  **X**  ||  **X**  ||"20.08.2010"
-|DisplayName||Vorname + " " + Nachname||"Nik Example"+|LeavingDate||Austrittsdatum bei Wegzug oder Beenden der Schule||  **X**  ||  **X**  ||"15.07.2019"
-|EntranceDate||Eintrittsdatum in der Schule||"20.08.2010"+|SchoolId||Die SchoolId der zugewiesenen Schuleinheit (siehe school.csv)||  **X**  || ||"MATDGABCD12345-COMMUNITY-DG3JFABC123"| 
-|LeavingDate||Austrittsdatum bei Wegzug oder Beenden der Schule||"15.07.2019"+|ClassName||Anzeigename der zugeteilten Klasse|| ||  **X**  ||"6. Primar"
-|SchoolId||Die SchoolId der zugewiesenen Schuleinheit (siehe school.csv)||"MATDGABCD12345-COMMUNITY-DG3JFABC123"|+|SchoolName||Bezeichnung der Schuleinheit|| ||  **X**  ||"Primarschule Oberdorf"
 +¹) Im Export 'Active Directory - Gesamtexport (Mitarbeitende, Lernende und Klassen/Gruppen)' verfügbar\\ 
 +²) Im Export 'Active Directory - Lernende' verfügbar\\ 
 +*) Ab Version 2020.4: Ist der Domainname leer, wird die E-Mail-Adresse als UserPrincipalName genommen. Dies setzt voraus, dass die E-Mail-Adresse vollständig mit dem Anmeldenamen in Office365 oder Windows korrespondiert.
  
 ==== Schlüssel, Name, Rufname, E-Mail-Adresse, Ein- und Austrittsdatum der Schüler (Schülerdaten) einsehen und bearbeiten: ==== ==== Schlüssel, Name, Rufname, E-Mail-Adresse, Ein- und Austrittsdatum der Schüler (Schülerdaten) einsehen und bearbeiten: ====
Zeile 148: Zeile 187:
  
 ===== employee_group.csv ===== ===== employee_group.csv =====
 +In dieser Datei werden alle Lehrpersonen den Klassen oder Gruppen zugewiesen. Die Fachlehrperson, die einem Fach zugewiesen ist, werden mit der jeweiligen Klasse geliefert.
 +
 ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^
 |GroupId||Die GroupID der jeweiligen Klasse oder Gruppe (siehe group.csv)||"MATDGABCD12345-CLASS-1PRIMAR"| |GroupId||Die GroupID der jeweiligen Klasse oder Gruppe (siehe group.csv)||"MATDGABCD12345-CLASS-1PRIMAR"|
Zeile 174: Zeile 215:
  
 ===== student_group.csv ===== ===== student_group.csv =====
 +Die Zuweisung der Schüler zu den jeweiligen Klassen und Gruppen erfolgt in dieser Datei.
 +
 ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^
 |GroupId||Die GroupId der jeweiligen Klasse oder Gruppe (siehe group.csv)||"MATDGABCD12345-CLASS-1PRIMAR"| |GroupId||Die GroupId der jeweiligen Klasse oder Gruppe (siehe group.csv)||"MATDGABCD12345-CLASS-1PRIMAR"|
Zeile 188: Zeile 231:
  
 ===== employee_school.csv ===== ===== employee_school.csv =====
 +Die Zuweisung der Mitarbeiter zu einer oder mehreren Schuleinheiten erfolgt in dieser Datei.
 +
 ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^ ^Spaltenname Export^^Angaben in LehrerOffice^^Beispiel^
 |SchoolId||Die SchoolId der jeweiligen SchoolId (siehe school.csv)||"MAMCL6DD8O5EC2-COMMUNITY-DG3JF3P1V31"| |SchoolId||Die SchoolId der jeweiligen SchoolId (siehe school.csv)||"MAMCL6DD8O5EC2-COMMUNITY-DG3JF3P1V31"|
Drucken/exportieren
QR-Code
QR-Code lehreroffice:zusatz:export:activedirectory_gesamtexport (erstellt für aktuelle Seite)