Taller de Desarrollo V

Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Entorno Powerbuilder
Niveles de Jerarqua para la creacin de aplicaciones:
Powerbuilder posee tres niveles de jerarqua en sus objetos, los cuales conoceremos antes de
llevar a cabo nuestros objetos.
Workspace
: Es el rea de trabajo que nos permite gestionar los objetos de cada uno de
nuestros targets, facilitando la integracin de los objetos. Su extensin es PBW (1)
Target
: Es nuestra aplicacin y contiene el conjunto de libreras que la conforman. Su
extensin es PBT (2)
Libreras
: Es el nivel elemental en donde se almacenan nuestros objetos, mens,
ventanas, estructuras, datawindows entre otros. Su extensin es PBL (3)
Si usamos el explorador de windows nuestros tres archivos se veran de la siguiente manera:

Iconos principales del painter PowerBar I;

Icono que permite la creacin de nuevos objetos; y nos permite acceder a la ventana de
nuevos objetos en power que tiene la siguiente clasificacin:

Workspace

Permite la creacin de workspace que contiene los diferentes tipos de

targets
Target
Permite la creacin de:
- Application: Permite la creacin de nuestro target de aplicacin
- Template Application: Permite la creacin de una aplicacin
paso a paso.
- Existing Application: Permite incluir una aplicacin existente,
usada tambin para migrar aplicaciones de versiones anteriores.
PB Object
Permite la creacin de los objetos de Powerbuilder, como objetos no
visuales, clases standard, ventanas, mens, estructuras, funciones.
DataWindow Permite la creacin de objetos datawindows en sus diferentes tipos
Database
Permite la creacin de objetos especiales para el trabajo con base de
datos como por ejemplo el Data Pipeline que es una interfase para la
migracin entre diferentes o similares motores de bases de datos.
Project
Permite la creacin de nuestro archivo ejecutable para la distribucin de
nuestras aplicaciones.
Tool
Nos ofrece herramientas que nos facilitan la ayuda del trabajo de
codificacin en powerbuilder.
Icono de Herencia nos permite heredar los objetos de tipo Windows, User Object y Mens
que son los nicos que pueden heredarse.
Icono que nos permite abrir los objetos creados en powerbuilder.

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Icono que habilita o deshabilita la presentacin del System Tree que es el browser de los
objetos, libreras, targets y libreras. Un Worskspace de ejemplo se presenta a continuacin:
Observe:
Que existe un workspace municipal y nos
indica que esta creado en la ruta c:\muni.
Que existen dos target el siscoa y el
predial.
Que existen varias libreras y en ellas
recin se encuentran los objetos de power
builder.

Icono que muestra u oculta la ventana de resultados, que es donde power informa sobre
las acciones que se desarrollan mientras se lleva a cabo la construccin.
Icono que permite acceder al painter de libreras, para administrar la creacin de las
mismas as como mover, copiar, importar, regenerar objetos de power que estas
contengan.
Icono que permite acceder a los profiles de BD, un profile es un conjunto de instrucciones
que nos permiten conectarnos a diferentes motores de base de datos. Power 10 incluye la
conexin ADO y OLEDB; siendo la caracterstica ms saltante la del ADO que permite
conectarse a SQL Server, Oracle u otro proveedor de base de datos, utilizando el mismo
driver.
Icono que permite ejecutar la aplicacin actual.
Icono que permite seleccionar del workspace actual el target (aplicacin) que se desea
ejecutar.
Creando un workspace
A continuacin haga clic sobre el icono nuevo ubique el tab de Workspace, y seleccione le icono
workspace; como se muestra a continuacin.

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Observe el circulo rojo,

vera que la palabra
target aparece deshabilitada,
esto
se
mantendr as mientras
no exista un workspace
creado. Como se puede
comprobar en el System
tree, como se aprecia e
continuacin:

Antes de crear el workspace cree en su disco C una carpeta que llamara tomando la primera
letra de su nombre y el apellido, ejemplo si su nombre es Isabel Perales cree la carpeta
iperales.
Luego de hacer dobleclik sobre el icono seleccionado power nos pedir la ruta en donde se
creara el Workspace, gurdelo en la carpeta creada; y siga el mismo Standard ya utilizado.
Observe que ahora aparece su nombre en el system tree como se aprecia a continuacin:

Ahora crearemos el target y al hacer esto tambin se creara el objeto aplicacin, haga clic en el
icono de nuevo y ahora seleccione el tab Target ubique el icono target como se muestra a
continuacin:

Luego Power mostrara una ventana en donde deberos ingresar:

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

El nombre de nuestra aplicacin, al hacer esto power auto completa el nombre de nuestra
librera y target. Ingrese el nombre de su aplicacin clase1; observe que luego de hacer tab
power completo lo siguiente:

Haga clic en el botn Finish y ahora observe su system tree.

Observe que se crearon los siguientes objetos:
1.
2.
3.
4.

Es
Es
Es
Es

el
el
la
el

Workspace.
target
librera
objeto aplicacin

