8/14/2019 ManualPB

1/23

Perodo Lectivo 2004 2005

UNIVERSIDAD DE CARABOBOFACYT COMPUTACIN

BASES DE DATOS

Manual de Power Builder

Definicin

Es un entorno grfico de programacin que est compuesto de diferentes

herramientas que permiten el desarrollo rpido de aplicaciones. Con estas

herramientas se pueden desarrollar aplicaciones Cliente / Servidor a travs

de ODBC (Open DataBase Connectivity) o Drivers Nativos para la Base de

Datos. Una aplicacin Cliente / Servidor pone en comunicacin una estacin

de trabajo con un Servidor de Base de Datos Central. Este modelo consiste

en utilizar una Base de Datos que reside en una mquina separada

denominada Servidor. El Software de gestin de Base de Datos se ubica en

las estaciones de trabajo remotas (Clientes). Las aplicaciones que se

ejecutan en las estaciones cliente, acceden a los datos que se encuentran en

el servidor

Es una herramienta de desarrollo empresarial orientada a objetos que

permite construir diferentes tipos de aplicaciones y componentes. Se

pueden desarrollar aplicaciones cliente / servidor, aplicaciones distribuidas

y aplicaciones para Internet.

Esta herramienta de desarrollo est completamente orientada a objetos, lo

que permite a equipos de programadores crear aplicaciones grficas

1

8/14/2019 ManualPB

2/23

sofisticadas con acceso a informacin de base de datos locales o en

servidores de red.

El lenguaje de escritura de PowerBuilder es el PowerScript.

Las escrituras consisten en uso de los comandos, las funciones, y

declaraciones que realizan el proceso en respuesta a un evento.

Barra de HerramientasEl PowerBar es el punto de control principal para los usos de PowerBuilder.

Nuevo (new): Permite la creacin de cualquier objeto, espacio de

rabajo, aplicacin, ventana, datawindow.t

Heredar

Abrir (open): Abre cualquier objeto que se encuentra guardado

previamente en una librera, como ventanas, datawindow, un objeto

aplicacin, etc. File/open o Ctrl+O

Correr o ver un objeto

Ventana de rbol del sistema: Muestra u oculta la ventan del rbol

del sistema que se encuentra en la parte izquierda de la pantalla.

Ventana de salida

2

8/14/2019 ManualPB

3/23

Siguiente error o mensaje / Anterior error o mensaje

Lista de Pendientes: Muestra u oculta la ventana clip. Sirve como un

portapapeles dentro de PB.

Explorador: Visualiza la informacin del objeto.

Heredar

Librera: Permite mover objetos de una a otra, borrar objetos, etc.

Perfil de Base de Datos: Permite configurar las conexiones a la Basede Datos.

Perfil EASERVER

Base de Datos: abre un painter que permite consultar tablas, vistasy dems objetos que se encuentran en la BD.

Editor

Construccin / Despliegue / Bqueda Workspace

Depurar / Seleccionar y depurar

Correr / Seleccionar y correr

Salir

3

8/14/2019 ManualPB

4/23

PowerBuilder trabajo con pintores. Los pintores proporcionan un surtido de

herramientas para construir objetos.

PowerBuilder proporciona un pintor para cada tipo de objeto que se

construye.

Cuando se abre a un pintor, PowerBuilder exhibe una ventana nueva que

tenga un espacio de trabajo en el cual se disea el objeto que usted est

construyendo. PowerBuilder tambin exhibe un o ms PainterBars con losbotones que proporcionan el acceso fcil a las herramientas disponibles en

el pintor o el editor.

4

8/14/2019 ManualPB

5/23

Workspace

El Workspace o espacio de trabajo es un archivo de extensin .pbw el

cual PB crea, donde se guardan las configuraciones del proyecto que se

esta desarrollando.Se encuentra ubicado en la powerbar file/open workspace

5

8/14/2019 ManualPB

6/23

Aplicacin

Una vez creado el espacio de trabajo, debemos crear nuestra aplicacin.

Una aplicacin tiene como elementos a las ventanas, los mens, los

DataWindows y los objetos de usuario.

