Un encabezado de estudio analítico es una serie de etiquetas encerradas en un bloque de comentario al principio de un script de Analytics. Las etiquetas de estudio analítico especifican los parámetros de entrada que el usuario completa antes de programar o ejecutar un script de estudio analítico, así como los parámetros de la salida.

El encabezado de estudio analítico es obligatorio para todos los scripts de estudio analítico que desee ejecutar en Robots, en el Servidor de AX o en la ventana Aplicación de análisis.

La manera más sencilla de agregar o modificar un encabezado de estudio analítico consiste en usar el Diseñador de encabezado de estudio analítico. El Diseñador ofrece comprobación automática de errores y orientación integrada para asegurar que el encabezado que usted crea sea válido y funcione correctamente. Si desea obtener más información, consulte Trabajo con encabezados de estudios analíticos.

También puede crear un encabezado de estudio analítico introduciendo manualmente las etiquetas de estudio analítico necesarias. O puede usar una combinación de introducción manual y el Diseñador.

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. Las etiquetas pueden estar en cualquier orden en el encabezado de estudio analítico, excepto por las siguientes:

  • la etiqueta ANALYTIC, que debe ser la primera
  • las etiquetas FIELD, que deben seguir inmediatamente a la etiqueta TABLE con la cual están asociadas

Ejemplo

Este encabezado de estudio analítico identifica una tabla y un campo para utilizar en el script, así como el parámetro de fecha de inicio:

COMMENT 
//ANALYTIC Identificar cheques faltantes 
  Este script de 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
END

Cada etiqueta del encabezado utiliza el siguiente formato:

//tag_name attributes
  texto_descriptivo_opcional

El indicador de etiqueta // debe ser el primer carácter que no sea un espacio en blanco en la línea del script. El nombre de la etiqueta debe ir inmediatamente después del indicador de etiqueta, sin ningún espacio ni carácter entre ellos.

El texto descriptivo opcional se debe introducir en la siguiente línea después de la etiqueta. El texto puede ser de varias líneas, pero no se pueden saltear líneas. Los saltos de línea no se conservan al mostrar el texto descriptivo en las aplicaciones cliente.

Componente Convención
Nombres de las etiquetas

Los nombres de las etiquetas no distinguen entre mayúsculas y minúsculas.

A diferencia de los nombres de comandos y funciones de Analytics, los nombres de las etiquetas no se pueden abreviar.
Atributos de las etiquetas Al especificar valores de atributos para una etiqueta, debe incluir espacios y, si lo desea, encerrar el valor entre comillas.
Descripciones de las etiquetas Las descripciones son opcionales Si se especifica una descripción ésta puede tener varias líneas, pero los cortes de líneas no se respetan en las aplicaciones cliente.

Puede utilizar un operador de asignación especial ( := ) para especificar valores de prueba para una etiqueta de estudio analítico que requiere una definición:

  • FILE
  • TABLE
  • FIELD
  • PARAM

Utilice esta sintaxis para probar los scripts de estudios analíticos en Analytics:

//TABLE v_TablaAnálisis "Tabla que se debe clasificar" := "Trans_Mayo"

Cuando el script se ejecuta en Analytics, el parámetro asume el valor que se especifica en la asignación. Cuando el script de estudio analítico se ejecuta en una aplicación cliente, el valor de prueba se ignora y se utilizan los parámetros de entrada definidos por el usuario.

Debe dejar un espacio entre el operador de asignación y la sintaxis de la etiqueta que lo precede. Los valores de asignación deben utilizar el calificador correcto para el tipo de datos, tal como se requiere en Analytics. Si desea obtener más información, consulte Tipos de datos.

Etiqueta Descripción
ANALYTIC

Designa un script como un script de estudio analítico que se puede ejecutar en Robots, en el Servidor de AX o en la ventana Aplicación de análisis.
Etiquetas de entrada
FILE

Especifica un archivo ajeno a Analytics, como un archivo de Excel o un archivo delimitado, que proporciona datos de entrada para un script de estudio analítico que se ejecuta en Robots o en el Servidor de AX.

  • Robots el archivo debe estar ubicado en la ficha Entrada/Salida en el mismo robot que el script de estudio analítico
  • Servidor de AX el archivo debe estar ubicado en la subcarpeta Archivos relacionados de la carpeta en la cual se encuentra el script de estudio analítico
TABLE

Define una tabla de Analytics que el usuario selecciona como información de entrada para un script de estudio analítico.

La etiqueta TABLE puede ir seguida de cero o más etiquetas FIELD en líneas secuenciales.
FIELD

Define un campo que el usuario selecciona como entrada para un script de estudio analítico.

El campo debe formar parte de la tabla que se define en la etiqueta TABLE previa. La primera etiqueta FIELD debe ir directamente a continuación de una etiqueta TABLE y puede ir seguida de más etiquetas FIELD en líneas secuenciales.
PARAM

Crea un parámetro de entrada para un script de estudio analítico y define los requisitos del valor de entrada.

Un parámetro de entrada es un marcador de posición que permite al usuario especificar el valor real al programar o ejecutar un script de estudio analítico.
PASSWORD

Crea un parámetro de entrada de contraseña para un script de estudio analítico. El parámetro ofrece almacenamiento encriptado de una contraseña para usarla más adelante en un comando de ACLScript.

Se solicita al usuario que especifique el valor de contraseña solicitado al programar o iniciar el script de estudio analítico, de forma que no sea necesaria la intervención del usuario cuando se está ejecutando el script de estudio analítico.
Etiquetas de salida
DATA

Especifica que una tabla de Analytics generada por un script de estudio analítico se copia a una subcarpeta de datos (una ubicación de almacenamiento) en el entorno de desarrollo.

En general, usted almacena las tablas de Analytics para que puedan ser utilizadas como tablas de entrada para scripts de estudios analíticos posteriores.
RESULT

Especifica los resultados de la salida de un script de estudio analítico que usted desea poner a disposición de los usuarios finales en las aplicaciones cliente.

Los resultados de salida, aun cuando existen, no están disponibles de forma automática.
PUBLISH

Especifica un archivo que contiene metadatos que definen qué tablas de Analytics se deben publicar en AX Exception cuando se termina de procesar un script de estudio analítico.