EL OBJETO DATAWINDOW

Un DataWindow es lo que su nombre indica: una ventana de datos, es un objeto

visual de acceso a los datos. 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. Gestiona la conexin a una fuente de datos. Puede, adems,
escoger distintos estilos de presentacin: tabular, formato libre, etiquetas,
grficos y crosstab.
Para tener una aplicacin en Power Builder con base de datos se necesitan:

Un Objeto Datawindows .

Un Control Datawindows (Un control datawindow debe asociarse a un

objeto datawindow para poder visualizar los registros en la una ventana).

Cdigo de conexin de base de datos en el script de la aplicacin

Cdigo del objeto Transaccin y de actualizacin en la ventana en la que

se mostrar el datawindow.

Un datawindows es una sentencia SQL que esta ligada a una representacin

grfica. Donde cada elemento de esta representacin es individualizable y puede
ser alterado en el cdigo del programa.
Esta definicin indica dos elementos unidos (aunque distintos entre si)
a. Origen de Datos:
Corresponde a la sentencia SQL propiamente tal, la que podr tener
caractersticas de Agrupamiento, Ordenamiento, Condicionales (extraer un
conjunto definido de registros) y en fin todas las pertinentes a una sentencia
SQL pura.
b. Presentacin:
Corresponde a la distribucin grfica de los elementos de la consulta y otros
aadidos, dentro de un rea definida para ello. La que podr ser utilizada

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

para presentar datos, ingresar datos, listarlos o imprimirlos; tal y como

aparecen en esta hoja.

ESTILO DE PRESENTACION
Se pueden escoger los siguientes estilos de presentacin en un nuevo Objeto
DataWindow :

Estilo Tabular
Este estilo presenta los datos a travs de columnas a lo ancho de la pgina, cada
columna muestra su encabezado (header), generalmente muestran muchas filas
de las B.D., al mismo tiempo como pueda el Objeto Datawindow. Presenta el
origen de datos en forma columnada pero sin ajuste total. Permite una mayor
libertad en el diseo. Puede modificar la organizacin default, moviendo las
columnas y textos. Este estilo es frecuentemente usado cuando se quiere agrupar
los datos.

Estilo Freeform (Libre)

Este estilo lista las columnas de datos a lo largo de la pgina, de arriba hacia
abajo, con su respectiva etiqueta para cada columna. La presentacin es libre,
donde cada campo esta en una lnea distinta.

Puede organizar la definicin

default moviendo las columnas y textos. Tambin puede cambiar los atributos
del texto o la forma de los objetos. Este estilo es frecuentemente usado para
entrada de datos (mantenimiento) y reportes.
Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

Estilo Grid (Malla)

Este estilo presenta los datos en formato fila-columna con lneas grid que
separan filas y columnas. Disea una malla de datos en forma columnada. No
puede mover las columnas y encabezados como en los estilos anteriores. El
usuario puede reordenar los elementos de la pantalla en tiempo de ejecucin, al
contrario que con otros estilos de presentacin. El usuario puede redimensionar
y reordenar las columnas con el ratn mientras se ejecuta la aplicacin.

Estilo Label (Etiqueta)

Este estilo presenta los datos como etiquetas. Escoja este estilo para crear
etiquetas de correo u otro tipo de etiquetas. El diseo es de etiquetas, donde Ud.
podr elegir el tipo de etiqueta de las prediseadas, en papel continuo o
separado, y otras opciones.

Estilo N-Up (Encolumnado)

Este estilo presenta 2 ms filas de datos en la misma lnea del Objeto
DataWindow, una seguida de otra. Se debe especificar cuantas filas se dispondr
horizontalmente en cada lnea. Esto permite presentar a lo ancho de la pgina
viarias filas de informacin que conforman la base de datos. Es similar al estilo
label.

Estilo Group
Este estilo es una forma corta para crear grupos en un Objeto DataWindow,
generando un estilo tabular agrupado. Disea listado de registros por agrupacin
de campos. Muy utilizado para reportes de resumen de informacin.

