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

Etiquetas de transformação

4D provides a set of transformation tags which allow you to insert references to 4D variables or expressions, or to perform different types of processing within a source text, referred to as a "template". These tags are interpreted when the source text is executed and generate an output text.

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​

4D tags are interpreted recursively: 4D always attempts to reinterpret the result of a transformation and, if a new transformation has taken place, an additional interpretation is performed, and so on until the product obtained no longer requires any further transformation. 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.

This powerful principle meets most needs related to text transformation. 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​

To ensure the correct evaluation of expressions processed via tags, regardless of the language or 4D version, it's recommended to use the tokenized syntax for elements whose name may vary over versions (commands, tables, fields, constants). 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. This feature facilitates code maintenance and compatibility between 4D languages and versions.

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.

Pass the "WEBFOLDER" keyword to restore the default path (relative to the page).

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 -->. The code block itself can contain carriage returns, line feeds, or both; it will be interpreted sequentially by 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.
  • Any error will display the standard error dialog that lets the user stop code execution or enter debugging mode.
  • 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 de projeto, por exemplo. A propriedade de método Disponível através de tags e URLs 4D (4DACTION ...) não é tida em conta.
  • Even if the text always uses English-US, it is recommended to use the token syntax (:Cxxx) for command and constant names to protect against potential problems due to commands or constants being renamed from one version of 4D to another.

The fact that 4DCODE tags can call any of the 4D language commands or project methods could be seen as a security issue, especially when the database is available through HTTP. However, since it executes server-side code called from your own template files, the tag itself does not represent a security issue. In this context, as for any Web server, security is mainly handled at the level of remote accesses to server files.

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:

The number of iterations is evaluated at startup and will not change during the processing. 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.

The number of loops is based on the number of elements of the collection. 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. If any collection element is not of the same type as the variable, an error is generated and the loop stops.
  • 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 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).

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

For example, here are the processing results of the 4D text variable myvar with the available tags:

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. It must be indicated within parenthesis and comply with the 4D syntax rules.

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-->​

This comment allows repetition of a portion of code as long as the condition is fulfilled. 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]-->​

This syntax makes a loop for each record from the table current selection in the current process. The code portion located between the two comments is repeated for each current selection record.

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. The expression can be any valid Boolean expression and must contain a variable part to be evaluated in each loop to avoid infinite loops.

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. The current array element is increased each time the portion of code is repeated.

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);
  • An array was expected (the variable is not an array or is a two dimension array);
  • O método não existe;
  • Erro de sintaxe (quando o método está em execução);
  • Access error (you do not have the appropriate access privileges to access the table or the method).
  • 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.).

As 4D executes methods in their order of appearance, it is absolutely possible to call a method that sets the value of many variables that are referenced further in the document, whichever mode you are using. 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.
  • It is possible to display the contents of an object field by means of a 4D formula. 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​

Several existing 4D transformation tags can be expressed using a $-based syntax:

$4dtag (expression)​

pode ser utilizado em vez de

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

This alternative syntax is available only for tags used to return processed values:

(Other tags, such as 4DIF or 4DSCRIPT, must be written with the regular syntax).

Por exemplo, pode escrever:

$4DEVAL(UserName)

em vez de:

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

The main advantage of this syntax is that it allows you to write XML-compliant templates. Some 4D developers need to create and validate XML-based templates using standard XML parser tools. 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).

The following examples show the result of processing depending on the syntax and tag used:

  // 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. For example, suppose that you need to evaluate the following complex (unrealistic) string:

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

Você pode escrever:

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