Comando SEQUENCE

Concept Information

Testar a ordem sequencial

Determina se um ou mais campos em uma tabela do Analytics estão em ordem sequencial e identifica itens fora de sequência.

Sintaxe

SEQUENCE <ON> {<FIELDS> campo_chave <D> <...n>|<FIELDS> ALL <EXCLUDE nome_campo <...n>>} <UNFORMATTED> <ERRORLIMIT n> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <TO {SCREEN|nome_arquivo|PRINT}> <APPEND> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <PRESORT> <ISOLOCALE código_localidade>

Parâmetros

Nome Descrição
ON FIELDS campo_chave D <...n> | FIELDS ALL

Um ou mais campos de caracteres, numéricos ou datahora para teste de ordem sequencial.

  • FIELDS campo_chave teste o campo ou os campos especificados

    Se houver mais de um campo, eles devem ser separados por espaços e podem ser de tipos de dados diferentes.

    Se você testar mais de um campo, os campos serão testados na ordem em que são listados.

    Inclua D para testar valores de campo-chave em ordem decrescente. A ordenação de teste padrão é crescente.

  • FIELDS ALL teste todos os campos da tabela

    Se você testar por todos os campos, os campos serão testados na ordem em que aparecem no layout da tabela.

    Testar valores de campo-chave em ordem crescente é a única opção para FIELDS ALL.

Nota

Quando você testa mais de um campo, está testando a ordem sequencial aninhada na tabela de origem. O uso válido de SEQUENCE exige que você especifique campos de teste na mesma ordem que a ordem sequencial aninhada existente na tabela de origem. Vários campos de teste são testados como um grupo aninhado. Eles não são testados de forma independente entre si.
EXCLUDE nome_campo

opcional

Válido apenas ao testar a ordem sequencial usando FIELDS ALL.

O campo ou os campos a serem excluídos do comando. EXCLUDE permite ajustar a palavra-chave ALL, excluindo os campos especificados.

EXCLUDE deve seguir FIELDS ALL imediatamente ou a última ocorrência da palavra-chave ALL se você estiver incluindo campos de uma ou mais tabelas relacionadas. Por exemplo:

FIELDS ALL EXCLUDE campo_1 campo_2
FIELDS ALL nome_tabela_relacionada.ALL EXCLUDE campo_1 campo_2

UNFORMATTED

opcional

Suprime os cabeçalhos e as quebras de página quando os resultados são enviados a um arquivo.

ERRORLIMIT n

opcional

O número de erros permitidos antes de terminar o comando. O valor padrão é 10.

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 | 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

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.

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.

PRESORT

opcional

Ordena a tabela pelo campo-chave antes de executar o comando.

Nota

Você não pode usar PRESORT dentro do comando GROUP.
ISOLOCALE código_local

opcional

Nota

Aplicável apenas à edição Unicode do Analytics.

A localidade do sistema no formato idioma_país. Por exemplo, para usar francês canadense, insira fr_ca.

Use os códigos a seguir:

  • idioma código de idioma padrão ISO 639
  • país código de país padrão ISO 3166

    Se você não especificar um código de país, será usado o país padrão do idioma.

Se você não usar ISOLOCALE, a localidade do sistema padrão será usada.

Variáveis de saída do Analytics

Nome Contém
WRITEn

O número total de erros de sequência identificados pelo comando.

Exemplos

Testar a existência de IDs de funcionários fora de sequência

Grave todos os erros de sequência identificados nos campos IDFuncionário em um arquivo de texto:

SEQUENCE ON IDFuncionário ERRORLIMIT 10 TO "ErrosSequência.txt"

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Testar a ordem sequencial.

Uso de SEQUENCE dentro de um GROUP

Se o comando SEQUENCE for usado dentro de um comando GROUP, o comando será executado para evitar interferência no processamento do grupo, mas nenhum erro de sequência de dados será relatado.