Estilo Graph
Los anteriores estilos son basados en texto. PowerBuilder provee de un estilo que
permite mostrar informacin grficamente. El estilo Graph disea un grfico
dependiendo de valores numricos.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

Estilo Composite (Compuesto)

El tipo Composite permite tener DataWindow dentro de otros DataWindows.
Utiliza como presentacin un reporte previamente creado.

Estilo Crosstab
Permite visualizar los totales de los registros teniendo en cuenta dos campos.

Estilo Rich Text

Se utiliza para crear cartas con combinacin de campos del Origen de datos
fijado. La cantidad de documentos que se generan en forma automtica depende
de la cantidad de registros que tiene la tabla utilizada.
Se pueden utilizar todas las caractersticas del formato de texto RTF.

Estilo TreeView
Se utiliza cuando al agrupar registros, estos se agrupan en carpetas.

DEFINIENDO LA FUENTE DE DATOS

Al definir la fuente de datos (dataSource), se especifica cul es la que ser usada
en el Objeto Datawindow. Se puede escoger de las siguientes fuentes de datos:

Quick Select (seleccin rpida)

SQL Select (seleccin mediante SQL)

Query (consulta)

External (procedimiento externo)

Stored Procedure (procedimiento almacenado)

Quick Select
Significa una seleccin rpida. Si los datos a recuperar son de una sola tabla y
slo necesita escoger columnas, (no necesita agrupar, campos calculados, etc.),
escoger Quick Select, el cual genera una sentencia SQL. Solo permite las
sentencias ordinarias de SQL: Sort y Criteria. La primera para poder ordenar por
el campo especifico y la segunda para indicar registros a mostrar dependiendo de
un valor condicional.
Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

SQL Select
Significa seleccin mediante instrucciones SQL. Cuando selecciona el SQL Select
como Data Source, se puede seleccionar de una a ms tablas, adems de
mostrar campos calculados. Puede incluir lo siguiente:

Criterio de seleccin (clausula Where)

Criterio de Sort u ordenamiento (clausula Order By)

Criterio de agrupamiento (clausula Group By y Having)

Query
Si el origen de Datos es una Consulta definida previamente en el rea de Trabajo
Query y ha sido almacenada como un objeto de Powerbuilder; escoger Query. Ud.
debe seleccionar la consulta que desee utilizar como Origen de Datos de este
Datawindows. Las consultas son instrucciones SQL que permiten acceder a los
registros de las tablas.

External
Si los datos no provienen de una B.D. , escoger External.
Esto incluye las siguientes situaciones:

Si los datos sern importados de un archivo externo, tal como un archivo

de texto (TXT) o archivo Xbase(DBF).

Si los datos sern importados de una aplicacin DDE.

Stored Procedure
Si el origen de datos es un procedimiento que ha sido almacenado en la Base de
Datos, escoger Stored Procedure. Los procedimientos almacenados son un
conjunto de instrucciones SQL que se graban dentro de una base de datos con
un nombre determinado y se pueden llamar y ejecutar desde cualquier
aplicacin.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

CREACION DE UN OBJETO DATAWINDOW

Seleccionar el icono New y seleccionar la hoja DataWindow, escoger el estilo de

presentacin, seleccionar para nuestra primera aplicacin el estilo Grid como se
muestra en la siguiente ventana:

Escoger una fuente de datos para el Objeto DataWindow. (Para el ejemplo se

escoger la fuente de datos SQL Select)

Luego aparecer una ventana de la cual se debe(n) seleccionar la(s) Tabla(s) que
estarn involucradas en el Datawindow, si este es nuevo.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

Se termina la seleccin presionando el botn Open y si desea cancelar la

seleccin presione el botn Cancel, luego de lo cual aparecer en forma grfica
la(s) Tabla(s) y tambin las relaciones existentes entre ellas. Si Ud. deseara
aadir nuevas tablas presione el botn

