Funzioni di sistema CA Process Automation › applyXPathToUrl

applyXPathToUrl

La funzione applyXPathToUrl utilizza una query XPath per estrarre i dati XML da un URL specificato. La funzione restituisce un frammento XML con l'elenco dei nodi ottenuti dalla query.

Sintassi

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

Argomenti

url (String)

Definisce l'URL del documento 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 si omette l'argomento di returnArray o si imposta su false, la query restituisce un frammento XML con l'elenco dei nodi. Ad esempio:

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

• Quando returnArray è true:

  sXMLArray (C2OValueArray)

  Se si imposta l'argomento returnArray su true, la query restituisce una matrice C2OValueArray in cui ogni elemento è un frammento XML per un nodo. Ad esempio:

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