Haga clic derecho sobre cada uno de estos objetos y observe como cambian las opciones del
men contextual, tome en cuenta estas opciones para laboratorios siguientes.
Explore ahora el objeto aplicacin y obtendr la siguiente imagen:
Observe que este objeto posee Propiedades,
eventos, y funciones pre definidas.
Por ahora miremos por ahora los eventos mas
importantes:
Open: Se dispara cuando se ejecuta la
aplicacin.
Close: Se dispara cuando se cierra la
aplicacin.
Systemerror: Se dispara cuando se produce
un error en tiempo de ejecucin.
Conociendo el ambiente de construccin
Haga doble clic sobre el objeto aplicacin, pasaremos a explicar la pantalla que se presenta a
continuacin:

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Donde:
1.
2.
3.
4.
5.

6.

Es el rea en donde se escribe en lenguaje powerscript

Son la propiedades del objeto seleccionado actualmente, en este caso el objeto
aplicacin.
Haciendo clic en este botn podemos administrar las propiedades adicionales del objeto
aplicacin, como las variables del sistema powerbuilder
Esta zona muestra la informacin de los argumentos y datos adicionales del evento, esta
propiedad esta activa porque el icono que se encuentra enganchado, si usted hace clic
sobre el mismo icono (Ejecute esta operacin y observe los resultados)
Browser de objetos, es aquel que nos muestra los objetos que estn disponibles
actualmente. Como se muestra a continuacin:
Observe que adicionalmente puede usted declarar
funciones o variables.

Browser de Eventos del sistema y de usuario, aqu podr navegar hasta encontrar los
eventos del objeto activo actualmente, observe que la opcin (New Event) siempre esta
disponible,

Adicionalmente observe los tab inferiores tambin es posible desplazarnos entre estos tabas
para cambiar de evento, declarar variables, entre otras cosas. Cuando usted esta desarrollando
puede que la apariencia cambie y necesite resetear nuevamente esta forma inicial para ello
siempre estar disponible en su men las opciones View / Layout / Default como se
muestra a continuacin:

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

DECLARANDO VARIABLES
Haga clic sobre el tab Declare Instante Variables,

Obtendr la siguiente pantalla:

Observe que ahora el browser
de eventos tiene:

Y en cada una de ellas se puede

declara variables segn los tipos
explicados.
Globales, Shared, Instante

Cree entonces:
Una Variable Global de tipo string llamada gs_empresa
Una Variable Instancia de tipo string llamada is_conexion
Luego vuelva al OPEN del objeto aplicacin, haciendo clic en el tab OPEN y coloque el siguiente
script:

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Observe ahora que:

1. El script Open ahora un icono
que nos indica que hay script en
el evento.
2. El icono de Compile, sirve para
procesar los scripts, del evento
actual, utilicelo para depurar
errores de sintaxis. Ahora haga
clic en dicho icono y no tendr
resultados por que sus scripts
estn correctamente escritos
Ahora probaremos escribiendo cdigos errneos.
Ahora vuelva a presionar el icono
de Compile y tendr los siguientes
resultados.

Observe que hay un error,

que indica la incompatibilidad
entre los tipos de asignacin,
esto es evidente ya que
gs_empresa es de tipo cadena
y esta queriendo asignarse un
valor numrico. As como este
error se van a presentar a
medida que se implemente
mayores cdigos, mientras el
error persista no se podr
guardar el contenido del
objeto, observe que hay un
asterisco al costado del
nombre del objeto seal que
el contenido actual no esta
guardado.
Ahora comentemos dicha lnea para conseguir guardar el objeto y no peder el cdigo ingresado.
Un comentario se escribe utilizando el doble
slash, observe que el cdigo ha cambiando de
apariencia, ahora Compile nuevamente el
script y vera que ya no aparece el mensaje de
error. Como se muestra a continuacin.

Observe que
ya no hay asterisco al costado del titulo del
objeto.

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

Ahora probaremos la capacidad de las variables de instancia, adicione en el evento OPEN el

siguiente script:

Ahora adicione el siguiente script en el evento close:

Observe que no ha declarado la variable is_conexion en ninguno de los eventos (Open / Close);
solo ha necesitado declararla una vez y puede ser utilizada en cualquier parte del objeto en este
caso el de aplicacin.
Ahora ejecute la aplicacin usando el icono RUN, as al ejecutar la aplicacin aparecer el
siguiente mensaje:
El valor de la variable es No

Luego haga clic sobre el botn aceptar y obtendr la siguiente ventana:

El valor de la variable es Si

Observe que se ha ejecutado el evento open y luego close; explique este resultado al
instructor.
Ahora pruebe creando variables locales en ambos eventos y explique al instructor los resultados
obtenidos.

Taller de Desarrollo V
Instructor: Vctor Gutirrez

Powerbuilder 10
Laboratorio I

CONSTRUYENDO UNA VENTANA

Cree una ventana, tendr la siguiente ventana:

1.
2.
3.
4.
5.
6.

Es el nombre del objeto el (Untitled) significa que la ventana no tiene nombre.

Title es la propiedad del Titulo para la ventana, esta puede asignarse va powerscript.
MenuName, aqu se asocia un men a la ventana.
Center, aqui se le dice a la ventana que esta aparecer centrada.
WindowType, se le dice a al ventana que tipo de ventana ser.
WindowState, se le dice a la ventana como esta aparecer.

Ahora guarde la ventana como w_clase1 y coloque un titulo, su nombre, luego ejecute la
ventana y cambie las propiedades explicadas.
Luego intente usar las propiedades indicadas y configurarlas utilizando powerscript.