Import (Integration-Funktion)

a

XML-Struktur für einen Import

BatchImport

<?xml version="1.0" encoding="UTF-8"?>
                            <core:BatchImport ... trxControl="SINGLE">
                            <batch action="DELETE"><base:User id="815">
                            </base:User></batch>
                            <batch action="DELETE"><base:User id="816">
                            </base:User></batch>
                            ...
                            <batch action="DELETE"><base:Role id="151">
                            </base:Role></batch>
                            </core:BatchImport>

• Dieser Batch-Import soll zunächst bestimmte Benutzerkonten und danach eine bestimmte Rolle löschen.

Prinzipiell kann ein geeignetes XML direkt als Text zugewiesen werden.

Typischerweise wird ein Rückgabewert der Intergration-Funktion create xml from node verwendet, die einen Knoten der Zielstruktur auswertet, der einen Batch-Import oder Single-Import definiert (s. a. Beispiel unten).

Ein "Import-Knoten" kann ausgehend von Orchestration-Vorlagen konfiguriert und danach z. B. per Mapping an Quelldaten angebunden werden. Dann wird zur Laufzeit des Profils dynamisch eine lauffähige XML-Struktur inklusive der erforderlichen Namespace-Deklarationen (im Beispiel links weggelassen) erzeugt.

b
(optional)

Name für ein DOM-Objekt, in dem die Ergebnisliste von einem "responsiven" Batch-Import gespeichert werden soll

importResponse

Rückgabewert für das Beispiel zu Parameter a  

<?xml version="1.0" encoding="UTF-8"?>
                            <list ... >
                            <entry id="815" ... xsi:type="base:User">...
                            </entry>
                            <entry id="816" ... xsi:type="base:User">...
                            </entry>
                            ...
                            <entry id="151" ... xsi:type="base:Role">...
                            </entry>
                            </list>

c

XML-Struktur für ein Integration Login

<base:LobsterDataLoginRequest
                            xmlns:base="SCM.BASE" userName="jabend"
                            selectedRole="2" selectedCompany="501" />

Prinzipiell kann ein geeignetes XML direkt als Text zugewiesen werden.

Stattdessen kann auch der Wert einer Variablen zugeordnet werden, der zur Laufzeit per Funktion Create Login Request (Integration-Funktion) befüllt wird.

d
(optional)

deklariert per Wert true den Funktionsaufruf als Testlauf

true (Testlauf, d. h. Import wird nicht ausgeführt)
false oder keine Zuweisung (kein Testlauf, d. h. Import wird ausgeführt)

Die Zuweisung der vom System automatisch verwalteten Variablen VAR_IS_TEST für diesen Parameter kann hilfreich sein, um unerwünschte Importe - etwa bei einem "Mapping Test" - zu verhindern.

Das Berechnungsfeld "resultsCount" verwendet zunächst die Funktion create xml from node, um das XML für den im Knoten "BatchImport" zu erzeugen.

Dabei wird der Parameter b, über den der xml-Header unterdrückt werden kann, nicht verwendet. Das XML enthält den Header also.

Beim anschließenden Aufruf von Import (Integration-Funktion) wird das Batch-Import-XML als Ergebnis im Paramter a eingebunden.

Der Parameter b definiert, dass die Antwort des Imports als DOM-Objekt mit dem Namen "importResponse" gespeichert werden soll.

Per Parameter c werden die Anmeldedaten aus der Variablen "var__LOGIN_REQUEST" abgerufen.

Der Parameter d bezieht sich auf die vom System bereitgestellte Variable VAR_IS_TEST, da der Aufruf als Testlauf erfolgen soll, wenn z. B. ein "Mapping Test" ausgeführt wird.

Der Knoten "results" soll schließlich den im DOM-Objekt "importResponse" gespeicherten Rückgabewert als formatierten Text ausgeben.

Dies ermöglicht die allgemeine Intergration-Funktion
dump XML/DOM object.