4D Doc Center : SET XSLT PARAMETER

4D v14.3

XML

SET XSLT PARAMETER


SET XSLT PARAMETER ( nomParam ; valorParam )

Parâmetro	Tipo	Descrição
nomParam	cadeia	Nome do parâmetro a procurar na folha XSL
valorParam	cadeia	Valor do parâmetro a usar no documento transformado

Descrição

O comando SET XSLT PARAMETER deve utilizarse em conjunto com o comando APPLY XSLT TRANSFORMATION. Permite definir os valores dos parâmetros variáveis localizados em uma folha de estilo XSL no momento da transformação XSLT de um documento XML. Utilizando este comando, é possível inserir valores de processos 4D na folha de estilo XSL logo antes de utilizar APPLY XSLT TRANSFORMATION.

Notas:

Para maiores informações sobre a transformação XSL (ou XSLT), consulte a seção Introdução aos comandos de XML Utilities.
O alcance deste comando é o processo atual. Deve ser chamado no mesmo processo que o comando APPLY XSLT TRANSFORMATION associado.

Passe em nomParam o nome da variável parâmetro XSL a ser substituída. Este parâmetro deve estar presente na folha de estilos XSL como $parasubstituir. Entretanto, o caractere $ não é necessário em nomParam. Por exemplo, se a instrução <xsl:template match=$myvar> estiver localizada no arquivo XSL, simplesmente passe “minhavar” em nomParam para definir este parâmetro.

Em valorParam, passe o valor que deseja inserir no arquivo transformado ao invés do parâmetro XSL variável. Para utilizar o exemplo anterior, se passar o valor “titulo” em valorParam, a transformação XSLT levará em consideração a instrução <xsl:template match="title"> (que define os elementos “título” como sujeito a aplicação de uma regra de estilo).

Se o valor for de tipo string, deve ser incluído entre aspas simples (por exemplo 'meuvalor'), além das aspas duplas da sintaxe 4D ("'meuvalor'").

Nota: para uma descrição detalhada da linguagem XSL, pode consultar vários websites de Internet dedicados a esta linguagem. Por exemplo: http://xml.org.

Para passar varios parâmetros a uma folha de estilos XSL, simplesmente chame várias vezes ao comando SET XSLT PARAMETER. Os parâmetros são “empilhados” até que se chama APPLY XSLT TRANSFORMATION no mesmo processo. Quando for executado APPLY XSLT TRANSFORMATION, a “pilha” de parâmetros se apaga automaticamente.

Exemplo

O exemplo abaixo define dois parâmetros XSL depois transforma o documento meudoc.xml em um arquivo HTML utilizando a folha de estilo minhafolha.xsl:

 XSLT SET PARAMETER("varstyle";"'bold'")

 XSLT SET PARAMETER("varcolor";"'blue'")

 $xmldoc:="meudoc.xml"

 $xslhoja:="minhafolha.xsl"

 $htmldoc:="meudoc.html"

 XSLT APPLY TRANSFORMATION($xmldoc;$xslhoja;$htmldoc)

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema OK assume o valor 1. Do contrário, assume o valor 0.