Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación 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 relación con el objeto datawindows y base de datos.
 Aplicar los objetos Datawindows en la creación de aplicaciones con base de datos.
 Conoces las funciones básicas de Datawindows.

Contenidos:
1) Objeto DataWindows: Concepto, creación y estilos de Datawindows.
2) Control Datawindows: Concepto, propiedades y conexión con el objeto datawindows.
3) Conexión de la aplicación con la base de datos.
4) Establecimiento de la transacción del Objeto Datawindows con Control Datawindows.
Manipulación de los datos desde la una ventana.
5) Funciones Datawindows.

OBJETO DATAWINDOWS.
Concepto:
Llamado también 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→ orígenes de
datos ODBC).
Este objeto se conecta a nivel de la aplicación con el Control Datawindows (Datawindows Control)
para que el usuario pueda realizar las transacciones con el objeto DataWindows.

¿Cómo se crea un DataWindows?

1. Clic en File→New→DataWindow

Administración de Bases de Datos -. Pág. 32 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

Ventana de estilos de datawindow.

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

Ventana de Orígenes de Datos.

Al activar la casilla Retrieve on Preview el datawindow mostrara la vista previa de los registros del
datawindow.
Seleccionamos Quick Select (selección rápida) y clic en Next.

Orígenes de Datos.
Quick Select.- Se usa cuando queremos seleccionar de manera sencilla y rápida los campos para el
DataWindow. Este tipo sólo 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.

Administración de Bases de Datos -. Pág. 33 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

SQL Select.- Selección mediante instrucciones SQL (Lenguaje de Estructurado de Consulta). Permite
mostrar campos calculados, seleccionar solo un grupo de registros, mostrar los registros ordenados,
hacer resúmenes 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 información 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
aplicación.
Web Service.- Accede desde un servidor web.

3. Ventana de Quick Select

En esta ventana seleccionamos las tablas de la BD. Si estas tablas están relacionadas aparecen
acompañados 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 botón Add All.
Además de seleccionar las tablas con sus respectivos campos definimos si los datos serán
ordenados con la opción Sort estableciendo algún criterio.

4. Ventana de propiedades básicas del objeto datawindow

Administración de Bases de Datos -. Pág. 34 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación 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 información que contiene los campos que se han seleccionado
en la datawindow.
Sumary: Este espacio está reservado en el caso quisiéramos añadir algunos datos de resumen
referido a esa página del reporte.

Administración de Bases de Datos -. Pág. 35 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

Footer: Es el pie de página 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 ejecución.

Administración de Bases de Datos -. Pág. 36 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

FREEFORM
Permite organizar la presentación 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 opción Radiobuttons:

Accelerator: Permite ingresar una letra la cual acompañada de la tecla ALT ubicará el cursor en
dicho campo a la hora de ejecutar la aplicación.
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: Varía la escala de visualización 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 opción CheckBox:

3 States: si se activa el checkbox tendrá 3 estados.
Left Text: Se utiliza para escribir el texto que acompaña 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.

Administración de Bases de Datos -. Pág. 37 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación 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 página, mientras que el encabezado sobre cada columna. A
diferencia del estilo grid no se puede cambiar la posicion de las columnas en tiempo de ejecución sólo
se realiza en tiempo de diseño.

CONTROL DATAWINDOW
CONCEPTO:
Es el contenedor para DataWindow Object en una aplicación 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 según 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.

Administración de Bases de Datos -. Pág. 38 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación 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 aplicación.
CONEXIÓN CON EL OBJETO DATAWINDOW.
Para conectar el control datawindow con el objeto datawindow se utiliza la propiedad DataObject.

CONEXIÓN DE LA APLICACIÓN CON LA BASE DE DATOS.

Escribir en el evento open de la aplicación 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 transacción 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 conexión a la base de datos. En el ejemplo la conexión
se realiza a base de datos librería cuya usuario (UID) es dba y la contraseña (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 conexión”+ “Codigo de error:”+ &

Administración de Bases de Datos -. Pág. 39 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

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

Halt Close
End if
CONNECT Esta instrucción realiza la conexión con la base de datos con los parámetros datos en la
propiedad DBMS y DBPAR, siempre al final se coloca punto y coma (;).

ESTRABLECIMIENTO DE LA TRANSACCIÓN DEL OBJETO DATAWINDOWS CON CONTROL

DATAWINDOWS. MANIPULACIÓN 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
creación. Se utiliza con la variable SQLCA porque es la variable que se utilizó en los eventos open de
la aplicación.
RETRIEVE.- Permite recuperar los registros en los DataWindow.

ESQUEMA DE UNA CONEXIÓN DE LA BASE DE DATOS CON UNA APLICACIÓN.

Windows Development
Environment

Application

ODBC Interface
PBODB12.DLL

ODBC Driver Manager

ODBC32.DLL

DRIVER DRIVER DRIVER

DATA DATA DATA

SOURCE SOURCE SOURCE

Administración de Bases de Datos -. Pág. 40 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

FUNCIONES BASICAS DE DATAWINDOWS

SetTransObject(sqlca).- Permite conectar el DataWindow con la base de datos física que utilizó para su
creación. 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_empleado.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 posición del cursor a la fila anterior (registro anterior) en el

datawindows. Ejemplo: dw_1.ScrollPriorRow()

ScrollNextRow(). -Cambia posición del cursor a la fila siguiente (registro siguiente) en el

datawindows. Ejemplo: dw_1.ScrollNextRow()

RowCount().- Devuelve el número 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_empleado.retrieve()
Obtiene los datos de la base en el dw_empleado, de la tabla que está asociada al
DataWindow

Reset().- Limpia los datos del DataWindow .

InsertRow().- Inserta una fila en un DataWindow en la posición especificada.

ejemplo: dw_empleado.InsertRow(0)
Inserta una fila en la posición 0

DeleteRow().- Elimina o borra una fila de la posición especificada de un DataWindow .

Ejemplo: dw_empleado.DeleteRow(5)
Borra la fila numero 5 del DataWindow dw_empleado
Si quiero borrar la fila actual escribo: dw_empleado.deleteRow(0)
Commit;.- Guarda , salva, o ejecuta los cambios que se hicieron en el DataWindow en la base física,
commit equivale a guardar.

Rollback;.- Cancela los cambios que se hicieron en el DataWindow , es decir no los graba en la
base física.

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_empleado.update()=1 then
commit;
else
rollback;
end if

Administración de Bases de Datos -. Pág. 41 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

AUTOEVALUACION
Diseñar la base de datos VENTAS y realice consultas y/o reportes valiéndose de datawindows grid,
tabular y freeform.

Administración de Bases de Datos -. Pág. 42 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.
Universidad Nacional del Santa Ingeniería de Sistemas e Informática Computación II

Administración de Bases de Datos -. Pág. 43 .- Mg. Carlos Eugenio Vega Moreno

con Power Builder.