Su primer script de Analytics

Este breve y sencillo tutorial muestra los fundamentos de ACLScript. El tutorial solo aborda la apertura de una tabla y la extracción de un subconjunto de registros, pero ACLScript puede hacer mucho más.

¿Qué necesita?

En este tutorial, se da por sentado que instaló y activó Analytics y que tiene acceso a los datos de ejemplo que se envían junto con la aplicación.

Nota

De forma predeterminada, los proyectos con datos de muestra se instalan en C:\Usuarios\nombre_de_usuario\Documentos\ACL Data\Archivos de datos de muestra en su sistema de archivos local.

Configuración

Abra el proyecto de Analytics de ejemplo

  1. Abra ACL para Windows.
  2. Haga clic en Abrir un proyecto de estudio analítico y desde la carpeta Datos de ACL\Archivos de datos de muestra de ACL, seleccione Proyecto de muestra.ACL.

Cree su primer script

  1. En el Navegador, desde la ficha Panorama, haga clic con el botón derecho del ratón en la carpeta Scripts y seleccione Nuevo > Script.

    Se agrega Nuevo_script al Navegador y se lo abre en el editor de scripts.

  2. Haga clic con el botón derecho del ratón en Nuevo_script, seleccione Renombrar y escriba extraer_facturas.

La lógica del script

En este script, vamos a utilizar ACLScript para hacer lo siguientes:

  1. Abrir la tabla Trans_Cp.
  2. Copie desde la tabla todos los registros con un importe de factura superior a 1000,00 y almacénelos en una nueva tabla denominada Trans_Cp_elevadas.
  3. Abra la nueva tabla e inspeccione los resultados.

Abra la tabla Trans_Cp

Los datos están almacenados en tablas; por lo tanto, para trabajar con los datos, primero es necesario abrir una tabla. El comando OPEN indica que usted está trabajando con la tabla especificada y pone los datos de la tabla a disposición de los comandos de su script:

OPEN Trans_Cp

Copie esta línea, péguela en el editor de scripts y, a continuación, haga clic en Ejecutar en la barra de herramientas del editor.

Si se abre la tabla Trans_Cp, su script está funcionando. Cierre la tabla y continúe.

Extraiga todos los registros a Trans_Cp_elevadas y cierre Trans_Cp

Ahora que el script está trabajando con la tabla Trans_Cp, podemos usar el comando EXTRACT para copiar registros de Trans_Cp a una nueva tabla denominada Trans_Cp_elevadas:

EXTRACT RECORD TO 'Trans_Cp_elevadas'
CLOSE Trans_Cp

Copie esta línea, péguela en el editor de scripts en una línea después del comando OPEN y haga clic en Ejecutar en la barra de herramientas del editor.

Debe ver la tabla Trans_Cp_elevadas aparecer en el Navegador debajo de Tablas > Cuentas_por_pagar. Esta nueva tabla contiene los registros copiados desde Trans_Cp.

Extraiga el subconjunto de registros a Trans_Cp_elevadas y cierre Trans_Cp

En este punto, puede agregar un parámetro IF condicional al comando EXTRACT para copiar únicamente los registros de facturas con importes que superan los 1000,00.

Observe de qué manera utilizamos el parámetro IF para comprobar si el valor del campo Importe_factura es superior a 1000,00. Si la prueba no se evalúa como verdadera, no se extrae el registro:

EXTRACT RECORD TO 'Trans_Cp_elevadas' IF Importe_factura > 1000,00
CLOSE Trans_Cp

Copie esta línea y reemplace con ella el comando EXTRACT existente en el editor de scripts; a continuación, haga clic en Ejecutar en la barra de herramientas del editor.

Cuando se le indique, haga clic en Sí para sobrescribir la tabla Trans_Cp_elevadas. La tabla Trans_Cp_elevadas ahora contiene los registros copiados con los importes que superan 1000,00 en Trans_Cp.

Abra la tabla Trans_Cp_elevadas

Finalizaremos el script abriendo la nueva tabla Trans_Cp_elevadas de manera que pueda inspeccionar los resultados del comando EXTRACT. Como esta es la última acción del script, se abre la tabla y usted puede revisar los registros:

OPEN Trans_Cp_elevadas

Copie esta línea, péguela en el editor de scripts en una línea después del comando EXTRACT y, a continuación, haga clic en Ejecutar en la barra de herramientas del editor.

La tabla Trans_Cp_elevadas se abre cuando el script se completa y usted puede revisar los registros extraídos desde Trans_Cp.

El script completo

OPEN Trans_Cp

EXTRACT RECORD TO 'Trans_Cp_elevadas' IF Importe_factura > 1000,00
CLOSE Trans_Cp

OPEN Trans_Cp_elevadas

¿Cómo continuar?