Kommandozeilen-Tool - Versionsgeschichte

Sed: /* Import */

2020-08-07T12:37:54Z

Import

Sed: /* Export */

2020-08-07T12:37:34Z

Export

Hying: /* Allgemein */

2019-04-30T10:27:46Z

Allgemein

Sed: /* Import */

2010-04-06T09:00:22Z

Import

Sed am 27. Januar 2010 um 10:38 Uhr

2010-01-27T10:38:59Z

Sed: Die Seite wurde neu angelegt: „==Allgemein== Der Import von Daten via XML ist über eine native Java-Schnittstelle möglich. Eine Verknüpfung mit anderen Daten ist hierbei vollständig über …“

2010-01-18T15:41:49Z

Die Seite wurde neu angelegt: „==Allgemein== Der Import von Daten via XML ist über eine native Java-Schnittstelle möglich. Eine Verknüpfung mit anderen Daten ist hierbei vollständig über …“

Neue Seite

==Allgemein==
Der Import von Daten via XML ist über eine native Java-Schnittstelle möglich.

Eine Verknüpfung mit anderen Daten ist hierbei vollständig über Anker realisiert. Dadurch sind sowohl Beziehungen zu neuen, wie auch vorhandenen Daten möglich. Jedes Element muss für den Import über einen eindeutigen Anker verfügen. Dieser dient als Primärschlüssel. Bei einem nochmaligen Import wird das entsprechende Element hierüber identifiziert und aktualisiert. Auch Verknüpfungen mit anderen Elementen z.B. für Systemlinks erfolgen über den Anker. Auch die Angabe des "<code>parent</code>" für Elemente, wie auch die Beziehung zum Template erfolgt über einen Anker.

Der Import kann beliebig oft ausgeführt werden. Ist ein Element bereits vorhanden, werden die in XML beschriebenen Felder ersetzt bzw. ergänzt. Auf diese Weise können auch wechselseitige Beziehungen zwischen Elementen und Pools importiert werden.

Importiert werden können:
*Einzelne XML-Dateien
:Ein XML-Dokument das sich genau auf einen Artikel bzw. Artikelpool bezieht, kann einzeln importiert werden
*Eine Ordnerstruktur von XML-Dateien
:Eine verschachtelte Ordnerstruktur mit XML-Daten kann verwendet werden, um mehrere XML-Dokumente zu importieren. Dabei kann die Verschachtelung verwendet werden, um auf die Reihenfolge des Imports Einfluss zu nehmen. Artikelpools sollten in der Regel vor Artikeln, die in diesem neuen Pool gespeichert werden sollen, importiert werden. Die Verschachtelung der XML-Dokumente hat dabei keinen direkten Einfluss auf Beziehungen im IES. Diese Beziehungen werden ausschließlich über Anker realisiert. Aber dadurch, dass ein Pool oder Element in einem Ordner "oberhalb" eines anderen Elementes liegt, wird dieses zuerst importiert. Zum ersten Elemente kann das zweite dann eine Beziehung über den Anker aufbauen.

*XIP-Dateien
:XIP Dateien sind gezippte XML-Strukturen (siehe oben). Der Vorteil liegt darin, dass bei einem Upload nur eine Datei angegeben werden muss. Dieses Format wird in Zukunft noch weiter ausgebaut.

==Import==
Für den Import wird das Java-Commandline-Tool "<code>iespkg</code>" ausgeführt. Es werden folgende Parameter benötigt:
<source lang="xml">
usage: iespkg import <login> <password> <client> <pkg-file>
</source>

;<code>import</code>
:Das eigentliche Kommando dieses Tools. Zur Zeit ist hier nur "<code>import</code>" möglich.
;<code>login</code>
:Account, mit dem die Daten angelegt werden sollen. Beachten Sie bitte, dass ausreichende Rechte für den Import gegeben sind.
;<code>password</code>
:Das Passwort des Accounts.
;<code>client</code>
:Der Namespace / Anker des Mandanten, in den die Daten importiert werden sollen. In diesem Mandanten muss auch der Nutzer des Imports konfiguriert sein.
;<code>pkg-file</code>
:Die XML-Datei bzw. der Ordner oder das XIP-Paket mit den XML-Dateien, in denen die Informationen für den Import stehen.

Alternativ kann der Import in einer Property-Datei konfiguriert werden. Damit lassen sich auch Einstellungen zum Logging vornehmen. Der Aufruf ist dann nur noch der folgende:
<source lang="xml">
usage: iespkg <property-file> <pkg-file>
</source>

Zur erweiterten Steuerung des Imports können noch Parameter angegeben werden.
<source lang="xml">
usage: iespkg import <login> <password> <client> <pkg-file> --<parameter> --<parameter> ...
</source>
oder
<source lang="xml">
usage: iespkg <property-file> <pkg-file> --<parameter> --<parameter> ...
</source>

<div class="note">
'''Hinweis:''' Die --<parameter> müssen unter Windows in Anführungszeichen gefasst werden.
</div>

