Búsqueda Interactiva en Powerbuilder 11.5 by Tux Merlin - Joomla-gnu.com

Transcripción

1 Todos los sistemas tienen métodos de búsquedas para seleccionar determinados items al ingresar datos. Un caso típico se da en una empresa durante el proceso de facturación, por ejemplo, al elegir el cliente al que le haremos la factura. Estas búsquedas, por buena regla de programación, tienen que ser veloces y eficientes ya que, dependiendo de la cantidad de datos, pueden transformarse en algo tedioso para el usuario final. Por ejemplo si tenemos una lista de 500 clientes, colocar en el formulario una lista descolgable para seleccionarlos sería una verdadera aberración. La solución típica para el caso de abundancia de datos es la denominada búsqueda interactiva. o búsqueda secuencial. Este subsistema consiste en brindarle al usuario/dataenter un formulario con una casilla donde irá escribiendo, por ejemplo el nombre de la empresa y debajo, automáticamente, se irá filtrando la lista hasta dar con lo que se necesita. Con esto trabajará más rápido, más eficientemente. y a gusto. Aquí veremos cómo realizar un formulario de búsqueda interactiva o secuencial utilizando un datawindows y una casilla de entrada de texto en Powerbuilder v11.5. La vista del formulario final será algo como esto: página 1 / 7

