XIP Transformation

Ab IES-Version 2.14

Der IES-XIP Export läßt sich als Migrations-Werkzeug verwenden, um alte Datenbestände des IES in eine neue Struktur umzuwandeln. Die Definition der Mappings für die Migration erfolgt über SPML-Templates. Dabei erzeugen die Templates XIP-XML um die Daten eines Artikels zu beschreiben.

Konzept

Für jedes Seiten-Template wird ein korrespondierendes Migrations-Template angelegt. Die Verknüpfung zwischen Seiten-Template und Migrations-Template erfolgt über den Anchor-Namen. Das Migrations-Template muss den gleichen Anchor wie des Seiten-Template mit einem zusätzlichen Prefix bekommen. Diese Template-Prefix wird beim Export mit angegeben.

Beim normalen XIP-Export werden die XIP-Daten direkt für den Artikel erzeugt. Ist ein Template-Prefix angegeben sucht der XIP-Prozess nach einem passenden Migrations-Template und führt dieses mit dem Artikel aus. Die vom Template erzeugten XIP-Daten werden als Export-Daten verwendet.

Artikel-Pool-Strukturen können über den Export nicht verändert werden. Daten eines Artikel-Pools können über ein Template [ANCHOR-PREFIX]article.pool aber definiert werden.

Medien können über ein Template [ANCHOR_PREFIX]media definiert werden.

Der Template-Prefix kann wie folgt gesetzt werden:

Kommandozeile

--transformTemplatePrefix [prefix]

XIP-Manager

Beim Export im Reiter 'Export Transformation' kann der Template-Prefix angegeben werden.

Alternativ zu Templates können auch SPML-Dateien in Module verwendet werden. Hierbei wird anstatt eines Anchor-Prefix der Datei-Pfad zu den Dateien angegeben. Hiebei wird auch angegeben in welchem Module die Dateien zu finden sind.

Der Template-Pfad kann wie folgt gesetzt werden:

Kommandozeile

--transformModuleTemplatePath [moduleId]:/path/to/dir

XIP-Manager

Beim Export im Reiter 'Export Transformation' kann der Template-Pfad angegeben werden.

Best practice

• Einzelne Abschnitte sollten in jeweils eigenen Templates definiert und inkludiert werden
• Daten die unverändert übernommen werden sollen können mit der SPML-Methode toXIP() generiert werden
• Wenn die Daten in dem gleichen Mandanten wieder importiert werden sollen, dürfen keine bestehenden Anchor exportiert werden. Um dies zu verhindern kann die Export-Regel 'Immer Auto-Anchor setzten, auch wenn ein Anchor existiert' (Kommandozeile: --forceAutoAnchor angewendet werden.
• Um durch die Content-Felder eines Artikels zu iterieren kann system.information.all verwendet werden.