<source lang="xml">
usage: iespkg <property-file> <pkg-file> "--<parameter>" "--<parameter>" ...
</source>

;<code>--ies.xip.import.publishMode=all|all-file</code>
:Publiziert alle zu importierenden Artikel entwender in allen Publishern des Mandanten (<tt>all</tt>) oder in allen File-Publishern <tt>all-file</tt>). Die in den XML-Daten angegebenen Publisher-Stati werden ignoriert.

;<code>--ies.xip.import.publisher=anchor[,anchor,...]</code>
:Publiziert alle zu importierenden Artikel in den angegebenen Publishern. Die in den XML-Daten angegebenen Publisher-Stati werden ignoriert.

;<code>--ies.xip.import.createPools=true|false</code>
:Pools die noch nicht existieren werden angelegt. Default ist <tt>true</tt>

;<code>--ies.xip.import.updatePools=true|false</code>
:Pools die existieren werden aktualisiert. Default ist <tt>true</tt>

;<code>--ies.xip.import.deletePools=true|false</code>
:Pools die mit diesem XIP einmal importiert wurden, aber jetzt nicht mehr darin enthalten sind, werden gelöscht. Default ist <tt>false</tt>.
:Die Pools können nur gelöscht werden, wenn die Pools mit einem XIP-Package importiert wurden, das eine ID (<tt>ies.xip.id</tt>) und eine Version (<tt>ies.xip.version</tt>) besitzt.

;<code>--ies.xip.import.deleteOnlyEmptyPools=true|false</code>
:Löscht nur leere Pools. Default ist <tt>false</tt>

;<code>--ies.xip.import.createElements=true|false</code>
:Elemente, die noch nicht existieren, werden angelegt. Default ist <tt>true</tt>

;<code>--ies.xip.import.updateElements=true|false</code>
:Elemente, die existieren, werden aktualisiert. Default ist <tt>true</tt>

;<code>--ies.xip.import.deleteElements=true|false</code>
:Elemente die mit diesem XIP einmal importiert wurden, aber jetzt nicht mehr darin enthalten sind, werden gelöscht. Default ist <tt>false</tt>.
:Die Elemente können nur gelöscht werden, wenn die Elemente mit einem XIP-Package importiert wurden, das eine ID (<tt>ies.xip.id</tt>) und eine Version (<tt>ies.xip.version</tt>) besitzt.

;<code>--ies.xip.import.ignoreParents</code>
:Ignoriert den Parent, wenn der Pool oder das Element schon existiert. Der Pool oder das Element wird nicht zu dem angegebenen Parent verschoben. Default ist <tt>true</tt>

;<code>--ies.xip.import.checkVersion=true|false</code>
:Ist dieser Parameter <tt>true</tt>, wird der Import nur bei gleichen oder neueren Versionen vorgenommen. Anderenfalls wird der Import auch bei niedrigeren Versionen vorgenommen. Default ist <tt>true</tt>

;<code>--ies.xip.import.checkDepends=true|false</code>
:Ist dieser Parameter <tt>true</tt>, prüft der Importer, ob alle für dieses XIP-Paket benötigten XIP-Pakete installiert sind. Default ist <tt>true</tt>

;<code>--ies.xip.import.anchor.replace=regex:replacement</code>
:Ersetzt Teile von Anchor-Namen. Der zu ersetzende Teil wird mit einem regulären Ausdruck definiert. Mit einem Doppelpunkt (:) getrennt, wird die Zeichenkette angegeben, die eingetragen werden soll.

;<code>--ies.xip.import.listener=javaclass[,javaclass,...]</code>
:In Java implementierbare Listener, die während des Imports auf bestimmte Ereignisse warten und dann ausgeführt werden.

← Nächstältere Version		Version vom 30. April 2019, 10:27 Uhr
Zeile 1:		Zeile 1:
		+	Für den XIP Im- und Export soll das aktuelle Kommando [[XIP_iesxip \| iesxip]] verwendet werden.
		+
	==Allgemein==		==Allgemein==
	Der Import und Export von Daten via XML.		Der Import und Export von Daten via XML.

← Nächstältere Version		Version vom 6. April 2010, 09:00 Uhr
Zeile 98:		Zeile 98:
	:In Java implementierbare Listener, die während des Imports auf bestimmte Ereignisse warten und dann ausgeführt werden.		:In Java implementierbare Listener, die während des Imports auf bestimmte Ereignisse warten und dann ausgeführt werden.

		+	;<code>--ies.xip.import.xslt=xsltfile</code>
		+	:XSLT-Datei mit Regeln zur Transformation der XML-Daten vor dem Import
		+
		+	;<code>--ies.xip.import.syncfile=syncfile</code>
		+	:Datei, in der die Importe für spätere Aufrufe erfasst werden. Ein erneuter Import der Daten mit Angabe dieses Sync-Files, gleicht die vorhandenen Daten mit den XIP-Daten ab. Früher importierte Elemente, die nicht mehr in den XIP-Daten enthalten sind, werden im IES gelöscht (bei <code>--ies.xip.import.deleteElements=true</code> und <code>--ies.xip.import.deletePools=true</code>) oder depubliziert.

	==Export==		==Export==

