XML GET OPTIONS
XML GET OPTIONS ( elemRef|documento ; seletor ; valor {; seletor2 ; valor2 ; ... ; seletorN ; valorN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| elemRef|documento | Texto | → | Elemento de referência raiz XML ou Referência de documento aberto |
| seletor | Integer | → | Opção a conseguir |
| valor | Integer | ← | Valor atual da opção |
Descrição
O comando XML GET OPTIONS é utilizado para ler o valor atual de um ou mais dos parâmetros XML definidos para a sessão atual e o usuário atual.
Em seletor, passe uma das constantes do tema "XML" indicando a opção a obter. O valor atual da opção é retornado no parâmetro valor:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| XML binary encoding | Inteiro longo | 5 | Especifica a maneira como os dados binários são convertidos. Valores possíveis: XML Base64 (valor padrão): os dados binários são convertidos simplesmente em base64 XML Data URI scheme: os dados binários são convertidos em base64 e são adicionados ao cabeçalho "data:;base64". Este formato permite principalmente a um navegador decodificar automáticamente uma imagen, e também é necessário para inserir imagens . Para maior informação, consulte http://en.wikipedia.org/wiki/Data%5FURI%5Fscheme. |
| XML BOM | Inteiro longo | 9 | Especifica se os documentos XML incluem BOM. Valores possíveis: XML por padrão (por padrão): utiliza a configuração atual do banco de dados. Por padrão, BOM não é incluído - exceto em bancos de dados/projetos criados com versões 4D anteriores a v19.x, nas quais BOM era incluído. Veja configurações de Compatibilidad. XML enabled: inclui BOM XML disabled: não inclui BOM |
| XML date encoding | Inteiro longo | 2 | Especifica a forma na qual se convertes as datas 4D. Por exemplo, !01/01/2003! no fuso horária de Paris. Valores possíveis: XML ISO (valor padrão): uso de formato xs:datetime sem indicação de fuso horária. Resultado: "2003-01-01". A parte hora, se estiver presente no valor 4D (via SQL) é perdida. XML Local: uso de formato xs:date com indicación de fuso horário. Resultado: "2003-01-01 +01:00". A parte hora, se estiver presente no valor 4D (via SQL) é perdida. XML Datetime local: uso de formato xs:dateTime (ISO 8601). Indicação do fuso horário. Este formato permite conservar a parte hora, se estiver presente no valor 4D (via SQL). Resultado: " |
| XML DOM case sensitivity | Inteiro longo | 8 | Especifica a sensibilidade à maiúsculas e minúsculas em relação aos nomes dos elementos dos comandos DOM Get XML element e DOM Count XML elements. Valores possíveis: XML case sensitive (valor predeterminado): os comandos distinguem entre maiúsculas e minúsculas XML case insensitive: os comandos não distinguen entre maiúsculas e minúsculas. |
| 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 XMLXML disabled (valor predeterminado): não permite a resolução de entidades externas (uma declaração de entidade externa gera um erro de análise) |
| XML indentation | Inteiro longo | 4 | Define a indentação de document XML. Valores possíveis: XML With indentation (valor padrão): o documento está indentado. XML No indentation: o documento não está indentado; seu conteúdo se localiza em uma única linha. |
| XML line ending | Inteiro longo | 10 | Caracteres de final de linha em documentos XML escritos. Valores possíveis: XML por padrão (por padrão): utiliza a configuração atual do banco de dados. Por padrão é LF em macOS e CRLF em Windows. Entretanto, em macOS, nos bancos/projetos criados com versões de 4D antes de v19,x, por padrão era CR para DOM e CRLF para SAX. Ver também Parâmetros de compatibilidade. XML LF: utiliza LF (quebra de linha) XML CR: utiliza CR (carriage return/retorno de carro) XML CRLF: utiliza CR+LF |
| XML picture encoding | Inteiro longo | 6 | Especifica a forma na qual as imagens devem ser convertidas (antes de codificar em base64). Valores possíveis: XML Convert to PNG (valor normal): as imagens são convertidas em PNG antes de ser codificadas em base64. XML Native codec: as imagenes são convertidas em seu primeiro CODEC nativo de armazenamento antes de ser codificadas em base64. Deve utilizar estas opções para codificar imagenes SVG (ver exemplo de comando XML SET OPTIONS). |
| XML string encoding | Inteiro longo | 1 | Especifica a forma como as strings 4D são convertidas em valores de elementos. Não se refere às conversões em atributos para as quais XML impõe o uso de caracteres de escape. Valores possíveis: XML With escaping (valor normal): conversão das strings 4D em valores de elementos XML com substituição de caracteres. Os dados de tipo texto são analisados automaticamente de maneira que os caracteres proibidos (<&>’) são substituidos pelas entidades XML ([#&/]amp;[#&/]lt;[#&/]gt; [#&/]apos;[#&/]quot;). XML Raw data: as strings 4D são enviadas como dados brutos; 4D não efetua codificação nem análise. Os valores 4D são convertidos se for possível em fragmentos XML e são inseridos como filho do elemento objetivo. Se um valor não puder ser considerado como fragmento XML, se insere em forma de dado bruto em um novo nodo CDATA. |
| XML time encoding | Inteiro longo | 3 | Define a forma como as horas 4D são convertidas. Por exemplo, ?02/00/46? (hora de Paris). A codificação difere dependendo de se quiser expressar uma hora ou uma duração. Valores possíveis para as horas: XML Datetime UTC: hora expressa em UTC (Universal Time Coordinated). Note que a conversão a UTC é automática. Resultado: " |