XmlC14N

XmlC14N( < cXML>, < cOption>, < @cErro>, < @cWarning> ) --> cRetXML

(caracter)
• Retorna o XML recodificado na forma canonical.

Um algoritmo de canonicalization tem o objetivo de aplicar as seguintes regras em um XML:

• Normalizar quebras de linha
• Normalizar valores de atributos
• Trocar seções  CDATA pelo seu conteúdo explícito

Essa função atende às especificação W3C - World Wide Web Consortium REC-xml-c14n-20010315 . A função  XmlC14N() aplica a canonicalização na string XML informada como parâmetro em conformidade com a especificação de canonicalização C14N 1.0 ( não-exclusiva), removendo comentários. 

Observações

• Caso a string XML informada como parâmetro não seja válida, não seja um XML, caso seja um XML mal-formado, a aplicação Advpl será interrompida com uma ocorrência de erro fatal "Failed to parse XML".
• Caso a string XML seja vazia, a aplicação AdvPL será interrompida com uma ocorrência de erro fatal "Invalid empty document on XmlC14N".
• Caso a string XML seja válida, porém o processo de canonicalização não seja completo com sucesso, a função retonará uma string em branco. 

User function tstC14N()
Local cError := ""
Local cWarning := ""
Local cXml := memoread("\xml\example.xml")
Local cXmlRet := ""

cXmlRet := XmlC14N( cXML , "" , @cError, @cWarning)

if ( Len(cXmlRet) > 0 )
    memowrite("\xml\canonical.xml", cXmlRet)
else
    conout("Nao foi possível canonicalizar o XML")
    varinfo("cError", cError)
    varinfo("cWarning", cWarning)
endif

Return