XML GET OPTIONS
XML GET OPTIONS ( refElement | document ; selector ; valor {; selector2 ; valor2 ; ... ; selectorN ; valorN} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| refElement | document | Texto | 🡒 | Referencia del elemento XML raíz o referenica del documento abierto |
| selector | Entero largo | 🡒 | Opción a leer |
| valor | Entero largo | 🡘 | Valor actual de la opción |
Descripción
El comando XML GET OPTIONS se utiliza para obtener el valor actual de uno o más de los parámetros XML definidos para la sesión actual y el usuario actual.
En selector, pase una de las constantes del tema XML indicando la opción a obtener. El valor actual de la opción se devuelve en el parámetro valor:
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| XML binary encoding | Entero largo | 5 | Especifica la manera como se convierten los datos binarios. Valores posibles: XML Base64 (valor por defecto): los datos binarios se convierten simplemente en base64XML Data URI scheme: los datos binarios se convierten en base64 y se añade el encabezado "data:;base64". Este formato permite principalmente a un navegador decodificar automáticamente una imagen, y también es necesario para insertar imágenes . Para mayor información, consulte http://en.wikipedia.org/wiki/Data%5FURI%5Fscheme. |
| XML BOM | Entero largo | 9 | Especifica si los documentos XML incluyen BOM. Valores posibles: XML por defecto (por defecto): utiliza la configuración actual de la base. Por defecto, BOM no se incluye, excepto en las bases/proyectos creados con versiones hasta v19.x, donde BOM se incluye. Ver también parámetros de compatibilidad. XML activado: incluye BOM XML desactivado: no incluye BOM |
| XML date encoding | Entero largo | 2 | Especifica la forma en que se convierten las fechas 4D. Por ejemplo, !01/01/2003! en la zona horaria de Paris. Valores posibles: XML ISO (valor por defecto): uso del formato xs:datetime sin indicación de la zona horaria. Resultado: "2003-01-01". La parte hora, si está presente en el valor 4D (vía SQL) se pierde. XML Local: uso del formato xs:date con indicación de zona horaria. Resultado: "2003-01-01 +01:00". La parte hora, si está presente en el valor 4D (vía SQL) se pierde. XML Datetime local: uso del formato xs:dateTime (ISO 8601). Indicación de la zona horaria. Este formato permite conservar la parte hora, si está presente en el valor 4D (vía SQL). Resultado: " |
| XML DOM case sensitivity | Entero largo | 8 | Especifica la sensibilidad a mayúsculas y minúsculas con respecto a los nombres de los elementos de los comandos DOM Get XML element y DOM Count XML elements. Valores posibles:XML case sensitive (valor predeterminado): los comandos distinguen entre mayúsculas y minúsculasXML case insensitive: los comandos no distinguen entre mayúsculas y minúsculas. |
| XML external entity resolution | Entero largo | 7 | Controla si las entidades externas están definidas en documentos XML. Por razones de seguridad, por defecto, los analizadores XML DOM y SAX de 4D no permiten la resolución de entidades externas. Tenga en cuenta que el alcance de este selector es el proceso de llamada (si es apropiativo) o todos los procesos cooperativos (si se llama desde un proceso cooperativo). Se aplica globalmente a todos los documentos XML (el primer parámetro se ignora, puede pasar una cadena vacía). ** Valores posibles:**XML enabled: permite la resolución de entidades externas en documentos XMLXML disabled (valor predeterminado): no permite la resolución de entidades externas (una declaración de entidad externa genera un error de análisis) |
| XML indentation | Entero largo | 4 | Define la indentación del document XML. Valores posibles: XML With indentation (valor por defecto): el documento está indentado.XML No indentation: el documento no está indentado; su contenido se ubica en una sola línea. |
| XML line ending | Entero largo | 10 | Caracteres de fin de línea en documentos XML escritos. Valores posibles: XML por defecto (por defecto): utiliza la configuración actual de la base. Por defecto es LF en macOS y CRLF en Windows. Sin embargo, en macOS, en las bases/proyectos creados con versiones de 4D hasta la v19.x, por defecto es CR para DOM y CRLF para SAX. Ver también parámetros de compatibilidad. XML LF: utiliza LF (salto de línea) XML CR: utiliza CR (carriage return) XML CRLF: utiliza CR+LF |
| XML picture encoding | Entero largo | 6 | Especifica la forma en la que las imágenes deben convertirse (antes de codificar en base64). Valores posibles: XML Convert to PNG (valor por defecto): las imágenes se convierten en PNG antes de ser codificadas en base64.XML Native codec: las imágenes se convierten en su primer CODEC nativo de almacenamiento antes de ser codificadas en base64. Debe utilizar estas opciones para codificar imágenes SVG (ver ejemplo del comando XML SET OPTIONS). |
| XML string encoding | Entero largo | 1 | Especifica la forma como las cadenas 4D se convierten en valores de elementos. No concierne a las conversiones en atributos para las cuales XML impone el uso de caracteres de escape. Valores posibles: XML With escaping (valor por defecto): conversión de las cadenas 4D en valores de elementos XML con reemplazo de caracteres. Los datos de tipo texto son analizados automáticamente de manera que los caracteres prohibidos (<&>’) son reemplazados por las entidades XML (&<> '").XML Raw data: las cadenas 4D se envían como datos brutos; 4D no efectúa codificación ni análisis. Los valores 4D se convierten si es posible en fragmentos XML y se insertan como hijo del elemento objetivo. Si un valor no puede considerarse como fragmento XML, se inserta en forma de dato bruto en un nuevo nodo CDATA. |
| XML time encoding | Entero largo | 3 | Define la forma como las horas 4D se convierten. Por ejemplo, ?02/00/46? (hora de Paris). La codificación difiere dependiendo de si quiere expresar una hora o una duración. Valores posibles para las horas: XML Datetime UTC: hora expresada en UTC (Universal Time Coordinated). Note que la conversión a UTC es automática. Resultado: " XML Seconds: número de segundos desde la media noche; sin modificación del valor porque expresa una duración. Resultado: " |