APPLY XSLT TRANSFORMATION

O comando APPLY XSLT TRANSFORMATION aplica uma transformação XSLT a um documento ou BLOB que contenha XML e gera um documento ou um BLOB resultado. O alcance deste comando é o processo atual.

Nota: para maior informação sobre transformação XSL (ou XSLT), consulte a seção Introdução aos comandos de XML Utilities.

O comando exige três parâmetros de tipo BLOB ou string de caracteres.

Aviso: este comando aceita apenas variáveis ou campos como parâmetros.

Se passar uma string de caracteres, você designa um documento. Neste caso, pode passar unicamente o nome (o documento deve estar junto à estrutura do banco de dados) ou a rota de acesso completa do documento.

Não pode misturarar diferentes tipos de parâmetros dentro de uma mesma chamada.

• O parâmetro fontexml deve conter a fonte XML a transformar. O comando verifica a validez do código XML.
• O parâmetro folhaXSL deve conter a folha de estilo XSL a utilizar para a transformação XSLT. Esta folha de estilos pode ter sido gerada manualmente ou utilizando um software especializado. O comando verifica a validez do código XML.
• O parâmetro resultado deve conter o nome do documento ou do BLOB que deve receber o resultado da transformação XSLT. Se passar um nome de documento que não existe na localização designada, 4D o cria automaticamente. Se o documento estiver aberto em escrita, um erro é gerado.

O comando analiza o recurso XML e o transforma utilizando as instruções da folha de estilos XSL. Se o comando SET XSLT PARAMETER tiver sido utilizado anteriormente, o comando substitui os parâmetros definidos por seu valor. O resultado da transformação se escreve no documento ou BLOB resultado.

O parâmetro opcional compilaFolha permite otimizar a transformação XSLT, especialmente no caso de aplicações sucesivas da mesma folha XSL. Quando o parâmetro compileFolha se passa e tem o valor True, o arquivo XSL folhaXSL é analizado na primeira chamada do comando, depois é compilada e armazenada na memória. Em cada chamada posterior com o mesmo arquivo XSL, o comando utiliza diretamente o arquivo compilado (a não ser que tenha sido modificado), o que pode acelerar o processo. A otimização não considera as possíveis modificações realizadas nos arquivos importados (através xsl:import). Se um arquivo referênciado pelo arquivo XSL for modificado, é necessario “forçar” a recompilação do novo arquivo XSL chamando ao comando novamente com o parâmetro compileFolha em False (ou se omitido).

Consulte o exemplo do comando  SET XSLT PARAMETER

Se a transformação for realizada corretamente, a variável sistema OK assume o valor 1, do contrário assume o valor 0.