Hilfe

Hinweise:

Zu importierende Dateien, zum Beispiel Bilder, müssen im gleichen Ordner wie die zugehörige XML-Datei oder in Unterordnern im gleichen Verzeichnis gespeichert werden. Das Verzeichnis wird im Systemparameter ImportDirectory im Ordner XMLImport (Systemparameter) definiert.
Die zu importierende XML-Datei darf maximal 5 MB groß sein.

Mit der Web-Service-Operation startImport können Sie einen XML-Import erstellen und starten, auch wenn ein externer Daemon verwendet wird. Mithilfe von externen Daemons können mehrere XML-Importe parallel gestartet werden. Beachten Sie auch die allgemeinen Web-Services-Fehlercodes. Es wird die ID des XML-Imports zurückgegeben.

Parameter	Datentyp	Verwendung	Beschreibung
`daemonId`	String	Optional	Die Prozess-ID des externen Daemons.
`p_sImportFile`	String	Erforderlich	Der Name der Importdatei aus dem XML-Importordner und der Dateipfad.
`p_sConfigFile`	String	Erforderlich	Der Name der Importprofildatei aus dem XML-Importordner und der Dateipfad.
`p_sImportLanguageId`	String	Erforderlich	Die ID der Sprache.
`p_sPratImportMode`	String	Erforderlich	Sie müssen definieren, wie mit Produktattributwerten umgegangen wird. Beim Bearbeiten und beim Zuordnen eines Produktattributs in Viamedici EPIM können Sie definieren, ob die Produktattributwerte auf Hierarchieebene, auf Produktebene oder auf Produktvariantenebene bearbeitbar, sichtbar oder ausgeblendet sind: `1`: Bearbeitbarkeit prüfen. `2`: Bearbeitbarkeit prüfen; gesperrte ignorieren. `3`: Bearbeitbarkeit ignorieren. `4`: Bearbeitbarkeit erzwingen. Detaillierte Beschreibungen zur Bearbeitbarkeit finden Sie in den XML-Importeinstellungen (Importszenarien).
`p_sCheckTimestamp`	String	Erforderlich	Sie müssen definieren, ob Objekte importiert werden, deren Änderungsdatum neuer ist als das Exportdatum. Mögliche Werte: `0`: Geänderte Objekte importieren. `1`: Geänderte Objekte nicht importieren.
`p_sIgnoreMustAttr`	String	Erforderlich	Sie müssen definieren, ob leere Produktattributwerte importiert werden können, auch wenn für die Produktattribute definiert ist, dass die Produktattributwerte keine optionalen Eingabefelder sind. `0`: Produktattribute mit leeren Produktattributwerten werden nicht importiert, wenn für die Produktattribute definiert ist, dass die Produktattributwerte keine optionalen Eingabefelder sind. `1`: Produktattribute werden mit leeren Produktattributwerten importiert, auch wenn für die Produktattribute definiert ist, dass die Produktattributwerte keine optionalen Eingabefelder sind.
`p_sViaCONTENT`	String	Erforderlich	Sie müssen definieren, wie Elemente importiert werden. Mögliche Werte: `0`: Erstellen und Update. Neue Elemente werden erstellt und vorhandene Elemente werden upgedatet. `1`: Nur Updates. Vorhandene Elemente werden upgedatet. `2`: Nur Zuordnen. Elemente werden Hierarchien, Produkten oder Produktvarianten zugeordnet.
`p_sViaPRODUCT`	String	Erforderlich	Sie müssen definieren, wie Hierarchien, Produkte und Produktvarianten importiert werden. Mögliche Werte: `0`: Erstellen und Update. Neue Hierarchien, Produkte und Produktvarianten werden erstellt und vorhandene Hierarchien, Produkte und Produktvarianten werden upgedated. `1`: Nur Updates. Vorhandene Hierarchien, Produkte und Produktvarianten werden upgedatet. `2`: Nur Zuordnen. Hierarchien, Produkten oder Produktvarianten werden anderen Hierarchien, Produkten oder Produktvarianten zugeordnet und dadurch werden Beziehungen erstellt.
`p_sViaDict`	String	Erforderlich	Sie müssen definieren, wie Wörterbucheinträge importiert werden. Mögliche Werte: `0`: Erstellen und Update. Neue Wörterbucheinträge werden erstellt und vorhandene Wörterbucheinträge werden upgedatet. `1`: Nur Updates. Vorhandene Wörterbucheinträge werden upgedatet. `2`: Nicht importieren. Wörterbucheinträge werden nicht importiert.
`p_sReimportUnformDict`	String	Erforderlich	Sie müssen definieren, ob Wörterbucheinträge formatiert oder unformatiert importiert werden. Mögliche Werte: `0`: Wörterbucheinträge werden mit Formatierung importiert. `1`: Wörterbucheinträge werden unformatiert importiert.
`p_sCoatImportMode`	String	Erforderlich	Sie müssen definieren, wie mit Elementattributen umgegangen wird. Beim Bearbeiten und beim Zuordnen eines Elementattributs in Viamedici EPIM können Sie definieren, ob die Elementattributwerte des Wurzelelements und der Elementvarianten bearbeitbar, sichtbar oder ausgeblendet sind: `1`: Bearbeitbarkeit prüfen. `2`: Bearbeitbarkeit prüfen, nicht bearbeitbare ignorieren. `3`: Bearbeitbarkeit ignorieren. `4`: Bearbeitbarkeit erzwingen. Detaillierte Beschreibungen zur Bearbeitbarkeit finden Sie in den XML-Importeinstellungen (Importszenarien).
`p_sMatchReferencesMode`	String	Erforderlich	Sie müssen definieren, wie Referenzen abgeglichen werden. `0`: Hierarchien, Produkte, Produktvarianten und Referenzen von Hierarchien, Produkte und Produktvarianten werden geprüft. `1`: Alle Objekte, keine Referenzen: Es werden nur Hierarchien, Produkte und Produktvarianten geprüft, die nicht als Referenzen gekennzeichnet sind. `2`: Nur Referenzen: Es werden nur Hierarchien, Produkte und Produktvarianten geprüft, die als Referenzen gekennzeichnet sind.
`p_sCollectionId`	String	Optional	Sie können die ID einer Sammlung angeben, der die importierten Objekte zugeordnet werden.
`p_sCollectionNote`	String	Optional	Sie können eine Notiz im Kollaborationsprotokoll der Sammlung hinzufügen. Es können maximal 300 Zeichen eingegeben werden.