2 Desde este formulario el usuario irá escribiendo en el casillero"buscar por Denominación" el nombre de la empresa y la selección en azul mostrada debajo en el datawindows se irá moviendo sola hasta dar con la búsqueda. Luego presionando ENTER o clickeando en "Seleccionar" el dato será pasado a la variable de entorno para ser utilizada en, otro formulario. Además de ello, el presente formulario, permite elegir por qué columna de datos vamos a realizar la búsqueda. En la imagen mostrada, si clickeamos sobre CUIT, la búsqueda se hará por esta columna, es decir, el usuario deberá ingresar números. Asimismo, al clickear en el título de la columna se cambiará automáticamente la etiqueta del casillero de ingreso por el texto de la columna. Para empezar debemos tener un datawindows creado -como se ve en la imagen- con la propiedad general " Mouse Selection" activada. A su vez el "Tab Order" de los campos debe ser 0 para ambas columnas. En la ventana, el objeto vinculado a dicho datawindows debe tener las siguientes propiedades generales activadas: Visible, Enabled, HScrollbar, LiveScroll y lo llamaremos "dw_lclie" (instancia del objeto datawindows dw_sele_clie"). La ventana que vemos debe ser del tipo "response!", es decir emergente y con el título indicativo "Búsqueda de Clientes". La guardaremos con el nombre de "w_popup_clientes" para saber que es una ventana emergente de consulta. La casilla de búsqueda, donde se ingresará el texto, será un objeto de usuario llamado "uo_busca" y pertenecerá a una instancia del objeto "uo_busca_clientes". Este último objeto tendrá la siguiente apariencia: Estará conformado por una ventana con un objeto "Single Line Edit" llamada "sle_texto", rodeado por un objeto "Group Box" para página 2 / 7

3 mostrar el título (en el ejemplo: "Buscar por"). Definiremos en "Declare Instance Variables" lo siguiente: datawindow dw string columna,columna_integer,columna_label En "Function List" agregaremos dos funciones: una llamada "wf_poner_titulo" y otra "wf_sort". La primera será: "Access: public", "Return Type: None", "Function Name: wf_poner_titulo" y contendrá el siguiente código: gb_1.text = 'Buscar por ' +columna_label sle_texto.text = '' dw.setfilter("") dw.filter() La otra función será: "Acces: public", "Return Type: None", "Function Name: wf_sort" y contendrá el siguiente código: //Ordene el dw por la columna definida para que la busqueda sea mas efectiva if columna_integer = columna then dw.setsort("integer("+columna+") asc" ) else dw.setsort(columna+" asc" ) end if dw.sort() El objeto "Single Line Edit" deberá tener definido el evento "Constructor" con el siguiente código: //debe definir prinero el dw y la comuna a buscar //llama al evento sort despues de terminar el constructor Post wf_sort() Post wf_poner_titulo() página 3 / 7

4 Este evento es el que agregará el texto al lado de "Buscar por". Asimismo definiremos un evento propio titulado "ue_keypress" del tipo "Keycode key, unsignedlong keyflag" con el siguiente código: //Busca sensitivamente dentro de una columna de tipo char() //primero debe definir en el condstructor el dw y la columna a buscar long is_linea string buscar,ls_tipo int largo ls_tipo = dw.describe(columna+".coltype") buscar = upper(text) largo = len(buscar) choose case mid(ls_tipo,1,4) case 'char' is_linea = dw.find("upper(mid("+columna+",1,"+string(largo)+")) = '"+buscar+"'",1,dw.rowcount()) case 'deci' is_linea = dw.find("upper(mid(string("+columna+"),1,"+string(largo)+")) = '"+buscar+"'",1,dw.rowcount()) case 'long' is_linea = dw.find("upper(mid(string("+columna+"),1,"+string(largo)+")) = '"+buscar+"'",1,dw.rowcount()) end choose dw.scrolltorow(is_linea) Este evento es el más importante ya que es el que hará la búsqueda secuencial. Volviendo a la ventana "w_popup_clientes", haremos lo siguiente: Definiremos las siguientes variables de instancia: string is_codig,is_perfi int ii_fila_elegida página 4 / 7

5 En su evento "Open" pondremos el siguiente código: /* Script de inicio ventana w_seleclie by TuxMerlin (c) 2009 Objeto: w_seleclie Evento: open() Work: Cargas los datos en el datawindow Call: 1) Desde w_fichas_clientes botón "Búsqueda Interactiva" 2) Desde Facturación y Remitos */ //Traigo los datos dw_lclie.settransobject(sqlca) dw_lclie.retrieve(sqlca) //Le doy el foco por si trabaja más con el teclado dw_lclie.setfocus() Está comentado así que supongo entenderán de qué se trata. Veamos los códigos de los demás objetos de la ventana. El botón "Salir" tendrá este código definido en el evento "Clicked": close(parent) El botón "Seleccionar" tendrá este código definido en el evento "Clicked": /* Script para el botón seleccionar fila by TuxMerlin (c) 2009 Objeto: w_seleclie --> cb_seleccionar Evento: clicked() Work: selecciona la resaltada Call: w_seleclie -> cb_seleccionar */ // Me devuelve el número de fila que elegí ii_fila_elegida=dw_lclie.getrow() // Abro la Ficha del Cliente y envío el parámetro closewithreturn(parent,ii_fila_elegida) página 5 / 7

6 Este botón será el encargado, si se presiona, de cargar los datos de la fila en la variable de instancia "ii_fila_elegida" que será utilizada en la ventana desde donde fue realizada la consulta. Si miran los comentarios, en el código del evento "Open", se darán cuenta que devolvería los datos a la ventana "w_fichas_clientes". El objeto "dw_lclie" en su evento "Clicked" debe tener el siguiente código: /*Aqui al dar cliked en la cabecera de la columna se configura para filtar el nombre de la label debe ser llamado nombre del campo + '_t' como define PB Ejemplo nombre - > Label o cabecera nombre */ if row = 0 then if dwo.name = 'datawindow' then return string ls_columna ls_columna = mid(string(dwo.name),1,len(string(dwo.name))-2) uo_busca.columna_label = dwo.text uo_busca.columna = ls_columna //uo_busca.wf_sort() uo_busca.wf_poner_titulo() uo_busca.setfocus() end if En los comentarios del código pueden ver qué es lo que hace. Finalmente, en el evento constructor del objeto de usuario "uo_busca" debemos ingresar el siguiente código: //por default configuro la columna y el label de la columna inicial //y tambien el datawindow a ser filtrado dw = dw_lclie columna = 'denominacion' columna_label = 'Denominacion' página 6 / 7

7 Powered by TCPDF ( Búsqueda Interactiva en Powerbuilder 11.5 Con esto ya tenemos la búsqueda interactiva o secuencial deseada y como ven puede utilizarse desde cualquier otra ventana donde tengamos necesidad de acceder a nuestros clientes. "Good programming!" {jd_file file==52} {gotop} página 7 / 7