ca_pam_convertXMLToJSObject(xmlString, elementTagName)

Formulaires › Concepteur de formulaires › Fonctions d'éléments de formulaire › Eléments de formulaire › Analyse XML › ca_pam_convertXMLToJSObject(xmlString, elementTagName)

ca_pam_convertXMLToJSObject(xmlString, elementTagName)

Crée un objet JavaScript à partir d'un fichier XML.

Remarque : Si l'élément XML est conscient de l'espace de noms et qu'il présente un préfixe d'espace de noms, utilisez des apostrophes pour y accéder.

Paramètres d'entrée

xmlString (string): Définit la chaîne XML à convertir en objet JavaScript.
elementTagName (string): (Facultatif) Renvoie l'élément incluant le nom de balise spécifié. Si vous ne fournissez pas elementTagName, la méthode renvoie l'élément racine.

Valeur de retour

Renvoie une valeur de type d'objet.

Exemple :

Conversion du code XML suivant en objet JavaScript :

<?xml version="1.0"?>
<catalog>
   <book id="bk101">
      <author>Gambardella, Matthew</author>
      <title>Manuel du développeur XML</title>
      <genre>Informatique</genre>
      <price>44.95</price>
      <publish_date>2000-10-01</publish_date>
      <description>Etude approfondie pour la création d'applications 
      à l'aide du code XML.</description>
   </book>
</catalog>

Cet exemple convertit les données XML ci-dessus en objet JavaScript.

La syntaxe suivante convertit le document XML en objet JavaScript :
```
   var parsedXML = ca_pam_convertXMLToJSObject(xmlString);
```
Vous pouvez utiliser n'importe laquelle des lignes suivantes pour accéder à l'élément book :
```
   var bookObj = parsedXML . book[0];   
   var bookObj = parsedXML [“book”][0];
```
Vous pouvez utiliser n'importe laquelle des lignes suivantes pour récupérer la valeur d'attribut d'ID de l'élément book :
```
   var idVal = bookObj.id;
   var idVal = bookObj[“id”];
```

Vous pouvez utiliser n'importe laquelle des lignes suivantes pour accéder à la valeur de description de l'élément book :

   var bookDesription = bookObj. description[0]._text;
   var bookDesription = bookObj[“description”][0][“_text”];

Remarque : Si un élément contient un attribut et un élément avec le même nom, accédez-y sous forme de tableau. Dans le tableau, le premier membre (index 0) est toujours l'attribut et les éléments suivent.

Exemple :

Conversion du code XML suivant en objet JavaScript :

<?xml version="1.0"?>
<categories>
    <category name="Temps"> 
        <name part="1">Ensoleillé</name>
        <name part="2">Pluvieux</name>
    </category>
    <category name="Climat"> 
        <name part="1">Humide</name>
        <name part="2">Sec</name>
    </category>
</categories>

Cet exemple convertit les données XML ci-dessus en objet JavaScript.

Utilisez la syntaxe suivante pour récupérer l'objet de la première catégorie à partir des catégories XML représentées sous la forme xmlString :
```
   var parsedXML= ca_pam_convertXMLToJSObject(xmlString);
   var firstCatagory= parsedXML.category[0];
```
Utilisez la syntaxe suivante pour accéder à l'attribut de nom :
```
   var bookName = firstCatagory.name[0];
```
Utilisez la syntaxe suivante pour accéder à la valeur du premier élément de nom :
```
   var firstBookName = firstCatagory.name[1]._text;
```

Exemple :

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
	<Header/>
	<Body>
		<getStartRequestFormsResponse xmlns="http://www.ca.com/itpam">
			<startRequests>
				<startRequest name="RahulSrf" refPath="/Folder/">
					<description/>
				</startRequest>
				<startRequest name="Start Request Form" refPath="/RestSupport/">
					<description/>
				</startRequest>
			</startRequests>
		</getStartRequestFormsResponse>
	</Body>
</Envelope>

Cet exemple présente l'utilisation de la méthode ca_pam_convertXMLToJSObject(xmlString, elementTagName) avec le paramètre elementTagName :

Le script suivant récupère tous les éléments <startRequest> du code XML :

var srfResult = ca_pam_convertXMLToJavaScriptObject(xmlString,'startRequest');

srfResult est un tableau de tous les éléments startRequest.

Exemple :

<?xml version="1.0"?> 
<note _text="abc"> 
    <_text>Tove</_text> 
</note>

Cet exemple présente un scénario dans lequel le code XML contient _text en tant qu'élément ou attribut. Dans ce cas, la méthode crée un tableau avec le nom "_text".

Le premier élément du tableau renvoie le noeud de texte dans l'élément.
Le deuxième élément du tableau renvoie le noeud d'attribut (avec le nom "_text") de l'élément.
D'autres éléments du tableau renvoient les noeuds d'élément enfant (avec le nom "_text") de l'élément.

Le script suivant accède aux valeurs :

var parsedXML= ca_pam_convertXMLToJavaScriptObject(xmlString); 
var textNode= parsedXML["_text"][0]; 
var attributeValue= parsedXML["_text"][1]; 
var childTextNodeValue= parsedXML["_text"][2]["_text"];

Le script donne le résultat suivant :

textNode=" ;

(...car il n'existe aucune valeur scalaire au niveau du noeud.)

attributeValue="abc"; 
childTextNodeValue="Tove"

Vous pouvez également trouver cette fonction dans le contenu prédéfini dans CA Process Automation.

Sur la page d'accueil, cliquez sur Parcourir le contenu prêt à l'emploi.
Accédez au dossier User Interaction Forms, puis 08 Populate Table SOAP WS: Populate Table SOAP WS.