Comando LIST

Envía los datos de salida de uno o más campos de una tabla de Analytics a una visualización con un formato de columnas.

Sintaxis

LIST {FIELDS nombre_campo <AS nombre_visible> <...n>|FIELDS ALL} <LINE número lista_campos> <TO {SCREEN|nombre_archivo|PRINT}> <UNFORMATTED> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <SKIP líneas> <EOF> <APPEND>

Parámetros

Nombre	Descripción
FIELDS nombre_campo <...n> \| FIELDS ALL	Los campos que se deben incluir en la salida: FIELDS nombre_del_campo usar los campos especificados FIELDS ALL usa todos los campos de tabla
AS nombre_visible opcional	Se utiliza únicamente al listar datos por medio de FIELDS nombre_campo. El nombre visible (título de columna alternativo) para el campo en la salida. Si desea que el nombre visible sea el mismo que el nombre del campo o un nombre visible existente en la tabla de origen, no use AS. Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.
LINE lista_campo numérico opcional	Se utiliza más de una línea en la salida para cada registro: número el número de línea, debe estar entre 2 y 60 inclusive lista_campo los campos que se deben incluir en esa línea
TO SCREEN \| 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_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
UNFORMATTED opcional	La salida se muestra como texto sin formato. La salida es idéntica a la que crea el comando EXPORT ASCII. Los datos sin formato se pueden enviar a un archivo para su posterior procesamiento por otros programas de software.
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.
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.
SKIP líneas opcional	Inserta la cantidad especificada de líneas en blanco entre cada registro de la lista. Por ejemplo, LIST ALL SKIP 1 genera una lista con espaciado doble (un línea en blanco entre cada registro).
EOF opcional	Ejecute el comando una vez más después de que se alcance el final del archivo. De esta manera, se asegura de que se procese el registro final de la tabla cuando se encuentra dentro de un comando GROUP. Utilice EOF solo si todos los campos son campos calculados que hacen referencia a registros anteriores.
APPEND opcional	Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo.

Nombre

Descripción

FIELDS nombre_campo <...n> | FIELDS ALL

Los campos que se deben incluir en la salida:

FIELDS nombre_del_campo usar los campos especificados
FIELDS ALL usa todos los campos de tabla

AS nombre_visible

opcional

Se utiliza únicamente al listar datos por medio de FIELDS nombre_campo.

El nombre visible (título de columna alternativo) para el campo en la salida. Si desea que el nombre visible sea el mismo que el nombre del campo o un nombre visible existente en la tabla de origen, no use AS.

Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.

LINE lista_campo numérico

opcional

Se utiliza más de una línea en la salida para cada registro:

número el número de línea, debe estar entre 2 y 60 inclusive
lista_campo los campos que se deben incluir en esa línea

TO SCREEN | 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_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

UNFORMATTED

opcional

La salida se muestra como texto sin formato. La salida es idéntica a la que crea el comando EXPORT ASCII. Los datos sin formato se pueden enviar a un archivo para su posterior procesamiento por otros programas de software.

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.

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.

SKIP líneas

opcional

Inserta la cantidad especificada de líneas en blanco entre cada registro de la lista. Por ejemplo, LIST ALL SKIP 1 genera una lista con espaciado doble (un línea en blanco entre cada registro).

EOF

opcional

Ejecute el comando una vez más después de que se alcance el final del archivo.

De esta manera, se asegura de que se procese el registro final de la tabla cuando se encuentra dentro de un comando GROUP. Utilice EOF solo si todos los campos son campos calculados que hacen referencia a registros anteriores.

APPEND

opcional

Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo.

Ejemplos

Listado de excepciones y guardado en un archivo de texto

Usted utiliza LIST para crear un reporte que incluya las excepciones identificadas en una tabla de inventario. El reporte se guarda como un archivo de texto:

LIST Número_producto Descripción Cantidad Costo_unitario Valor IF Cantidad < 0 OR Costo_unitario < 0 HEADER "Valores negativos" TO “Excepciones.txt”

Observaciones

Cuándo usar LIST

Utilice LIST para imprimir datos, mostrar datos en la pantalla, para exportarlos a un archivo de texto.

Formato y totales

A menos que especifique UNFORMATTED, la siguiente información se incluye de manera automática:

números de página
fecha
hora
identificación del usuario
encabezados de columna

Las columnas numéricas también se suman automáticamente.

[ Volver al inicio ]