Comando GAPS

Detecta si un campo numérico o de fechahora de una tabla de Analytics contiene uno o más faltantes en la secuencia de datos.

Sintaxis

GAPS <ON> campo_clave <D> <UNFORMATTED> <PRESORT> <MISSING límite> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <TO {SCREEN|nombre_tabla|nombre_archivo|PRINT}> <APPEND> <LOCAL> <OPEN>

Parámetros

Nombre	Descripción
ON campo_clave D	Los campos o expresiones en los que se buscarán faltantes. Incluya D para ordenar el campo clave en orden descendente. El criterio de ordenamiento predeterminado es ascendente.
UNFORMATTED opcional	Suprime los encabezados de página y los saltos de página cuando los resultados se envían a un archivo.
PRESORT opcional	Ordena la tabla por el campo primario antes de ejecutar el comando. Nota No puede utilizar PRESORT dentro del comando GROUP.
MISSING límite opcional	Los resultados de la salida contienen elementos faltantes individuales en lugar de intervalos de faltantes. El valor de límite especifica la máxima cantidad de elementos faltantes que se reportará para cada faltante identificado. El valor predeterminado es 5. Si se excede el límite para un faltante determinado, los elementos faltantes se reportan como un intervalo de ese faltante específico. El valor de límite no restringe la cantidad total de elementos faltantes reportados, sólo restringe el número de elementos faltantes reportados dentro de un faltante específico.
HEADER texto_encabezado opcional	El texto que se debe insertar en la parte superior de cada página de un reporte. texto_encabezado_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema HEADER de Analytics.
FOOTER texto_pie_de_página opcional	El texto que se debe insertar en la parte inferior de cada página de un reporte. texto_pie_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema FOOTER de Analytics.
IF prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición. Nota El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).
WHILE prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla. Nota Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.
FIRST rango \| NEXT rango opcional	La cantidad de registros que se procesarán: FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado Utilice intervalo para especificar la cantidad de registros que se deben procesar. Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.
TO SCREEN \| nombre_tabla \| nombre_archivo \| PRINT opcional	El lugar al que se deben enviar los resultados del comando: SCREEN muestra los resultados en el área de visualización de Analytics nombre_tabla guarda los resultados en una tabla de Analytics Especifique el nombre_tabla como una cadena entre comillas con la extensión de archivo .FIL. Por ejemplo: TO "Salida.FIL" Por valor predeterminado, el archivo de datos de la tabla (.FIL) se guarda en la carpeta que contiene el proyecto de Analytics. Utilice una ruta de archivo absoluta o relativa para guardar el archivo de datos en una carpeta existente o una diferente: TO "C:\Salida.FIL" TO "Resultados\Salida.FIL" Nota Los nombres de las tablas tienen un límite de 64 caracteres alfanuméricos, sin incluir la extensión .FIL. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número. nombre_de_archivo guarda los resultados en un archivo Especifique el nombre_de_archivo como una cadena entre comillas con la extensión de archivo adecuada. Por ejemplo: TO "Salida.TXT" Por valor predeterminado, el archivo se guarda en la carpeta que contiene el proyecto de Analytics. Utilice una ruta de archivo absoluta o relativa para guardar el archivo en una carpeta existente o una diferente: TO "C:\Salida.TXT" TO "Resultados\Salida.TXT" PRINT envía los resultados a la impresora predeterminada
APPEND opcional	Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo. Nota Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas: los mismos campos el mismo orden de campos los campos coincidentes son de la misma longitud los campos coincidentes tienen el mismo tipo de datos Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos.
LOCAL opcional	Guarda el archivo de salida en la misma ubicación que el proyecto de Analytics. Nota Aplicable únicamente al ejecutar el comando en una tabla de servidor con un archivo de salida que es una tabla de Analytics.
OPEN opcional	Abre la tabla creada por el comando después de la ejecución del comando. Solo es válido si el comando crea una tabla de salida.

Variables de salida de Analytics

Nombre	Contiene
GAPDUPn	La cantidad total de grupos de duplicados inexactos, faltantes o duplicados identificados por el comando.

Ejemplos

Prueba para detectar números de factura faltantes

Usted utiliza GAPS para garantizar que no falte ningún número de factura en una tabla Facturas:

OPEN Facturas
GAPS ON Núm_Factura PRESORT TO "Facturas_Faltantes.fil"

Observaciones

Uso de GAPS en campos de caracteres

Además de probar campos numéricos o de fechahora, también puede probar si hay faltantes en datos numéricos que aparecen en un campo de carácter. Por ejemplo, puede verificar los números de cheque, que suelen tener el formato de datos de carácter.

Si hay letras y números juntos en un campo de carácter, únicamente se prueban los números y se ignoran las letras.

[ Volver al inicio ]

Guía de creación de scripts de ACL 14.1