DOM Parse XML source

DOM Parse XML source ( documento {; validaçao {; dtd|schmea}} ) : Text

Parâmetro	Tipo		Descrição
documento	Text	→	Rota documentos
validaçao	Boolean	→	True = Validação; False = sem validação
dtd|schmea	Text	→	Localização do schema DTD ou XML
Resultado	Text	←	Referência do elemento XML

Descrição

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... O parâmetro booleano validaçao permite indicar se validar ou não a estrutura.
• 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á. Se passar True em validaçao e omitir o terceiro parâmetro, o comando tentará validar a estrutura XML através de uma referência DTD ou XSD que se encontra na estrutura mesma. A validação pode ser indireta: se a estrutura contiver uma referência a um arquivo DTD que contenha uma referência a um arquivo XSD, o comando tentará realizar as duas validações.

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. Validação por esquema

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.

Exemplo 1

Abertura sem validação de um documento XML em disco:

 $xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml")

Exemplo 2

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")

Exemplo 3

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")

Exemplo 4

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")

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0.

Ver também

DOM CLOSE XML
DOM Parse XML variable

Propriedades

Número do comando	719
Thread-seguro	✓
Modificar variáveis	OK