Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com

Página Inicial

 
4D v19
Field references

Field references  


 

4D View Pro lhe permite utilizar referências aos campos do banco de dados 4D em suas fórmulas. Quando  mostrar uma área 4D View Pro, uma referência de campo se substitui pelo valor do campo no registro atual. Se manter um link dinâmico entre a área e os dados 4D: se mudar o valor do campo, a área 4D View Pro utilizará o novo valor.

 

Para ser chamado em uma fórmula 4D View Pro, um campo 4D deve seguir as exigências abaixo:

  • o campo foi declarado como fórmula usando o comando  VP SET CUSTOM FUNCTIONS(ver exemplo)
  • O tipo de campo deve ser compatível com 4D View Pro (ver a seguir).    

Um erro é devolvido na célula 4D View Pro se a fórmula chamara um campo que não seja compatível.

Nota: por segurança quando VP SET CUSTOM FUNCTIONS não for usado (não recomendado), só os campos pertencentes à estrutura virtual do banco de dados, ou seja, declarados através dos comandos com o parâmetro * SET TABLE TITLES ou SET FIELD TITLES. Nesse caso, nomes de tabela e campos devem seguir ECMA (ver ECMA Script Standard). 

4D View Pro é compatível com referências a campos dos tipos abaixo:

TipoTipo de valor em 4D View Pro
Alfa, Textostring
Inteiro, inteiro longo, Inteiro de 64 bits, Real, Floatnúmero
DataTipo de data JavaScript (hora, minuto, seg = 0)
HoraTipo de data JavaScript (data na base data, ou seja 12/31/1899)
Booleanobool
Imagemtipos de imagens compatíveis: jpg, png, gif, bmp, svg; outros tipos convertidos em png. Cria um uri (data:image/png;base64,xxxx) definido como fundo para a célula 4D View Pro onde se executa a fórmula

Example  

Se quisermos imprimir o nome da pessoa em uma célula de área 4D View Pro usando um campo 4D:

  1. Crie uma tabela "Employee" com um campo "L_Name":
  2. No método formulário do formulário que contém a área 4D View Pro, pode escrever:
     Case of
        :(Form event code=On Load)
           var $o : Object
           $o:=New object
           $o.EMP_NAME:=New object //declare the function
           $o.EMP_NAME.formula:=Formula([Employee]L_Name)
           VP SET CUSTOM FUNCTIONS("ViewProArea";$o)
     End case
  3. Edite os conteúdos da célula na área 4D View Pro e digite "=e":
  4. Select EMP_NAME (use a tecla Tab) e digite o final ).
  5. Valide o campo para exibir o nome do empregado atual:

    Nota: A tabela [Employee] deve ter um registro atual.

Note: Quando o comando VP SET CUSTOM FUNCTIONS não é usado (não recomendado), campos declarados na estrutura virtual são digitados com uma sintaxe como TABLENAME_FIELDNAME(). 



Ver também 

USE 4D FORMULAS IN YOUR SPREADSHEET (blog post)
VP SET CUSTOM FUNCTIONS

 
PROPRIEDADES 

Produto: 4D
Tema: 4D View Pro Database References

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

Criado por: 4D v17 R2

 
ARTICLE USAGE

4D View Pro ( 4D v19)