Fonctions système CA Process Automation › applyXPathToUrl

applyXPathToUrl

Cette fonction utilise une requête XPath pour extraire des données XML d'une URL spécifiée. La fonction renvoie un fragment XML qui répertorie les noeuds résultant de la requête.

Syntaxe

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

Arguments

url (chaîne)

Définit l'URL du document XML sur lequel exécuter la requête XPath.

xpathQuery (chaîne)

Définit la requête XPath à exécuter.

namespaceAware (booléen)

(Facultatif) Spécifie si les espaces de nom doivent être supprimés avant d'appliquer la requête XPath.

Valeurs :

True : CA Process Automation ne supprime pas les espaces de nom avant d'appliquer la requête XPath.

False : CA Process Automation supprime les espaces de nom avant d'appliquer la requête XPath, ce qui simplifie la requête.

Valeur par défaut : Vrai

returnArray (booléen)

(Facultatif) Spécifie si la valeur renvoyée doit être un tableau de résultats ou une chaîne unique.

Valeurs :

True : la fonction renvoie un tableau de résultats.

False : la fonction renvoie une chaîne unique avec plusieurs résultats concaténés dans la chaîne.

Valeur par défaut : Faux

Remarque : Si la requête XPath ne trouve pas de correspondance, elle renvoie un tableau vide.

Valeurs renvoyées et exemples

Une des valeurs renvoyées suivantes, selon la valeur de l'argument returnArray.

• Lorsque l'argument returnArray est False :

  sXML (chaîne)

  Si vous ignorez l'argument returnArray ou le définissez sur False, la requête renvoie un fragment XML qui répertorie les noeuds. Exemple :

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

• Lorsque l'argument returnArray est True :

  sXMLArray (C2OValueArray)

  Si vous définissez l'argument returnArray sur True, la requête renvoie un tableau C2OValueArray dans lesquels chaque élément est un fragment XML correspondant à un noeud. Exemple :

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