y seleccinela(s). Si Ud. deseara

extraer una tabla del Origen de datos, presione el botn derecho del mouse sobre
la representacin grfica de la Tabla y seleccione la opcin Close.
A continuacin seleccionar los campos con los que se trabajar en el
DataWindow. Para seleccionar los campos simplemente haga un clic sobre su
nombre en la representacin grfica de cada Tabla, aparecer en forma
enmarcada, si desea desmarcarla simplemente vuelva a hacer un clic sobre esta.
Si desea seleccionar todos los campos, dar click derecho sobre el nombre de la
tabla y Select All. Tambin podemos indicar el orden como aparecern los
campos en el DataWindow. Presionar del Power Bar el botn Return. Aparecer
una ventana en donde se pueden cambiar algunos atributos del objeto
DataWindow.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

Al presionar Next nos mostrar una ventana con el resumen del objeto
DataWindow. Presionar Finish y veremos la ventana del DataWindonw en donde
se puede mejorar la apariencia del ttulo y otros.
El objeto DataWindow tiene 2 partes: arriba, es donde hacemos el diseo es decir
en donde cambiamos el formato, ttulos, apariencia, y en la seccin de abajo es
donde tenemos la vista previa.

SECCIONES DE LA PRESENTACIN
Las secciones son reas donde pueden ponerse los objetos.

Cada seccin esta

delimitada por una barra horizontal, que tiene escrita el nombre de la seccin y
una flecha que apunta hacia el rea que corresponde a dicha seccin. Para
cambiar el largo de una seccin mantenga presionado el mouse sobre la barra
horizontal de esta y crrala hacia arriba o abajo; inmediatamente se agrandara el
rea correspondiente.
Las secciones son las siguientes.

Nombre

Descripcin

Header

Esta seccin se imprime en cada pagina que se origine

al momento de imprimir, y corresponde a un
encabezado de pagina.

Detail

Esta seccin se imprime para cada registro que

contenga la sentencia de Origen de Datos.

Summary

Esta seccin es utilizada cuando existan calculos , que

estn relacionados con campos del Origen de Datos
sean funciones agregadas de SQL.

Footer

Esta seccin se imprimir en cada pagina, y

corresponde a un pie de pagina.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza

Adicional a estas secciones estndar, existen 2 que son definidas por el usuario
al declarar un Grupo.

Nombre

Descripcin

Header Group

Esta seccin se imprime cada vez que cambie el valor

para el cual fue definido el grupo. Cada Grupo tiene
un nmero que lo identifica.

Trailer Group

Esta seccin es impresa cada vez que termina de

listarse los registros del Grupo.

Para ver las propiedades de la hoja de la presentacin, presione el botn derecho

del mouse estando este en un rea vaca de la presentacin. Estas propiedades
estn divididas en tres tpicos

Tpicos

Descripcin

General

Determina la unidad de medida para la presentacin,

el color de fondo de la presentacin.

Pointer

El tipo de puntero del mouse que ser utilizado

cuando este pase por encima del Area vaca de la
presentacin

Printer
Specification

Se definen las especificaciones al imprimir; como son

el tipo de papel, la Orientacin.

Luego que se le ha dado la apariencia deseada, guardar el Objeto DataWindow.

Escribir el nombre con el que se va a guardar el objeto datawindow, por ejemplo
d_1, seleccionar la librera en la que se va a grabar y hacer click en el botn ok.

MODIFICANDO UN DATAWINDOW EXISTENTE

Hacer click en el botn Open del Power Bar.

En Object Type seleccionar Datawindow.

A continuacin seleccionar de la lista de objetos Datawindows de la

librera el que se quiere modificar. En la ventana que aparecer a
continuacin modificar el datawindow seleccionado.

Luego que se han hecho las modificaciones respectivas, grabarlo.

Facultad de Ingeniera Industrial, Sistemas e Informtica

Ing. Ana Doris M. Barrera Loza