Comando LIST

Exibe os dados de um ou mais campos de uma tabela do Analytics formatados em colunas.

Sintaxe

LIST {FIELDS nome_campo <AS nome_exibicao> <...n>|FIELDS ALL} <LINE número lista_de_campos> <TO {SCREEN|nome_arquivo|PRINT}> <UNFORMATTED> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <SKIP linhas> <EOF> <APPEND>

Parâmetros

Nome Descrição
FIELDS nome_campo <...n> | FIELDS ALL

Os campos a serem incluídos na saída.

  • FIELDS nome_campo inclua o campo ou os campos especificados

    Os campos são incluídos na ordem em que são listados.

  • FIELDS ALL inclua todos os campos da tabela

    Os campos são incluídos na ordem em que aparecem no layout da tabela.

AS nome_exibicao

opcional

Usado apenas na listagem usando FIELDS nome_campo.

O nome de exibição (título alternativo da coluna) para o campo na saída. 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.

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.
LINE número lista_de_campos

opcional

Mais de uma linha é usada na saída para cada registo:

  • número o número da linha, deve estar entre 2 e 60 inclusive
  • lista_de_campos os campos serão incluídos nessa linha

TO SCREEN | nome_arquivo | PRINT

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

UNFORMATTED

opcional

A saída é exibida como texto não formatado. A saída é idêntica àquela criada pelo comando EXPORT ASCII. A saída de dados não formatados pode ser feita em formato de um arquivo, que posteriormente pode ser processado por outros programas.

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.

SKIP linhas

opcional

 Insere o número especificado de linhas em branco entre cada registo da lista. Por exemplo, LIST ALL SKIP 1 produz uma lista com duplo espaço (uma linha em branco entre cada registro).

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.

APPEND

opcional

Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo.

Exemplos

Listagem de exceções e como salvá-las em um arquivo de texto

Use LIST para criar um relatório listando exceções identificadas em uma tabela de estoque. O relatório é salvo como um arquivo de texto:

LIST Número_de_produto Descrição Quantidade Custo_unitário Valor IF Quantidade < 0 OR Custo_unitário < 0 HEADER "Valores negativos" TO "Exceções.txt"

Observações

Quando usar LIST

Use o comando LIST para imprimir dados, exibir dados na tela ou exportá-los para um arquivo de texto.

Formatação e totais

A menos que você especifique UNFORMATTED, as seguintes informações são incluídas automaticamente:

  • números de página
  • data
  • hora
  • identificação do usuário
  • cabeçalhos de colunas

As colunas numéricas também são totalizadas automaticamente.