XML SET OPTIONS

4D v16.3

XML

XML SET OPTIONS


XML SET OPTIONS ( elemRef\|documento ; seletor ; valor {; seletor2 ; valor2 ; ... ; seletorN ; valorN} )

Parâmetro	Tipo	Descrição
elemRef\|documento	Texto, refDoc	Elemento de referencia raiz XML ou Referência de documento aberto
seletor	Inteiro longo	Opção a estabelecer
valor	Inteiro longo	Valor da opção

Descrição

O comando XML SET OPTIONS é utilizado para modificar o valor de um ou mais parâmetros XML para estrutura passada no primeiro parâmetro.

Este comando se aplica às estruturas XML de tipo "árvore" (DOM) ou "document" (SAX). No primeiro parâmetro, pode passar uma referência do elemento raiz (refElement), ou a referência de um documento SAX aberto (document).

Passe em seletor a opção a modificar e em valor o novo valor da opção. Pode passar tantos pares seletor/valor como queira. Deve utilizar as constantes descritas abaixo, localizadas no tema "XML":

As opções definidas por este comando são utilizadas unicamente no sentido 4D a XML (não tem efeito na leitura de valores XML em 4D). Os seguintes comandos utilizam as seguintes opções:

Constante	Tipo	Valor
XML binary encoding	Inteiro longo	5
XML date encoding	Inteiro longo	2
XML indentation	Inteiro longo	4
XML picture encoding	Inteiro longo	6
XML string encoding	Inteiro longo	1
XML time encoding	Inteiro longo	3

Notas:

Os valores XML Local e XML Datetime local não oferecem datas expressas em UTC (Universal Time Coordinated); são convertidas sem modificação mas indicam a diferença horária. Estes formatos são úteis no caso de conversões sucessivas e recíprocas (round tripping).
Os valores XML UTC e XML Datetime UTC são equivalentes aos precedentes desde o ponto de vista do formato, mas são expressas em UTC. Estes formatos devem ter prioridade para ter certeza da inter-operabilidade. Os valores não são modificáveis.

As opções abaixo permitem que modifique algumas das propriedades padrão xml parser:

Constante	Tipo	Valor	Comentário
XML DOM case sensitivity	Inteiro longo	8
XML external entity resolution	Inteiro longo	7	Controla se as entidades externas são resolvidas em documentos XML. De forma pré-determinada, por razões de segurança, os analisadores XML DOM e SAX 4D não permitem a resolução de entidades externas. Valores possíveis: XML enabled: permite a resolução de entidades externas em documentos XML XML disabled (valor predeterminado): não permite a resolução de entidades externas (uma declaração de entidade externa gera um erro de análise)

Exemplo

Inserir uma imagem SVG:

 XML SET OPTIONS($pictElemRef;XML binary encoding;XML data URI scheme)

 XML SET OPTIONS($pictElemRef;XML picture encoding;XML native codec)

 DOM SET XML ATTRIBUTE($pictElemRef;"xlink:href";PictVar)

Ver também

DOM SET XML ATTRIBUTE
DOM SET XML DECLARATIONS
DOM SET XML ELEMENT VALUE
SAX ADD XML ELEMENT VALUE
XML GET OPTIONS