SAX OPEN XML ELEMENT

4D v16.3


SAX OPEN XML ELEMENT ( document ; balise {; nomAttribut ; valeurAttribut} {; nomAttribut2 ; valeurAttribut2 ; ... ; nomAttributN ; valeurAttributN} )

Paramètre	Type	Description
document	RefDoc	Référence du document ouvert
balise	Chaîne	Nom de l’élément à ouvrir
nomAttribut	Chaîne	Nom d’attribut
valeurAttribut	Chaîne	Valeur d’attribut

Description

La commande SAX OPEN XML ELEMENT permet d’ajouter un nouvel élément dans le document XML référencé par document ainsi que, facultativement, des attributs et leurs valeurs.

L’élément ajouté est “ouvert” dans le document (la balise de fin n’est pas ajoutée). Pour refermer un élément créé à l’aide de cette commande, vous devez soit :

utiliser la commande SAX CLOSE XML ELEMENT,
refermer le document XML. Dans ce cas, 4D ajoute automatiquement les balises XML de fermeture nécessaires.

Passez dans balise le nom de l’élément à créer. Ce nom peut contenir uniquement des lettres, des chiffres, ainsi que les caractères “.”, “-“,”_” et “:”. Si un caractère invalide est passé dans balise, une erreur est générée.

Facultativement, la commande permet de passer un ou plusieurs couple(s) attributs/valeurs (sous forme de variables, champs ou valeur littérales) via les paramètres nomAttribut et valeurAttribut. Vous pouvez passer autant de couples attribut/valeur que vous voulez.

Exemple

L’instruction suivante :

 vElement:="Book"

 SAX OPEN XML ELEMENT($RefDoc;vElement)

... inscrira cette ligne dans le document :

<Book

Gestion des erreurs

Si un caractère invalide est passé dans balise, une erreur est générée.

Voir aussi

SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT ARRAYS