Comando AGE

Agrupa os registros em períodos de vencimento com base nos valores de um campo data ou datahora. Conta os registros em cada período e subtotaliza os campos numéricos especificados em cada período.

Sintaxe

AGE <ON> campo_data <CUTOFF data_limite> <INTERVAL dias <;...n>> <SUPPRESS> <SUBTOTAL campo_numérico <...n>|SUBTOTAL ALL> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <TO {SCREEN|nome_arquivo|GRAPH|PRINT}> <KEY campo_quebra> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <APPEND> <LOCAL> <STATISTICS>

Parâmetros

Nome	Descrição
ON campo_data	O nome do campo de data ou datahora ou a expressão para ordenação por período. Embora você possa estipular o vencimento em um campo datahora, apenas a parte da data referente aos valores de datahora será levada em consideração. A parte referente à hora é ignorada. Você não pode estipular o vencimento apenas em dados de hora.
CUTOFF data_limite opcional	A data com a qual os valores em campo_data serão comparados. Você precisa especificar data_limite como uma cadeia sem aspas no formato AAMMDD ou AAAAMMDD, independentemente do formato do campo de data. Por exemplo: CUTOFF 20141231 Se você omitir CUTOFF, a data atual do sistema será usada como data limite.
INTERVAL dias <;...n> opcional	Os intervalos de data (ou seja, o número de dias) a utilizar no cálculo dos períodos de vencimento. dias representa o início de cada período de vencimento contado retroativamente a partir da data_limite: o primeiro valor de dias identifica o início do primeiro período de vencimento um primeiro valor de dias igual a "0" especifica que o primeiro período de vencimento deve começar na data_limite especificada o último valor de dias identifica o fim do último período de vencimento Você deve especificar os intervalos como cadeia sem aspas com valores separados por ponto e vírgula: INTERVAL 0,90,180,270,365 Os períodos de vencimento padrão são 0; 30; 60; 90; 120 e 10.000 dias. Um intervalo de 10.000 dias é utilizado para separar os registros com datas provavelmente inválidas. Caso necessário, os intervalos de datas podem ser personalizados para refletir outros relatórios internos periodizados.
SUPPRESS opcional	Suprime as datas fora dos períodos de vencimento da saída do comando.
SUBTOTAL campo_numérico <...n> \| SUBTOTAL ALL opcional	Um ou mais campos numéricos ou expressões a serem subtotalizadas para cada grupo. Vários campos devem ser separados por espaço. Especifique ALL para subtotalizar todos os campos numéricos da tabela.
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).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.
TO SCREEN \| nome_arquivo \| GRAPH \| PRINT	A localização para onde enviar os resultados do comando: SCREEN exibe os resultados na área de exibição do Analytics nome_arquivo salva os resultados em um arquivo Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT" Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente: TO "C:\Saída.TXT" TO "Resultados\Saída.TXT" GRAPH exibe os resultados em um gráfico na área de exibição do Analytics PRINT envia os resultados para a impressora padrão
KEY campo_quebra opcional	O campo ou expressão que agrupa cálculos de subtotal. Um subtotal é calculado cada vez que o valor de campo_quebra muda. campo_quebra deve ser um campo ou expressão de caracteres. Apenas um campo pode ser especificado, mas é possível usar uma expressão que contém mais que um campo.
HEADER texto_cabeçalho opcional	O texto a ser inserido na parte superior de cada página de um relatório. texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.
FOOTER texto_rodapé opcional	O texto a ser inserido na parte inferior de cada página de um relatório. texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Nota Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos: os mesmos campos a mesma ordem de campos os campos correspondentes têm o mesmo comprimento os campos correspondentes têm o mesmo tipo de dados O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
LOCAL opcional	Salva o arquivo de saída no mesmo local que o projeto do Analytics. Nota Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics.
STATISTICS opcional	Nota Somente pode ser usado se SUBTOTAL também for especificado. Calcula valores médios, mínimos e máximos para todos os campos de SUBTOTAL.

Exemplos

Vencimentos de faturas com subtotal de valores

Você quer calcular os vencimentos de uma tabela de contas a receber com base no campo Data_Fatura e calcular o subtotal do campo Valor_Fatura.

As faturas são agrupadas em períodos de 30 dias:

da data limite até 29 dias anteriores
de 30 dias anteriores até 59 dias anteriores
e assim por diante

Os resultados incluem o valor total pendente de faturas para cada período:

OPEN Ar 
AGE ON Data_Fatura CUTOFF 20141231 INTERVAL 0;30;60;90;120;10000 SUBTOTAL Valor_Fatura TO SCREEN

Observações

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Períodos de vencimento

O comando AGE agrupa os registros em períodos de vencimento com base nos valores de um campo data ou datahora. Os resultados de saída contêm um único registro para cada período contendo a contagem dos registros da tabela de origem que pertencem ao período.

Medição de intervalo

Períodos de vencimento são baseados em intervalos de datas (isto é, números de dias) contados para trás na linha do tempo, a partir da data do sistema ou a partir da data de corte que você especificar, como uma data final do período fiscal.

Períodos futuros

É possível criar períodos de vencimento mais recentes que a data limite especificando valores negativos como intervalos de datas. Por exemplo, o comando a seguir cria períodos de vencimento antes e depois da data limite:

INTERVAL -60;-30;0;30;60;90

Essa abordagem cria um perfil de dados de todos os registros em uma tabela usando pontos no tempo diferentes.

Casos de uso comuns

Entre os usos comuns do vencimento inclui-se avaliar tendências de vendas, consultar volumes de transações e agrupar faturas pela quantidade de dias ultrapassados.

O Analytics cria automaticamente um ou dois períodos de vencimento para as datas que não pertencerem aos períodos de vencimento especificados, contanto que o SUPPRESS não esteja sendo utilizado.

[ Voltar ao início ]

Guia de scripting do ACL 14.1