DOM EXPORTER VERS VARIABLE

version 2004

DOM EXPORTER VERS VARIABLE (refElément; vVarXml)

La commande DOM EXPORTER VERS VARIABLE permet de sauvegarder un arbre XML dans une variable texte ou BLOB.

Passez dans refElément la référence de l'élément racine à exporter.

Passez dans vVarXml le nom de la variable devant contenir l'arbre XML. Cette variable peut être de type Texte ou BLOB. Vous pouvez choisir le type en fonction des opérations à effectuer par la suite ou de la taille que l'arbre peut atteindre (rappelons qu'en mode Non unicode les variables de type Texte sont limitées à 32 K de texte, en mode Unicode cette limite est de 2 Go).

Attention, en mode Non unicode si vous utilisez une variable Texte pour stocker l'élément refElément, il sera encodé en Mac "courant" (c'est-à-dire Mac Roman sur la plupart des systèmes occidentaux). Cela signifie que le texte retourné ne sera plus dans l'encodage d'origine (encoding="xxx"). Dans ce cas, la variable vVarXml permet de visualiser ou de stocker le code obtenu mais PAS de générer un document XML valide (via la commande ENVOYER PAQUET par exemple).

En mode Unicode, l'encodage d'origine est conservé dans la variable.

Cet exemple sauvegarde l'arbre vRefElem dans une variable texte :

   C_TEXTE(vtMonTexte)
   DOM EXPORTER VERS VARIABLE(vRefElem;vtMonTexte)

DOM EXPORTER VERS FICHIER, SVG EXPORTER VERS IMAGE.

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée (par exemple, si la référence de l'élément n'est pas valide).