6

8/14/2019 ManualPB

7/23

Propiedades de la Aplicacin

Tpico DescripcinGeneral Permite obtener informacin del objeto aplication.

Font Permite definir caractersticas de presentacin visualde elementos.

Icon Permite definir el icono de la aplicacin.Variable Permite conocer las variables globales por defecto y

su tipo.

Libraries Permite declarar las libreras que conforman laaplicacin.

Eventos de la Aplicacin

Evento DescripcinOpen Las acciones cuando inicie la ejecucin de la aplicacin.Close Las acciones cuando termine la ejecucin de la apli

Ventanas

Las Ventanas son como contenedores, es posible poner en ellos unadiversidad de objetos. Estos objetos se denominan en forma genrica

7

8/14/2019 ManualPB

8/23

Controles.

Layer: permite ver la vista del diseo de la ventana Open: muestra el script del objeto seleccionado. Event List: muestra la lista de eventos del objeto seleccionado. Function List: muestra la lista de las funciones del objeto

seleccionado.

Declare Instance Variables: lugar donde se declaran las variablesGlobal, Shared, instante y las funciones externas.

Propiedades de La Ventana

Tpico DescripcinGeneral Casilla Title, indica el texto de titulo de la ventana. La

casilla Menu Name, indica el nombre del objeto Menu para

la ventana. Window Type, indica el tipo de ventana:

8

8/14/2019 ManualPB

9/23

Child, ventana que permanece inserta dentro de unaventana MDI.

Main, ventana normal, con posibilidad de men. MDI Frame, ventana que posee rea interna para

contener otras ventanas. MDI Frame with , igual que la anterior, pero con

barra de estado inferior.

Response, necesita cerrar esta ventana paracontinuar ejecucin.

Position Permite indicar la posicin de la ventana dentro de lapantalla, como ser presentada. Utilice el esquema inferior

para mover la ventana.

Icon Identifica al Icono que aparecer en la parte izquierda de lacabecera de la ventana.

Scroll Permite definir si la ventana tendr barras dedesplazamiento, y la unidad a utilizarse por ellas.

ToolBar Permite definir si se utilizara la caja de herramientadefinida para el menu, su presentacin y posicin.

Controles

Son los objetos visuales que pueden ser puestos en la ventana.

Los controles bsicos son:

CommanButton: Puede visualizar un texto en el. Presenta la capacidad

visual de sobresalir y achatarse al presionar el mouse sobre el

PictureButton: Tiene todas las caractersticas del control anterior,

pero adicionalmente permite mostrar una n dentro del mismo botn.

CheckBox / RadioButton: Permite hacer una seleccin (marcarlo)

entre varias alternativas. En el primero cada alternativa es

independiente. En el segundo solo una alternativa, del conjunto, puede

seleccionarse.

9

8/14/2019 ManualPB

10/23

StaticText: Caja de texto, como etiqueta. Solo para mostrar

informacin, no hay posibilidad que pueda escribirse directamente en

el.

Picture: Caja de dibujo, permite visualizar una n. Esta puede ser

definida en tiempo de diseo, o puede ser modificada en tiempo de

ejecucin.

SingleLineEdit: Caja de edicin de texto, es posible que el usuario en

tiempo de ejecucin escriba un texto dentro de la misma caja.

EditMask: Caja de texto, a la que se le puede restringir el conjunto de

caracteres a ingresar. Permite un formato de presentacin.

DropDownListBox: Caja de lista desplegable. Muestra un solo tem, el

seleccionado, de la lista que se despliega al presiona el botn adjunto.

ListBox: Caja de lista. Muestra todos los tems a la vez, pudiendo

seleccionarse inclusive, ms de uno.

Datawindow: Datawindow Control, el que se vincula con un objeto

Datawindow diseado.

10

8/14/2019 ManualPB

11/23

Propiedades de los Controles

Tpico Descripcin

General Name, indica el nombre del objeto. La casilla Text,indica el texto a ser mostrado. Tag, permite guardarcualquier dato. Visible, indica si el objeto puede verse.

Enabled, indica si objeto esta activamente disponible.

