SearchTask (Integration-Funktion)

Im nachfolgenden Beispiel werden alle Sendungen mit dem Arbeitsstatus "Freigegeben" (RELEASED) gesucht.

Die entsprechende Suche wurde über den Abfragekonfigurator aufgebaut und über den Menüpunkt Orchestration-Vorlagen als Unterknoten SearchTask zum Knoten SearchNode (mit gesetzter Option "Nur für SQL") eingefügt (s. Erstellen einer statischen Zielstruktur).

Die Ausführung der Suche wird durch Funktionsaufrufe für das Feld executeSearch im Data-Knoten ausgelöst:

• Die Funktion create xml from node()liefert das XML des SearchTask-Knotens:
  

   

  
  
  

• Die XML-Struktur des SearchTask-Knotens wird als Ergebnis in Parameter a der SearchTask (Integration-Funktion)-Funktion übernommen, die die Suche ausführt und das Ergebnis in das DOM-Objekt searchResult (Parameter k) speichert:
  

   

  
  
  

• Im nachfolgenden Feld getResult wird die Funktion get value from XML() verwendet, um das DOM-Objekt mit einem XPath-Ausdruck auszuwerten:
  

  

• Im Beispiel wird dem Feld getResult die ID (id) der ersten Sendung zugewiesen, die die Suche zurückgibt.

Eine Tupel-Suche soll über zwei Parameter (Benutzername/username, Kontonummer/address.accNumber) ein bestimmtes Benutzer-Konto in Lobster Data Platform / Orchestration identifizieren und - sofern ein Treffer existiert - dessen ID (id) zurückgeben.

<?xml version="1.0" encoding="UTF-8"?>
<core:SearchTask ... entity="base:User" skipCsvEnvelope="false" tryUseExistingConnection="true">
   <base:LobsterDataLoginRequest ... />
   <core:TupleSearch>
      <core:SearchJunction junction="CONJUNCTION">
         <core:SimplePropertySearch projection="username" compareType="==" stringValue="@PARAM_B@"/>
         <core:SimplePropertySearch projection="address.accNumber" compareType="=="
 stringValue="@PARAM_C@"/>
      </core:SearchJunction>
		...
      <core:PropertyProjection property="id"/>
		...
      <groupBy/>
   </core:TupleSearch>
</core:SearchTask>

Als konkreter Anwendungsfall soll die in der Variable var__searchUserId vordefinierte Tupel-Suche mit wechselnden Parametern genutzt werden, um die Konten bestimmter Benutzer per Batch-Import zu aktualisieren.

►ANMERKUNG◄ Da die Tupel-Suche den zu aktualisierenden Benutzer über die zurückgegebene ID (id) identifiziert, kann der search-Knoten im batch-Knoten des Imports deaktiviert werden, wenn diese als Wert für das id-Attribut im User-Knoten zugewiesen wird.

Im batch-Knoten der BatchImport-Struktur wurde ein Berechnungsfeld searchUserId ergänzt, das zwei Funktionsaufrufe verkettet:

Zunächst wird die im obigen Screenshot rechts ausgewählte Funktion SearchTask (Integration-Funktion) aufgerufen, der per Parameter a auf die Variable var_searchUserId zugreift.

• Den "Suchparametern" b und c werden Werte von Quellfeldern ("username" und "account") zugewiesen, so dass jede Iteration des batch-Knotens eine individuelle Suche ausführt.

• Das Suchergebnis wird per Parameter k als DOM-Objekt mit dem Namen searchResult gespeichert.

Die Funktion get value from XML()greift über den XPath-Ausdruck //row[1]/item[1] auf den Wert der ersten Spalte (item[1]) der ersten Zeile (row[1]) innerhalb des result-Knotens der TupleSearchResult-Strukur (s. Tupel-Suche) zu. Da die Suche nur ein einzige Projektion (id) verwendet, ist das die ID des ersten Treffers, sofern es überhaupt Treffer gibt. Dieser Wert wird dem Feld searchUserId als Berechnungsergebnis zugewiesen. Das Feld id_attr im User-Objekt kann diesen Wert z. B. über die Funktion copy() auf das Zielfeld searchUserId übernehmen.

Innerhalb eines Profils soll eine Tupel-Suche alle Benutzer ermitteln, deren Adresse eine bestimmte Kontonummer (address.accNumber) zugewiesen ist, um zu prüfen, ob diese Kontonummer eindeutig vergeben ist.

<?xml version="1.0" encoding="UTF-8"?>
<core:SearchTask ... entity="base:User" skipCsvEnvelope="false" tryUseExistingConnection="true">
   <base:LobsterDataLoginRequest ... />
   <core:TupleSearch>
      <core:SimplePropertySearch projection="address.accNumber" compareType="==" stringValue="@PARAM_B@"/>
		...
      <core:PropertyProjection property="id"/>
      <core:PropertyProjection property="username"/>
      <groupBy/>
   </core:TupleSearch>
</core:SearchTask>

In der Zielstruktur wird ein Berechnungsfeld mit zwei Funktionsaufrufen versehen:

Zunächst wird die Funktion SearchTask (Integration-Funktion) ausgeführt, deren Parameter a die XML-Struktur aus der Zwischenablage als statischer Textwert zugewiesen wird.

• Der Parameter b wird mit einem Quelldatenfeld account verknüpft, das die zu prüfende Kontonummer definiert.

• Das Suchergebnis wird per Parameter k als DOM-Objekt mit dem Namen searchResult gespeichert.

Anschließend wird das als Suchergebnis zurückgegebene DOM-Objekt searchResult (Parameter a) mit der Funktion get value from XML() ausgewertet.

• Der XPath-Ausdruck (//@count) liefert die Anzahl der Zeilen innerhalb der TupleSearchResult-Struktur (s. Tupel-Suche), die im Kopf der Suche als Attribut übergeben werden.