Computacin II Ing.

Sistemas e Informtica Datawindows

DATAWINDOWS
Un datawindows es una sentencia SQL que est 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:
a. Origen de Datos:
Corresponde a la sentencia SQL, la que podr tener caractersticas de Agrupamiento, Ordenamiento,
Condicionales (extraer un conjunto definido de registros).
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 para presentar datos, ingresar datos,
listarlos o imprimirlos; tal y como aparecen en esta hoja.

Seleccin Tipo y Presentacin

Para trabajar con las Datawindows presione el botn , luego de lo cual aparecer la ventana de
seleccin; podr seleccionar una ya existente, para modificarla, o presionar el botn New para crear
una nueva Datawindows.
Si presiona el botn New deber seleccionar el modo de trabajo para el Origen de datos y tambin el tipo
de Presentacin.

Modos de trabajo:
El modo de trabajo define como se trabajara con el Origen de Datos. Existen 5 tipos de Modos de trabajo

Modo Descripcin
No presenta las tablas en forma grfica, y solo permite las sentencias
ordinarias de SQL (Sort y Criterio). La primera para poder ordenar por el
Quick Select
campo especifico y la segunda para indicar registros a mostrar
pedendiendo de una valor condicional.

Presenta las tablas en forma grfica, y permite trabajar con todas las
Sql Select caractersticas de Sql estndar (Sort, Group, Having, Compute y Where,
entre otros).

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 1

Computacin II Ing. Sistemas e Informtica Datawindows

El origen de Datos esuna Consulta definida previamente en el Area de

Trabajo Query; esta consulta queda almacenada como un objeto de
Query
Powerbuilder; Ud. debe seleccionar la consulta que desee utilizar como
Origen de Datos de este Datawindows.

El origen de datos no esta relacionado con ninguna Tabla. Ud. debe

definir los campos que interactan (nombre, tipo y largo) Utilice los
External botones Add para aadir un nuevo campo al final de los ya existentes, el
botn Insert le permitir insertar un campo entre otros y el botn
Delete le permitir eliminar el campo actual.

Stored El origen de datos es un procedimiento que ha sido almacenado en la

Procedure Base de Datos. Seleccione uno si lo ha creado, o crelo previamente.

Tipos de presentacin
El Tipo de presentacin define como se presentaran los datos en el DataWindows, existen 11 tipos de
presentacin las que son:

Presentacin Descripcin
Composite Utiliza como presentacin un reporte previamente creado.

Freeform La presentacin es libre, donde cada campo esta en una lnea

distinta. Muy utilizado para el ingreso de datos.

Graph Disea un grfico dependiendo de una consulta, esta debe

contener datos relacionados.
Grid Disea una malla de datos en forma columnada, y cada columna
con una justificacin completa.
Group Disea listado por agrupacin de campos. Muy
utilizado para reportes de resumen de informacin.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 2

Computacin II Ing. Sistemas e Informtica Datawindows

El diseo es de etiquetas, donde Ud. podr elegir el tipo de

etiqueta de las prediseadas, en papel
continuo o separado, y otras opciones.
Rich Text Permite definir una carta con combinacin de campos del Origen
de datos fijado. Se pueden utilizar todas las caractersticas del
formato de texto RTF.
Tabular Presenta el origen de datos en forma columnada pero sin ajuste
total. Permite una mayor libertad en el diseo.

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

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 se deseara aadir nuevas tablas presione el botn y seleccinela(s).

Si se 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.
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.

Utilizacin
El objeto datawindows en si no es de ninguna utilidad, si no se vincula con un objeto Datawindow
control. Este objeto, es visual y es posible de insertar directamente en una ventana; para que
pueda ser utilizado por el usuario.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 3

Computacin II Ing. Sistemas e Informtica Datawindows

Objeto Datawindow Control

El objeto Datawindow Control se selecciona del listado de objetos que se pueden insertar en

una ventana, simplemente haga un clic sobre el icono

