EF Popup
El ef_popup se utiliza para obtener una combinación clave-valor desde una página popup. Para esto se necesitan dos cosas: La operación o ítem principal y la operación que va a actuar como popup o diálogo.
Definición Popup
El popup es un ítem con el tipo de página
popup. Este tipo de pagina mantiene viva la conexión con la ventana
original y brinda una función javascript para comunicar los valores
seleccionados a la operacion principal:
seleccionar(clave, descripcion).
El popup puede tener cualquier estructura, a manera de ejemplo se muestra una estructura típica, que consiste de un ci y un cuadro:
A partir de la version 1.5.0 se separó la definición para la columna de
descripción, con lo cual ahora se pueden devolver claves compuestas y la
descripción sin necesidad de redefinir el método que atrapa la
interacción. En este caso a la página original se le envía una clave
compuesta, la cual cuando viaje al servidor se separará y será entregada
como un arreglo posicional.
Comunicación con la operación
La particularidad de este cuadro es que ante una selección en lugar de comunicar el evento hacia PHP retorna el valor seleccionado a la operación principal. Este comportamiento es posible gracias a una Acción de evento Respuesta ef_popup. Esta acción se definiría así en el cuadro.
Operación principal
En el formulario de la operación se define un ef de tipo ef_popup, y se le indica cual será el item de popup o dialogo que se utilizará:
Al clickear sobre el icono de apertura, se abre el item definido en una ventana popup. Cuando el valor lo carga el usuario el par clave-descripción lo brinda explícitamente desde la selección. Cuando se quiere cargar el ef desde el servidor también se debe explicitar este par, esto se hace definiendo la carga de opciones del ef (llamado anteriormente DAO).
A este mecanismo le llega la clave y debe retornar el valor asociado. En el caso de claves compuestas se deberá proveer un ''arreglo posicional'' con los valores necesarios para la clave, los cuales serán enviados como parámetros separados al mecanismo de carga.