Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

lehreroffice:zusatzprogramme:service-schnittstelle:datenschnittstelle_konfiguration_-_eigenstaendige_aufgaben [2014/07/30 11:56] (aktuell)
Zeile 1: Zeile 1:
 +====== Datenschnittstelle Konfiguration – Eigenständige Aufgaben ======
 +Öffnen Sie auf Windows das '​LehrerOffice Service Konfigurationsprogramm'​ bzw. auf Mac die App '​LehrerOffice_Service Konfiguration'​ (im Ordner Programme > LehrerOffice_Service) und wechseln Sie in das Register '​Eigenständige Aufgaben'​.
 +
 +===== Eigenständige Aufgaben =====
 +Diese Aufgaben können unabhängig von der Schulverwaltungslösung eingesetzt werden. Sie werden mit dem Parameter /​K:​[task.ini] aufgerufen, wobei die Konfigurationsdatei im Aufgaben-Ordner (Standard: %main%\Aufgaben) liegen muss. Sie haben keine Abhängigkeit zu anderen Aufgaben, daher wird nur die angegebene und keine andere ausgeführt.
 +
 +Um eine neue Aufgabe zu erstellen, klicken Sie auf 'Neue Aufgabe'​. Hier können Sie nun den Namen der Datei festlegen, die im konfigurierten Aufgabenordner abgelegt wird. Zusätzlich müssen Sie direkt eine Aufgabe auswählen. Falls mindestens eine Aufgabe in diesem Ordner vorhanden ist, können Sie diese Dateien auswählen und die Einstellungen bearbeiten.
 +
 +Standardmässig werden hier die Einstellungen aus der globalen „LehrerOffice_Service.ini“ angezeigt. Falls Sie diese für eine einzelne Aufgabe überschreiben möchten, müssen Sie das explizit mit dem Anklicken des Kästchens verdeutlichen. Erst danach können Sie den Wert ändern, der dann in der ausgewählten Aufgabendatei und nicht in der „LehrerOffice_Service.ini“ gespeichert wird. Falls Sie wieder den globalen Wert verwenden möchten, können Sie einfach das Häkchen entfernen.
 +
 +==== Aufbau der Aufgaben-Dateien ====
 +Die Konfigurationsdatei muss eine „task“-Sektion haben, worin der Name der Aufgabe angegeben sein muss. In dieser Datei können alle in der LehrerOffice_Service.ini gesetzten Parameter (z.B. DB, SMTP, Pfade) überschrieben werden, um vom Austauschprozess unabhängige Aufgaben ausführen zu können.
 +
 +Mögliche Aufgaben:
 +
 +<​code>​LehrerOffice_Service.exe /​K:​Datensicherung.ini</​code>​
 +
 +Beispiel einer Konfigurationsdatei für eine Datensicherung:​
 +
 +<​code>​[task]
 +name=backup_cleanup
 +
 +[backup]
 +filename=EigeneSicherung
 +minsize=2048
 +
 +[cleanup]
 +backupdays=14
 +excludeprefix=Fehler_
 +
 +[path]
 +backup=C:​\Backup
 +
 +[smtp]
 +send=1
 +subject=Backup-Fehlermeldung
 +attach=1
 +</​code>​
 +
 +==== Aufgabe – Daten sichern und aufräumen ====
 +
 +Mit dieser Aufgabe wird eine Datensicherung der Datenbank von LehrerOffice ausgeführt. Diese allgemeine Aufgabe kann unabhängig von der Schulverwaltungslösung eingesetzt werden. Es wird empfohlen vor jedem Import eine Sicherung zu erstellen.
 +
 +Die Backup-Funktion speichert die Datensicherungen automatisch im Datensicherungsordner gemäss den [[lehreroffice:​zusatzprogramme:​service-schnittstelle:​datenschnittstelle_konfiguration_-_einstellungen|Grundeinstellungen]]. Aus Sicherheitsgründen wird eine andere Dateiendung (.~db) als für die produktive Datendatei (.db) verwendet, damit mit der CleanUp-Funktion das falsche Löschen ausgeschlossen werden kann. Nach der ausgeführten Sicherung werden das Datum, die Uhrzeit sowie die Dateigrösse der Datensicherungsdatei geprüft. ​
 +
 +==== Aufgabe – Export ====
 +
 +Mit dieser Aufgabe können Daten aus der Datenbank von LehrerOffice in CSV-Dateien exportiert werden. Für den Export werden SQL-Statements aus einer SQL-Datei ausgelesen und in eine gleichnamige Datei mit der Endung .CSV geschrieben. Der Zielordner kann konfiguriert werden, genauso wie das Trennzeichen (";"​) und das Encoding (UTF8).
 +
 +Beispiel einer Konfigurationsdatei für den Export der Lehrpersonen und Schüler:
 +
 +<​code>​
 +[task]
 +name=export
 +
 +[export]
 +output=%main%\Exports\
 +;​delimiter=;​
 +;​encoding=utf8
 +;​quote="""​
 +
 +[sqlfiles]
 +%main%\SQLs\Export_Lehrpersonen.sql=1
 +%main%\SQLs\Export_Schueler.sql=1
 +</​code>​
  
Drucken/exportieren