Referência > Referência de funções > Funções lógicas > GetField
 

GetField

Avalia o nomeDoCampo e retorna o conteúdo do campo especificado.

Formato 

GetField(nomeDoCampo)

Parâmetros 

nomedoCampo - qualquer expressão de texto ou campo de texto que se refere a um nome do campo

Tipo de dados retornado 

texto, número, data, hora, carimbo de data/hora, container

Originado em 

FileMaker Pro 6.0 ou anterior

Descrição 

GetField avalia nomedoCampo, faz a correspondência do resultado com um campo na tabela em que o cálculo foi realizado e retorna o conteúdo desse campo.

Para retornar os valores de campos com o mesmo nome de campo em várias tabelas, coloque nomedoCampo entre aspas duplas, como em GetField("nomedoCampo").

Por exemplo, GetField("Telefone") retorna um valor de Cliente::Telefone quando GetField é calculado na tabela Cliente, e retorna Empresa::Telefone quando GetField é calculado na tabela Empresa.

Para retornar os valores de vários campos, não coloque nomedoCampo entre aspas, como em GetField(nomedoCampo), e especifique um campo com um valor que corresponda ao nome de outro campo na tabela. Para alterar o valor que GetField retorna, altere o valor no campo especificado para corresponder ao nome de um campo diferente na tabela.

Por exemplo, uma tabela tem três campos: Cliente::MétododeContato, Cliente::Telefone e Cliente::e-mail. Quando Cliente::MétododeContato tiver "Telefone", GetField(MétododeContato) retornará o conteúdo de Cliente::Telefone. Contudo, quando Cliente::MétododeContato tiver "e-mail", GetField(MétododeContato) retornará o conteúdo de Cliente::e-mail.

Exemplo 1 

Se classificar registros em um campo de cálculo definido pela função GetField, você poderá classificar os registros dinamicamente e exibir dados de sub-resumo alterando o valor do campo especificado por GetField.

Suponha que um banco de dados tenha quatro campos:

Nome do cliente, um campo de texto

Cidade, um campo de texto

ClassificarSeleção, um campo global

ClassificarChave, um campo de cálculo definido como GetField("ClassificarSeleção")

Este script vai ao layout Faturas e classifica registros no campo ClassificarChave:

Ir para layout ["Faturas" (Faturas)]
Classificar registros [Restaurar; Com diálogo: Desativado]
#Classificar pelo campo ClassificarChave
Ir para registro/solicitação/página [Primeiro]

Se ClassificarSeleção contiver "Nome do cliente", ClassificarChave retornará os valores do campo Nome do cliente, e o conjunto encontrado será classificado por Nome do cliente. Todos os dados de sub-resumo especificados para aparecer quando os registros são classificados por ClassificarChave são exibidos no campo Nome do cliente.

Se ClassificarSeleção for alterado para conter "Cidade", ClassificarChave retornará os valores do campo Cidade, o conjunto encontrado será reclassificado por Cidade e os dados do sub-resumo serão exibidos no campo Cidade.

Como o conjunto encontrado é classificado por ClassificarChave, as informações de classificação são atualizadas automaticamente quando os valores retornados por ClassificarChave mudam, e você não precisa realizar outra operação de classificação.

Tópicos relacionados 

Referência de funções (lista de categorias)

Referência de funções (lista em ordem alfabética)

Sobre fórmulas

Sobre funções

Definição de campos de cálculo

Utilização de operadores em fórmulas