Systemfunktionen von CA Process Automation › applyXPath

applyXPath

Die Funktion "applyXPath" verwendet eine XPath-Abfrage, um XML-Daten zu extrahieren, und gibt ein XML-Fragment mit einer Liste der Knoten zurück, die aus der Anfrage resultieren.

Syntax

sXML = applyXPath(xmlData, xpathQuery, namespaceAware, returnArray)

Argumente

xmlData (String)

Definiert die XML-Datei, in der die XPath-Anfrage ausgeführt werden soll.

xpathQuery (String)

Definiert die XPath-Anfrage, die ausgeführt werden soll.

namespaceAware (Boolean)

(Optional) Gibt an, Namespaces entfernt werden sollen, bevor die XPath-Anfrage angewendet wird.

Werte:

True: CA Process Automation entfernt keine Namespaces, bevor die XPath-Anfrage angewendet wird.

Falsch: CA Process Automation entfernt Namespaces, bevor die XPath-Anfrage angewendet wird, um die Anfrage zu vereinfachen.

Standard: True

returnArray (Boolesch)

(Optional) Gibt an, ob ein Array mit Ergebnissen oder eine einzelne Zeichenfolge zurückgegeben werden soll.

Werte:

True: Die Funktion gibt ein Array mit Ergebnissen zurück.

False: Die Funktion gibt eine einzelne Zeichenfolge mit mehreren verketteten Ergebnissen zurück.

Standard: False

Hinweis: Wenn die XPath-Anfrage keine Übereinstimmung findet, wird ein leeres Array zurückgegeben.

Rückgabewerte und Beispiele

Einer der folgenden Rückgabewerte, basierend auf dem Wert des Arguments "returnArray".

• Wenn "returnArray" "false" ist:

  sXML (String)

  Wenn Sie das returnArray-Argument weglassen oder auf "false" setzen, gibt die Abfrage diesen Wert zurück. Der Wert, der zurückgegeben wird, ist ein XML-Fragment, in dem die Knoten aufgelistet werden. Zum Beispiel:

  Process.xpathResult = applyXPath(Process.bookXML, "/bookstore/book[2]", true, false);
  

• Wenn "returnArray" "true" ist:

  sXMLArray (C2OValueArray)

  Wenn Sie das returnArray-Argument auf "true" setzen, gibt die Anfrage diesen Wert zurück. Der Wert, der zurückgegeben wird, ist ein C2OValueArray-Array, in dem jedes Element ein XML-Fragment für einen Knoten ist. Zum Beispiel:

  Process.xpathArrayResult = applyXPath(Process.bookXML, "/bookstore/book", true, true);