Luego haga un clic en la posicin, en la ventana, donde desea poner el Datawindow control.

Haga doble clic sobre el objeto Datawindows que esta ahora en la ventana, o bien presione el botn,
teniendo seleccionado el objeto, para ver las propiedades que posee.

Propiedades del Objeto

Propiedad Descripcin
Name Es el nombre que tendr el objeto Datawindow Control.

Datawindow Escriba el nombre del objeto Datawindow que ser

mostrado en este Datawindow control. Para seleccionar un
Datawindow presione el botn "Browse".

Title Escriba el texto que aparecer en la barra de titulo, si esta marcada

la opcin TitleBar.
TitleBar Si esta opcin esta marcada, el texto que este en la caja Title se
mostrara como una barra de titulo.
Control Si esta opcin est marcada, permite que el Datawindow Control, sea
Menu un objeto flotante (pudiendo moverse) dentro de los limites de la
ventana que lo contiene.
Maximize Permite que el Datawindow control, presente los
box botones Maximizar y Minimizar, respectivamente.
Minimize
box

Manejo de Datawindow Control

Para hacer uso del Datawindow Control en tiempo de ejecucin es necesario indicar que objeto de
transaccin ser utilizado por el Datawindow para presentar la informacin definida en el. Esto se hace,
con la siguiente funcin:
<nom Dw>.SetTransObject(<obj transac>)
Donde:
<nom Dw> es el nombre del Datawindow Control.
<obj transac> es el objeto de transaccin, por defecto utilice SQLCA.

Esta sentencia debe escribirse antes de hacer uso del Datawindow Control, normalmente se pone en
el Evento "Open" de la ventana que contiene al Datawindow Control.
Ej.
dw_inicio.SetTransObject( sqlca )

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 4

Computacin II Ing. Sistemas e Informtica Datawindows

Para obtener datos de la Base de Datos, y mostrarlos en el Datawindow Control, se utiliza la

siguiente funcin:
<nom Dw>.Retrieve (<lista parametros>)
Donde:
<nom Dw> es el nombre del Datawindow Control.
<lista parmetros>, si para el Origen de Datos (del Datawindow), se definieron argumentos,
deben listarse los valores a utilizar por cada uno en el mismo orden en que fueron definidos y
separados entre si por una coma. Los argumentos se escriben como literales, sin comillas para
los argumentos de tipo texto.
Ej.
dw_nuevo.Retrieve( Contabilidad, sle_edad.text )

Para modificar en tiempo de ejecucin el datawindow que esta vinculado al Datawindow

Control, utilice la siguiente funcin:

<nom Dw>.DataObject= <nombre obj Dw>)

Donde:

<nom Dw> es el nombre del Datawindow Control.

< nombre obj Dw >, es el nombre de un objeto Datawindow definido. Si el objeto
Datawindow vinculado al Datawindow Control, es necesario nuevamente, indicar el objeto de
transaccin que se utilizara para este Datawindow y volver a ocupar la funcin Retrieve, para
obtener los datos de esta nuevo Datawindow.
Ej.
dw_nuevo.DataObject= d_otro

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 5

Computacin II Ing. Sistemas e Informtica Datawindows

Funciones para el manejo:

Aadir
Para aadir un nuevo registro se utiliza la siguiente funcin:
<nom Dw>.InsertRow(<pos>) Donde:
<nom Dw> es el nombre del Datawindow Control.
<pos> Es la posicin, dentro del nmero de registros mostrados en el Datawindow
Control, donde se insertara el nuevo registro. Si <pos>= 0, aade un registro al final de
los ya existentes. El aadir un registro, para ser llenado los datos de los campos por el
usuario, no implica que el foco se mueva a este nuevo registro.

Ej. dw_nuevo.InsertRow(1)

Eliminar
Para eliminar un registro debe conocer cual es la posicin, dentro del nmero de registros
mostrados en el Datawindow Control, del registro a eliminar.
Esto se hace, con la siguiente funcin:

