Desarrollo de scripts de estudios analíticos
El método recomendado para desarrollar un script de un estudio analítico es primero crear y probar un script regular en Analytics. Una vez que el script funcione correctamente, agregue el encabezado de estudio analítico para convertir el script en un script de estudio analítico. Los scripts de estudio analítico se pueden ejecutar en Robots, en el Servidor de AX o en la ventana Aplicación de análisis.
Si desea obtener información sobre cómo crear scripts regulares, consulte Guía de inicio.
Identificar cualquier entrada o salida del script
En el encabezado del estudio analítico, debe declarar cualquier entrada del script y cualquier salida del script que desee poner a disposición de los usuarios finales o que desee utilizar como entrada para scripts posteriores.
La identificación de las entradas y salidas requeridas antes de comenzar hará que el desarrollo sea más fluido.
A continuación se describen diferentes tipos de entradas y salidas, con las etiquetas del estudio analítico asociadas entre paréntesis.
| Entradas | Salidas |
|---|---|
Acceso a los datos de origen
Hay dos enfoques básicos para acceder a los datos de origen requeridos por un script de estudio analítico:
- Conectividad automatizada
- Carga manual
Puede utilizar ambos enfoques en el mismo script de estudio analítico, si es necesario.
Conectividad automatizada
La ventaja de este enfoque es que las importaciones de datos a Robots o al Servidor de AX pueden automatizarse completamente, incluso ejecutarse de acuerdo con un programa.
En el cuerpo del script de estudio analítico, utilice uno de los comandos ACLScript para conectarse a un origen de datos externo, importar datos y crear una tabla de Analytics con una copia de los datos:
Nota
Estos comandos no requieren ninguna etiqueta de estudio analítico correspondiente en el encabezado de estudio analítico.
Utilice ACCESSDATA a menos que tenga una razón para usar uno de los otros comandos. DEFINE TABLE DB es un comando anterior que se mantiene para la compatibilidad con versiones anteriores de scripts.
Carga manual
La carga manual proporciona una manera simple de importar datos a Robots o al Servidor de AX y puede ser apropiada cuando los usuarios tienen archivos de datos de origen almacenados localmente.
Robots
Puede cargar manualmente en Robots archivos que no sean de Analytics, como Excel o delimitados. Debe utilizar un método diferente para hacer que las tablas de Analytics estén disponibles.
- Archivos ajenos a Analytics Puede cargar manualmente archivos ajenos a Analytics, como Excel o delimitados, a la ficha Entrada/salida en un robot. Para acceder a los datos cargados en un script de estudio analítico, utilice una etiqueta FILE en el encabezado de estudio analítico y un comando IMPORT apropiado, como IMPORT EXCEL, en el cuerpo del script.
- Tablas de Analytics No puede cargar tablas de Analytics manualmente en la ficha Entrada/salida. En su lugar, utilice una etiqueta DATA en el encabezado de estudio analítico para guardar una tabla de salida de Analytics en la ficha Entrada/salida. Para acceder a la tabla de Analytics en un script posterior, utilice el comando OPEN en el cuerpo del script.
Servidor de AX
Puede cargar manualmente en el Servidor de AX archivos que no sean de Analytics, como Excel o delimitados, y tablas de Analytics.
- Archivos ajenos a Analytics Puede importar archivos, como Excel y delimitados, a la subcarpeta Archivos relacionados. Para acceder a los datos importados en un script de estudio analítico, utilice una etiqueta FILE en el encabezado de estudio analítico y un comando IMPORT apropiado, como IMPORT EXCEL, en el cuerpo del script.
- Tablas de estudios analíticos Al importar un proyecto de Analytics al Servidor de AX, las tablas del proyecto se importan a la subcarpeta Datos. Para acceder a una tabla importada en un script de estudio analítico, utilice el comando OPEN en el cuerpo del script.
Flujo de trabajo para crear y comprobar un script de estudio analítico
Nota
El siguiente flujo de trabajo es un enfoque sugerido para desarrollar scripts de estudio analítico; sin embargo, usted puede desarrollar scripts de estudio analítico de la manera que le parezca más conveniente.
Crear el script de Analytics
Cree un script en Analytics sin utilizar cuadros de diálogo personalizados para introducir información del usuario ni ninguna otra función que requiera la interacción con el usuario durante la ejecución del script. Los scripts de estudio analítico permiten la entrada de datos por parte del usuario antes de ejecutar el script, pero, a diferencia de los scripts comunes, no admiten la interacción con el usuario durante la ejecución del script.
Para almacenar valores de entrada de una prueba en el script de Analytics, cree variables de manera temporal en la parte superior del script. Por ejemplo:
ASSIGN v_TablaAnálisis = "Trans_Mayo"
Pruebe y depure el script hasta que se ejecute sin errores.
Agregar el encabezado de estudio analítico y las etiquetas
Agregue un encabezado de estudio analítico al script. Copie los nombres de las variables de la parte superior del script a las etiquetas correspondientes del Diseñador de encabezado de estudio analítico.
Un ejemplo de una etiqueta resultante en el encabezado de estudio analítico:
//TABLE v_TablaAnálisis "Tabla que se debe clasificar"
Si desea obtener más información, consulte Trabajo con encabezados de estudios analíticos.
Incluir el log en los resultados del script de estudio analítico
El log es una herramienta crucial para diagnosticar la causa de las fallas de los scripts de estudio analítico. También puede ser importante cuando los scripts de estudio analítico tienen éxito pero dan resultados inesperados. El log se crea automáticamente cuando un script de estudio analítico falla, pero si el script de estudio analítico se realiza con éxito, solo se genera el log si especifica la etiqueta de estudio analítico RESULT.
En el Diseñador de encabezado de estudio analítico active Conservar el archivo de log para asegurarse de que haya un log disponible cada vez que se ejecute el script de estudio analítico. Se agrega la etiqueta correspondiente al encabezado del estudio analítico:
//RESULT LOG
Validar el encabezado del estudio analítico
Valide el encabezado del estudio analítico Puede validar el encabezado del estudio analítico con la frecuencia que lo desee.
Si desea obtener más información, consulte Validar encabezados de estudios analíticos.
Asignar valores de prueba temporales a las etiquetas de estudio analítico
Utilizando el operador de asignación especial ( := ), asigne valores de prueba temporales a todas las etiquetas del estudio analítico que necesiten la entrada de datos por parte del usuario. Puede copiar los valores de prueba desde las asignaciones de variables temporales en la parte superior del script. Por ejemplo:
//TABLE v_TablaAnálisis "Tabla que se debe clasificar" := "Trans_Mayo"
Para asignar valores de prueba temporales con el Diseñador de encabezado de estudio analítico, ingrese el valor en el campo Valor de prueba para todas las etiquetas de estudio analítico que requieren entradas del usuario.
Si desea obtener más información acerca de la asignación de valores de prueba temporales, consulte Especificación de valores de entrada de prueba en Analytics.
Eliminar las variables temporales
Elimine las variables temporales desde la parte superior del script o exclúyalas con comentarios si cree que tal vez desee utilizarlas nuevamente.
Recorrer el script del estudio analítico
Recorra el script de estudio analítico haciendo clic en Paso 
, o pulsando F10 de manera reiterada. Revise el contenido de la etiqueta Variables en el Navegador para asegurarse de que todas las variables del encabezado del estudio analítico se estén creando correctamente, con la asignación adecuada de valores de prueba.
Pruebe y depure el script de estudio analítico hasta que se ejecute sin errores.
Nota
Si desea salir del script de estudio analítico antes de que finalice, pulse Esc y haga clic en Sí en el diálogo de confirmación.
Consejo
Puede eliminar todas las variables almacenadas y las asignaciones de variables del proyecto de Analytics introduciendo DELETE ALL OK en la línea de comando. Borrar la etiqueta Variables antes de recorrer un script de estudio analítico le permite comenzar de cero.
Eliminar los valores de prueba temporales
Cuando finalice la comprobación, puede eliminar los valores de prueba temporales y el operador de asignación especial de todas las etiquetas del estudio analítico. O puede optar por conservarlos si considera que se requerirán pruebas adicionales. Los valores de prueba se ignoran en los entornos de implementación.
Implementar el script de estudio analítico
Para implementar el script de estudio analítico en el entorno de destino, confirme y envíe el script a Robots o importe el proyecto de Analytics al Servidor de AX.
Flujo de trabajo para comprobar una aplicación de análisis
Para los scripts de estudio analítico que se ejecutarán en el Cliente Web AX o la ventana Aplicación de análisis, también necesita comprobar la aplicación de análisis.
Eliminar los formatos de tabla redundantes
Una vez que haya probado y depurado todos los scripts de estudio analítico y los subscripts de la aplicación de análisis, y haya determinado que se ejecutan correctamente, elimine los formatos de tabla del proyecto de Analytics que no incluirá en la aplicación de análisis.
Los formatos de tabla redundantes crean un cierto desorden en la aplicación de análisis en AX Cliente, el Cliente Web AX y la ventana Aplicación de análisis y podrían resultar confusos para los usuarios finales.
Abra la aplicación de análisis en la ventana Aplicación de análisis
Abra la aplicación de análisis finalizada en la ventana Aplicación de análisis haciendo clic con el botón secundario del ratón en la entrada del proyecto de Analytics en la ficha Panorama y seleccionando Abrir como Aplicación de análisis.
Nota
Si no se puede abrir la aplicación de análisis y recibe un mensaje de error que indica que los scripts de estudio analítico tienen nombres idénticos, compruebe el valor nombre en la etiqueta ANALYTIC de cada script de estudio analítico que se especifica en el mensaje de error. Los valores de nombre de los scripts de estudio analítico deben ser exclusivos en un proyecto de Analytics.
Ejecutar los scripts de estudio analítico
Ejecute todos los scripts de estudio analítico de la aplicación de análisis para confirmar que estén funcionando correctamente.
Observe el orden correcto para ejecutar los scripts de estudio analítico si está utilizando la opción TYPE con la etiqueta ANALYTIC y creando scripts de estudios analíticos de importación, preparación y análisis.
Compruebe el log del
Si un script de estudio analítico no se ejecuta correctamente, abra y revise el archivo de log (nombre_estudio_analítico.log). El log debería incluir una entrada, marcada con una X roja, que indica el motivo por el cual no se pudo completar correctamente el script de estudio analítico:
- por valores de entrada que se introdujeron incorrectamente, vuelva a ejecutar inmediatamente el script de estudio analítico con un valor de entrada correcto
- por errores de sintaxis y lógicos en el cuerpo del script, corrija el error en Analytics y vuelva a abrir la aplicación de análisis en la ventana Aplicación de análisis
Un script de estudio analítico puede completarse con éxito, pero es posible que la tabla de resultados no contenga los resultados que usted esperaba. Cuando ocurra esto, revise las entradas del log en secuencia y compruebe los valores de entrada que se enviaron al scripts de estudio analítico para asegurarse de que el script de estudio analítico esté funcionando de la manera deseada.
Empaquetar y validar una aplicación de análisis
Empaquetar o importar la aplicación de análisis
Una vez que esté satisfecho con el funcionamiento de la aplicación de análisis, empaquétela para su distribución y uso en la ventana Aplicación de análisis o impórtela a AX Servidor para utilizarla en AX Cliente o el Cliente Web AX. Si desea obtener más información, consulte Empaquetamiento de las aplicaciones de análisis.
Ejecute las aplicaciones de análisis de AX Servidor
Si está desarrollando scripts de estudios analíticos para utilizarlos en AX Servidor, ejecute todos los scripts de estudios analíticos utilizando tanto AX Cliente como el Cliente Web AX para asegurarse de que funcionan como usted lo espera.
