convertValueToXml

Fonctions système CA Process Automation › convertValueToXml

convertValueToXml

Cette fonction renvoie un fragment XML basé sur un tableau de types simples ou sur un mappage de valeurs de types simples.

Lorsque vous utilisez un mappage de valeurs, les éléments XML sont créés à l'aide de noms de champs en tant que balises et de valeurs de champs en tant que contenu. Vous pouvez spécifier une chaîne ou la valeur null pour le paramètre de balise lorsque vous utilisez des mappages de valeurs. Si vous spécifiez une chaîne, la chaîne est utilisée pour créer un élément racine avec la balise spécifiée. Les éléments créés à partir du mappage de valeurs sont contenus dans cet élément racine. Si vous spécifiez une valeur nulle, les éléments sont au niveau racine.

Lorsque vous utilisez un tableau, vous devez spécifier une chaîne pour le paramètre de balise. Elle est utilisée pour créer les balises d'élément avec les valeurs de tableau en tant que contenu de l'élément.

Syntaxe

sXML = convertValueToXml(arrayOrVmap, tag)

Arguments

arrayOrVmap (chaîne): Spécifie un tableau ou un mappage de valeurs.
tag (chaîne): Spécifie la balise obligatoire à utiliser avec un tableau ou la balise facultative à utiliser avec un mappage de valeurs.

Valeur de retour

sXML (chaîne): Le type renvoyé est Chaîne.

Exemples

Dans cet exemple, Process.array contient les valeurs 1, 2 et 3.
```
Process.xml = convertValueToXml(Process.array, "test")
```
Process.xml contient le fragment XML suivant :
```
 <test>1<test><test>2<test><test>3<test>
```
Dans cet exemple, Process.valuemap a deux champs avec les noms "champ1" et "champ2" et les valeurs "valeur1" et "valeur2".
```
Process.xml = convertValueToXml(Process.valuemap, null)
```
Process.xml contient le fragment XML suivant :
```
 <champd1>valeur1</champ1><champ2>valeur2</champ2>
```