<nom Dw>.DeletedRow(<pos>) Donde:

<nom Dw> es el nombre del Datawindow Control.
<pos> es la posicin del registro a eliminar. Si desea Eliminar el registro donde est el foco
(cursor actualmente), utilice la siguiente funcin:
<nom Dw>.GetRow( )

Ej.
dw_nuevo.DeletedRow( dw_nuevo. GetRow( ) )

Buscar
Permite buscar un registro, dentro de los listados en el Datawindow Control, que coincida con
la expresin definida. Para esto utilice la siguiente funcin:
<nom Dw>.Find(<expre cond>) Donde:
<nom Dw> es el nombre del Datawindow Control.
< expre cond > es una expresin que se escribe igual que una expresin Where. Esta funcin
devuelve la posicin del registro que cumpla con la condicin, o un cero si no encuentra ninguno.

Ej.
integer pos
pos= dw_nuevo.Find("rut= " + sle_rut.text + "")

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 6

Computacin II Ing. Sistemas e Informtica Datawindows

Filtrar Registros
Esto significa que del conjunto de registros que muestra el Datawindow Control en forma habitual,
solo se mostraran los que cumplan con cierta condicin. Quedando los otros invisibles, pero presentes en
el Datawindow Control. Para esto posee de dos funciones, la primera para definir una filtro, y la segunda
para ejecutar el filtrado definido.

Definir Filtro: Si desea modificar el filtro definido en la "Presentacin" del Datawindow, o crear un
nuevo filtro, utilice la siguiente funcin:

<nom Dw>.SetFilter(<expre cond>) Donde:

<nom Dw> es el nombre del Datawindow Control.
< expre cond > es una expresin que se escribe igual que una expresin Where.

Ejecutar Filtro: Para realizar el filtrado en el Datawindow Control, utilice la siguiente funcin:

<nom Dw>.SetFilter( )
Donde: <nom Dw> es el nombre del Datawindow Control.

Ej.
dw_nuevo.SetFilter("Edad>21")
dw_nuevo.SetFilter( )

Actualizar Base de Datos

Debe indicrsele que traspase la informacin modificada/eliminada/ actualizada, desde el Datawindow
Control a la Base de Datos.
Para esto utilice la siguiente funcin:

<nom Dw>.Update( )
Donde: <nom Dw> es el nombre del Datawindow Control. Esta funcin
devuelve un valor, -1 si un error ocurrio

Ej.
If dw_nuevo. Update( ) <> -1 then
Commit ;
Else
Rollback ;
End If

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 7

Computacin II Ing. Sistemas e Informtica Datawindows

EVENTOS
El Objeto Datawindow Control tambin posee eventos, los ms comunes son los siguientes:

Evento Descripcin
RowFocusChanged Sucede cuando el foco cambia de un registro a otro,
no de un campo a otro dentro del mismo registro.
Tambin sucede cuando se obtienen datos (Retrieve) de la
Base de Datos.
ItemChanged Ocurre cuando el usuario un campo ha sido modificado y
este campo pierde el foco ( presionar tecla Enter, tecla Tab,
o movindose a otro campo cualquiera). Tambin ocurre
cuando se utiliza la funcin AccepText o la funcin
Update.

Definicin de SQLCA
SQL Communications Area(SQLCA) es un objeto transaccional. Un objeto transaccional es el rea de
comunicacin entre el script (lugar donde se programa un evento) y la base de datos. PowerBuilder define
este tipo de objeto para facilitar la comunicacin con la base de datos desde el cdigo de programacin.
Este objeto es accesado por default, cada vez que se utiliza una sentencia SQL dentro de un script.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 8

Computacin II Ing. Sistemas e Informtica Datawindows

CONEXION DE BASES DE DATOS CON POWER BUILDER Y USO DE

DATAWINDOWS
1. Una vez, que se encuentre dentro del power builder, seleccionar el icono de DataBase
2. Dentro de la ventana de base de datos, seleccionar la carpeta de Uitilities y expandir.

