Funciones del sistema de CA Process Automation › applyXPathToUrl

applyXPathToUrl

La función applyXPathToUrl utiliza una consulta XPath para extraer datos XML desde una URL especificada. La función devuelve un fragmento XML que enumera los nodos que se han devuelto de la consulta.

Sintaxis

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

Argumentos

url (String)

Define la URL del documento XML en el cual se ejecuta XPath.

xpathQuery (String)

Define la consulta XPath para ejecutar.

namespaceAware (Boolean)

(Opcional) Especifica si se deben eliminar los espacios de nombre antes de aplicar la consulta XPath.

Valores:

Verdadero: CA Process Automation no elimina espacios de nombre antes de aplicar la consulta XPath.

Falso: CA Process Automation elimina espacios de nombre antes de aplicar la consulta XPath, haciendo simple la consulta.

Valor predeterminado: True

returnArray (Booleano)

(Opcional) Especifica si se debe devolver una matriz de resultados o una sola cadena.

Valores:

Verdadero: La función devuelve una matriz de resultados.

Falso: La función devuelve una sola cadena con varios resultados concatenados en la cadena.

Valor predeterminado: False

Nota: Si la consulta XPath no encuentra una coincidencia, devuelve una matriz vacía.

Valores de retorno y ejemplos

Uno de los valores de retorno siguientes, basados en el valor del argumento de returnArray.

• Cuando returnArray es false:

  sXML (String)

  Si se omite el argumento de returnArray o se establece como falso, la consulta devuelve un fragmento de XML que enumera los nodos. Por ejemplo:

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

• Cuando returnArray es true:

  sXMLArray (C2OValueArray)

  Si se establece el argumento returnArray como true, la consulta devuelve un C2OValueArray en el cual cada elemento es un fragmento de XML para un nodo. Por ejemplo:

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