Funções do sistema do CA Process Automation › applyXPath

applyXPath

A função applyPath usa uma consulta XPath para extrair dados XML e retorna um fragmento XML que lista os nós que resultam da consulta.

Sintaxe

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

Argumentos

xmlData (sequência de caracteres)

Define o XML no qual executar a consulta XPath.

xpathQuery (sequência de caracteres)

Define a consulta XPath a ser executada.

namespaceAware (Boolean)

(Opcional) Especifica se deseja remover espaços de nome antes de aplicar a consulta XPath.

Valores:

True: o CA Process Automation não remove espaços de nome antes de aplicar a consulta XPath.

False: o CA Process Automation remove espaços de nome antes de aplicar a consulta XPath, tornando a consulta simples.

Padrão: True

returnArray (Booleano)

(Opcional) Especifica se deve retornar ma matriz de resultados ou uma única sequência de caracteres.

Valores:

True: a função retorna uma matriz de resultados.

False: a função retorna uma única sequência de caracteres com vários resultados concatenados na sequência de caracteres.

Padrão: False

Observação: se a consulta XPath não encontrar uma correspondência, retornará uma matriz vazia.

Valores de retorno e exemplos

Um dos seguintes valores de retorno, com base no valor do argumento returnArray.

• Quando returnArray for falso:

  sXML (sequência de caracteres)

  Se você omitir esse argumento returnArray ou defini-lo como false, a consulta retornará esse valor. O valor retornado é um fragmento XML que lista os nós. Por exemplo:

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

• Quando returnArray for verdadeiro:

  sXMLArray (C2OValueArray)

  Se você definir o argumento returnArray como true, a consulta retornará esse valor. O valor que é retornado é uma C2OValueArray na qual cada elemento é um fragmento XML de um nó. Por exemplo:

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