3. Seleccionar la opcin Create ASA Database y realizar doble clic, se activar la siguiente pantalla.

4. Seleccione el botn Browse, busque la carpeta en donde desea grabar su base de datos, indique el
nombre de la misma, y realice un clic sobre el botn Guardar.
5. Dentro de la ventana Create Adaptive Server Anywhere DataBase, Seleccione el botn Ok
6. Una, vez que se haya creado, se observar que dentro de la base de datos ODBC, se agrego la nueva
conexin que se ha creado.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 9

Computacin II Ing. Sistemas e Informtica Datawindows

7. Si se desea cambiar el nombre de la conexin, realice doble clic sobre la conexin.

8. En la ventana que se activa, seleccione Profile Name, e ingrese el nuevo nombre de la conexin.
Ejemplo (Conexin_Alumnos) y seleccione el botn Ok

La conexin, se mostrar con

el nuevo nombre creado.
Luego expanda la nueva
conexin.

9. Si se desea crear tablas de datos, dentro de la conexin creada, seleccione la carpeta Tables y realizar
un clic con el botn derecho.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 10

Computacin II Ing. Sistemas e Informtica Datawindows

10. En la ventana de diseo de tablas, ingresar el nombre del campo, tipo de dato y ancho del mismo

11. Para grabar la nueva tabla de datos, seleccione el icono de guarda, en la ventana que se activa, ingrese
el nombre de la tabla y seleccione el botn Ok.

12. Expanda la carpeta Tables y ver que la nueva tabla se ha agregado a la lista de tablas.

13. Para crear un ndice (Llave Principal) dentro de la tabla creada, seleccione la tabla, realice un clic con el
botn derecho, seleccione New, y luego Primary Key.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 11

Computacin II Ing. Sistemas e Informtica Datawindows

14. En la ventana de Primary Key (Conexin_Alumnos), Active el check del campo, del cual desea crear el
ndice principal y luego grabe la tabla de datos.

15. Dentro de la ventana Object Layout, se mostrar la tabla de datos, con su clave creada, tal como se
muestra a continuacin.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 12

Computacin II Ing. Sistemas e Informtica Datawindows

Cree la tabla Datos_Alumnos, de la misma manera, el diseo es el siguiente:

La llave principal ser Codigo_Alumno.

Al terminar de crear se deber de mostrar las dos tablas creadas, cada una con sus respectivas
llaves creadas, tal como se muestra a continuacin

Claves Forneas (Foreign Key)

Las Clave fornea es una combinacin de una o mas columnas de una tabla que sirven para identificar a una
o mas columnas de otra tabla, una clave fornea, relaciona informacin de dos tablas. Una tabla puede
contener varias claves forneas, ya que su informacin puede estar relacionada con mas de una tabla.
Crear una clave fornea para la tabla Datos_Alumnos.
1. Seleccione la tabla Datos_Alumnos, dentro de la carpeta Tables, dar un clic con el botn derecho, en
el men que se activa, seleccionar New, seguido de Foreign Key.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 13

Computacin II Ing. Sistemas e Informtica Datawindows

2. En la ficha general de Foreign Key, ingresar el nombre de la clave (Foreign Key, puede ser el mismo
nombre del campo) y seleccionar el campo Forneo (Codigo_Especialidad) y el la ficha Primary
Key, seleccionar la tabla (Table), de donde viene el campo forneo (Especialidades) y activar el
campo principal (Codigo_Especialidad)

3. Despus de haber creado la clave fornea, grabar la tabla.

4. En la venta de Layout, se mostrar las dos tablas con su respectiva llave, tal como se muestra a
continuacin.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 14

Computacin II Ing. Sistemas e Informtica Datawindows

Crear una consulta que muestre los datos de la tabla Especialidades.

1. Seleccione el icono New del PowerBar1

