Universidad de Chiclayo

Filial Jan
POWER BUILDER
CONCEPTO
PowerBuilder es un medio ambiente grfico de desarrollo de
aplicaciones

cliente/servidor.

Usando

PowerBuilder,

se

puede

desarrollar fcilmente poderosas aplicaciones grficas orientadas al

objeto, que accesan bases de datos locales o en el servidor, haciendo
pleno uso de una atractiva interfaz de usuario (GUI). Powerbuilder
proporciona las herramientas necesarias para crear todo tipo de
aplicaciones.
APLICACIN GUI
Todas las aplicaciones GUI (graphical user interface) lucen de un
modo similar. Esto significa que la apariencia, caractersticas y
funcionamiento de los diferentes objetos que forman una aplicacin,
por

ej:

mens,

ventanas,

cajas

de dilogo

botones

estn

estandarizadas. De esta manera, la aplicacin se provee de una

consistencia visual que la hace atractiva y fcil de usar.
APLICACIN POWERBUILDER
La interfaz de usuario de una aplicacin PowerBuilder consiste de
mens y ventanas con las cuales interacta el usuario. Las
aplicaciones PowerBuilder pueden incluir todos los controles windows
standard, tales como: buttons, checkboxes, dropdown listboxes y edit
boxes, as como controles especiales PowerBuilder que permiten que
las aplicaciones sean fciles de desarrollar y usar.
QU ES DATAWINDOWS?
Es un objeto encargado de la manipulacin de los datos. El
datawindows control es en realidad una interfaz para que el usuario
vea los datos, pero el encargado de manipular, recuperar, guardar,
etc. (todo lo que tenga que ver con el manejo de los datos) es el

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
objeto no visual que es usado dentro del datawindows control, y que
es el mismo objeto que usa un datastore. Tambin se puede
considerar como una ventana de datos que se usa para la
recuperacin, manipulacin y muestra de informacin.
Ventajas Principales de DataWindows
Su construccin requiere poco o nada de conocimiento de SQL.
Para construir un DataWindow Object, se especifica grficamente
la informacin que se desea recuperar desde la base de datos,
seleccionando tems en un pintor de DataWindow. La sentencia
SQL se genera automticamente.
Los DataWindows reducen el nmero de recursos de sistema
requeridos para representar datos en forma de tablas o reportes.
Los DataWindows poseen una amplia gama de caractersticas de
reporte, incluyendo.
Eventos de DataWindows
Descripcin

Evento
Clicked

El usuario ejecuta un click con el ratn.

Este evento est presente en casi todos los objetos de

Constructor

PowerBuilder. Se ejecuta cuando el sistema acaba de

crear
el objeto.
Ha
ocurrido
un error de base de datos. Util para capturar

DbError
Destructor
EditChanged
Error

errores de la base de datos y tratarlos segn nuestro

criterio.
El
sistema destruye los objetos, normalmente al cerrar una
ventana.
Cada vez que el usuario pulsa una tecla y modifica un
carcter del contenido de un campo.
Se produce un error de validacin en un campo.
El usuario ha modificado un campo e intenta cambiar de

ItemChanged

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 producido un itemchanged pero los datos que

ItemError

contiene el campo no pasan las

reglas de validacin

introducidas en el datawindow object.

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
ItemFocusChan
ged
RetrieveEnd
RetrieveRow
RetrieveStart
RowFocusChan
ged
SqlPreview
Retrieve
UpdateEnd
UpdateStart

El usuario cambia de campo.

Ha finalizado una instruccin retrieve (consulta a la base
de datos).
Mientras se est ejecutando una instruccin retrieve y
recuperamos cada una de las filas.
Antes de que se lance la instruccin SQL Select contra la
base de datos.
El foco cambia de fila. Cuidado con esta instruccin
porque se ejecuta por s sola cuando

hacemos un

insert,vez
un delete
o un retrieve.
Cada
que ejecutamos
funciones de PowerBuilder que
afectan a la base de datos.
Update, etc. Muy til para depurar el sql que se est
generando.
Ha finalizado la actualizacin de la base de datos.
Antes de que empiece la actualizacin de la base de datos.

Funciones principales de un Datawindows en Power Builder

Hola amigos este dia traigo las funciones mas comunes de los
Datawindows de Power Builder que encontre en una pagina de
internet...
espero les sean de ayuda:
SetTransObject
Hace que un control DataWindow use un objeto de transaccin
especificado por el programador. El objeto de transaccin proporciona
la informacin nesecesaria para comunicarse con la Base de Datos.
Retorna -1 si ha ocurrido un error.
Sintaxis Dwn. Settransobject(Transaccin)
Argumen
t

