Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

Actividad de Aprendizaje N 03

CONTROL Y OBJETOS DATAWINDOWS

Objetivos:

Conceptualizar y diferenciar los objetos y controles datawindows.

Conocer los estilos de objetos Datawindows.

Conocer el control datawindows y la relacin con el objeto datawindows y base de datos.

Aplicar los objetos Datawindows en la creacin de aplicaciones con base de datos.

Conoces las funciones bsicas de Datawindows.

Contenidos:
1) Objeto DataWindows: Concepto, creacin y estilos de Datawindows.
2) Control Datawindows: Concepto, propiedades y conexin con el objeto datawindows.
3) Conexin de la aplicacin con la base de datos.
4) Establecimiento de la transaccin del Objeto Datawindows con Control Datawindows.
Manipulacin de los datos desde la una ventana.
5) Funciones Datawindows.

OBJETO DATAWINDOWS.
Concepto:
Llamado tambin objeto transacciones porque sirve para recuperar, mostrar y editar datos de una
base de datos relacional o cualquier otra fuente u origen de datos. Este se conecta directamente con
la base de datos generando un DSN (Data Source Name), nombre de origen de datos, que es
controlado por el sistema operativo (Panel de control Herramientas administrativas orgenes de
datos ODBC).
Este objeto se conecta a nivel de la aplicacin con el Control Datawindows (Datawindows Control)
para que el usuario pueda realizar las transacciones con el objeto DataWindows.

Cmo se crea un DataWindows?

1. Clic en FileNewDataWindow

Administracin de Bases de Datos

con Power Builder.

-. Pg. 32 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

Ventana de estilos de datawindow.

2. Doble Clic en cualquier estilo disponible. Por ejemplo en Grid.

Ventana de Orgenes de Datos.

Al activar la casilla Retrieve on Preview el datawindow mostrara la vista previa de los registros del
datawindow.
Seleccionamos Quick Select (seleccin rpida) y clic en Next.

Orgenes de Datos.
Quick Select.- Se usa cuando queremos seleccionar de manera sencilla y rpida los campos para el
DataWindow. Este tipo slo permite mostrar en el DataWindow los campos de la tabla o tablas que se
han seleccionado sin poder mostrar campos calculados.
Los campos calculados son aquellos que no se encuentran en la tabla pero se pueden calcular y
obtener mediante los campos que si se encuentran en la tabla.

Administracin de Bases de Datos

con Power Builder.

-. Pg. 33 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

SQL Select.- Seleccin mediante instrucciones SQL (Lenguaje de Estructurado de Consulta). Permite
mostrar campos calculados, seleccionar solo un grupo de registros, mostrar los registros ordenados,
hacer resmenes de registros como, contar, sumar, etc.
Query(consulta).- Permite crear un DataWindow con una consulta creada previamente.
External.- Este tipo se utiliza cuando los datos que se va mostrar no se encuentran grabado en una
base de datos, pudiendo estar en un archivo de texto plano (*.txt).
Stored Procedure.- Muestra informacin que se obtiene mediante procedimientos almacenados.
Un procedimiento almacenado son un conjunto de instrucciones SQL que se pueden grabar dentro de
una base de datos con un nombre determinado y que se pueden llamar y ejecutar desde cualquier
aplicacin.
Web Service.- Accede desde un servidor web.

3. Ventana de Quick Select

En esta ventana seleccionamos las tablas de la BD. Si estas tablas estn relacionadas aparecen
acompaados de una flecha tal como se ve en la figura. Una vez seleccionado(s) la(s) tabla(s),
seleccionar los campos. Si queremos todos hacemos clic en el botn Add All.
Adems de seleccionar las tablas con sus respectivos campos definimos si los datos sern
ordenados con la opcin Sort estableciendo algn criterio.

4. Ventana de propiedades bsicas del objeto datawindow

Administracin de Bases de Datos

con Power Builder.

-. Pg. 34 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

Background Color: establece un color de fondo del datawindow.

Color: Permite establecer un color al texto (text, etiqueta del campo) o la columna (columns, datos
del campo).
Border: Permite establecer un Borde al texto (text, etiqueta del campo) o la columna (columns,
datos del campo).

5. Ventana resumen de las opciones seleccionadas.

6. Ventana del Objeto DataWindow

Header: aqu aparece el encabezado de las columnas. Por defecto asume como rotulo los
nombres de los campos pero este se puede modificar.
Detail: En esta rea se muestra la informacin que contiene los campos que se han seleccionado
en la datawindow.
Sumary: Este espacio est reservado en el caso quisiramos aadir algunos datos de resumen
referido a esa pgina del reporte.

Administracin de Bases de Datos

con Power Builder.

-. Pg. 35 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

Footer: Es el pie de pgina que nosotros consideremos para los reportes.

