Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com
- Manual de linguagem 4D
-
- XML DOM
-
-
Visão Geral dos comandos XML DOM
-
DOM Append XML child node
-
DOM Append XML element
-
DOM CLOSE XML
-
DOM Count XML attributes
-
DOM Count XML elements
-
DOM Create XML element
-
DOM Create XML element arrays
-
DOM Create XML Ref
-
DOM EXPORT TO FILE
-
DOM EXPORT TO VAR
-
DOM Find XML element
-
DOM Find XML element by ID
-
DOM Get first child XML element
-
DOM Get last child XML element
-
DOM Get next sibling XML element
-
DOM Get parent XML element
-
DOM Get previous sibling XML element
-
DOM Get Root XML element
-
DOM GET XML ATTRIBUTE BY INDEX
-
DOM GET XML ATTRIBUTE BY NAME
-
DOM GET XML CHILD NODES
-
DOM Get XML document ref
-
DOM Get XML element
-
DOM GET XML ELEMENT NAME
-
DOM GET XML ELEMENT VALUE
-
DOM Get XML information
-
DOM Insert XML element
-
DOM Parse XML source
-
DOM Parse XML variable
-
DOM REMOVE XML ATTRIBUTE
-
DOM REMOVE XML ELEMENT
-
DOM SET XML ATTRIBUTE
-
DOM SET XML DECLARATION
-
DOM SET XML ELEMENT NAME
-
DOM SET XML ELEMENT VALUE
-
DOM Parse XML source
| DOM Parse XML source ( documento {; validaçao {; dtd|schmea}} ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| documento | String |
|
Rota documentos | |||||
| validaçao | Booleano |
|
True = Validação; False = sem validação | |||||
| dtd|schmea | String |
|
Localização do schema DTD ou XML | |||||
| Resultado | String |
|
Referência do elemento XML | |||||
O comando DOM Parse XML source analisa um documento que contém uma estrutura XML e retorna uma referência para este documento. O comando pode validar ou não o documento através de uma DTD ou de um esquema XML (documento XSD, XML Schema Definitiom).
O documento pode estar no disco ou em Internet/Intranet.
Nota: A execução do comando DOM Parse XML source é síncrona.
No parâmetro documento pode passar:
- Uma rota de acesso completa padrão (do tipo C:\\Pasta\\Arquivo\\... em Windows e MacintoshHD:Pasta:Arquivo em Mac OS),
- Ou uma rota Unix em Mac OS (a qual deve começar por /).
- Ou uma rota red de tipo http://www.site.com/Arquivo ou ftp://publico.ftp.com...
- Se validação for igual a True, a estrutura se validará. Neste caso, o analisador tentará validar a estrutura XML do documento baseado na referência DTD ou o esquema XML incluída no documento, ou através da DTD ou o esquema XML designado pelo terceiro parâmetro, se for passada.
- Se validação for igual a False, a estrutura não se validará.
O terceiro parâmetro permite designar uma DTD específica ou um esquema XML para a análise do documento. Se utiliza este parâmetro, o comando não considera a DTD referenciada no documento XML.
Validação por DTD
Há duas formas de especificar uma DTD:
- Como uma referência. Para fazê-lo, passe a rota de acesso completa da nova DTD (extensão “dtd”) no parâmetro dtd. Se o documento indicado não contiver uma DTD válida, o parâmetro dtd é ignorado e um erro é gerado.
- Diretamente em um texto. Neste caso, se os conteúdos do parâmetro começam por “<?xml”, 4D considerará que essa é a DTD; do contrário, 4D o considerará como uma rota de acesso.
Para validar o documento através de um esquema XML, apenas necessita passar no terceiro parâmetro um arquivo ou uma URL de extensão “xsd” ao invés de um “dtd”. A validação por esquema XML é considerada mais flexível e poderosa que a validação por DTD. A linguagem dos documentos XSD está baseada na linguagem XML. Em especial, os esquemas XML são compatíveis com tipos de dados. Para maior informação sobre os esquemas XML, por favor consulte a seguinte direção: http://www.w3.org/XML/Schema.
Se a validação não puder ser realizada (não DTD ou XSD, URL incorreto, etc.), um erro é gerado. A variável sistema Erro indica o número do erro. Pode interceptar este erro utilizando um método instalado pelo comando ON ERR CALL.
O comando retorna uma cadeia de 16 caracteres (RefElement) constituindo a referência em memória da estrutura virtual do documento. Esta referência deve ser utilizada com os outros comandos de análise XML.
Importante: Quando não precisar mais dele, lembre de chamar ao comando DOM CLOSE XML com esta referência com o objetivo de liberar memória.
Abertura sem validação de um documento XML em disco:
$xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml")Abertura sem validação de um documento XML localizado junto ao arquivo de estrutura do banco:
$xml_Ref_Estruct:=DOM Parse XML source("importar.xml")Abertura de um documento XML localizado no disco e validação utilizando um DTD que fica no disco:
$xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml";True;"C:\\importar_dtd.xml")Abertura sem validação de um documento XML localizado em uma URL específica:
$xml_Ref_Estruct:=DOM Parse XML source("http://www.4DHispano.com/xml/importar.xml")Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0.
Produto: 4D
Tema: XML DOM
Número
719
Modificado: 4D v11 SQL
Manual de linguagem 4D ( 4D v20 R7)
