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
Originada na versão
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.