Para los Botones: Default indica que si se presionael Enter en cualquier parte de la ventana, se activa

dicho botn. Cancel indica que si se presiona latecla Escape, se activa dicho botn.

Para las cajas de Edicin, Etiqueta y ListaDesplegable: Alignment, indica la alineacin deltexto. Case el tipo de presentacin. Border indica

el tipo de borde. Limit, el nmero de caracteres a

dejar ingresar.

Para la Lista Desplegable: Allow Edit, indica que sepuede escribir un tem adems de seleccionarlo.Sort, indica que el listado ser ordenado

alfabticamente.

Para la Lista: Multi Select, indica posibilidad de

11

8/14/2019 ManualPB

12/23

seleccin mltiple.

Font Permite definir el tipo de letra, tamao y caractersticasde presentacin del texto visible. Text Color, indica elcolor del Texto. Background, indica el color de fondo.

Position Indica las coordenadas X e Y, tambin se indica el largo(Width) y el alto del objeto (Height)

Icon Indica el tipo de Icono, que ser utilizado por el cursorcuando este pase por encima del objeto en tiempo de

ejecucin.

Items Para los objetos lista, permite ingresar el texto decada tem.

Mask Para la mascara, permite definir la mascara deentrada de datos. Seleccione Type para ver enMasks, los posibles caracteres a utilizar. Cualquier

otro carcter se considera un litera.

Eventos Controles

Evento Descripcin

Clicked Cuando el usuario presione el mouse sobre el reaque conforma el objeto visual.

GetFocus Cuando el objeto obtiene la atencin, se mouse elcursor sobre el.

LoseFocus Cuando el objeto pierde la atencin.DoubleClicked Cuando el usuario presiona dos veces el mouse

sobre el rea que conforma el objeto visual.

SelectionChanged Cuando se cambio de tem seleccionado.

RButtonDown Cuando se presiona el botn derecho del mousesobre el rea que conforma el objeto visual.

Modified Cuando el control pierde la atencin, se presionaEnter o Tab, o el texto es modificado.

12

8/14/2019 ManualPB

13/23

Datawindows

Un datawindows es una sentencia sql que esta 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, ingresardatos, 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 yaexistente, 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.

13

8/14/2019 ManualPB

14/23

Modo DescripcinQuick Select No presenta las tablas en forma grfica, y solo

permite las sentencias ordinarias de SQL (Sort yCriteria)La primera para poder ordenar por el campo

especifico y la segunda para indicar registros amostrar pedendiendo de una valor condicional (Ej.

8/14/2019 ManualPB

15/23

Presentacin DescripcinComposite Utiliza como presentacin un reporte previamente

creado.

Freeform La presentacin es libre, donde cada campo esta enuna lnea distinta. Muy utilizado para el ingreso dedatos.

Graph Disea un grfico dependiendo de una consulta, estadebe contener datos relacionados.

Grid Disea una malla de datos en forma columnada, y cadacolumna con una justificacin completa.

Group Disea listado por agrupacin de campos. Muyutilizado para reportes de resumen de informacin.

El diseo es de etiquetas, donde Ud. podr elegir eltipo de etiqueta de las prediseadas, en papel

continuo o separado, y otras opciones.

Rich Text Permite definir una carta con combinacin de camposdel Origen de datos fijado. Se pueden utilizar todas

las caractersticas del formato de texto RTF.

Tabular Presenta el origen de datos en forma columnada perosin ajuste total. Permite una mayor libertad en eldiseo.

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.

15

8/14/2019 ManualPB

16/23

Se termina la seleccin presionando el botn Open y si desea cancelarla seleccin presione el botn Cancel, luego de lo cual aparecer enforma 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 enforma 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.

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 DescripcinName Es el nombre que tendr el objeto Datawindow Control.

Datawindow Escriba el nombre del objeto Datawindow que ser

16

8/14/2019 ManualPB

17/23

mostrado en este Datawindow control. Para seleccionar

un Datawindow presione el botn "Browse".

Title Escriba el texto que aparecer en la barra de titulo, siesta marcada la opcin TitleBar.

TitleBar Si esta opcin esta marcada, el texto que este en lacaja Title se mostrara como una barra de titulo.

ControlMenu

Si esta opcin est marcada, permite que el DatawindowControl, sea un objeto flotante (pudiendo moverse)

dentro de los limites de la ventana que lo contiene.

Maximizebox

Minimizebox

Permite que el Datawindow control, presente losbotones Maximizar y Minimizar, respectivamente.

Manejo de Datawindow Control

Para hacer uso del Datawindow Control en tiempo de ejecucin esnecesario indicar que objeto de transaccin ser utilizado por el

Datawindow para presentar la informacin definida en el.

Esto se hace, con la siguiente funcin:

.SetTransObject()

Donde:

es el nombre del Datawindow Control. 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 )

