Personen-Import

Scheduler Tasks

Der Import der Personen-Datensätze ist als Scheduler-Tasks umgesetzt, die automatisch zeitgesteuert ausgeführt werden.

Der inkrementelle Import erfolgt alle 5 Minuten zwischen 01:00 und 23:55 Uhr.
Der Komplettabgleich erfolgt nächtlich um 00:00 Uhr. 

Durch die "Play-Buttons" (1) können die Tasks manuell gestartet werden. 

Über das Aktivieren der Checkbox "Full Import (otherwise incremental)" in den Task-Einstellungen kann bestimmt werden, ob ein Komplett- oder ein Teilimport durchgeführt werden soll.

Hinweis
Das "Planer"-Modul und somit der Zugriff auf die Scheduler Tasks steht nur BE-Benutzern mit Admin-Berechtigung zur Verfügung!

Manuelles Starten der Tasks über die Shell

Die Tasks können auch manuell über die Shell angestossen werden: 

Komplettabgleich: 
/var/www/html/releases/current/cms/typo3/sysext/core/bin/typo3 scheduler:run --task=1 -f

Inkrementell: 
/var/www/html/releases/current/cms/typo3/sysext/core/bin/typo3 scheduler:run --task=2 -f

Der Parameter "Task" ist die ID des jeweiligen Tasks, dieser muss ggfs. angepasst werden.

Import-Logik

Der Import ist in zwei unterschiedliche Tasks aufgeteilt. 

Inkrementeller Import

Der inkrementelle, alle 5 Minuten ausgeführte Import verarbeitet die Daten aus der XML-Datei 
/var/cache/typo3/contacts/incremental-upload-*.xml

Dabei werden die Dateien sortiert nach dem Dateinamen (insbesondere dem Timestamp) abgearbeitet.

Beim inkrementellen Import werden die in der o.g. XML-Datei enthaltenen Daten verarbeitet und die entsprechenden Personen-Datensätze aktualisiert bzw. neu hinzugekommene Personen / Rollen / Räume angelegt. Es erfolgt kein Abgleich auf gelöschte Personen / Rollen / Räume. 

Nach dem Import wird die verarbeitete XML-Datei gelöscht.

Komplett-Import

Der komplette, nächtlich um 00:00 Uhr ausgeführte Import verarbeitet die Daten aus der XML-Datei 
/var/cache/typo3/contacts/full-upload.xml

Beim Komplettimport werden zunächst alle Personen / Rollen / Räume auf hidden=1 (also deaktiviert) gesetzt. Die in der o.g. XML-Datei enthaltenen Daten werden verarbeitet und die entsprechenden Datensätze, die in der XML-Datei vorhanden sind, wieder aktiviert und aktualisiert, neu hinzugekommene Personen / Rollen / Räume werden angelegt.

Nach dem Import wird die verarbeitete XML-Datei gelöscht.

Logging

Die Importvorgänge werden in einer Log-Datei protokolliert und in /var/cache/typo3/logs abgelegt. Pro Importvorgang wird eine Logdatei angelegt, z.B. full-upload-20180425140023.log oder incremental-upload-20180313113543-48b24aa2-5bf3-43f4-a577-f4fd17605287.log

Datensätze

Die Personen-Datensätze werden in den Ordner "Hochschule Trier > Daten > Personen" importiert. 

Die einzelnen Datensätze können (bei entsprechender Berechtigung) geöffnet und gespeichert werden, das Editieren der einzelnen Felder ist aber nicht möglich ("read-only")

back-to-top nach oben