@@ Zeile 47: / Zeile 47: @@
 usage: iespkg <property-file> <xipfile|xipdir> --<parameter> --<parameter> ...
 </source>
 <source lang="xml">

@@ Zeile 1: / Zeile 1: @@
 ==Allgemein==
-Der Import von Daten via XML ist über eine native Java-Schnittstelle möglich.
+Der Import und Export von Daten via XML.
-Eine Verknüpfung mit anderen Daten ist hierbei vollständig über Anker realisiert. Dadurch sind sowohl Beziehungen zu neuen, wie auch vorhandenen Daten möglich. Jedes Element muss für den Import über einen eindeutigen Anker verfügen. Dieser dient als Primärschlüssel. Bei einem nochmaligen Import wird das entsprechende Element hierüber identifiziert und aktualisiert. Auch Verknüpfungen mit anderen Elementen z.B. für Systemlinks erfolgen über den Anker. Auch die Angabe des "<code>parent</code>" für Elemente, wie auch die Beziehung zum Template erfolgt über einen Anker.
+Eine Verknüpfung mit anderen Daten ist hierbei vollständig über Anker realisiert. Dadurch sind sowohl Beziehungen zu neuen, wie auch vorhandenen Daten möglich. Jedes Element muss für den Import bzw. Export über einen eindeutigen Anker verfügen. Dieser dient als Primärschlüssel. Bei einem nochmaligen Import/Export wird das entsprechende Element hierüber identifiziert und aktualisiert. Auch Verknüpfungen mit anderen Elementen z.B. für Systemlinks erfolgen über den Anker. Auch die Angabe des "<code>parent</code>" für Elemente, wie auch die Beziehung zum Template erfolgt über einen Anker.
-Der Import kann beliebig oft ausgeführt werden. Ist ein Element bereits vorhanden, werden die in XML beschriebenen Felder ersetzt bzw. ergänzt. Auf diese Weise können auch wechselseitige Beziehungen zwischen Elementen und Pools importiert werden.
+Ein Import kann beliebig oft ausgeführt werden. Ist ein Element bereits vorhanden, werden die in XML beschriebenen Felder ersetzt bzw. ergänzt. Auf diese Weise können auch wechselseitige Beziehungen zwischen Elementen und Pools importiert werden.
 Importiert werden können:
@@ Zeile 18: / Zeile 18: @@
 Für den Import wird das Java-Commandline-Tool "<code>iespkg</code>" ausgeführt. Es werden folgende Parameter benötigt:
 <source lang="xml">
-usage: iespkg import <login> <password> <client> <pkg-file>
+usage: iespkg import <login> <password> <client> <xipfile|xipdir>
 </source>
 ;<code>import</code>
-:Das eigentliche Kommando dieses Tools. Zur Zeit ist hier nur "<code>import</code>" möglich.
+:Das eigentliche Kommando dieses Tools.
 ;<code>login</code>
 :Account, mit dem die Daten angelegt werden sollen. Beachten Sie bitte, dass ausreichende Rechte für den Import gegeben sind.
@@ Zeile 29: / Zeile 29: @@
 ;<code>client</code>
 :Der Namespace / Anker des Mandanten, in den die Daten importiert werden sollen. In diesem Mandanten muss auch der Nutzer des Imports konfiguriert sein.
-;<code>pkg-file</code>
+;<code>xipfile|xipdir</code>
 :Die XML-Datei bzw. der Ordner oder das XIP-Paket mit den XML-Dateien, in denen die Informationen für den Import stehen.
 Alternativ kann der Import in einer Property-Datei konfiguriert werden. Damit lassen sich auch Einstellungen zum Logging vornehmen. Der Aufruf ist dann nur noch der folgende:
 <source lang="xml">
-usage: iespkg <property-file> <pkg-file>
+usage: iespkg <property-file> <xipfile|xipdir>
 </source>
 Zur erweiterten Steuerung des Imports können noch Parameter angegeben werden.
 <source lang="xml">
-usage: iespkg import <login> <password> <client> <pkg-file> --<parameter> --<parameter> ...
+usage: iespkg import <login> <password> <client> <xipfile|xipdir> --<parameter> --<parameter> ...
 </source>
 oder
 <source lang="xml">
-usage: iespkg <property-file> <pkg-file> --<parameter> --<parameter> ...
+usage: iespkg <property-file> <xipfile|xipdir> --<parameter> --<parameter> ...
 </source>
@@ Zeile 51: / Zeile 51: @@
 <source lang="xml">
-usage: iespkg <property-file> <pkg-file> "--<parameter>" "--<parameter>" ...
+usage: iespkg <property-file> <xipfile|xipdir> "--<parameter>" "--<parameter>" ...
 </source>
@@ Zeile 97: / Zeile 97: @@
 ;<code>--ies.xip.import.listener=javaclass[,javaclass,...]</code>
 :In Java implementierbare Listener, die während des Imports auf bestimmte Ereignisse warten und dann ausgeführt werden.