Comando SEQUENCE

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 <D> <...n>|<FIELDS> ALL} <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> <LOCAL> <ISOLOCALE código_local>

Parâmetros

Nome	Descrição
ON FIELDS campo D <...n> \| FIELDS ALL	Os campos ou expressões que devem ser verificados quanto a ordem sequencial. Especifique ALL para verificar todos os campos da tabela do Analytics. Inclua D para ordenar o campo-chave em ordem decrescente. A ordem de classificação-padrão é crescente.
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: 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" 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.
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.
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.

Nome

Descrição

ON FIELDS campo D <...n> | FIELDS ALL

Os campos ou expressões que devem ser verificados quanto a ordem sequencial. Especifique ALL para verificar todos os campos da tabela do Analytics.

Inclua D para ordenar o campo-chave em ordem decrescente. A ordem de classificação-padrão é crescente.

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:

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

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.

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

Teste para IDs e datas de contração de funcionários fora de sequência

Grave todos os erros de sequência identificados nos campos IDFuncionário e DataContratação em um arquivo de texto:

SEQUENCE ON IDFuncionário DataContratação ERRORLIMIT 10 TO "ErrosSequência.txt"

Observações

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.

[ Voltar ao início ]

Guia de scripting do ACL 14.1