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

applyXPathToUrl

A função applyXPathToUrl usa uma consulta XPath para extrair dados XML a partir de um URL especificado. A função retorna um fragmento XML com a lista de nós que resultam da consulta.

Sintaxe

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

Argumentos

url (sequência de caracteres)

Define o URL do documento XML no qual executar o 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 o argumento returnArray ou defini-lo como falso, a consulta retornará um fragmento XML que lista os nós. Por exemplo:

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

• Quando returnArray for verdadeiro:

  sXMLArray (C2OValueArray)

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

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