CREANDO DATAWINDOWS

Un datawindow es un objeto visual de acceso a los datos.

EL OBJETO DATAWINDOWS El Objeto DataWindow es un objeto que se usa para recuperar, presentar y manipular datos de una base de datos relacional u otra fuente de datos (como archivos DBF). Puede, adems, escoger distintos estilos de presentacin (freefrom, Graph,). Los objetos DataWindow tienen conocimiento de los datos que son recuperados. Puede especificar formato de display y otros atributos, de forma tal que los datos son mostrados de manera ms significativa.

Para tener un datawindow en una ventana se debe tener dos elementos: Datawindows Objeto ( ver fig. anterior ) Datawindows Control ( Un datawindow control debe asociarse a un datawindow objeto para poder visualizar su contenido en una ventana). Cdigo de conexin de base de datos en el script de la aplicacin y de actualizacin en la ventana en la que se mostrar el datawindow.

CREANDO UN OBJETO DATAWINDOW Para crear un objeto datawindow, seguir los siguientes pasos: Hacer un click en el pintor DataWindow ( ). A continuacin, el window Select Datawindow se displayar. Hacer click en el botn New. La ventana New DataWindow se displayar.

Escoger el estilo de presentacin: Freeform, tabular, grid, entre otros. (Para el ejemplo se escoger el tipo GRID) [Opcional ] escoger opciones para el Objeto DataWindow. Escoger un Data Source para el Objeto DataWindow. (Para el ejemplo se escoger la fuente de datos Quick Select) Hacer click en el botn Ok. Seleccionar la(s) tabla(s) y campos de la(s) misma(s) que se presentarn en el datawindow.

Si se desea se puede hacer un previo inmediatamente despus que el Objeto Data Window ha sido definido. Para ello hacer click en el botn () de la barra de herramientas del pintor datawindows. [Opcional ] se puede mejorar la apariencia del ttulo y otros. Guardar el Objeto DataWindow ( hacer click en el botn A continuacin aparecer la siguiente ventana: de la barra de herramientas ).

Es conveniente que el datawindow objeto tenga el mismo nombre que el datawindow control. Escribir el nombre con el que se va a guardar el objeto datawindow, seguido de la convencin dw_, seleccionar la librera en la que se va a grabar y hacer click en el botn ok.

MODIFICANDO UN DATAWINDOW EXISTENTE

Hacer click al Pintor DataWIndow (datawindow painter). Seleccionar el objeto datawindow de la actual librera. Hacer click en OK. En la ventana que aparecer a continuacin modificar el datawindow seleccionado.

ESCOGIENDO EL ESTILO DE PRESENTACION El estilo de presentacin que se selecciona para un objeto datawindow determina el formato que PowerBuilder usa para el primer display del Objeto DataWindow en el DataWindow painter Workspace. Se pueden escoger los siguientes estilos de presentacin en un nuevo Objeto DataWindow : Tabular Freeform Grid Label N-up Group Graph Crosstab

ESTILO TABULAR Este estilo de presentacin presenta los datos a travs de columnas, encabezados(header) y pginas, generalmente muestran muchas filas de las B.D., al mismo tiempo como pueda el Objeto Datawindow. Puede modificar la organizacin default, moviendo las columnas y textos. Este estilo es frecuentemente usado cuando se quiere agrupar los datos.

ESTILO FREEFORM Este estilo de presentacin presenta los datos como columnas de datos, de arriba hacia abajo de la pgina, con su respectiva etiqueta para cada columna. Puede organizar la definicin default moviendo las columnas y textos. Este estilo es frecuentemente usado para entrada de datos(mantenimiento).

ESTILO GRID

Este estilo de presentacin, presenta los datos en formato fila-columna con lineas grid que separan filas y columnas. No puede mover las columnas y encabezados como en los estilos anteriores.

ESTILO LABEL Este estilo presenta los datos como etiquetas. Escoja este estilo para crear etiquetas de correo u otro tipo de etiquetas.

ESTILO N-UP Este estilo presenta 2 ms filas en la misma lnea del Objeto DataWindow, una seguida de otra. Es similar al estilo label.

ESTILO GROUP Este estilo es una forma corta para crear grupos en un Objeto DataWindow, generando un estilo tabular que est agrupado por ciertas popiedades que son definidas por el que programa.

ESTILO GRAPH Y CROSSTAB Los anteriores estilos son basados en texto. PowerBuilder provee dos estilos que permiten mostrar informacin grficamente : graphs y crosstab.

DEFINIENDO LA FUENTE DE DATOS Al definir la fuente de datos (dataSource), se especifica cul es la fuente de datos que ser usada en el Objeto Datawindow. Se puede escoger de las siguientes fuentes de datos: Quick Select SQL Select Query External Stored Procedure

Si los datos que el Objeto DataWindow muestra, proviene de una base de datos, escoger Quick Select, SQLSelect, Query , o Stored Procedure como la Data Source.

