Definir campo

Substitui todo o conteúdo do campo especificado no registro atual pelo resultado de um cálculo.

Opções 

• Especificar campo de destino especifica o campo cujo conteúdo você deseja selecionar. Se não houver campo especificado e um campo for selecionado no Modo de navegação ou no Modo de busca, esse campo será usado.
• Resultado calculado é o cálculo cujos resultados serão inseridos por esta etapa de script.

Originada na versão 

6.0 ou anterior

Descrição 

• O resultado do cálculo deve corresponder ao tipo de campo. Por exemplo, não é possível atribuir um cálculo de data a um campo de container.
• O campo especificado não precisa estar no layout atual.
• Se o resultado do cálculo não corresponder ao tipo de campo de destino, e a opção de validação do campo estiver definida como Sempre, o campo não será definido e um código de erro será retornado (que pode ser capturado com a Função Get(LastError)).
• Quando possível, a etapa de script Definir campo tornará o registro ativo e o manterá assim até que o registro seja fechado ou confirmado. Os scripts que usam uma série de etapas de script Definir campo devem agrupá-las se possível, para que as etapas de script Definir campo subsequentes possam atuar no registro sem precisar bloqueá-lo, baixar e carregar dados, indexar o campo etc., após cada etapa. Essas funções e a validação no nível do registro são executadas após o fechamento ou a confirmação do registro.
• Se o campo de destino for um campo de repetição, você poderá especificar ou gerar um número de repetição a partir de uma expressão calculada.

Exemplo 1 

Insere a soma dos totais gerais das faturas no campo Estatística.

Definir campo [Clientes::Estatística; Soma ( Faturas::Total geral )]

Exemplo 2 

Mostra quando usar Definir campo, em vez de Definir campo por nome, para simplificar scripts.

#Se o campo de destino não for alterado, use a etapa de script Definir campo.

Definir campo [Clientes::Telefone comercial; Cobrança de crédito::Número de telefone]

#Se você usar Definir campo por nome com um campo de destino que não altera,
#é preciso colocar o campo de destino entre aspas para que ele seja avaliado como uma cadeia de caracteres literal
#e retorne o nome do campo especificado. Se você não usar as aspas,
#Definir campo por nome avalia o campo especificado e usa o resultado como o campo de destino.
#Se o resultado não especificar um nome de campo, nada acontece.

Definir campo por nome ["Clientes::Telefone comercial"; Cobrança de crédito::Número de telefone]

Tópicos relacionados 

• Etapa de script Definir campo por nome
• Definição de campos de cálculo
• Referência de etapas de script