Saltar para o conteúdo principal
Versão: 20 R4

Etiquetas de transformação

4D oferece um conjunto de etiquetas de transformação que lhe permite inserir referências a variáveis ou expressões 4D, ou realizar diferentes tipos de processamento dentro de um texto de origem, referido como um "modelo". Essas tags são interpretadas quando o texto de origem é executado e geram um texto de saída.

Esse princípio é usado em particular pelo servidor da Web 4D para criar [páginas de modelo da Web] (WebServer/templates.md).

Em geral, essas tags devem ser inseridas como comentários do tipo HTML (<!--#Tag Contents-->), mas uma sintaxe alternativa compatível com xml (#alternative-syntax-for-4dtext-4dhtml-4deval) está disponível para algumas delas.

É possível misturar vários tipos de etiquetas. Por exemplo, a seguinte estrutura HTML é inteiramente viável:

<HTML>
<BODY>
<!--#4DSCRIPT/PRE_PROCESS-->   (Method call)
<!--#4DIF (myvar=1)-->   (If condition)
   <!--#4DINCLUDE banner1.html-->   (Subpage insertion)
<!--#4DENDIF-->   (End if)
<!--#4DIF (mtvar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLE]-->   (Loop on the current selection)
<!--#4DIF ([TABLE]ValNum>10)-->   (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpage.html-->   (Subpage insertion)
<!--#4DELSE-->   (Else)
   <B>Value: <!--#4DTEXT [TABLE]ValNum--></B><br/>   (Field display)
<!--#4DENDIF-->
<!--#4DENDLOOP-->   ](End for)
</BODY>
</HTML>

Princípios de utilização das etiquetas​

Parsing​

A análise do conteúdo de uma fonte template é feita em dois contextos:

  • Usando o comando PROCESS 4D TAGS; esse comando aceita um template como entrada, bem como parâmetros opcionais, e retorna um texto resultante do processamento.

  • Usando o servidor HTTP integrado do 4D: [páginas de modelo] (WebServer/templates.md) enviadas por meio dos comandos WEB SEND FILE (.htm, .html, .shtm, .shtml), WEB SEND BLOB (texto/html tipo BLOB), WEB SEND TEXT ou chamadas usando URLs. Nesse último caso, por motivos de otimização, as páginas sufixadas com ".htm" e ".html" NÃO são analisadas. Para analisar páginas HTML nesse caso, você deve adicionar o sufixo ".shtm" ou ".shtml" (por exemplo, http://www.server.com/dir/page.shtm).

Processamento recursivo​

As etiquetas 4D são interpretadas de forma recursiva: 4D sempre tenta reinterpretar o resultado de uma transformação e, se uma nova transformação tiver ocorrido, uma interpretação adicional é realizada, e assim por diante, até que o produto obtido não precise mais de nenhuma transformação adicional. Por exemplo, dada a seguinte instrução:

<!--#4DHTML [Mail]Letter_type-->

Se o próprio campo de texto [Mail]Letter_type contiver uma tag, por exemplo, <!--#4DSCRIPT/m_Gender-->, essa tag será avaliada recursivamente após a interpretação da tag 4DHTML.

Esse princípio poderoso atende à maioria das necessidades relacionadas à transformação de texto. Observe, entretanto, que em alguns casos isso também pode permitir a inserção de código malicioso no contexto da Web, [o que pode ser evitado] (WebServer/templates.md#prevention-of-malicious-code-insertion).

Identificadores com tokens​

Para garantir a avaliação correta das expressões processadas por meio de tags, independentemente do idioma ou da versão 4D, é recomendável usar a sintaxe tokenizada para elementos cujo nome possa variar de acordo com as versões (comandos, tabelas, campos, constantes). Por exemplo, para inserir o comando Current time (tempo atual), digite Current time:C178.

Utilizar o "." como separador decimal​

4D sempre usa o caractere de ponto final (.) como um separador decimal ao avaliar uma expressão numérica usando uma tag 4D 4DTEXT, 4DHTML e 4DEVAL. Os parâmetros regionais são ignorados. Esse recurso facilita a manutenção do código e a compatibilidade entre idiomas e versões 4D.

4DBASE​

Sintaxe: <!--#4DBASE folderPath-->​

A tag <!--#4DBASE --> designa o diretório de trabalho a ser usado pela tag <!--#4DINCLUDE-->.

Quando é chamada em uma página da Web, a tag <!--#4DBASE --> modifica todas as chamadas <!--#4DINCLUDE--> subsequentes nessa página, até a próxima <!--........-->, se houver. Se a pasta<!--#4DBASE --> for modificada em um arquivo incluído, ela recuperará seu valor original do arquivo pai.

O parâmetro folderPath deve conter um nome de caminho relativo à página atual e deve terminar com uma barra (/). A pasta designada deve estar localizada dentro da pasta Web.

Passe a palavra-chave "WEBFOLDER" para restaurar o caminho padrão (relativo à página).

O código seguinte, que deve especificar um caminho relativo para cada chamada:

<!--#4DINCLUDE subpage.html-->
<!--#4DINCLUDE folder/subpage1.html-->
<!--#4DINCLUDE folder/subpage2.html-->
<!--#4DINCLUDE folder/subpage3.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

... é equivalente a:

<!--#4DINCLUDE subpage.html-->
<!--#4DBASE folder/-->
<!--#4DINCLUDE subpage1.html-->
<!--#4DINCLUDE subpage2.html-->
<!--#4DINCLUDE subpage3.html-->
<!--#4DBASE ../folder/-->
<!--#4DINCLUDE subpage.html-->
<!--#4DBASE WEBFOLDER-->

Por exemplo, para definir um directório para a página inicial:

/* Index.html */
<!--#4DIF LangFR=True-->
    <!--#4DBASE FR/-->
<!--#4DELSE-->
    <!--#4DBASE US/-->
<!--#4DENDIF-->
<!--#4DINCLUDE head.html-->
<!--#4DINCLUDE body.html-->
<!--#4DINCLUDE footer.html-->

No arquivo "head.html", a pasta atual é modificada por meio de <!--#4DBASE -->, sem que isso altere seu valor em "Index.html":

/* Head.htm */
/* O diretório de trabalho aqui é relativo ao arquivo incluído (FR/ ou US/) */
<!--#4DBASE Styles/-->
<!--#4DINCLUDE main. ss-->
<!--#4DINCLUDE product.css-->
<!--#4DBASE Scripts/-->
<!--#4DINCLUDE main.js-->
<!--#4DINCLUDE product.js-->

4DCODE​

Sintaxe: <!--#4DCODE codeLines-->​

A tag 4DCODE permite que você insira um bloco de código 4D de várias linhas em um modelo.

Quando um <! -#4DCODE sequencia detectada que é seguida de um espaço, um CR ou um caractere LF, 4D interpreta todas as linhas de código até a próxima sequência -->. O bloco de código em si pode conter retornos, feeds de linha ou ambos; ele será interpretado sequencialmente por 4D.

Por exemplo, pode escrever num modelo:

<!--#4DCODE
//PARAMETERS initialization
C_OBJECT:C1216($graphParameters)
OB SET:C1220($graphParameters;"graphType";1)
$graphType:=1
//...your code here
If(OB Is defined:C1231($graphParameters;"graphType"))
    $graphType:=OB GET:C1224($graphParameters;"graphType")
    If($graphType=7)
        $nbSeries:=1
        If($nbValues>8)
            DELETE FROM ARRAY:C228 ($yValuesArrPtr{1}->;9;100000)
            $nbValues:=8
        End if
    End if
End if
-->

Eis as características da etiqueta 4DCODE:

  • O comando TRACE é suportado e ativa o depurador 4D, permitindo que você depure seu código de modelo.
  • Qualquer erro exibirá a caixa de diálogo de erro padrão que permite que o usuário interrompa a execução do código ou entre no modo de depuração.
  • O texto entre <!--#4DCODE and --> é dividido em linhas que aceitam qualquer convenção de fim de linha (cr, lf ou crlf).
  • O texto é tokenizado no contexto do banco de dados chamado PROCESS 4D TAGS. Isto é importante para o reconhecimento dos métodos dos projectos, por exemplo. A propriedade de método Disponível através de tags e URLs 4D (4DACTION ...) não é tida em conta.
  • Mesmo que o texto sempre use o inglês americano, é recomendável usar a sintaxe de token (:Cxxx) para nomes de comandos e constantes para se proteger contra possíveis problemas devido ao fato de comandos ou constantes serem renomeados de uma versão do 4D para outra.

O fato de que as tags 4DCODE podem chamar qualquer um dos comandos do idioma 4D ou métodos do projeto pode ser visto como um problema de segurança. especialmente quando o banco de dados está disponível por HTTP. No entanto, como ele executa o código do servidor chamado a partir dos seus próprios arquivos de template, a tag em si não representa um problema de segurança. Neste contexto, como em qualquer servidor Web, a segurança é manipulada principalmente ao nível de acessos remotos para arquivos de servidor.

4DEACH e 4DENDEACH​

Sintaxe: <!--#4DEACH variable in expression--> <!--#4DENDEACH-->​

O comentário <!--#4DEACH--> permite iterar um item especificado sobre todos os valores da expressão. O item é definido como uma variável cujo tipo depende do tipo da expressão.

O comentário <!--#4DEACH--> pode iterar por três tipos de expressão:

O número de iterações é avaliado na inicialização e não será alterado durante o processamento. Adicionar ou remover itens durante o loop não é recomendado porque resulta em iterações faltantes ou redundantes.

<!--#4DEACH item in collection-->​

Essa sintaxe itera em cada item da coleção. A parte do código localizada entre <!--#4DEACH --> e <!--#4DENDEACH--> é repetida para cada elemento da coleção.

O parâmetro item é uma variável do mesmo tipo que os elementos da coleção.

A coleção deve conter apenas elementos do mesmo tipo, caso contrário, um erro será retornado assim que a variável item receber o primeiro tipo de valor incompatível.

O número de loops é baseado no número de elementos da coleção. A cada iteração, a variável item é automaticamente preenchida com o elemento correspondente da coleção. Os pontos abaixo devem ser considerados:

  • Se a variável item for do tipo objeto ou do tipo coleção (ou seja, se expressão for uma coleção de objetos ou de coleções), a modificação dessa variável modificará automaticamente o elemento correspondente da coleção (porque objetos e coleções compartilham as mesmas referências). Se a variável for de tipo escalar, só se modificará a variável.
  • A variável item recebe o mesmo tipo que o primeiro elemento da coleção. Se algum elemento da coleção não for do mesmo tipo que a variável, será gerado um erro e o loop será interrompido.
  • Se a coleção contiver elementos com um valor Null, será gerado um erro se o tipo de variável item não for compatível com valores Null (como variáveis longint).

Exemplo com uma coleção de valores escalares​

getNames retorna uma coleção de strings. O método foi declarado como "disponível através de tags 4D e URLs".

 <table class="table">    

        <tr><th>Name</th></tr>

          <!--#4DEACH $name in getNames-->
        <tr>
            <td><!--#4DTEXT $name--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

Exemplo com uma coleção de objetos​

O getSalesPersons retorna uma coleção de objetos.

    <table class="table">    
         <!--#4DCODE
            $salePersons:=getSalesPersons
          -->          
       <tr><th>ID</th><th>Firstname</th><th>Lastname</th></tr>

          <!--#4DEACH $salesPerson in $salePersons-->
        <tr>
            <td><!--#4DTEXT $salesPerson.ID--></td>
            <td><!--#4DTEXT $salesPerson.firstname--></td>
            <td><!--#4DTEXT $salesPerson.lastname--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

<!--#4DEACH entity in entitySelection-->​

Essa sintaxe itera em cada entity da entitySelection. A parte do código localizada entre <!--#4DEACH --> e <!--#4DENDEACH--> é repetida para cada entidade da seleção de entidades.

O parâmetro entidade é uma variável de objeto da classe de seleção da entidade.

O número de loops é baseado no número de entidades da seleção de entidades. Em cada iteração, a variável de objeto entidade é automaticamente preenchida com a entidade correspondente à seleção da entidade.

Exemplo com uma tabela html​

    <table class="table">     

        <tr><th>ID</th><th>Name</th><th>Total purchase</th></tr>

          <!--#4DEACH $customer in ds.Customers.all()-->
        <tr>
            <td><!--#4DTEXT $customer.ID--></td>
            <td><!--#4DTEXT $customer.name--></td>
            <td><center><!--#4DTEXT String($customer.totalPurchase;"$###,##0")--></center></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

Exemplo com PROCESS 4D TAGS​

var customers : cs.CustomersSelection
var $input; $output : Text

customers:=ds.Customers.all()
$input:="<!--#4DEACH $cust in customers-->"
$input:=$input+"<!--#4DTEXT $cust.name -->"+Char(Carriage return)
$input:=$input+"<!--#4DENDEACH-->"
PROCESS 4D TAGS($input; $output)
TEXT TO DOCUMENT("customers.txt"; $output)

<!--#4DEACH property in object-->​

Essa sintaxe itera em cada propriedade do objeto. A parte do código localizada entre <!--#4DEACH --> e <!--#4DENDEACH--> é repetida para cada propriedade do objeto.

O parâmetro propriedade é uma variável de texto automaticamente preenchida com o nome da propriedade processada atualmente.

As propriedades do objeto são processadas de acordo com sua ordem de criação. Durante o loop, propriedades podem ser adicionadas ou eliminadas no objeto, sem modificar o número de loops que permanecerão no número original de propriedades do objeto.

Exemplo com as propriedades de um objeto​

getGamers é um método de projeto que retorna um objeto como ("Mary"; 10; "Ann"; 20; "John"; 40) para calcular as pontuações dos jogadores.

    <table class="table">    
          <!--#4DCODE
           $gamers:=getGamers
          -->          

        <tr><th>Gamers</th><th>Scores</th></tr>

          <!--#4DEACH $key in $gamers-->
        <tr>
            <td ><!--#4DTEXT $key--></td>
            <td ><!--#4DTEXT $gamers[$key]--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

4DEVAL​

Sintaxe: <!--#4DEVAL expression-->​

Sintaxe alternativa: $4DEVAL(expressão)​

A tag 4DEVAL permite que você avalie uma variável ou expressão 4D. Como a tag 4DHTML, 4DEVAL não escapa dos caracteres HTML ao retornar o texto. No entanto, ao contrário do 4DHTML ou [4DTEXT] (#4dtext), o 4DEVAL permite que você execute qualquer instrução 4D válida, incluindo atribuições e expressões que não retornam nenhum valor.

Por exemplo, é possível executar:

 $input:="<!--#4DEVAL a:=42-->" //atribuição
 $input:=$input+"<!--#4DEVAL a+1-->" //cálculo
 PROCESS 4D TAGS($input;$output)
  //$output = "43"

No caso de um erro durante a interpretação, o texto inserido terá o formato: <!--#4DEVAL expr-->: ## error # error code.

Por razões de segurança, é recomendável usar a tag 4DTEXT ao processar dados introduzidos de fora do aplicativo, a fim de evitar a inserção de código malicioso.

4DHTML​

Sintaxe: <!--#4DHTML expression-->​

Sintaxe alternativa: $4DHTML(expression)​

Assim como a tag 4DTEXT, esta tag permite avaliar uma variável 4D ou expressão que retorne um valor, e insira como uma expressão HTML. Ao contrário da tag 4DTEXT, essa tag não escapa dos caracteres especiais do HTML (por exemplo, ">").

Por exemplo, aqui estão os resultados do processamento da variável de texto 4D myvar com as tags disponíveis:

Valor myvarEtiquetasResultados
myvar:="<B>"<!--#4DTEXT myvar-->&amp;lt;B&amp;gt;
myvar:="<B>"<!--#4DHTML myvar--><B>

No caso de um erro de interpretação, o texto inserido será <!--#4DHTML myvar-->: ## error # error code.

Por motivos de segurança, recomenda-se usar a tag [4DTEXT] (#4dtext) ao processar dados introduzidos de fora do aplicativo, para evitar a [inserção de código malicioso] (#prevention-of-malicious-code-insertion).

4DIF, 4DELSE, 4DELSEIF e 4DENDIF​

Sintaxe: <!--#4DIF expression--> {<!--#4DELSEIF expression2-->...<!--#4DELSEIF expressionN-->} {<!--#4DELSE-->} <!--#4DENDIF-->​

Usado com os comentários <!--#4DELSEIF--> (opcional), <!--#4DELSE--> (opcional) e <!--#4DENDIF-->, o comentário <!--#4DIF expressão--> oferece a possibilidade de executar partes do código condicionalmente.

O parâmetro expressão pode conter qualquer expressão 4D válida que retorne um valor booleano. Deve ser indicado entre parênteses e estar em conformidade com as regras da sintaxe 4D.

A expressão <!--#4DIF --> ... <!--#4DENDIF--> blocos podem ser aninhados em vários níveis. Como em 4D, cada expressão <!--#4DIF --> deve corresponder a um <!--#4DENDIF-->.

Em caso de erro de interpretação, o texto "<! -#4DIF expressão-->: Uma expressão booleana foi esperada ao invés do conteúdo localizado entre <!--#4DIF --> e <!--#4DENDIF-->. Da mesma forma, se não houver tantos <!--#4DENDIF--> como <!--#4DIF -->, o texto "<! -#4DIF expressão-->: 4DENDIF esperado" foi inserido em vez do conteúdo localizado entre <!--#4DIF --> e <!--#4DENDIF-->.

Usando a tag <!--#4DELSEIF-->, você pode testar um número ilimitado de condições. Somente o código que segue a primeira condição avaliada como True é executado. Se não houver condições verdadeiras, nenhuma declaração é executada (se não houver nenhuma declaração final <!--#4DELSE-->). Você pode usar uma tag <!--#4DELSE--> após a última <!--#4DELSEIF-->. Se todas as condições forem falsas, as instruções seguintes <!--#4DELSE--> serão executadas.

Os dois códigos seguintes são equivalentes.

Código usando somente 4DELSE:

<!--#4DIF Condition1-->
  /* Condition1 é true*/
<!--#4DELSE-->
    <! -#4DIF Condition2-->
        /* Condition2 é true*/
    <! -#4DELSE-->
        <! -#4DIF Condition3-->
            /* Condição 3 é verdadeira */
        <! -#4DELSE-->
            /*Nenhuma das condições são verdadeiras*/
        <! -#4DENDIF-->
    <!--#4DENDIF-->
<!--#4DENDIF-->

Código semelhante usando a tag 4DELSEIF:

<!--#4DIF Condition1-->
     /* Condição1 é verdadeira*/
<!--#4DELSEIF Condition2-->
     /* Condição2 é verdadeira*/
<!--#4DELSEIF Condition3-->
    /* Condição3 é verdadeira */
<!--#4DELSE-->
    /* Nenhuma das condições é verdadeira*/
<!--#4DENDIF-->

Este exemplo de código inserido em uma página HTML estática exibe um rótulo diferente de acordo com o resultado de expressão vname#"":

<BODY>
...
<!--#4DIF (vname#"")-->
Names starting with <!--#4DTEXT vname-->.
<!--#4DELSE-->
No name has been found.
<!--#4DENDIF-->
...
</BODY>

Este exemplo insere páginas diferentes dependendo de qual usuário está conectado:

<!--#4DIF LoggedIn=False-->
    <!--#4DINCLUDE Login.htm -->
<!--#4DELSEIF User="Admin" -->
    <!--#4DINCLUDE AdminPanel.htm -->
<!--#4DELSEIF User="Manager" -->
    <!--#4DINCLUDE SalesDashboard.htm -->
<!--#4DELSE-->
    <!--#4DINCLUDE ItemList.htm -->
<!--#4DENDIF-->

4DINCLUDE​

Sintaxe: <!--#4DINCLUDE path-->​

Essa tag foi projetada principalmente para incluir uma página HTML (indicada pelo parâmetro path) em outra página HTML. Por padrão, somente o corpo da página HTML especificada, ou seja, o conteúdo encontrado dentro das tags <body> e </body>, é incluído (as próprias tags não são incluídas). Isso permite evitar conflitos relacionados a meta etiquetas presentes nos cabeçalhos.

No entanto, se a página HTML especificada não contiver tags <body>``</body>, a página inteira será incluída. Cabe-lhe a você verificar a coerência das meta etiquetas.

O comentário <!--#4DINCLUDE --> é muito útil para testes (<!--#4DIF-->) ou laços (<!--#4DLOOP-->). É muito conveniente incluir banners de acordo com critérios ou de forma aleatória. Ao incluir, independentemente da extensão de nome do arquivo, O 4D analisa a página chamada e, em seguida, insere o conteúdo (modificado ou não) na página originando a chamada 4DINCLUDE.

Uma página incluída com o <! -#4DINCLUDE --> o comentário é carregado no cache do servidor Web da mesma forma que as páginas chamadas através de uma URL ou enviadas com o comando WEB SEND FILE.

Em path, coloque o caminho que leva ao documento a ser incluído. Aviso: No caso de uma chamada 4DINCLUDE, o caminho é relativo ao documento a ser analisado, ou seja, o documento "pai". Use o caractere com a barra (/) como um separador de pastas e os dois pontos (..) para subir um nível (sintaxe HTML). Quando você usa a tag 4DINCLUDE com o comando PROCESS 4D TAGS, a pasta padrão é a pasta do projeto.

Você pode modificar a pasta padrão usada pela tag 4DINCLUDE na página atual, usando a tag <!--#4DBASE --> (veja abaixo).

O número de <!--#4DINCLUDE caminho--> dentro de uma página é ilimitado. No entanto, as chamadas <!--#4DINCLUDE caminho--> só podem ser feitas em um nível. Isso significa que, por exemplo, você não pode inserir <!--#4DINCLUDE mydoc3.html--> no corpo da página mydoc2.html, que é chamado por <!--#4DINCLUDE mydoc2--> inserido em mydoc1.html. Além disso, 4D verifica que as inclusões não são recursivas.

Em caso de erro, o texto inserido é "<!--#4DINCLUDE path--> :O documento não pode ser aberto".

Exemplos:

<!--#4DINCLUDE subpage.html-->
<!--#4DINCLUDE folder/subpage.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

4DLOOP e 4DENDLOOP​

Sintaxe: <!--#4DLOOP condition--> <!--#4DENDLOOP-->​

Este comentário permite a repetição de uma porção de código, desde que a condição seja satisfeita. A porção é delimitada por <!--#4DLOOP--> e <!--#4DENDLOOP-->.

A condição <!--#4DLOOP --> ... <!--#4DENDLOOP--> blocos podem ser aninhados. Como em 4D, cada <!--#4DLOOP condition--> deve corresponder a um <!--#4DENDLOOP-->.

Existem cinco tipos de condições:

<!--#4DLOOP [table]-->​

Esta sintaxe faz um loop para cada registro da tabela selecionada atualmente no processo atual. A porção de código localizada entre os dois comentários é repetida para cada registro de seleção atual.

Quando a tag 4DLOOP é usada com uma tabela, os registros são carregados no modo "Somente leitura".

O seguinte código:

<!--#4DLOOP [People]-->
<!--#4DTEXT [People]Name--> <!--#4DTEXT [People]Surname--><br/>
<!--#4DENDLOOP-->

... poderia ser expresso em linguagem 4D da seguinte forma:

 FIRST RECORD([People])
 While(Not(End selection([People])))
    ...
    NEXT RECORD([People])
 End while

<!--#4DLOOP array-->​

Esta sintaxe cria um ciclo para cada item do array. O item atual do array é aumentado quando cada parte do código é repetida.

Esta sintaxe não pode ser utilizada com arrays de duas dimensões. Neste caso, é preferível combinar um método com loops aninhados.

O seguinte exemplo de código:

<!--#4DLOOP arr_names-->
<!--#4DTEXT arr_names{arr_names}--><br/>
<!--#4DENDLOOP-->

... poderia ser expresso em linguagem 4D da seguinte forma:

 For($Elem;1;Size of array(arr_names))
    arr_names:=$Elem
    ...
 End for

<!--#4DLOOP method-->​

Essa sintaxe cria um loop desde que o método retorne True. O método utiliza um tipo de parâmetro Long Integer. Primeiro, ele é chamado com o valor 0 para permitir um estágio de inicialização (se necessário); em seguida, é chamado com os valores 1, 2, 3 e assim por diante, desde que retorne True.

Por motivos de segurança, em um processo da Web, o método de banco de dados On Web Authentication pode ser chamado uma vez, logo antes do estágio de inicialização (execução do método com 0 como parâmetro). Se a autenticação for correta, a fase de inicialização prossegue.

C_BOOLEAN($0) e C_LONGINT($1) DEVE ser declarado dentro do método para fins de compilação.

O seguinte exemplo de código:

<!--#4DLOOP my_method-->
<!--#4DTEXT var--> <br/>
<!--#4DENDLOOP-->

... poderia ser expresso em linguagem 4D da seguinte forma:

 If(AuthenticationWebOK)
    If(my_method(0))
       $counter:=1
       While(my_method($counter))
          ...
          $counter:=$counter+1
       End while
    End if
 End if

O método my_method pode ser o seguinte:

 C_LONGINT($1)
 C_BOOLEAN($0)
 If($1=0) `Inicialização
    $0:=True
 Else
    If($1<50)
       ...
       var:=...
       $0:=True
    Else
       $0:=False `Para o loop
    End if
 End if

<!--#4DLOOP expression-->​

Com esta sintaxe, a tag 4DLOOP faz um laço contanto que a expressão retorne True. A expressão pode ser qualquer expressão booleana válida e deve conter uma parte da variável para ser avaliada em cada laço para evitar laços infinitos.

Por exemplo, o seguinte código:

<!--#4DEVAL $i:=0-->
<!--#4DLOOP ($i<4)-->
<!--#4DEVAL $i-->
<!--#4DEVAL $i:=$i+1-->
<!--#4DENDLOOP-->

...produz o seguinte resultado:


0

1
2
3

<!--#4DLOOP pointerArray-->​

Nesse caso, a tag 4DLOOP funciona como em uma matriz: ela faz um loop para cada elemento da matriz referenciada pelo ponteiro. O elemento atual da matriz é aumentado cada vez que a parte do código é repetida.

Essa sintaxe é útil quando você passa um ponteiro de matriz como parâmetro para o comando PROCESS 4D TAGS.

Exemplo:

 ARRAY TEXT($array;2)
 $array{1}:="hello"
 $array{2}:="world"
 $input:="<!--#4DEVAL $1-->"
 $input:=$input+"<!--#4DLOOP $2-->"
 $input:=$input+"<!--#4DEVAL $2->{$2->}--> "
 $input:=$input+"<!--#4DENDLOOP-->"
 PROCESS 4D TAGS($input;$output;"elements = ";->$array)
  // $output = "elements = hello world "

Em caso de erro de interpretação, o texto "<!--#4DLOOP expressão-->: description" é inserido em vez do conteúdo localizado entre <!--#4DLOOP --> e <!--#4DENDLOOP-->.

Podem ser mostradas as seguintes mensagens:

  • Tipo de expressão inesperado (erro padrão);
  • Nome incorreto da tabela (erro no nome da tabela);
  • Esperava-se uma matriz (a variável não é uma matriz ou é uma matriz de duas dimensões);
  • O método não existe;
  • Erro de sintaxe (quando o método está em execução);
  • Erro de acesso (você não tem os privilégios de acesso adequados para acessar a tabela ou o método).
  • 4DENDLOOP esperado (o número <!--#4DENDLOOP--> não corresponde ao número <!--#4DLOOP -->).

4DSCRIPT/​

Sintaxe: <!--#4DSCRIPT/MethodName/MyParam-->​

A tag 4DSCRIPT permite que você execute métodos 4D ao processar o modelo. A presença da tag <!--#4DSCRIPT/MyMethod/MyParam--> como um comentário HTML inicia a execução do método MyMethod com o parâmetro Param como uma string em $1.

Se a tag for chamada no contexto de um processo da Web, quando a página for carregada, 4D chamará o método de banco de dados On Web Authentication (se existir). Se retornar True, 4D executa o método.

O método deve retornar o texto em $0. Se a string começa com o caractere de código 1, ele é considerado HTML (o mesmo princípio é verdadeiro para a tag 4DHTML).

Por exemplo, vamos dizer que você insere o seguinte comentário “Hoje é <!--#4DSCRIPT/MYMETH/MYPARAM-->” em uma página de modelo da web. Quando carrega a página, 4D chama o método do banco de dados Na Web Authentication, então chama o método MYMETH e passa a string “/MYPARAM” como o parâmetro $1. O método retorna o texto em $0 (por exemplo "12/31/21"); a expressão "Hoje é <!--#4DSCRIPT/MYMETH/MYPARAM–>" torna-se, portanto, "Hoje é 12/31/21".

O método MYMETH é o seguinte:

  //MYMETH
 C_TEXT($0;$1) //Estes parâmetros devem ser sempre declarados
 $0:=String(Current date)

Um método chamado por 4DSCRIPT não deve chamar elementos de interface (DIALOG, ALERT, etc.).

Como 4D executa métodos em sua ordem de aparição, é absolutamente possível chamar um método que define o valor de muitas variáveis que são referenciadas mais adiante no documento, seja qual for o modo que estiver usando. Você pode inserir quantos comentários <!--#4DSCRIPT...--> você quiser em um modelo.

4DTEXT​

Sintaxe: <!--#4DTEXT expression-->​

Sintaxe alternativa: $4DTEXT(expression)​

A tag <!--#4DTEXT expression--> permite que você insira uma referência a uma variável ou expressão 4D que retorna um valor. Por exemplo, se escrever (numa página HTML):

<P>Bem-vindo a <!--#4DTEXT vtSiteName-->!</P>

O valor da variável 4D vtSiteName será inserido na página HTML quando ela for enviada. Esse valor é inserido como texto simples, e os caracteres HTML especiais, como ">", são automaticamente escapados.

Também é possível inserir expressões 4D. Você pode, por exemplo, inserir diretamente o conteúdo de um campo (<!--#4DTEXT [tableName]fieldName-->), um elemento de array (<! -#4DTEXT tabarr{1}-->) ou um método retornando um valor (<!--#4DTEXT mymethod-->). A conversão de expressões segue as mesmas regras das variáveis. Além disso, a expressão deve respeitar as regras de sintaxe 4D.

Por motivos de segurança, recomenda-se usar essa tag ao processar dados introduzidos de fora do aplicativo, a fim de evitar a [inserção de código malicioso] (#prevention-of-malicious-code-insertion).

No caso de um erro de avaliação, o texto inserido aparecerá como <!--#4DTEXT myvar-->: ## error # error code.

  • É necessário utilizar variáveis processo.
  • É possível mostrar o conteúdo de um campo imagem. No entanto, não é possível exibir o conteúdo de um item matriz de imagens.
  • É possível exibir o conteúdo de um campo de objeto por meio de uma fórmula 4D. Por exemplo, você pode escrever <!--#4DTEXT OB Get:C1224([Rect]Desc;\"color\")-->.
  • Normalmente, trabalha-se com variáveis de tipo texto. No entanto, também é possível utilizar variáveis BLOB. Você só precisa gerar BLOBs no modo Texto sem comprimento.

Sintaxe alternativa para 4DTEXT, 4DHTML, 4DEVAL​

Várias tags de transformação 4D existentes podem ser expressas usando uma sintaxe baseada em $:

$4dtag (expression)​

pode ser utilizado em vez de

<!--#4dtag expression-->​

Esta sintaxe alternativa está disponível apenas para as tags usadas para retornar valores processados:

(Outras tags, como 4DIF ou 4DSCRIPT, devem ser escritas com a sintaxe normal).

Por exemplo, pode escrever:

$4DEVAL(UserName)

em vez de:

<!--#4DEVAL(UserName)-->

A principal vantagem dessa sintaxe é que ela permite que você escreva modelos em conformidade com XML. Alguns desenvolvedores de 4D precisam criar e validar modelos baseados em XML usando ferramentas padrão de análise de XML. Como o caractere "<" é inválido em um valor de atributo XML, não era possível usar a sintaxe "<!-- -->" das tags 4D sem quebrar a sintaxe do documento. Por outro lado, o escape do caractere "<" impedirá que 4D interprete as tags corretamente.

Por exemplo, o código a seguir causaria um erro de análise de XML devido ao primeiro caractere "<" no valor do atributo:

<line x1="<!--#4DEVAL $x-->" y1="<!--#4DEVAL $graphY1-->"/>

Utilizando a sintaxe $, o seguinte código é validado pelo analisador:

<line x1="$4DEVAL($x)" y1="$4DEVAL($graphY1)"/>

Observe que $4dtag e <--#4dtag --> não são estritamente equivalentes: ao contrário de <--#4dtag -->, o processamento de $4dtag não interpreta tags 4D [recursivamente] (#recursive-processing). As tags $ são sempre avaliadas uma vez e o resultado é considerado como texto simples.

A razão para esta diferença é evitar a injeção de código malicioso. Conforme [explicado abaixo] (#prevention-of-malicious-code-insertion), é altamente recomendável usar as tags 4DTEXT em vez das tags 4DHTML ao manipular o texto do usuário para se proteger contra reinterpretações indesejadas das tags: com 4DTEXT, caracteres especiais como "<" são escapados, portanto, quaisquer tags 4D que usem a sintaxe <!--#4dtag expression --> perderão seu significado específico. No entanto, como o 4DTEXT não escapa do símbolo $, decidimos interromper o suporte à recursão para evitar a injeção maliciosa usando a sintaxe $4dtag (expression).

Os exemplos a seguir mostram o resultado do processamento, dependendo da sintaxe e da tag usadas:

  // exemplo 1
 myName:="<!--#4DHTML QUIT 4D-->" //injeção maliciosa
 input:="My name is: <!--#4DHTML myName-->"
 PROCESS 4D TAGS(input;output)
  //4D will quit!
  // exemplo 1
 myName:="<!--#4DHTML QUIT 4D-->" //injeção maliciosa
 input:="My name is: <!--#4DHTML myName-->"
 PROCESS 4D TAGS(input;output)
  //4D will quit-->"
  // exemplo 1
 myName:="<!--#4DHTML QUIT 4D-->" //injeção maliciosa
 input:="My name is: <!--#4DHTML myName-->"
 PROCESS 4D TAGS(input;output)
  //4D will quit)"

Observe que a sintaxe $4dtag suporta a correspondência de pares de aspas ou parênteses. Por exemplo, suponha que você precise avaliar a seguinte cadeia de caracteres complexa (irrealista):

String(1) + "\"(hello)\""

Você pode escrever:

 input:="$4DEVAL( String(1)+\"\\\"(hello)\\\"\")"
 PROCESS 4D TAGS(input;output)
 -->output is 1"(hello)"