Si los datos a recuperar son de una sola tabla y slo necesita escoger columnas, criterio de seleccin y Sort (No necesita agrupar, campos calculados, etc.), escoger Quick Select SQLSelect. Si la data ha sido definida y salvada en un query, escoger Query. Si la data es definida en un Stored Procedure (procedimieno almacenado), escoger Stored Procedure. Si los datos no provienen de una B.D. , escoger Select externa. Esto incluye las siguientes situaciones: Si los datos sern importados de un archivo externo, tal como un archivo de texto separado por un tab o archivo Xbase(DBF). Si los datos sern importados de una aplicacin DDE.

QUICK SELECT Si slo necesita seleccionar columnas de una sola tabla, use Quick Select data source, el Quick Select genera una sentencia SQL.

SQL SELECT Cuando el SQL Select como Data Source, se construye la sentencia SQL select (grafico o texto) que puede incluir lo siguiente: Ms de una tabla Criterio de seleccin (clausula Where) Criterio de Sort(clausula Order By) Criterio de agrupamiento (clausula group By y Having) Columnas Computadas

CREANDO UN CONTROL DATAWINDOWS Un control datawindow, como todo control, va pegado en una ventana. Para crear un control datawindow y asociarlo con un objeto datawindow, seguir los siguientes pasos: Crear una nueva ventana (window). Seleccionar de la barra de herramientas el control datawindow (ver lista que aparece al lado izquierdo). Pegar el control en la ventana, dndole el tamao que se estime va a tener el datawindow que se desea mostrar.

Asociar el control datawindow al objeto datawindow anteriormente creado. Para ello, dar doble click sobre el control datawindow y aparecer la ventana de propiedades en la que se colocar en el rea DataWindow Object Name, el nombre del datawindow objeto. Es conveniente que el nombre del datawindow control sea el mismo que el del datawindow objeto. En el script de la ventana, en la que se encuetra el control datawindow en el evento open, escribir el siguiente cdigo:

dw_coleccion. settransobject(sqlca) dw_coleccion.retrieve( )

Si la aplicacin no tiene cdigo para CONEXION a base de datos, escribir el siguiente cdigo en el evento open de la aplicacin.

CONTROLANDO LA ACTUALIZACION Para controlar la actualizacin de un datawindow, seguir los siguientes pasos: Hacer un click con el botn derecho del mouse en el control datawindow. Aparecer una lista como la que se aprecia en la figura. Seleccionar la opcin: Modify DataWindow.... A continuacin aparecer el entorno datawindow (datawindow workspace). Seleccionar el men Rows, la opcin Update Properties.

A continuacin aparecer una ventana similar a la siguiente, en la que se har un check al checkbox Allow Updates.

Hacer click en OK y el datawindow tendr la propiedad de actualizacin.

COMPONENTES DE UN DATAWINDOWS Un datawindow consta principalmente de las siguientes reas:

En otro tipo de datawindow, tambin existen reas como: Group Header : Muestra informacin acerca de los grupos de la cabecera. Group Trailer : Muestra los totales por cada grupo creado. Barra de color : Se puede cambiar el color del background, texto, etc., desde el popup del men.

EVENTOS DE UN DATAWINDOWS

Los eventos ms importantes del objeto datawindow son: Evento Clicked El usuario ejecuta un click con el ratn. Constructor Este evento est presente en casi todos los objetos de PB. Se ejecuta cuando el sistema acaba de crear el objeto. DbError Ha ocurrido un error de base de datos. Util para capturar errores de la base de datos y tratarlos segn nuestro criterio. Destructor El sistema destruye los objetos, normalmente al cerrar una ventana. EditChanged Cada vez que el usuario pulsa una tecla y modifica un carcter del contenido de un Se ejecuta cuando ... .

campo. Error Se produce un error de validacin en un campo. ItemChanged El usuario ha modificado un campo e intenta cambiar de campo con la tecla tab o el mouse. Util para validar los datos, ya que nos da la oportunidad de rechazar lo que el usuario ha introducido. ItemError El usuario ha producido un itemchanged pero los datos que contiene el campo no pasan las reglas de validacin introducidas en el datawindow object. ItemFocusChanged El usuario cambia de campo. RetrieveEnd Ha finalizado una instruccin retrieve (consulta a la base de datos).

RetrieveRow Mientras se est ejecutando una instruccin retrieve y recuperamos cada una de las filas. RetrieveStart Antes de que se lance la instruccin SQL Select contra la base de datos. RowFocusChanged El foco cambia de fila. Cuidado con esta instruccin porque se ejecuta por s sola cuando hacemos un insert, un delete o un retrieve. SqlPreview Cada vez que ejecutamos funciones de PB que afectan a la base de datos. Retrieve, Update, etc. Muy til para depurar el sql que se est generando. UpdateEnd Ha finalizado la actualizacin de la base de datos.

UpdateStart Antes de que empiece la actualizacin de la base de datos. Para finalizar DataWindows, algo importante: Normalmente, primero pegas un datawindow control en la ventana, y despus le asignas un datawindow object que debes haber creado antes. Pero tambin se puede hacer sto dinmicamente a travs de un script. El atributo DataObject (de tipo string) es el que asigna el data object a la datawindow. Piensa por un momento en las posibilidades que sto ofrece.