Funzioni di sistema CA Process Automation › applyXPath

applyXPath

La funzione applyXPath utilizza una query XPath per estrarre i dati XML e restituisce un frammento XML con l'elenco dei nodi ottenuti dalla query.

Sintassi

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

Argomenti

xmlData (String)

Definisce i dati XML su cui eseguire la query XPath.

xpathQuery (String)

Definisce la query XPath da eseguire.

namespaceAware (Booleano)

(Facoltativo) Specifica se rimuovere gli spazi dei nomi prima di applicare la query XPath.

Valori:

True: CA Process Automation non rimuove gli spazi dei nomi prima di applicare la query XPath.

False: CA Process Automation rimuove gli spazi dei nomi prima di applicare la query XPath, rendendola semplice.

Impostazione predefinita: True

returnArray (Boolean)

(Facoltativo) Specifica se restituire una matrice di risultati o una stringa singola.

Valori:

True: la funzione restituisce una matrice di risultati.

False: la funzione restituisce una stringa singola con più risultati concatenati nella stringa.

Impostazione predefinita: False

Nota: se la query XPath non trova una corrispondenza, restituisce una matrice vuota.

Valori restituiti ed esempi

Uno dei valori restituiti seguenti, in base al valore dell'argomento returnArray.

• Quando returnArray è false:

  sXML (String)

  Se l'argomento returnArray viene omesso o impostato su False, la query restituisce questo valore. Il valore restituito è un frammento XML con l'elenco dei nodi. Ad esempio:

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

• Quando returnArray è true:

  sXMLArray (C2OValueArray)

  Se l'argomento returnArray è impostato su True, la query restituisce questo valore. Il valore restituito è una matrice C2OValueArray in cui ogni elemento è un frammento XML per un nodo. Ad esempio:

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