17

8/14/2019 ManualPB

18/23

Para obtener datos de la Base de Datos, y mostrarlos en elDatawindow Control, se utiliza la siguiente funcin:

.Retrieve ()

Donde:

es el nombre del Datawindow Control. < lista parametros >, 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:

.DataObject = )

Donde:

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 aocupar la funcin Retrieve, para obtener los datos de esta

nuevo Datawindow.

Ej.

dw_nuevo.DataObject= d_otro

Funciones para el manejo:

Aadir

Para aadir un nuevo registro se utiliza la siguiente funcin:

18

8/14/2019 ManualPB

19/23

.InsertRow()

Donde:

es el nombre del Datawindow Control.

Es la posicin, dentro del nmero de registrosmostrados en el Datawindow Control, donde se

insertara el nuevo registro. Si = 0, aade unregistro 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:

.DeletedRow()

Donde:

es el nombre del Datawindow Control. es la posicin del registro a eliminar. Si desea

eliminar el registro donde esta el foco (cursor

actualmente), utilice la siguiente funcin: .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:

19

8/14/2019 ManualPB

20/23

.Find()

Donde:

es el nombre del Datawindow Control.

< expre cond> es una expresin que se escribe igual queuna 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 + "")

Filtrar Registros

Esto significa que del conjunto de registros que muestra el

Datawindow Control en forma habitual, solo se mostraran losque 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:

.SetFilter()

Donde:

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:

.SetFilter( )

Donde: es el nombre del Datawindow Control.

20

8/14/2019 ManualPB

21/23

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:

.Update( )

Donde: 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

Eventos

El Objeto Datawindow Control tambin posee eventos, los ms

comunes son los siguientes:

Evento DescripcinRowFocusChanged 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.

21

8/14/2019 ManualPB

22/23

ItemChanged Ocurre cuando el usuario un campo ha sidomodificado y este campo pierde el foco ( presionartecla Enter, tecla Tab, o moviendose a otro campo

cualquiera)Tambien ocurre cuando se utiliza la

funcin AccepText o la funcin Update.

Libreras

Permite distinguir los elementos que conforman una librera. Estas no

estn distribuidas en forma jerrquica como en el rea de

"Aplication", solo son presentadas en orden del Area que forman

parte.

Para trabajar en el rea de Libreras presione el botn .

Aparecer una ventana como la siguiente

Donde en la parte superior se selecciona la unidad a revisarexistencia de Libreras, y en la parte inferior una especie de

directorio. Los archivos de librera estn acompaados por el icono .

Crear Librera, para ello presione el botn , escriba el nombree indique la ruta de la nueva librera.

Las siguientes operaciones, se pueden realizar con uno o ms

elementos seleccionados, de una Librera:

Editar, permite iniciar el rea a la que pertenece el elemento

Copiar

Mover

Eliminar para eliminar el (los) elementos marcados.

Exportar, permite extraer la definicin del elemento como unarchivo texto.

22

8/14/2019 ManualPB

23/23

Importar, permite aadir la definicin de un elemento desdeun archivo texto a la librera en curso. .

, permite que se actualicen los vnculos con otros

elementos, modificados, de PowerBuilder o de una Base de

Propiedades, permite modificar el comentario declarado para cadae e

Todos estas opciones estn disponibles en el men Entry

Regenerar

Datos.

nto.lem