Systemfunktionen von CA Process Automation › applyXPathToUrl

applyXPathToUrl

Die Funktion "applyXPathToUrl" verwendet eine XPath-Abfrage, um XML-Daten aus einer angegebenen URL zu extrahieren. Die Funktion gibt ein XML-Fragment zurück, das die Knoten auflistet, die sich aus der Anfrage ergeben.

Syntax

sXML = applyXPathToUrl(url, xpathQuery, namespaceAware, returnArray)

Argumente

url (String)

Definiert die URL des XML-Dokuments, auf dem 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 Argument "returnArray" weglassen oder auf "false" setzen, gibt die Abfrage ein XML-Fragment zurück, in dem die Knoten aufgelistet sind. Zum Beispiel:

  sXML =  applyXPathToUrl("http://localhost:8080/itpam_tutorials/book.xml", "/bookstore/book[2]", true, false);
  

• Wenn "returnArray" "true" ist:

  sXMLArray (C2OValueArray)

  Wenn Sie das Argument "returnArray" auf "true" setzen, gibt die Abfrage ein C2OValueArray zurück, in dem jedes Element ein XML-Fragment ist, das einem Knoten entspricht. Zum Beispiel:

  sXMLArray = applyXPathToUrl("http://localhost:8080/itpam_tutorials/book.xml", "/bookstore/book", true, true);