Conceptos básicos de la creación de scripts de Analytics
ACLScript es un lenguaje de comandos que permite programar y automatizar los comandos de Analytics. La estructura y los componentes de ACLScript son simples pero muy potentes.
Nota
Si es la primera vez que creará scripts, considere visitar la Academia para obtener capacitación básica antes de leer este contenido. Si desea obtener información sobre cursos para la creación de scripts y el uso de Analytics, visite www.highbond.com.
Comandos
Cada línea de un script ejecuta un comando de ACLScript y comienza con el nombre del comando. Un comando es una instrucción para ejecutar una operación en Analytics.
El nombre del comando va seguido de uno o más parámetros que se especifican como nombre_del_parámetro valor_del_parámetro.
Consejo
Según el comando, algunos parámetros son obligatorios y otros, opcionales. No es necesario que especifique los parámetros opcionales. Si se los omite, el comando se ejecuta sin ellos. Sin embargo, si omite un parámetro obligatorio, Analytics utiliza el valor predeterminado para ese parámetro.
Ejemplo de uso del comando CLASSIFY
El siguiente ejemplo muestra el comando CLASSIFY junto con los siguientes parámetros:
- ON: especifica qué campo de la tabla se debe utilizar para la clasificación
- SUBTOTAL: especifica campos opcionales para calcular el subtotal en la salida
- TO: especifica la tabla donde escribir los resultados del comando CLASSIFY
Observe cómo cada parámetro va seguido de uno o más valores del parámetro:
Notas importantes sobre la sintaxis de los comandos
- la primera palabra de una línea de script debe ser el nombre de un comando
- en la mayoría de los comandos, el orden de los parámetros que se incluyen después del nombre del comando no es importante
- la mayoría de los comandos requieren que abra la tabla de destino antes de ejecutar el comando, estos comandos deben ir precedidos de OPEN nombre_de_la_tabla
Comentarios
Como en cualquier lenguaje de scripts, en ACLScript puede agregar comentarios usando la palabra claveCOMMENT. Utilice los comentarios para que el código sea más fácil de comprender y para comunicarse con cualquier persona que intente leer, utilizar o comprender su script. ACLScript admite dos tipos de comentarios:
- comentarios de una sola línea se ignora todo el texto que sigue a COMMENT hasta llegar al final de la línea
- bloques de comentario de varias líneas comienzan con COMMENT y se ignora cada una de las líneas siguientes hasta llegar a la palabra clave END o una línea en blanco
Si desea obtener más información y ejemplos, consulte Comentarios.
Tipos de datos
ACLScript admite cuatro tipos de datos básicos:
- lógicos el tipo de datos más sencillo. Los datos lógicos expresan un valor de verdad que es verdadero o falso.
- numéricos contienen dígitos del 0 al 9 y pueden tener un signo negativo y un separador decimal
- carácter una serie de uno o más caracteres
- fechahora un valor de fecha, fechahora u hora expresado en un formato admitido
En Analytics, cada tipo de datos se trata de manera diferente y se puede usar en distintos comandos y funciones. Si desea obtener más información acerca de los tipos de datos, consulte Tipos de datos.
Expresiones
Una expresión es cualquier declaración que tenga un valor. La forma más sencilla de expresión es un literal, como 2 o "prueba"; sin embargo, las expresiones suelen aparecer como cálculos y pueden ser tan complejas como cualquier combinación permitida de operadores, condiciones, funciones y valores que podamos imaginar:
((2 + (3 - 2)) * 2) > ROOT(9;0)
Las expresiones se suelen usar en Analytics para completar campos calculados o como entrada para la lógica condicional. Si desea obtener más información sobre las expresiones, consulte Expresiones.
Funciones
Las funciones son rutinas incorporadas que aceptan una cantidad determinada de parámetros y devuelven un valor único. Utilice las funciones para manipular el contenido de los campos y las variables que se utilizan en los comandos.
Nota
Las funciones no modifican los datos del campo sino que generan y devuelven un nuevo valor sobre la base de un cálculo o un algoritmo que utiliza los datos del campo o variables como datos de entrada. Utilice el valor que devuelve la función como entrada para un comando.
Las funciones comienzan con el nombre de la función, seguido de un paréntesis de apertura, una lista de 0 o más valores separados por un punto y coma que se se pasan a la función como argumentos, y un paréntesis de cierre.
Ejemplo
La función BETWEEN(valor; mín; máx) tiene tres argumentos y devuelve verdadero si el valor cae dentro del rango o falso si cae fuera del rango:
- valor: la expresión o el campo que se debe probar
- mín: el mínimo del rango
- máx: el máximo del rango
BETWEEN(importe; 500; 5000)
Si desea obtener más información acerca de las funciones, consulte Funciones.
Variables
Las variables son una ubicación de almacenamiento temporal para un valor. Las variables tienen un identificador asociado que le permite hacer referencia al valor almacenado en la memoria de su computadora y trabajar con él.
ACLScript utiliza el comando ASSIGN para crear una variable y asignarla a un valor al mismo tiempo:
ASSIGN v_age_in_years = 3
Para que resulte más simple, puede omitir la palabra clave ASSIGN; sin embargo, se utiliza ASSIGN implícitamente y se ejecuta el mismo comando:
v_age_in_years = 3
Nota
ACLScript no admite valores en blanco. Todas las variables deben tener un valor asociado de uno de los tipos de datos admitidos. El interpretador de scripts evalúa el tipo de datos utilizando el formato de datos y el calificador que usted utiliza para asignarle el valor. Si desea obtener más información, consulte Tipos de datos.
Utilizar variables
Una vez que se crea una variable, puede hacer referencia a ella en cualquier lugar en el que haga referencia a nombres de campos o variables. También puede reasignarle un nuevo valor utilizando el comando ASSIGN.
EXTRACT RECORD TO 'result.fil' IF age > v_age_in_years v_age_in_years = 5
También puede utilizar la interpolación de cadenas o el reemplazo de variables para incluir una variable en un literal de cadena encerrando el nombre de la variable entre los caracteres %. Cuando Analytics detecta una variable reemplazada, reemplaza el marcador con su valor correspondiente:
ASSIGN v_table = erp_data OPEN %v_table%
Si desea obtener más información acerca de las variables, consulte Variables.
Estructuras de control
Una estructura de control es un componente de un script que decide qué dirección seguir según parámetros determinados. ACLScript ofrece tanto estructuras de bucle como de lógica condicional.
Lógica condicional
ACLScript implementa la lógica condicional como un comando IF y como un parámetro opcional en muchos comandos del lenguaje.
Consejo
El comando IF se utiliza para controlar si un comando se ejecuta o no, mientras que el parámetro IF se utiliza para decidir con qué registros de una tabla se ejecuta un comando.
IF
IF v_recuento > 10 CLASSIFY ON núm_cliente
Parámetro IF
CLASSIFY ON núm_cliente IF estado = 'NY'
Bucle
El comando LOOP proporciona la estructura de control de bucle en ACLScript. Este comando procesa las instrucciones dentro del bucle mientras que la expresión de la prueba de control sea verdadera.
Si desea obtener más información acerca de las estructuras de control, consulte Estructuras de control
Guía de creación de scripts de ACL 14.1