Preview: realiza una vista previa del datawindows.

7. Guardar Objeto DataWindow.

Clic File Save

Para nombrar a un objeto DataWindow se antepone el prefijo odw_

Estilos de DataWindow.
GRID
Muestra los datos en un reticulado de filas y columnas. El usuario puede reordenar las columnas en
tiempo de ejecucin.

Administracin de Bases de Datos

con Power Builder.

-. Pg. 36 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

FREEFORM
Permite organizar la presentacin de los datos en forma de ficha. Se utiliza para las ventanas de
entrada de datos. Las etiquetas de las columnas se ubican a lado izquierdo de los datos. Se utiliza
para formularios de ingreso de datos.

Propiedades del Style Type opcin Radiobuttons:

Accelerator: Permite ingresar una letra la cual acompaada de la tecla ALT ubicar el cursor en
dicho campo a la hora de ejecutar la aplicacin.
3D Look: Si se activa, los radiobuttons se mostraran en tres dimensiones.
Left Text: Si se activa, el texto se mostrar a la izquierda de cada radiobutton.
Scale Code: Vara la escala de visualizacin de los radiobuttons.
Column Across: Se utiliza para indicar la cantidad de radiobuttons que desea mostrar.
Code Table: Permite escribir el texto que desea mostrar con los radiobuttons (Display Data) y el valor
que se debe grabar cuando se seleccione cada uno de ellos (Data Value).

Propiedades del Style Type opcin CheckBox:

3 States: si se activa el checkbox tendr 3 estados.
Left Text: Se utiliza para escribir el texto que acompaa al control Check Box.
Data Value For On: Se utiliza para indicar el valor que se grabar cuando el check este
seleccionado.
Data Value For Off: Se utiliza para indicar el valor que se grabar cuando el check no este
seleccionado.

Administracin de Bases de Datos

con Power Builder.

-. Pg. 37 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

TABULAR
Es similar al tipo Grid ya que muestra los datos en formato tabla (filas y columnas). Los datos de
cada columna aparecen en toda la pgina, mientras que el encabezado sobre cada columna. A
diferencia del estilo grid no se puede cambiar la posicion de las columnas en tiempo de ejecucin slo
se realiza en tiempo de diseo.

CONTROL DATAWINDOW
CONCEPTO:
Es el contenedor para DataWindow Object en una aplicacin PowerBuilder. Se utiliza para presentar
datos de manera interactiva; para visualizar, cambiar datos y enviar los cambios a la base de datos.
Este control se inserta desde el cuadro de controles donde se encuentra ubicado tal como se indica
en la figura.

PROCEDIMIENTO PARA ADMINISTRAR Y

PRESENTAR DATOS DE UN OBJETO EN UN
CONTROL DATAWINDOWS.
1. Dibujar en una ventana el control datawindows.
2. Conectar el control DataWindow con el objeto
datawindow.
3. Conectarse a la base de datos desde donde se ha
creado el objeto datawindow.
4. Escribir instrucciones para recuperar y presentar
datos en el control datawindow.

PROPIEDADES
Name: Aqu aparece el nombre por defecto del control datawindows dw_1; nosotros podemos
asignar un nombre segn nuestro mejor parecer pero siempre con el prefijo dw_
Por ejemplo: dw_cursos, dw_articulos,dw_planilla
DataObject: en esta propiedad asignamos el nombre del objeto datawindows.
RichText Toolbar Activation Mode. Establece el modo de activacion de la barra de herramientas de
texto enriquecido.

Administracin de Bases de Datos

con Power Builder.

-. Pg. 38 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

Title: Permite asignar un texto que aparecera como titulo del control datawindow si es que la
propiedad Title Bar se activa.
Tag: Permite asignar un texto en el DataWindow para poder utilizarlo en su aplicacin.
CONEXIN CON EL OBJETO DATAWINDOW.
Para conectar el control datawindow con el objeto datawindow se utiliza la propiedad DataObject.

CONEXIN DE LA APLICACIN CON LA BASE DE DATOS.

Escribir en el evento open de la aplicacin la siguiente linea de codigo:
sqlca.DBMS="ODBC"
sqlca.DBParm="ConnectString='DSN=libreria;UID=dba;pwd=sql'"
connect;
open(w_estilosodw)

