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

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.

Creación de una variable y asignación de un valor

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%

Analytics utiliza los siguientes tipos de variables:

  • Variables generadas por el sistema se crean automáticamente después de ejecutar un comando
  • Variables permanentes permanecen en la memoria de la computadora hasta que se las elimina y continúan allí incluso después de cerrar el proyecto de Analytics

    Nota

    Para definir una variable permanente, coloque un guion bajo '_' delante del identificador: _v_nombre_compañía = 'Acme'.

  • Variables de la sesión permanecen en la memoria de su computadora hasta que las elimina o hasta que se cierra el proyecto de Analytics

Identificadores de las variables

Los identificadores de las variables distinguen entre mayúsculas y minúsculas y siguen determinadas convenciones relacionadas con el tipo de variable:

  • los identificadores de variables generados por el sistema utilizan solo mayúsculas: OUTPUTFOLDER
  • los identificadores de variables permanentes deben tener un prefijo '_': _v_permanente
  • los identificadores de variables de sesión utilizan el formato v_nombrevariable por convención, pero esta convención no es obligatoria

Durante el desarrollo o la depuración de los scripts, puede resultar útil hacer un seguimiento de los valores de las variables a medida que se ejecuta el script. Para capturar los valores de las variables en el archivo de log del script, utilice el comando DISPLAY:

DISPLAY v_antigüedad_en_años

Cuando el script se encuentra con este comando, lo escribe en el archivo de log. Para ver el valor de la variable en esta etapa de la ejecución del script, haga clic en la entrada del log.

Consejo

También puede usar las variables para ayudar a depurar insertando puntos de quiebre en el script e inspeccionando los valores de las variables en la ficha Variables del Navegador.