DOM SET XML DECLARATION
DOM SET XML DECLARATION ( refElemento ; codificaçao {; autonomo {; recuo}} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| refElemento | String | 🡒 | Referência de elemento XML |
| codificaçao | String | 🡒 | Conjunto de caracteres usado no documento XML |
| autonomo | Booleano | 🡒 | True=documento é autônomo; False (padrão) = documento não é autônomo |
| recuo | Booleano | 🡒 | Obsoleto, não usar |
Descrição
O comando DOM SET XML DECLARATION permite definir diferentes opções que são úteis na criação da árvore XML designado por elementRef. Estas opções fazem referência à codificação e à propriedade autônoma da árvore:
- codificação: indica o conjunto de caracteres utilizado no documento. Como padrão (se não for chamado ao comando), se utiliza o conjunto de caracteres UTF-8 (Unicode comprimido).
Nota: se passar um conjunto de caracteres que não seja suportado por comandos 4D XML, será usado UTF-8. Veja Conjuntos de caracteres para uma lista de conjuntos de caracteres suportados (entretanto para a maioria dos casos UTF-8 é recomendado). - autônomo: indica se a árvore é autônoma (True) ou se necesita outros arquivos ou recursos externos para seu funcionamento (False). Como padrão (se o comando não for chamado ou se for omitido o parâmetro), a árvore não é autônoma. Nota de compatibilidade: O parâmetro indentação se conserva por razões de compatibilidade com as versões anteriores de 4D mas seu uso não é recomendado em 4D v12. De agora em diante, para especificar a indentação do documento, se recomenda utilizar o comando XML SET OPTIONS
Exemplo
O exemplo define a codificação a utilizar e a opção autônoma do elemento elementRef:
DOM SET XML DECLARATION(elementRef;"UTF-16";True)