Description

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
El nombre del Control data window, con el cual se

Dwn

desea usar un objeto de transaccin.

Transacci Nombre del Objeto de transaccin, por defecto es

n
SQLCA.
Generalmente se establece el objeto de transaccin en el evento
Open de la ventana que contiene el control DataWindow.
En resumen el SettransObject(SQLCA) asocia el objeto transacin con
el control DataWindow.
Ejemplo:
DwnSoftware.settransobject(SQLCA)
InsertRow
Sintaxis Dwn.InsertRow(fila)
Argumen
t
Dwn

Descripcion
El nombre del control DataWindow en el cual se desea
insertar una fila.
Un entero Largo (long) que identifica la fila antes de la

Fila

cual desea insertar una fila nueva. Si el valor es cero

insertar al final de la tabla.

Ejemplo:
DwnSoftware.InsertRow(0)
Retrieve()
Recupera todas las filas de una tabla de la BDD en un control
DataWindow, Si incluyen argumentos, estos son usados por los
argumentos de recuperacion de la sentencia SQL SELECT del objeto
DataWindow. Retorna el nmero de filas recuperadas, -1 si ocurre un
error.
SintaxisDwn.Retrieve({Arg1, Arg2,})
Argument Descripcion
Arg1, Arg2 Argumentos de recuperacion, de la tabla de BDD
Ejemplo:
DwnSoftware.Retrieve(C001)

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
SetRowFocusIndicator
Especifica el indicador visual que identifica la fila actual en un control
DataWindow.
Sintaxis Dwn.SetRowFocusIndicator (Indicador)
Indicador El indicador visual para la fila actual, los valores validos son
Off!
Sin indicador.
FocusRe Un rectangulo de puntos alrededor de
ct!
Hand!

la fila.
Un dedo indice.
El nombre de un Picture Control.

SelectRow
Selecciona la fila especificada en el control de un DataWindows.
Sintaxis Dwn.SelectRow (Fila, Boolean)
Ejemplo:
DwnSoftware.SelectRow(0,False) // desactiva la fila anterior
DwnSoftware.SelectRow(15,true) // resalta toda la fila 15
SetItem
Establece el valor en una fila y columna especificada, un valor dentro
del datawindow, retorna -1 si ocurre un error.
Sintaxis DwnSoftware.Setitem (Fila, columna/campo, valor)
Ejemplo:
Dwn.SetItem(5, "sueldo",670)
En la fila 5, en el campo sueldo se asigna 670.
Tambin en vez del nombre de campo, puede ser el nmero de campo
de acuerdo como ha sido seleccionado en el objeto DataWindow.
GetItemString
Obtiene datos de tipo cadena de un buffer especificado de un control
DataWindow.
SintaxisDwn.GetitemString (Fila, Columna)
Ejemplo
String cad
Cad=DwnSoftware.GetItemString(3, "sfw_Nombre")

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
Extrae el dato que se encuentra en el campo sfw_nombre, en la fila 3,
dependiendo del tipo de dato que se va extraer tenemos:
Dwn.GetitemNumber
(Fila, columna)

Cuando el campo es de manera

general numrico, puede ser real o
entero.

Dwn.GetitemDecimal

Cuando

(Fila, columna)

exclusivamente decimal o real.

Dwn.GetitemDate (Fila,
columna)
Dwn.GetitemTime (Fila,
columna)
Dwn.GetitemDateTime

el

dato

extraer

es

Si el campo es de tipo fecha.

Si el campo es de tipo hora.
Cuando el campo es de tipo fecha

