Verfügbar für: Template Engine (ab Version 6.7.2)
Aufgabe: Kundenspezifische Prozedur, die das Import-Journal verarbeitet. Im Zuge dieser Vararbeitung können beispielsweise weitere Dateien für den Export markiert werden (siehe den Befehl obj touch).
Zusatzinformationen: siehe Import und Export.
Syntax:
importCallback importJournal
Funktionsparameter:
importJournal: Der Pfad zum Import-Journal. Die Funktion darf die Datei nicht modifizieren.Rückgabewert bei Erfolg: keiner
Das Import-Journal ist eine Aufzeichnung aller für eine Datei relevanten Aktionen während der Import-Phase. Das Journal enthält pro Zeile einen Eintrag der Form
Code Dateipfad
Code ist ein einzelnes Zeichen, das die Art der Änderung spezifiziert. Der Dateipfad ist der CMS-Pfad der betreffenden Datei. Zeilen, die mit einem Doppelkreuz (#) beginnen, sind Kommentare.
Das Import-Journal zeichnet die folgenden Änderungen auf und markiert sie mit dem jeweils angegebenen Code:
c: Die Datei mit dem angebenen Pfad wurde angelegt.
u: Ein Dateifeld (beispielsweise suppressExport) wurde geändert. Dieser Typ wird nicht bei Änderungen des Namens oder des darüber liegenden Ordners (parent) aufgezeichnet. Stattdessen werden dafür die Typen m und M aufgezeichnet.
r: Die Datei wurde gelöscht.
m: Die Datei wurde verschoben (der Pfad hat sich geändert). Der angegebene Pfad ist der bisherige Pfad der Datei. Auf diesen Eintrag folgt stets unmittelbar ein M-Eintrag.
M: Die Datei wurde verschoben (der Pfad hat sich geändert). Der angegebene Pfad ist der neue Pfad der Datei. Dieser Eintrag folgt stets unmittelbar auf einen m-Eintrag.
U: Der Inhalt der Datei wurde geändert (die Datei wurde freigegeben).
R: Der Inhalt der Datei wurde gelöscht (die Datei wurde zurückgezogen).
Das Import-Journal wird bei erfolgreicher Durchführung der Phase importCB geleert. Liefert der Import-Callback einen Fehler, so bleiben alle Einträge im Journal erhalten. Neue Einträge werden ans Ende des Journals angehängt.
Beispiel eines Import-Journals:
# This file is generated automatically.
# Only the TE is allowed to modify it.
u /
c /internet
c /internet/playland
c /internet/playland/de
c /internet/playland/de/wirueberuns
c /internet/playland/de/wirueberuns/faq
c /internet/playland/de/wirueberuns/faq/probiermodus
c /internet/playland/de/wirueberuns/faq/schadstofffreiheit
c /internet/playland/de/wirueberuns/faq/bestellung
c /internet/playland/de/wirueberuns/faq/verfuegbarkeit
U /
U /internet
U /internet/playland
U /internet/playland/de
U /internet/playland/de/wirueberuns
U /internet/playland/de/wirueberuns/faq
U /internet/playland/de/wirueberuns/faq/probiermodus
U /internet/playland/de/wirueberuns/faq/schadstofffreiheit
U /internet/playland/de/wirueberuns/faq/bestellung
U /internet/playland/de/wirueberuns/faq/verfuegbarkeit