Las variables locales y globales son aquellas cuyos valores definidos por el usuario deben introducirse en tiempo de ejecución.
- Una variable local conserva sus valores durante la ejecución de un procedimiento. Los valores se pierden cuando el procedimiento termina de procesarse. Los valores no se pasan a otros procedimientos que tengan el mismo nombre de variable.
La variable local se identifica mediante un símbolo ampersand (&) individual, seguido del nombre de la variable.
- La variable global conserva su valor durante la conexión al Servidor de informes WebFOCUS, y pasa de la ejecución de un procedimiento al siguiente.
Puesto que WebFOCUS crea una nueva sesión de WebFOCUS, en el Servidor de informes WebFOCUS, cada vez que envía una solicitud, no se retienen los valores de las variables globales entre solicitudes de informes. Esto quiere decir que puede utilizar la misma variable global en más de un procedimiento, siempre y cuando llame a dichos procedimientos en la misma solicitud.
Si quiere que el valor global de una variable esté en vigor en todos los procedimientos, añada la variable a un perfil del Servidor de informes WebFOCUS; por ejemplo, EDASPROF.PRF.
La variable global se identifica mediante un doble ampersand (&&), seguido del nombre de la variable.
Nota: Los valores con comas insertadas (',') no están permitidos.
Los nombres de las variables locales y globales están definidos por el usuario, mientras que las variables del sistema y las de estadísticas cuentan con nombres predefinidos. Se aplican las siguientes reglas a la hora de nombrar las variables locales y globales:
- El nombre de la variable local siempre viene precedido de un ampersand (&).
- El nombre de la variable global siempre viene precedido de un doble ampersand (&&).
- Los espacios en blanco insertados no son compatibles con los nombres de las variables.
- Si el valor de una variable tiene un espacio en blanco insertado, una coma o un signo de igualdad, coloque la variable entre comillas simples al hacer referencia a ella.
- El nombre de la variable puede ser una combinación de los caracteres A a Z, 0 a 9 y el carácter de subrayado. El primer carácter del nombre debe ser una letra.
- En vez de un nombre, puede asignar un número a la variable para obtener una variable posicional.
- Puede incluir un carácter de subrayado en el nombre de la variable, aunque no los siguientes caracteres: signo más, signo menos, asterisco, barra diagonal, punto, ampersand y punto y coma.
- El nombre de la variable ampersand está limitado a 100 caracteres, excepto aquellas variables citadas en -HTMLFORM, cuyo límite es de 64 caracteres.
&[&]namedonde:
- name
Es el nombre de la variable. El ampersand individual (&) indica que la variable es local, mientras que el doble ampersand (&&) indica una global. El ampersand individual seguido de una cadena numérica, indica que la variable es posicional.
El nombre que asigne debe seguir las reglas definidas en Convenciones de nomenclatura de variables locales y globales.
Las siguientes variables han sido nombradas correctamente:
&WHICHPRODUCT &WHICH_CITY '&CITY' &&CITY
Los nombres de las siguientes variables son incorrectos, por los motivos citados:
- &WHICH -CITY
Contiene un espacio en blanco insertado.
- &WHICH -CITY
Contiene un guión.
- WHICHCITY
Falta el ampersand (&) inicial.
Examine el siguiente procedimiento, SALESREPORT, donde &CITY, &CODE1 y &CODE2 son variables locales.
TABLE FILE SALES HEADING CENTER "MONTHLY REPORT FOR &CITY" "PRODUCT CODES FROM &CODE1 TO &CODE2" " " SUM UNIT_SOLD AND RETURNS AND COMPUTE RATIO/D5.2 = 100 * (RETURNS/UNIT_SOLD); BY CITY IF CITY EQ &CITY BY PROD_CODE IF PROD_CODE IS-FROM &CODE1 TO &CODE2 END
Suponga que ha proporcionado los siguientes valores al llamar al procedimiento:
EX SALESREPORT CITY=STAMFORD, CODE1=B10, CODE2=B20
Dialogue Manager sustituye los valores por las variables del siguiente modo:
TABLE FILE SALES HEADING CENTER "MONTHLY REPORT FOR STAMFORD" "PRODUCT CODES FROM B10 TO B20" " " SUM UNIT_SOLD AND RETURNS AND COMPUTE RATIO/D5.2 = 100 * (RETURNS/UNIT_SOLD); BY CITY IF CITY EQ STAMFORD BY PROD_CODE IF PROD_CODE IS-FROM B10 TO B20 END
Una vez ejecutado y finalizado el procedimiento, se pierden los valores STAMFORD, B10 y B20.
El siguiente ejemplo explica el uso de tres variables globales: &&CITY, &&CODE1, &&CODE2. Se sustituyen los valores del primer procedmiento, PROC1, aunque se mantienen y pasan al segundo, PROC2.
TABLE FILE SALES HEADING CENTER "MONTHLY REPORT FOR &&CITY" SUM UNIT_SOLD AND RETURNS AND COMPUTE RATIO/D5.2 = 100 * (RETURNS/UNIT_SOLD); BY CITY IF CITY EQ &&CITY BY PROD_CODE IF PROD_CODE IS-FROM &&CODE1 TO &&CODE2 END EX PROC2
TABLE FILE SALES HEADING CENTER "MONTHLY REPORT FOR &&CITY AND PRODUCT &&CODE1" PRINT UNIT_SOLD AND RETURNS AND COMPUTE RATIO/D5.2 = 100 * (RETURNS/UNIT_SOLD); BY CITY IF CITY EQ &&CITY IF PROD_CODE EQ &&CODE1 END
Puede añadir una variable a una cadena de caracteres, o combinar una o varias variables o literales para concatenarla. Consulte el manual Cómo crear informes con el lenguaje WebFOCUS para más detalles sobre la concatenación. Cuando use variables es importante que separe cada una de ellas del símbolo de concatenación, mediante un espacio.
Puede eliminar los espacios en blanco finales de una variable, por medio de la función TRUNCATE de Dialogue Manager. TRUNCATE sólo puede usarse con los comandos de Dialogue Manager compatibles con las funciones, como -SET e -IF. No puede usarse en un comando -TYPE ni en argumentos pasados a procedimientos.
TRUNCATE sólo puede actuar sobre una variable al mismo tiempo. Si intenta usar la función TRUNCATE con más de un argumento, obtendrá el siguiente mensaje de error:
(FOC03665) Error loading external function 'TRUNCATE'
Nota: En cambio, sí puede haber más de una función escrita por el usuario del mismo nombre, sin que se produzca un conflicto.
-SET &var2 = TRUNCATE(&var1);
donde:
- &var2
Es la variable de Dialogue Manager a la que se devuelve la cadena truncada. La longitud de esta variable es la de la cadena original o de la variable sin espacios en blanco finales. Si la variable original estaba compuesta únicamente por espacios en blanco, se devuelve un solo espacio en blanco, con una longitud de uno.
- &var1
Es la variable de Dialogue Manager o una cadena literal, entre comillas simples (‘). Es compatible el uso de variables del sistema y de estadísticas, además de las variables locales y globales creadas por los usuarios.
En el siguiente ejemplo, TRUNCATE elimina los espacios en blanco finales.
-SET &LONG = 'ABC ' ; -SET &RESULT = TRUNCATE(&LONG); -SET &LL = &LONG.LENGTH; -SET &RL = &RESULT.LENGTH; -HTMLFORM BEGIN <HTML> <BODY> <P>LONG = &LONG LENGTH = &LL</P> <P>RESULT = &RESULT LENGTH = &RL</P> </BODY> </HTML> -HTMLFORM END
La salida es:
En el siguiente ejemplo, cuando TRUNCATE elimina los espacios en blanco finales, se devuelve una longitud de 1, ya que la cadena sólo incluye espacios.
-SET &LONG = ' ' ; -SET &RESULT = TRUNCATE(&LONG); -SET &LL = &LONG.LENGTH; -SET &RL = &RESULT.LENGTH; -HTMLFORM BEGIN <HTML> <BODY> <P>LONG = &LONG LENGTH = &LL</P> <P>RESULT = &RESULT LENGTH = &RL</P> </BODY> </HTML> -HTMLFORM END
La salida es:
En el siguiente ejemplo, TRUNCATE es un argumento de la función YMD.
-SET &LONG = 'ABC ' ; -SET &RESULT = EDIT(TRUNCATE(&LONG)|'Z','9999'); -SET &LL = &LONG.LENGTH; -SET &RL = &RESULT.LENGTH; -HTMLFORM BEGIN <HTML> <BODY> <P>LONG = &LONG LENGTH = &LL</P> <P>RESULT = &RESULT LENGTH = &RL</P> </BODY> </HTML> -HTMLFORM END
La salida es:
Puede mostrar el valor de una variable emitiendo una consulta.
-? &[string]donde:
- string
Es el nombre de una variable. Si no se especifica este parámetro, aparecen los valores actuales de todas las variables locales, globales, del sistema y de estadísticas.
Puede capturar el valor de un parámetro SET, en una variable local.
En Developer Studio, la salida aparece en la Consola de comandos. En WebFOCUS, el resultado se devuelve a la ventana de su navegador, o como un comentario en el archivo HTML, si existe otra salida HTML de la solicitud. Utilice las funciones correspondientes del navegador Web, para ver los comentarios HTML (por ejemplo, Ver código fuente en Microsoft Internet Explorer).
-? SET parameter variabledonde:
- parámetro
Es un parámetro SET.
- variable
Es el nombre de la variable en que se va a almacenar el valor.
Introduzca lo siguiente para almacenar el valor de ASNAMES como valor de &ABC.
-? SET ASNAMES &ABC
Si omite &ABC del comando, se crea una variable llamada &ASNAMES, que contiene el valor de ASNAMES.