Comando REPORT

Informações do conceito

Formatar e gerar relatórios do Analytics

Formata e gera um relatório baseado na tabela aberta do Analytics.

Sintaxe

REPORT <ON campo_quebra <PAGE> <NODUPS> <WIDTH caracteres> <AS nome_exibicao>> <...n> FIELD outros_campos <WIDTH caracteres><AS nome_exibiçao> <...n> <SUPPRESS> <NOZEROS> <LINE n outros_campos> <PRESORT <campo_ordenação>> <...n> <SUMMARIZED> <SKIP n> <EOF> <TO {SCREEN|PRINT|nome_arquivo <HTML>}> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <APPEND>

Parâmetros

Nome Descrição

ON campo_quebra PAGE NODUPS WIDTH caracteres AS nome_exibição <...n>

opcional

O campo ou os campos de caracteres usados para quebrar o relatório em seções.

Uma nova seção e um novo subtotal de relatório serão criados a cada vez que o valor de campo_quebra for alterado. A divisão de relatórios em seções pode facilitar sua pesquisa.

  • campo_quebra o campo a ser usado como um campo de quebra

    Para executar um relatório baseado em uma exibição (DO REPORT), o campo de quebra deve ser o campo de caracteres mais à esquerda na exibição.

  • PAGE insere uma quebra de página cada vez que o valor de do campo de quebra é alterado
  • NODUPS suprime a exibição de valores duplicados do campo de quebra

    Por exemplo, se o nome do cliente estiver listado para cada registro de fatura, você poderá tornar o relatório mais legível listando apenas a primeira ocorrência de cada nome de cliente.

  • WIDTH caracteres o comprimento da saída em caracteres
  • AS nome_exibiçao o nome de exibição (título alternativo da coluna) do campo no relatório

    Especifique nome_exibiçao como uma cadeia entre aspas. Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna. Se você quiser que o nome de exibição seja o mesmo que o nome do campo ou um nome de exibição já existente na tabela de origem, não use AS.

Nota

Você deve especificar ON para usar campo_quebra, PAGE, NODUPS ou PRESORT.
FIELD Outros_campos WIDTH caracteres AS nome_exibiçao <...n>

Os campos a serem incluídos no relatório.

  • WIDTH caracteres o comprimento da saída em caracteres
  • AS nome_exibiçao o nome de exibição (título alternativo da coluna) do campo no relatório

    Especifique nome_exibiçao como uma cadeia entre aspas. Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna. Se você quiser que o nome de exibição seja o mesmo que o nome do campo ou um nome de exibição já existente na tabela de origem, não use AS.

As palavras-chave SUBTOTAL e ACCUMULATE são sinônimos de FIELD e foram descontinuadas. Todos os campos numéricos são subtotalizados automaticamente.

Nota

Os campos de quebra são incluídos automaticamente no relatório e não precisam ser especificados como outros_campos.

SUPPRESS

opcional

Exclui linhas de detalhe em branco do relatório.

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 outros_campos

opcional

Especifica o número de linhas de saída na coluna e os campos a serem exibidos na linha de número n.

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, inclusive.

Os títulos de colunas no relatório são determinados exclusivamente pelos campos na primeira linha. outros_campos especifica os campos ou expressões apropriadas para o relatório.

PRESORT campo_ordenação <...n>

opcional
  • Ordena campo_quebra, se um ou mais campos de quebra são especificados.
  • Ordena campo_ordenação, se um ou mais campos de ordenação são especificados.

PRESORT não ordena os campos listados como outros_campos, a menos que também estejam listados como campo_ordenação.

SUMMARIZED

opcional

Produz um relatório somente com subtotais e totais, e nenhuma linha de detalhe.

Os subtotais são gerados para valores únicos do campo de quebra. Se SUMMARIZED não for especificado, o Analytics gerará um relatório que inclui linhas de detalhe e subtotais para cada campo-chave de quebra especificado.
SKIP n

opcional

Insere linhas em branco entre as linhas de detalhe no relatório.

n deve ser um número inteiro especificando o número de linhas a serem inseridas. Por exemplo, SKIP 1 produz um relatório com espaço duplo.

EOF

opcional

Execute o comando uma ou mais vezes após alcançar o fim do arquivo.

Isso garante que o registro final na tabela seja processado dentro de um comando GROUP. Use EOF somente se todos os campos forem campos calculados referentes a registros anteriores.

TO SCREEN | PRINT| nome_arquivo <HTML>

opcional

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

  • A TELA 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_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"
  • PRINT envia os resultados para a impressora padrão

Por padrão, a saída dos relatórios em arquivo é salva como arquivos de texto ASCII. Especifique HTML se quiser gerar o relatório como um arquivo HTML (.htm).

Se você omitir TO, o relatório será gerado na tela.

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.

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.

Exemplos

Geração de um relatório HTML

Gere um relatório da tabela Ar e envie a saída para um arquivo formatado em HTML:

OPEN Ar
REPORT ON Num FIELD Vencimento Tipo Valor TO "C:\Relatórios\AR.htm" HTML