Fonctions système CA Process Automation › applyXPath

applyXPath

Cette fonction utilise une requête XPath pour extraire des données XML et renvoie un fragment XML qui répertorie les noeuds résultant de la requête.

Syntaxe

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

Arguments

xmlData (chaîne)

Définit les données XML sur lesquelles 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 cette valeur. Il s'agit d'un fragment XML qui répertorie les noeuds. Exemple :

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

• Lorsque l'argument returnArray est True :

  sXMLArray (C2OValueArray)

  Si vous avez défini l'argument returnArray sur True, la requête renvoie cette valeur. Il s'agit d'un tableau C2OValueArray dans lequel chaque élément est un fragment XML correspondant à un noeud. Exemple :

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