¿Dónde podemos usar la función?
En el designer al crear campos virtuales podemos usar la función debug(String)
En el builder, nos muestra que valores toma un expreción en el momento de la construcción
En el browser cuando creamos expreciones, por ejemplo para hacer algún cálculo en una columna
¿Cuando usar la función debug()?
Un problema común en el uso de campos virtuales es que la expresión aparenta no hacer correctamente el cálculo. Determinar cual es el problema implica saber cuales son los valores utilizados por la expresión al ser evaluada por O3. La función debug() sirve para este fin.
La función debug(String) muestra en el log el valor del texto, campo o variable que se le pase como parametro. Esto permite ver en el log generado por la aplicación el valor que tiene un elemento usado en una expresión al momento de ser evaluada la misma.
Ejemplo:
Suponiendo que la siguiente expresión determina el valor de un campo virtual de tipo String:
cantidad < 1000 ? "MENOR_MIL" : "SUPERIOR"
Esta expresión retorna el valor "MENOR_MIL" si el campo "cantidad" es menor a 1000 y sino retorna "SUPERIOR"
Para analizar que es lo que trae el campo de entrada "cantidad", se la puede puede redefinir de la siguiente manera:
debug("--> " + cantidad);
cantidad < 1000 ? "Menor" : "Mayor"
En el log aparecería el siguiente texto:
....
Debug: --> 25
Debug: --> 23
....
Suponiendo que en vez de ser el campo de entrada un double es un String, sería conveniente ponerlo de la siguiente manera para analizar si el valor trae espacios en blanco.
debug("[" + nombre + "]");
NOTA : Actualmente esta función no figura en la ayuda del editor de expresiones.
NOTA : El log generado por defecto se encuentra en la carpeta
/logs en los archivos Designer.log, Builder.log y Browser.log para Designer, Builder y browser respectivamente.
Activar la función debug()
El uso de esta funcíon necesita que se encienda una propertie en los archivos .properties que se encuentran el directorio donde se instalo O3
Para ello según donde sea necesario inspeccionar (browser,designer o builder) deberemos crear un archivo
O3Browser_user.properties , O3Desginer_user.properties, o O3Builer.properties
Colcar en dicho archivo
debug = true
salvarlo.
al volver a correr el browser, designer o builder en los archivo log o en la consola si se corrió con -debug, se verán los valores que toma la expreción de la cual se quiere saber su contenido.