DOM EXPORT TO VAR

versión 2004

DOM EXPORT TO VAR (refElement; vXmlVar)

El comando DOM EXPORT TO VAR permite guardar un árbol XML en una variable texto o BLOB.

Pase en refElement la referencia del elemento raíz a exportar.

Pase en vXmlVar el nombre de la variable que debe contener el árbol XML. Esta variable puede ser de tipo Texto o BLOB. Puede seleccionar el tipo en función de las operaciones a efectuar o del tamaño que el árbol pueda alcanzar (recuerde que en modo Unicode, las variables de tipo Texto están limitadas a 32 K de texto, mientras en modo Unicode, este límite es de 2 GB).

Recuerde que si utiliza una variable de tipo texto para almacenar el elemento refElement, en modo no Unicode, será codificado utilizando el conjunto de caracteres Mac "actual" (es decir, Mac Roman en la mayoría de los sistemas occidentales). Esto significa que el texto devuelto perderá su codificación original (encoding="xxx"). En este caso, la variables vVarXml permite visualizar o almacenar el código obtenido pero NO generar un documento XML válido (utilizando el comando SEND PACKET por ejemplo).

En modo Unicode, el código original se conserva en la variable.

Este ejemplo guarda el árbol vRefElem en una variable texto:

   C_TEXT(vtMiTexto)
   DOM EXPORT TO VAR(vRefElem;vtMiTexto)

DOM EXPORT TO FILE, SVG EXPORT TO PICTURE.

Si el comando se ejecutó correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0 y se genera un error (por ejemplo, si la referencia del elemento no es válida).