Agrupa os registros com base em valores idênticos de um campo de caracteres ou numérico. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

CLASSIFY <ON> campo_chave <SUBTOTAL campo_numérico <...n>|SUBTOTAL ALL> <INTERVALS número> <SUPPRESS> <TO {SCREEN|nome_tabela|GRAPH|PRINT}>  <LOCAL> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <KEY campo_quebra> <OPEN> <APPEND> <STATISTICS>
Nome Descrição
ON campo_chave

O campo de caracteres ou numérico a classificar.

O comprimento máximo do campo-chave é 2048 caracteres.

Se você quiser classificar uma tabela usando um campo-chave maior que 2048 caracteres, use o comando SUMMARIZE. Esse comando não restringe o comprimento do campo-chave.
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.
INTERVALS número

opcional

O número máximo de grupos nos resultados de saída.

Se o número de conjuntos de valores idênticos no campo sendo classificado exceder o máximo especificado, serão usados conjuntos a partir do início da coluna.

Os valores maiores que o máximo serão agrupados em um grupo chamado "OTHER".

Se INTERVALS for omitido, será criado um grupo para conjunto de valores idênticos no campo classificado.

Nota

Esse parâmetro não está disponível na interface do usuário do Analytics e somente pode ser usado como parte da sintaxe do ACLScript em um script ou na linha de comando.
SUPPRESS

opcional

Nota

Somente pode ser usado se INTERVALS também for especificado. SUPPRESS não está disponível na interface do usuário do Analytics e somente pode ser usado como parte da sintaxe do ACLScript em um script ou na linha de comando.

Exclui conjuntos de valores idênticos maiores que o máximo especificado pelo parâmetro INTERVALS da saída do comando.
TO SCREEN | nome_tabela | GRAPH | PRINT

A localização para onde enviar os resultados do comando:

  • SCREEN exibe os resultados na área de exibição do Analytics

    Dica

    Você pode clicar em qualquer valor de resultado vinculado na área de exibição para detalhar até o registro ou os registros associados na tabela de origem.

  • nome_tabela salva os resultados em uma tabela do Analytics

    Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL"

    Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:

    • TO "C:\Saída.FIL"
    • TO "Resultados\Saída.FIL"

    Nota

    Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. 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.

  • GRAPH exibe os resultados em um gráfico na área de exibição do Analytics
  • PRINT envia os resultados para a impressora padrão
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.

O parâmetro LOCAL deve seguir imediatamente o parâmetro TO.
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.
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.
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.
OPEN

opcional

Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.
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.
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.

Valor total de transações por cliente

Você quer classificar uma tabela de contas a receber com base no campo Numero_Cliente e calcular o subtotal do campo Valor_Trans. Os resultados da saída são agrupados por cliente e incluem o valor total de transações para cada cliente:

OPEN Ar 
CLASSIFY ON Numero_Cliente SUBTOTAL Valor_Trans TO "Total_cliente.FIL"

Valores total, médio, mínimo e máximo de transações por cliente

Assim como no exemplo anterior, você classifica uma tabela de contas a receber com base no campo Numero_Cliente e calcula o subtotal do campo Valor_Trans.

Agora, você inclui STATISTICS para calcular os valores de transação médio, mínimo e máximo para cada cliente:

OPEN Ar 
CLASSIFY ON Numero_Cliente SUBTOTAL Valor_Trans TO "Estatisticas_cliente.FIL" STATISTICS

Valores de fatura idênticos

Você precisa identificar valores de fatura que aparecem mais de uma vez na tabela Trans_Cp.

Para isso, você classifica a tabela com base no campo Valor_Fatura. Os resultados de saída são agrupados por valor da fatura, com uma contagem que pode ser usada para identificar todos os valores de fatura que ocorrem mais de uma vez:

OPEN Trans_Cp
CLASSIFY ON Valor_Fatura TO "Valores_fatura_agrupados.FIL" OPEN
SET FILTER TO COUNT > 1

Nota

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

Como funciona?

O CLASSIFY agrupa registros que têm o mesmo valor em um campo de caracteres ou numérico.

A saída consiste em um único registro para cada grupo, com uma contagem do número de registros na tabela de origem que pertencem ao grupo.

Ordenar e CLASSIFY

CLASSIFY pode processar dados ordenados ou não ordenados. A saída é ordenada automaticamente em ordem crescente.

Nomes de campos de subtotal e estatísticas gerados automaticamente

Se você usar STATISTICS para executar cálculos estatísticos com um ou mais campos SUBTOTAL e gerar os resultados em uma tabela do Analytics, os campos gerados automaticamente pelos parâmetros terão os seguintes nomes:

Descrição de campo gerado automaticamente

Nome do campo na tabela de saída

Título alternativo de coluna (nome de exibição) na tabela de saída

Campo de subtotal

nome do campo subtotalizado na tabela de origem

Total + título alternativo da coluna subtotalizada na tabela de origem

Campo de média

a_nome do campo subtotalizado na tabela de origem

Média + título alternativo da coluna subtotalizada na tabela de origem

Campo de mínimo

m_nome do campo subtotalizado na tabela de origem

Mínimo + título alternativo da coluna subtotalizada na tabela de origem

Campo de máximo

x_nome do campo subtotalizado na tabela de origem

Máximo + título alternativo da coluna subtotalizada na tabela de origem