startImport (XMLImportService, Web-Service-Operation)

Die REST-URL kann wie folgt definiert werden:

http://<SERVERNAME>:5555/axis2/services/XMLImportService/startImport?p_sImportFile=<\\[SERVERNAME]|[DriveLetter]:>\EPIMFS\produktion\import\image_test.xml&p_sConfigFile=<\\[SERVERNAME]|[DriveLetter]:>\EPIMFS\produktion\import\profiles\default_config.xml&p_sImportLanguageId=1234&p_sPratImportMode=1&p_sCheckTimestamp=1&p_sIgnoreMustAttr=1&p_sViaCONTENT=0&p_sViaPRODUCT=0&p_sViaDict=0p_sReimportUnformDict=1&p_sCoatImportMode=1&p_sMatchReferencesMode=0&p_sCollectionId=1234&p_sCollectionNote=Imported

Für Parameter, deren Wert einen Backslash beinhaltet, z. B. in Form eines Dateipfads, muss der Backslash in der REST-URL durch %5C ersetzt werden, um eine gültige URL zu erhalten:

http://<SERVERNAME>:5555/axis2/services/XMLImportService/startImport?p_sImportFile=<%5C%5C[SERVERNAME]|[DriveLetter]:>%5CEPIMFS%5Cproduktion%5Cimport%5Cimage_test.xml&p_sConfigFile=<%5C%5C[SERVERNAME]|[DriveLetter]:>%5CEPIMFS%5Cproduktion%5Cimport%5Cprofiles%5Cdefault_config.xml&p_sImportLanguageId=1234&p_sPratImportMode=1&p_sCheckTimestamp=1&p_sIgnoreMustAttr=1&p_sViaCONTENT=0&p_sViaPRODUCT=0&p_sViaDict=0p_sReimportUnformDict=1&p_sCoatImportMode=1&p_sMatchReferencesMode=0&p_sCollectionId=1234&p_sCollectionNote=Imported