2. Dentro de la ventana New, seleccionar la ficha Database, opcin Query y pulsar el botn Ok.

3. Seleccionar la tabla de donde se desea crear la consulta de datos (Especialidades) y pulsar el botn
Open.

4. Seleccionar los campos que se incluirn en la Consulta.

Campos Seleccionados
en la consulta
Tabla
seleccionada
para la consulta

5. Para realizar una presentacin preliminar, realice un clic sobre el icono , para salir de la vista,

seleccione el siguiente icono .

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 15

Computacin II Ing. Sistemas e Informtica Datawindows

6. Grabe la consulta, seleccionando el siguiente icono .

Consulta con Parmetros o Argumentos. Son consultas que retornan datos de acuerdo a un parmetro
o argumento ingresado.

Crear una consulta que muestre los datos de tabla especialidades, de acuerdo al cdigo de especialidad
ingresado.

1. Repetir los 5 procedimientos anteriores.

2. Estando dentro de la venta de diseo de consultas, seleccione Design

de la barra de men, seguido de la opcin Retrieval Arguments...

3. En la ventana que se activa (Especyfi Retrieval Arguments...), ingresar el nombre de la variable

(Cod_Esp) a crear, especifique el tipo de dato para el mismo (String), luego seleccione el botn OK

4. Seleccione la columna (Column) que se relacione con el Argumento. (Codigo_Especialdad), luego el

operador (=) y el valor (Value) , en este caso como valor ira el argumento que se ha creado, para lo
cual realice un clic con el botn derecho sobre este casillero, seleccione la opcin Arguments.., en la
ventana que se activa seleccionar el argumento creado (en este caso Cod_Esp), luego pulse el botn
Paste. Deber de quedar de la siguiente manera,

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 16

Computacin II Ing. Sistemas e Informtica Datawindows

5. Al realizar una presentacin preliminar , se activar una ventana en donde tendr que ingresar el
valor para el argumento que se ha creado. Ingresar el valor y pulsar el botn OK

Tal como se muestra en el

ejemplo, se mostrarn los datos,
de acuerdo a valor ingresado
(Argumento)

6. Para salir de la consulta, seleccione el siguiente icono .

7. Grabe la consulta, seleccionando el siguiente icono .

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 17

Computacin II Ing. Sistemas e Informtica Datawindows

Crear una consulta relacionando dos tablas de datos. Cuando una tabla de datos contiene campos de
otras tablas (Llaves forneas), como es el caso de la tabla Datos_Alumnos, es recomendable relacionarla
con la tabla principal (Especialidades) tal como se vio en clases anteriores.

Si se desea crear una consulta de la tabla Datos_Alumnos, y que muestre el nombre de la especialidad en
el campo Codigo_Especialidad, las dos tablas tendrn que estar relacionadas.

1. Seleccione el icono New del PowerBar1

2. Dentro de la ventana New, seleccionar la ficha Database, opcin Query y pulsar el botn Ok.

3. Seleccionar las tablas de donde se desea crear la consulta de datos (Dastos_Alumnos y

Especialidades) y pulsar el botn Open.

4. Seleccionar todo los campos de la tabla Datos_Alumnos a excepcin del campo

Codigo_Especialidad, y de la tabla Especialidades, seleccionar el campo Nombre_Especialidad.

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 18

Computacin II Ing. Sistemas e Informtica Datawindows

Indica que estas dos tablas

estn relacionadas por los
campos que indican las
lneas

5. Al realizar una presentacin preliminar , se mostrara que cada alumno aparece con el nombre de la
especialidad a donde pertenece, y no el codigo_especialidad que se encuentra en la tabla
Datos_Alumnos, esto se debe a la relacin que existe entre las dos tablas.

Datos Datos Datos Datos

6. Para salir de la consulta, seleccione el siguiente icono .

7. Grabe la consulta, seleccionando el siguiente icono .

Ing. Mirko Manrique Ronceros mirko.manrique@hotmail.com 19