SQLCA variable de tipo transaccin que permite conectarse con una base de datos utilizando dos
propedades basicas: ODBC y DBParm y opcionalmente SQLCODE.
La propiedad DBMS Indica el tipo de base de datos a la cual se conecta, es ODBC si se a creado
con SQLAnywhere de powerbuilder.
La propiedad DBParm indica la cadena de conexin a la base de datos. En el ejemplo la conexin
se realiza a base de datos librera cuya usuario (UID) es dba y la contrasea (pwd) es sql.
La propiedad SQLCODE devuelve un valor que indica si el acceso a la base de datos o a
cualquiera de sus objetos fue exitoso o no. Los valores son cero (0), indica xito y el valor -1 indica
un error.
Ejemplo:
If sqlca.SQLCODE=-1 then
MessageBox(BD Libreria,Error en la conexin+ Codigo de error:+ &

Administracin de Bases de Datos

con Power Builder.

-. Pg. 39 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

string(SQLCA.sqlDbcode)+ Error de mensaje: +SQLCA.sqlErrText,StopSign!)

Halt Close
End if
CONNECT Esta instruccin realiza la conexin con la base de datos con los parmetros datos en la
propiedad DBMS y DBPAR, siempre al final se coloca punto y coma (;).

ESTRABLECIMIENTO DE LA TRANSACCIN DEL OBJETO DATAWINDOWS CON CONTROL

DATAWINDOWS. MANIPULACIN DE LOS DATOS DESDE LA UNA VENTANA.
Escribir el siguiente codigo en el evento open de la ventana que contiene el datawindows.
dw_1.SetTransObject(sqlca)
dw_1.Retrieve()

SETTRANSOBJECT.- Permite conectar el Datawindow con la base de datos que utiliz para su
creacin. Se utiliza con la variable SQLCA porque es la variable que se utiliz en los eventos open de
la aplicacin.
RETRIEVE.- Permite recuperar los registros en los DataWindow.

ESQUEMA DE UNA CONEXIN DE LA BASE DE DATOS CON UNA APLICACIN.

Windows Development
Environment
Application
ODBC Interface
PBODB12.DLL

ODBC Driver Manager

ODBC32.DLL

DRIVER

DRIVER

DATA
SOURCE

DATA
SOURCE

Administracin de Bases de Datos

con Power Builder.

DRIVER

DATA
SOURCE

-. Pg. 40 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

FUNCIONES BASICAS DE DATAWINDOWS

SetTransObject(sqlca).- Permite conectar el DataWindow con la base de datos fsica que utiliz para su
creacin. Ejemplo: dw_1.SetTransObject(sqlca)
ScrollToRow().- Desplaza el cursor a una fila o registro determinado. Despliega el control de un
DataWindow a la fila especificada, no importa si esta se la ve o no en el DataWindow.
Ejemplo: DataWindow_maestro.ScrollToRow(5)
Mueve la fila o enfoca la fila 5 del DataWindow, no importa si la fila no se la ve el
DataWindow, mueve el puntero donde esta se encuentra.
ScrollPriorRow().- Cambia posicin del cursor a la fila anterior (registro anterior) en el
datawindows. Ejemplo: dw_1.ScrollPriorRow()
ScrollNextRow().-Cambia posicin del cursor a la fila siguiente (registro siguiente) en el
datawindows. Ejemplo: dw_1.ScrollNextRow()
RowCount().- Devuelve el nmero de filas que tiene el datawindows.
Ejemplo:
Integer filas
Filas=dw_1.RowCount()
Retrieve().- Obtiene las filas de una Base De Datos para presentarlo en un DataWindow
Ejemplo: dw_maestro.retrieve()
Obtiene los datos de la base en el dw_maestro, de la tabla que est asociada al
DataWindow
Reset().- Limpia los datos del DataWindow .
InsertRow().- Inserta una fila en un DataWindow, en la posicin especificada.
ejemplo: dw_maestro.InsertRow(0)
Inserta una fila en la posicin 0
DeleteRow().- Elimina o borra una fila de la posicin especificada de un DataWindow .
Ejemplo: dw_maestro.DeleteRow(5)
Borra la fila numero 5 del DataWindow maestro
Commit;.- Guarda , salva, o ejecuta los cambios que se hicieron en el DataWindow en la base fsica,
commit equivale a guardar.
Rollback;.- Cancela los cambios que se hicieron en el DataWindow , es decir no los graba en la
base fsica.
Update().- Determina si los datos del DataWindow han sido modificados, retorna 1 si los datos han
sido modificados y -1 si estos no son actualizados.
Actualiza la Base De Datos con los cambios hechos en el control del DataWindow . Ejemplo:
if dw_maestro.update()=1 then
commit;
else
rollback;
end if

Administracin de Bases de Datos

con Power Builder.

-. Pg. 41 .-

Mg. Carlos Eugenio Vega Moreno

Universidad Nacional del Santa

Ingeniera de Sistemas e Informtica

Computacin II

AUTOEVALUACION
EJERCICIO DE APLICACION.
Dado la siguiente base de datos

Administracin de Bases de Datos

con Power Builder.

-. Pg. 42 .-

Mg. Carlos Eugenio Vega Moreno