Agregar encabezados de estudios analíticos

Un encabezado de estudio analítico es una serie de etiquetas declaratorias encerradas en un comentario al inicio de un script. El encabezado incluye los parámetros de entrada que un usuario completa de antemano, lo que permite que el estudio analítico se ejecute sin supervisión, ya sea de forma inmediata o programada.

Después de desarrollar scripts en un proyecto de Analytics, debe agregar un encabezado de estudio analítico antes de poder confirmar y enviar scripts a Robots o de utilizar el proyecto como una aplicación de análisis en el Servidor de AX o en la ventana Aplicación de análisis.

Requisitos del encabezado de estudio analítico

El encabezado de estudio analítico debe cumplir determinados requisitos. Si no los cumple, el script de estudio analítico no se puede ejecutar correctamente.

Si desea obtener información detallada acerca de la sintaxis del encabezado de estudio analítico y una lista completa de etiquetas de estudios analíticos, consulte Etiquetas y encabezados de estudios analíticos.

Encierre los encabezados de estudio analítico en un bloque de comentario

Los encabezados de los estudios analíticos deben estar completamente definidos en un bloque de comentario que comienza en la primera línea del script.

COMMENT
Las etiquetas de estudio analítico se colocan aquí.
END

Declare las datos de entrada y las salidas

En el encabezado del estudio analítico, usted debe declarar los datos de entrada necesarios para el estudio analítico y las salidas que se copian a Robots o a AX Servidor, o que se escriben como resultados en la ventana Aplicación de análisis:

Entradas Salidas
  • tablas
  • campos
  • parámetros
  • archivos de entrada
  • solicitudes de contraseña
  • archivos de datos
  • tablas de resultados
  • archivos de log

Declare los valores de entrada

Los encabezados de estudios analíticos también deben declarar los valores de entrada que los usuarios especificarán cuando ejecuten o programen el estudio analítico.

Utilice la etiqueta PARAM para agregar parámetros de entrada que acepten los valores de entrada especificados por el usuario y los almacenen en variables. Por ejemplo, si desea que un estudio analítico seleccione datos sobre la base de un intervalo de fechas, debe agregar los parámetros Fecha de inicio y Fecha de finalización que le permitan al usuario especificar esas fechas.

Validar encabezados de estudios analíticos

Después de agregar un encabezado de estudio analítico a uno o más scripts, utilice las herramientas de Analytics para validar la sintaxis del encabezado a fin de asegurarse de que sea correcta. Realice la validación antes de confirmar y enviar los scripts a Robots o de empaquetar las aplicaciones de análisis, de manera que los estudios analíticos no fallen durante la ejecución.

Una herramienta valida los encabezados de estudio analítico individuales a nivel del script. La otra herramienta valida todos los encabezados de estudio analítico del proyecto de manera simultánea. Los dos tipos de validaciones se centran en diferentes aspectos.

Validar un encabezado de estudio analítico individual

La validación de un encabezado de estudio analítico a nivel del script se centra en la sintaxis de las etiquetas de estudio analítico individuales e informa de los errores con los números de línea correspondientes.

  1. Abra el script que contiene el encabezado del estudio analítico.
  2. En la barra de herramientas del Editor de scripts, haga clic en Validar el encabezado del estudio analítico  .

    Aparece un mensaje que indica que el encabezado del estudio analítico es válido o que especifica un error y el número de línea donde ocurre el error.

  3. Si el encabezado de estudio analítico contiene un error, corríjalo y haga clic en Validar el encabezado del estudio analítico nuevamente para asegurarse de que no existan más errores.

    Consejo

    Si la naturaleza del error no resulta obvia por el mensaje de error, revise el tema de Ayuda de la etiqueta de estudio analítico asociada. Compare cuidadosamente la sintaxis del tema con la sintaxis de la línea del encabezado del estudio analítico. Los errores se pueden deber a discrepancias mínimas en la sintaxis del encabezado del estudio analítico.

Validar todos los encabezados de estudio analítico de un proyecto

La validación de los encabezados de estudio analítico a nivel del proyecto comprueba dos cosas:

  • existe al menos un encabezado de estudio analítico en el proyecto
  • los nombres de los diferentes estudios analíticos son exclusivos

    Nota

    Esto se refiere al nombre especificado en la etiqueta ANALYTIC, no al nombre del script que figura en la ficha Panorama del Navegador.

La validación a nivel del proyecto se realiza de forma automática al comprobar y enviar scripts a Robots. También puede realizar la validación manualmente si agrega el botón Comprobar scripts a la barra de herramientas de Analytics.

  1. Si es necesario, agregue el botón Comprobar scripts a la barra de herramientas de Analytics:
    1. Haga doble clic en un lugar vacío de la barra de herramientas para abrir el cuadro de diálogo Personalizar la barra de herramientas.
    2. En la lista Botones disponibles de la barra de herramientas, seleccione el botón Comprobar scripts y haga clic en Agregar.
    3. En la lista Botones de la barra de herramientas actual, seleccione el botón Comprobar scripts y haga clic en Mover hacia arriba o en Mover hacia abajo para cambiar la ubicación del botón.

      El orden de los botones de arriba hacia abajo corresponde a su ubicación de izquierda a derecha en la barra de herramientas.

    4. Haga clic en Cerrar para guardar sus cambios.

  2. En la barra de herramientas, haga clic en Comprobar scripts .

    Aparece un mensaje que indica que los encabezados de estudio analítico del proyecto son válidos o que especifica uno o más errores.

  3. Si los encabezados de estudio analítico contienen un error, corríjalo y haga clic en Comprobar scripts nuevamente para asegurarse de que no haya más errores.

Ejemplo de encabezado del estudio analítico

COMMENT
//ANALYTIC Identificar cheques faltantes
  Este estudio analítico identifica los números de cheque faltantes
//TABLE v_tabla_pagos Tabla de pagos
  Seleccione una tabla que enumere los pagos e incluya una columna de números de cheque
//FIELD v_núm_cheque CN Número de cheque
  Seleccione el campo que contiene los números de cheque
//PARAM v_fecha_de_inicio D OPTIONAL Fecha de inicio (opcional)
  Introduzca la fecha de inicio para el análisis
//PARAM v_fecha_de_finalización D OPTIONAL Fecha de finalización (opcional)
  Introduzca la fecha de finalización para el análisis
//PARAM v_región C MULTI SEPARATOR , QUALIFIER ' Región(es)
  Introduzca un o más regiones para incluir en el análisis
//RESULT LOG
//RESULT TABLE ChequesFaltantes
//RESULT FILE ChequesFaltantes.xls
END

[ Volver al inicio ]

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