(Fila, columna)
y hora.
Ejemlo: Capturar en variables, sueldo del empleado, su edad y fecha
de nacimiento del empleado, cuya posicin se encuentre en la fila
nmero 3.
Int edad
Dec Sbas
Date Fenac
Edad= DwnEmpleado.GetItemNumber(3,"emp_Edad")
Sbas= DwnEmpleado.GetItemDecimal(3, "emp_Sbas")
Fenac=DwnEmpleado.GetItemDate(3,"emp_Fenac")
Nombre del campos en la tabla.
Gettext
Obtiene el valor de un control de edicion en la fila y columna actuales,
antes que este sea aceptado.
Sintaxis dwn.Gettext ()
Por ejemplo si este radio button se encuentra dentro del DataWindow,
y al seleccionar una de estas opciones se desea saber su valor
seleccionado basta emplear:
String Tmoneda
Tmoneda = DwnSalario.Gettext()

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
Setsort
Especifica, el criterio de ordenamiento para un DataWindow, retorna 1
si tuvo xito y -1 si se encontro un error.
SintaxisDwn.SetSort (campo1 [A|D])
Ejemplo:
DwnEmpleado.setsort()
Dwn.Sort()
Ejecuta la clasificacin con un previo criterio de seleccin
SintaxisDwn.Sort ()
Ejemplo:
DwnEmpleado.SetSort("emp_ape A, #2 D") // ordena apellido y sueldo
asumiendo
// que el #2 sea el campo sueldo.
DwnEmpleado.Sort() // Procede al ordenamiento.
GetRow
Retorna el nmero de la fila actual de un DataWindow, como un valor
Long,
Retorna 0 si no hay fila activa y -1 si se ha producido un error grave.
SintaxisDwn.GetRow ()
SetRow
Establece la fila deseada, mueve el cursor a la fila especificada, pero
no hace Scroll en el DataWindow.
SintaxisDwn.SetRow (Fila)
ScrollToRow
Hace un Scroll en un DataWindow, hasta alcanzar la fila especificada.
ScrollToRow cambia la fila actual pero no la columna actual. Retorna 1
si hubo xito, -1 en caso contrario. Scrolltorow no ilumina la fila a la
cual se hace scroll.
Sintaxis Dwn.ScrolltoRow(fila)
Si la fila toma un valor mayor que el nmero total de la fila, se hace
scroll a la ltima fila.
RowCount

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
Obtiene el nmero de filas que se encuentran disponibles en un
DataWindow
Sintaxis Dwn.RowCount()
ScrollToRow
Causa que el control se deslice a la fila especificada, cambiando la fila
actual, a donde se le indique.
Sintaxis Dwn.Scrolltorow(fila)
ScrollToPriorRow
Se desliza a la fila previa, sin cambiar la columna activa
Sintaxis Dwn.ScrollPriorRow(fila)
ScrollNextRow
Se desliza a la siguiente fila.
Sintaxis Dn.ScrollNextRow(fila)
DeleteRow
Suprime la fila especificada del control DataWindow, se actualiza
directamente la tabla enlazada al control.
Sintaxis Dwn.DeleteRow(fila)
Si la fila es igual a cero, elimina la fila activa donde se encuentra el
puntero, cada vez que se emplee esta sentencia, se tiene que
actualizar el DataWindow ejemplo:
Dwn.deleteRow(8) // elimina la fila nmero 8
Dwn.Update() // actualiza la base de datos enlazada
DeletedCount
Retorna el nmero de filas que hayan sido suprimidas desde el control
DataWindow pero que todavia no hayan sido actualizadas en la tabla
de la BDD asociada.
SintaxisDwn.DeletedCount()
Ejemplo:
Long Nf
Nf=Dwn.DeletedCount()
Update

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
Se envia a la base de datos todas las inserciones, eliminaciones y
actualizaciones del control DataWindow, retorna 1 si tuvo xito, -1 si
ocurri un error.
SintaxisDwn.Update()
Fuentes de datos (Data Source)

Los datos que se cargan en el DataWindow provienen de una fuente

de datos. Las fuentes de datos que se pueden especificar son:

Quick Select

SQL Select

Query

External

Stored Procedure
Quick Select: Se utiliza para recuperar los datos desde una sola
tabla: solo es necesario seleccionar las columnas, los criterios de
seleccin y el ordenamiento.
SQL Select: Permite tener mas control sobre la recuperacin de
datos. Permite consultas correlacionadas, columnas computadas,
agrupamiento de filas y operaciones complejas de recuperacin de
datos.

Ingeniera Informtica y de
Sistemas

Universidad de Chiclayo
Filial Jan
Query: Se puede emplear cuando la fuente de datos proviene de una
consulta creada y almacenada con el Query Painter.
External: Se utiliza cuando la fuente de datos no es un sistema de
bases de datos relacional como las entradas del usuario o un gestor
de archivos planos.
Stored

Procedure: Permite

recuperar

los

datos

travs

de

procedimientos almacenados en la base de datos.

DIFERENCIA
La diferencia entre un datastore y un datawindows control consiste en
que el datawindow control es visual y se puede pegar en una pantalla
para ver los datos: el datastore se usa en la programacin script para
manipular los datos y no tiene parte visual. Sirven para lo mismo, solo
que durante procesos y calculos, es mejor utilizar el datastore, ya que
al no tener la parte visual es ms "liviano" (rpido).
http://html.rincondelvago.com/power-builder_1.html
conexin sql

Ingeniera Informtica y de
Sistemas