Comando GAPS

Informações do conceito

Detecta se um campo numérico ou datahora em uma tabela do Analytics contém uma ou mais falhas em dados sequenciais.

Sintaxe

GAPS <ON> campo_chave <D> <UNFORMATTED> <PRESORT> <MISSING limite> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <TO {SCREEN|nome_tabela|nome_arquivo|PRINT}> <LOCAL> <APPEND> <OPEN>

Parâmetros

Nome	Descrição
ON campo_chave D	O campo ou expressão que deve passar por verificação de falhas. Inclua D para ordenar o campo-chave em ordem decrescente. O critério de ordenaçã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.
PRESORT opcional	Ordena a tabela pelo campo-chave antes de executar o comando. Observação Você não pode usar PRESORT dentro do comando GROUP.
MISSING limite opcional	Os resultados de saída contêm itens ausentes individuais em vez de intervalos de falha. O valor limite especifica o número máximo de itens ausentes a ser relatado para cada intervalo identificado. O valor padrão é 5. Se o limite for excedido em uma falha específica, os itens ausentes são relatados como um intervalo dessa falha específica. O valor limite não restringe o número total de itens ausentes relatados; apenas o número de itens ausentes relatados dentro de uma falha específica.
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.
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. Observação 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. Observação 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: PRIMEIROiniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado AVANÇARiniciar 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_tabela \| nome_arquivo \| PRINT opcional	A localização para onde enviar os resultados do comando: SCREENexibe 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 o registro ou registros associados na tabela de origem. nome_tabelasalva os resultados em uma tabela do Analytics Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. Por exemplo: TO "Output.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:\Output.FIL" TO "Results\Output.FIL" Observação 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. nome_arquivosalva os resultados em um arquivo Especifique nome_arquivo como uma cadeia entre aspas com a extensão de arquivo apropriada. Por exemplo: TO "Output.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:\Output.TXT" TO "Results\Output.TXT" PRINTenvia os resultados para a impressora padrão.
LOCAL opcional	Salva o arquivo de saída no mesmo local que o projeto do Analytics. Observação 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.
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Observação 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.
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.

Variáveis de saída do Analytics

Nome	Contém
GAPDUPn	O número total de grupos de falhas, duplicidades ou duplicidades parciais identificados pelo comando.

Exemplos

Teste de números de fatura ausentes

Use GAPS para garantir que não há números de faturas ausentes na tabela Faturas:

OPEN Faturas
GAPS ON Num_Fat PRESORT TO "Falhas_Faturas.fil"

Observações

Para obter mais informações sobre como este comando funciona, consulte Verificar falhas.

Uso de GAPS em campos de caracteres

Além de testar campos numéricos ou datahora, você também pode testar a existência de falhas em dados numéricos em um campo de caracteres. Por exemplo, você pode testar números de cheques, que normalmente são formatados como dados de caracteres.

Se letras e números aparecerem juntos em um campo de caracteres, apenas os números serão testados e as letras serão ignoradas.