IFbA dialogs

Uno de los temas a los cuales me cost ms entrarle en el mundo de los formularios
Adobe de SAP (SAP Interactive forms by Adobe - IFbA) es el de scripting y en particular los
dilogos o popups. Me fue bastante difcil conseguir documentacin y ejemplos de estos
temas. Quizs la principal documentacin con la que pude contar fue la gua de referencia
de javascript y la ayuda online de Adobe, pero definitivamente no encontr documentacin
en castellano. Esta serie de posts ir dedicada a mostrar en forma sencilla cmo
programar dilogos con javascript para principiantes y ser seguida de otra serie de posts
para desarrolladores experientes.
Qu comentar de los dilogos de Adobe? A primera vista parecen bastante limitados en
sus funcionalidades, pero con un poco de imaginacin podremos sacarle el jugo necesario
para resolver las situaciones ms comunes y algunas ms complejas.
Las bsicas
Para crear dilogos vamos a utilizar el mtodo execDialog del objeto app. Este mtodo
recibe como parmetro un objeto monitor el cual consta de los manejadores de eventos y
una propiedad description que representa el contenido del dilogo. Retorna un string con el
ItemId del elemento que hizo que el dilogo se cerrara. e.g. si el elemento es un botn
ok_cancel, retorna "ok" o "cancel".
Manejadores
El objeto Dialog tiene 5 manejadores (funciones):
initialize - se ejecuta cuando la ventana de dilogo se crea
validate - se ejecuta al validar los valores de los campos
commit - se ejecuta al presionar el botn OK
destroy - se ejecuta cuando se destruye la ventana de dilogo
itemID - se ejecuta cuando se modifica la propiedad itemID de un objeto

Todos los mtodos manejadores reciben como parmetro un objeto Dialog que es la
instancia del dilogo creado.
Propiedades del dilogo
Como decamos, la propiedad description contiene una serie de propiedades del dilogo
como name (nombre), width (ancho), height (alto). Su propiedad ms importante es
elements, la cual contiene un vector de objetos que representan los distintos objetos de la
ventana.
Ejemplos de estos objetos son un cuadro de texto, una etiqueta, un botn o un contenedor.
Mtodos
El objeto Dilogo (el cual es pasado a los manejadores) tiene una serie de mtodos de los
cuales los ms importantes son load y store.
El mtodo load se utiliza para cargar valores a los objetos del dilogo y el mtodo store
para obtener los valores de los objetos del dilogo.
En el siguiente post
En el siguiente post realizaremos un ejemplo sencillo de un dilogo utilizando tanto
notacin convencional de java como notacin literal.