Comando DEFINE COLUMN
Cria e adiciona uma ou mais colunas a uma exibição existente.
Sintaxe
DEFINE COLUMN nome_exibicao nome_campo <AS nome_exibicao> <POSITION n> <WIDTH caracteres> <PIC formato> <SORT|SORT D> <KEY> <PAGE> <NODUPS> <NOZEROS> <LINE n>
Parâmetros
| Nome | Descrição |
|---|---|
| nome_exibição |
A exibição onde a coluna será adicionada. |
|
nome_campo |
O campo para o qual criar a coluna. Para usar um campo de uma tabela relacionada, especifique o nome de campo como nome_tabela.nome_campo. |
| 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. |
| POSITION n opcional |
A posição numérica da coluna na exibição, da esquerda para a direita:
|
| 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. Se você omitir WIDTH, a largura de exibição será definida como o comprimento em caracteres especificado para o campo no layout da tabela. 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. |
| PIC formato opcional |
Nota Aplica-se somente a campos numéricos ou de datahora.
formato deve estar entre aspas. |
|
SORT | SORT D opcional |
Ordena a coluna:
|
|
KEY opcional |
A coluna é designada como um campo de quebra nos relatórios. Os relatórios serão subtotalizados e subdivididos quando o valor da coluna for alterado. As seguintes restrições se aplicam aos campos de quebra:
|
|
PAGE opcional |
Insere uma quebra de página cada vez que o valor do campo de quebra muda. |
|
NODUPS opcional |
Substitui valores repetidos por valores em branco no campo. Por exemplo, se o nome do cliente estiver listado para cada registro de fatura, o relatório ficará mais legível listando apenas a primeira ocorrência de cada nome de cliente. |
|
NOZEROS opcional |
Substitui valores zero por valores em branco no campo. Por exemplo, se um relatório incluir um grande número de valores zero em uma coluna, o relatório ficará mais legível listando apenas os itens que têm um valor diferente de zero. |
|
LINE n opcional |
O número de linhas na coluna. Se nenhum valor for especificado, a coluna adotará o padrão de uma linha única. O valor de n deve estar entre 2 e 60. |
Exemplos
Definição de uma exibição com seis colunas
Com a tabela AR aberta, você define uma exibição denominada Relatório_AR com seis colunas. As colunas são exibidas na ordem de especificação:
OPEN Ar DEFINE VIEW AR_Relatorio OK DEFINE COLUMN AR_Relatorio Numero AS "Número do Cliente" WIDTH 7 KEY DEFINE COLUMN AR_Relatorio Data AS "Data da Fatura" WIDTH 10 DEFINE COLUMN AR_Relatorio Vencto AS "Data de Vencimento" WIDTH 10 DEFINE COLUMN AR_Relatorio Referencia AS "Número de Referência" WIDTH 6 DEFINE COLUMN AR_Relatorio Tipo AS "Tipo de Transação" WIDTH 5 DEFINE COLUMN AR_Relatorio Qtde AS "Quantidade da Transação" WIDTH 12 PIC "-9999999999.99"
