Usar tokens em fórmulas

A linguagem 4D inclui um sistema de tokenização único para todos os nomes dos objetos da linguagem que forem usadas no código (constantes, comandos, tabelas, campos e palavras chaves). Tokenizar estes nomes significa que a medida que escreve se armazena internamente como referências absolutas (números) e logo se restauram como texto durante a execução ou visualização em função do contexto. Isto lhe permite garantir que o código sempre será interpretado corretamente, mesmo se modificar o nome das tabelas ou campos, ou  quando os comandos da linguagem 4D mudam de nome ao longo das diferentes versões do aplicativo.

Nota: isso também garante a tradução do código quando for ativada a opção  "Usar configuração do sistema regional" na Página Métodos das Preferências e abrir seus bancos de dados com as versões de 4D em diferentes idiomas.

A Tokenização é completamente transparente para os desenvolvedores 4D ao trabalhar no editor de código. Entretanto, este mecanismo não se aplica de forma automática nas fórmulas 4D já que consistem em texto que se interpreta durante a execução e não quando é escrito.  Na verdade, este é o  caso logo que o  código 4D se expressa em forma de texto sem formato, mais específicamente quando se exporta código e depois se importa utilizando os comandos METHOD GET CODE e METHOD SET CODE, copiar/colar ou interpretado desde Etiquetas HTML 4D.

Para continuar se beneficiando dos mecanismos de tokenização nestes contextos, só precisa utilizar uma sintaxe explícita (descrita mais adiante), que consiste em preceder os nomes dos objetos da linguagem de seu token.

Como padrão, o mecanismo de tokens não é implementado automaticamente nas fórmulas 4D (também chamadas expressões), já que consistem de texto que é interpretado no momento da execução e não quando está sendo ingressado. Entretanto, para os elementos nomeados das fórmulas, 4D oferece uma sintaxe especial que pode ser usada para referenciar diretamente aos tokens: só tem que adicionar um sufixo especifico e depois o nome do elemento para indicar seu tipo (comando, campo, etc.), seguido por sua referência. A sintaxe tokenizada se detalha na seguinte tabela:

Note: Letras maiúsculas (C, P) devem ser usadas nos sufixos, ou não serão interpretadas corretamente.

Quando for usado esta sintaxe, garante que suas fórmulas serão interpretadas corretamente mesmo que em caso de mudança de nome ou quando o banco de dados for executado em uma linguagem diferente

Nota: as constantes também são tokenizadas na linguagem, entretanto, nas fórmulas só podem passar seu valor com o objetivo de fazê-las independentes do  contexto.

Esta sintaxe é aceita em todas as fórmulas 4D (ou expressões 4D), independentemente do contexto de chamada:

• fórmulas 4D executadas utilizando Editor de fórmulas ou utilizando os comandos tais como EXECUTE FORMULA, APPLY TO SELECTION, QUERY BY FORMULA, LISTBOX INSERT COLUMN FORMULA, etc.
• expressões insertadas em áreas de texto enriquecido (ver ST INSERT EXPRESSION e Etiquetas suportadas),
• expressões  calculadas nas etiquetas de transformação (ver Etiquetas HTML 4D),
• expressões  inseridas em áreas de plug-ins,
• expressões  inseridas em áreas 4D Write Pro (a partir de 4D v15).

A sintaxe token exige a adição de números de referência de vários elementos. A localização dessas referências depende do tipo de elemento.

Os números dos comandos  podem ser encontrados neste manual Linguagem (área "Propriedades"), assim como na página Comandos do Explorador:

Tabelas e números de campos podem ser obtidos usando os comandos Table e Field.

Eles também são exibidos em  Inspetor do editor Structure:

Para saber quais são os tokens para os comandos 4D plug-in, o truque é digitar o código desejado no editor Método e então reiniciar 4D depois de desativar o plug-in (por exemplo ao mover uma pasta). Isso significa que apenas tokens serão exibidos no editor Método, e pode copiar as que quiser.

Código com plug-in instalado:

O mesmo código depois que o plug-in foi desativado: