4D v14.3
DOM Parse XML source
- 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 ELEMENT NAME
- DOM SET XML ELEMENT VALUE
- DOM SET XML OPTIONS
DOM Parse XML source
| DOM Parse XML source ( documento {; validaçao {; dtd|schmea}} ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| documento | cadeia |
|
Rota documentos | |||||
| validaçao | Booleano |
|
True = Validação; False = sem validação | |||||
| dtd|schmea | cadeia |
|
Localização do schema DTD ou XML | |||||
| Resultado | cadeia |
|
Referência do elemento XML (16 caracteres) | |||||
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
DOM CLOSE XML
DOM Parse XML variable
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)
