Comando REPORT

Información de concepto

Dar formato y generar reportes Analytics

Genera un reporte y le da un formato sobre la base de la tabla de Analytics abierta.

Sintaxis

REPORT <ON campo_corte <PAGE> <NODUPS> <WIDTH caracteres> <AS nombre_visible>> <...n> FIELD otros_campos <WIDTH caracteres> <AS nombre_visible> <...n> <SUPPRESS> <NOZEROS> <LINE n otro_campos> <PRESORT <campo_ordenamiento>> <...n> <SUMMARIZED> <SKIP n> <EOF> <TO {SCREEN|PRINT|nombre_archivo  <HTML>}> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <APPEND>

Parámetros

Nombre Descripción

ON campo_corte PAGE NODUPS WIDTH caracteres AS nombre_visible <...n>

opcional

El o los campos de caracteres que se utilizan para dividir el reporte en secciones.

Se crea un subtotal y una nueva sección del reporte cada vez que cambia el valor de campo_corte. Dividir los reportes en secciones puede facilitar su revisión.

  • campo_corte el campo que se utiliza como un campo de corte

    Para ejecutar un reporte sobre la base de una vista (DO REPORT), el campo de corte debe ser el campo de caracteres ubicado más a la izquierda en la vista.

  • PAGE inserta un salto de página cada vez que cambia el valor del campo de corte
  • NODUPS suprime los valores visibles duplicados del campo de corte

    Por ejemplo, si el nombre del cliente figura en cada registro de factura, puede facilitar la lectura del reporte incluyendo únicamente la primera instancia de cada nombre de cliente.

  • WIDTH caracteres la longitud de la salida del campo en caracteres
  • AS nombre_visible el nombre visible (título de columna alternativo) del campo en el reporte

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

Nota

Debe especificar ON para usar campo_corte, PAGE, NODUPS o PRESORT.
FIELD otros_campos WIDTH caracteres AS nombre_visible <...n>

Los campos que se deben incluir en el reporte.

  • WIDTH caracteres la longitud de la salida del campo en caracteres
  • AS nombre_visible el nombre visible (título de columna alternativo) del campo en el reporte

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

Las palabras clave SUBTOTAL y ACCUMULATE son sinónimos de FIELD y se desaconsejan. Se calcula el subtotal para todos los campos numéricos automáticamente.

Nota

Los campos de corte se incluyen automáticamente en el reporte y no es necesario especificarlos como otros_campos.

SUPPRESS

opcional

Excluye las líneas de detalles en blanco del reporte.

NOZEROS

opcional

Reemplaza los valores de cero por valores en blanco en el campo.

Por ejemplo, si un reporte incluye una gran cantidad de valores cero en un campo, es más fácil leer el reporte si solo se muestran los valores que no son ceros.
LINE n otros_campos

opcional

Especifica la cantidad de líneas de la salida en la columna y los campos que deben aparecer en el número de línea n.

Si no se especifica ningún valor, la columna tiene, por defecto, una sola línea. El valor de n debe estar entre 2 y 60 inclusive.

Los encabezados de las columnas del reporte son determinados únicamente por los campos de la primera línea. otros_campos especifica los campos o expresiones adecuados para el reporte.

PRESORT campo_ordenamiento <...n>

opcional
  • Ordena el campo_corte, si se especifican uno o más campos de corte.
  • Ordena campo_ordenamiento, si se especifican uno o más campos de ordenamiento.

PRESORT no ordena los campos indicados como otros_campos, a menos que también se incluyan como campo_ordenamiento.

SUMMARIZED

opcional

Genera un reporte que contiene solamente subtotales y totales sin líneas de detalles.

Se generan subtotales para los valores de campos de corte únicos. Si no se especifica SUMMARIZED, Analytics genera un reporte que incluye las líneas de detalles, así como los subtotales para cada uno de los campos de corte clave especificados.
SKIP n

opcional

Inserta líneas en blanco entre las líneas de detalle del reporte.

n debe ser un entero que especifica la cantidad de líneas que se deben insertar. Por ejemplo, SKIP 1 produce un reporte con espaciado doble.

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.

TO SCREEN | PRINT| nombre_archivo <HTML>

opcional

El lugar al que se deben enviar los resultados del comando:

  • PANTALLA muestra los resultados en el área de visualización de Analytics

    Consejo

    Puede hacer clic en cualquier valor de resultado enlazado en el área de visualización para ver con mayor detalle el o los registros asociados de la tabla de origen.

  • 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 otra carpeta existente:

    • TO "C:\Salida.TXT"
    • TO "Resultados\Salida.TXT"
  • PRINT envía los resultados a la impresora predeterminada

Por valor predeterminado, los reportes que se envían a un archivo se guardan como archivos de texto ASCII. Especifique HTML si desea que la salida del reporte sea un archivo HTML (.htm).

Si omite TO, el reporte se envía a la pantalla.

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.

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.

Ejemplos

Generación de un reporte HTML

Usted genera un reporte a partir de la tabla Ar y el reporte se envía a un archivo con formato HTML:

OPEN Cuentas_por_cobrar
REPORT ON Núm FIELDS Importe Tipo Vencimiento TO "C:\Reportes\AR.htm" HTML