Comando DEFINE FIELD . . . COMPUTED
Informações do conceito
Define um campo calculado em um layout da tabela do Analytics.
Sintaxe
Para definir um campo calculado:
DEFINE FIELD nome_campo COMPUTED expressão
Para definir um campo calculado com parâmetros opcionais:
DEFINE FIELD nome_campo COMPUTED
<IF teste> <STATIC> <PIC formato> <AS nome_exibicao> <WIDTH caracteres> <SUPPRESS> <observação_do_campo>
expressão
Para definir um campo calculado condicional:
DEFINE FIELD nome_campo COMPUTED
*** LINHA EM BRANCO ***
valor IF condição
<valor IF condição>
<...n>
valor_padrão
Para definir um campo calculado condicional com parâmetros opcionais:
DEFINE FIELD nome_campo COMPUTED
<IF teste> <STATIC> <PIC formato> <AS nome_exibicao> <WIDTH caracteres> <SUPPRESS> <observação_do_campo>
valor IF condição
<valor IF condição>
<...n>
valor_padrão
Nota
A sintaxe de várias linhas deve ser estruturada exatamente como mostrado na sintaxe genérica acima e nos exemplos abaixo.
Parâmetros
| Nome | Descrição |
|---|---|
| nome_campo |
O nome do campo calculado. Nota Os nomes dos campos estão limitados a 256 caracteres alfanuméricos maiúsculos e minúsculos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número. O Analytics apresenta uma variedade de palavras-chave reservadas que não podem ser usadas como nomes de campos. Para obter uma lista completa, consulte Palavras-chave reservadas. |
| expressão | Uma expressão válida do Analytics que define o valor do campo calculado. |
| IF teste opcional |
Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT). |
|
STATIC opcional |
O campo exibe o mesmo valor em cada linha da tabela até que um novo valor seja encontrado. Por exemplo, se houver um campo Sobrenome nos dados de origem, e:
Neste caso, "Smith" será exibido em seis linhas consecutivas e "Wong" será exibido na sétima linha. |
| PIC formato opcional |
Nota Aplica-se somente a campos numéricos. O formato da exibição de valores numéricos em exibições e relatórios do Analytics. formato deve estar entre aspas. |
|
AS nome_exibicao opcional |
O nome de exibição (título alternativo da coluna) para o campo na exibição. Se você quiser que o nome de exibição seja o mesmo que o nome do campo, não use AS. Especifique nome_exibicao como uma cadeia entre aspas. Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna. |
| WIDTH caracteres opcional |
A largura de exibição do campo em caracteres. O valor especificado controla a largura de exibição do campo em exibições e relatórios do Analytics. A largura de exibição nunca altera os dados. No entanto, pode ocultá-los se for menor que o comprimento do campo. A largura de exibição não pode ser inferior ao comprimento de nome_campo ou de nome_exibicao. Se você omitir WIDTH, a largura de exibição será definida como o comprimento do campo em caracteres. Nota Os caracteres especificados por WIDTH são caracteres de largura fixa. A mesma quantidade de espaço é alocada a cada caractere, independentemente da largura do caractere real. Por padrão, as exibições do Analytics usam uma fonte de largura proporcional que não corresponde ao espaçamento dos caracteres de largura fixa. Se você quiser uma correspondência de um para um entre o valor de WIDTH e os caracteres na exibição, poderá alterar a configuração Fonte Proporcional na caixa de diálogo Opções para uma fonte de largura fixa, como Courier New. |
|
SUPPRESS opcional |
Aplica-se somente a campos numéricos. Suprime a totalização automática dos campos numéricos calculados em relatórios do Analytics. A totalização de alguns campos numéricos não é apropriada. Por exemplo, um campo de custo unitário ou um campo de taxa de desconto. |
|
observação_do_campo opcional |
O texto de uma observação de campo adicionada à definição de campo no layout da tabela. observação_do_campo deve ser o último parâmetro, depois de todos os outros parâmetros obrigatórios e opcionais. O texto não pode ter várias linhas. Não é necessário usar aspas. |
| valor IF condição |
Somente campo calculado condicional.
|
| valor_padrão |
Somente campo calculado condicional. O valor ou expressão a ser usado no campo calculado se nenhuma das condições for avaliada como verdadeira. Nota A precisão decimal de todos os valores calculados é controlada pela precisão de valor_padrão. Por exemplo, se você especificar um valor padrão de 0,00, todos os valores serão calculados com duas casas decimais e, se necessário, arredondados. Para obter maior precisão, aumente o número de casas decimais em valor_padrão. |
Exemplos
Definição de um campo calculado
Defina um campo calculado chamado Valor que é o produto dos campos Custo e Quantidade:
DEFINE FIELD Valor COMPUTED Custo * Quantidade
Definição de um campo calculado com opções
Defina um campo calculado chamado Valor_03, com várias opções definidas. Inclua uma condição IF que limita quais os registros processados pelo campo calculado:
DEFINE FIELD Valor_03 COMPUTED
IF Classe_Produto = "03" PIC "($9.999.999,99)" AS "Valor Prod Classe 3" Valor é custo multiplicado por quantidade
Custo * Quantidade
Definição de um campo calculado condicional
Defina um campo calculado condicional denominado Imposto_vendas que calcula um imposto de venda diferente, dependendo do estado no qual a transação ocorreu. As transações que ocorreram fora dos três estados têm um imposto de venda padrão de US$ 0,00.
Nota
A segunda linha deve ficar em branco porque não há parâmetros opcionais.
DEFINE FIELD Imposto_vendas COMPUTED
0,0750 * Valor_vendas IF Estado = "RJ"
0,0400 * Valor_vendas IF Estado = "SP"
0,0625 * Valor_vendas IF Estado = "RS"
0,00
Definição de um campo calculado condicional com opções
Defina um campo calculado condicional denominado Imposto_vendas_100 que calcula um imposto de venda diferente, dependendo do estado no qual a transação ocorreu. O campo somente calcula imposto para valores iguais ou superiores a US$ 100.
As transações que ocorreram fora dos três estados têm um imposto de venda padrão de US$ 0,00.
Nota
Quando você especificar parâmetros opcionais, não deixe linhas em branco.
DEFINE FIELD Imposto_vendas_100 COMPUTED
IF Valor_vendas >= 100
0,0750 * Valor_vendas IF Estado = "RJ"
0,0400 * Valor_vendas IF Estado = "SP"
0,0625 * Valor_vendas IF Estado = "RS"
0,00
Observações
Para obter mais informações sobre o funcionamento desse comando, consulte Definir campos calculados.
Dois tipos de campos calculados
Há dois tipos de campos calculados:
- campos calculados padrão
Um campo calculado padrão executa o mesmo cálculo em cada registro da tabela.
Por exemplo, em uma tabela Inventário, você pode criar um campo calculado que multiplica o valor do campo Custo pelo valor do campo Quantidade para calcular o Valor do custo do inventário para cada registro.
- campo calculado condicional
Um campo calculado condicional pode executar cálculos diferentes nos registros de uma tabela de acordo com um conjunto de condições especificadas. Os cálculos executados em um registro dependem da condição atendida pelo registro.
Por exemplo, em uma tabela Transações, você pode criar um campo calculado condicional que calcula o imposto sobre a venda usando uma taxa ajustável, baseada no estado onde ocorreu a transação. Condições como IF Estado = "SP" e IF Estado = "RJ" testam cada registro para identificar a taxa a ser usada.
Diretrizes para a criação de um campo calculado condicional
Nota
Na definição de um campo calculado condicional, se você não especificar nenhum parâmetro opcional na segunda linha, deverá deixá-la em branco.
Além de um valor padrão, os campos calculados condicionais requerem pelo menos um valor condicional. Você deve usar a sintaxe de várias linhas a seguir para definir um campo calculado condicional:
- os parâmetros opcionais aparecem na segunda linha
- se não houver parâmetros adicionais, a segunda linha deve ficar em branco
- a primeira instrução condicional aparece na terceira linha
- cada instrução condicional exige uma linha separada
- o valor padrão aparece na última linha
Sobrescrevendo definições de campo
Você pode sobrescrever uma definição de campo em um layout de tabela definindo um campo que usa o mesmo nome que o campo existente.
Se SET SAFETY está definido como ON, o Analytics exibe uma caixa de diálogo de confirmação antes de sobrescrever o campo existente. Para evitar interromper um script, você pode definir SET SAFETY como OFF e o Analytics sobrescreve o campo existente sem solicitar confirmação.
