Funciones del sistema de CA Process Automation › applyXPath

applyXPath

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

Sintaxis

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

Argumentos

xmlData (String)

Define el XML en el cual se ejecuta la consulta 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 en falso, la consulta devuelve este valor. El valor que devuelve es un fragmento XML que enumera los nodos. Por ejemplo:

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

• Cuando returnArray es true:

  sXMLArray (C2OValueArray)

  Si se establece el argumento de returnArray a verdadero, la consulta devuelve este valor. El valor que devuelve es unaC2OValueArray en la cual cada elemento es un fragmento de XML para un nodo. Por ejemplo:

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