aprenda power builder 7 0
TRANSCRIPT
Fundamentos de programación en Power Builder
1
Fundamentos de programación en Power Builder
2
Edición 1.0
Prohibida la reproducción total o parcialSin nuestro consentimiento
Derechos de copia reservadoswww.LibrosDigitales.NET
Fundamentos de programación en Power Builder
3
Introducción
Objetivos
En este primer módulo se desarrollaran los siguientes puntos:
ü Introducción al concepto “Orientado a Objeto”
ü Descripción del entorno de desarrollo
ü Descripción de los principales objetos
ü Descripción de los principales controles
ü Pasos para Iniciar una aplicación
ü Desarrollo de una aplicación
Fundamentos de programación en Power Builder
4
Introducción al Concepto “Orientado a Objeto”
Paralela a la búsqueda de la computación distribuida, dentro del área de lainformática se ha venido madurando la tecnología “Orientado a Objeto”, la cualsoluciona muchos problemas de los sistemas estructurados, permitiendo undesarrollo de software más rápido y dinámico. Además de su potencial reusabilidadal ser cada objeto una entidad autónoma.
Existen muchas definiciones en la literatura pero todas coinciden en que se trata deun modelo de programación para representar la realidad. Además se puede decirque para que un sistema sea “Orientado a Objeto” debe soportar determinadascaracterísticas, como son:
§ Encapsulamiento o capacidad de ocultar la información.
§ Herencia.
§ Polimorfismo.
Veamos un ejemplo, el mundo real está compuesto por pequeñas entidades queinteractúan con otras entidades y/o sistemas. Para el desarrollo de aplicacionessoftware estas entidades son encapsuladas dentro de unidades estructuralesllamadas objetos, lo que permite tratar a cada uno de una manera independientede los demás, haciendo que cada objeto sea una unidad operativa con otros objetosy lograr un fin común. Un buen ejemplo de la programación orientada a objetos esel ensamblaje de una computadora, la cual está constituida por diferentes partesindependientes, que a su vez, están construidos por pequeñas partes ensambladascon anterioridad, dando la posibilidad de escoger su configuración, lo cual seríaimposible si nos tocara elaborar cada uno de los componentes, que esprácticamente lo que se hace con el software actual, donde cada nueva aplicaciónarranca casi desde cero.
Cada objeto es construido a partir de una plantilla llamada Clase, en donde seconsignan todas sus características y operaciones, los cuales se conocen comoatributos y métodos respectivamente. Cada una de estas clases representa untipo de objeto. Siguiendo con el ejemplo anterior, se puede citar una claseComputadora, la cual entre sus características tiene capacidad de memoria RAM,capacidad de disco duro y velocidad, se pueden armar gran cantidad deconfiguraciones diferentes, a partir de un mismo tipo de características con tansolo cambiar sus valores, en este caso se dice que cada objeto (Computadora conatributos ó configuración particular) es una instancia de su clase (Computadora).
Herencia
Este sistema permite derivar una clase de otra, permitiendo agregarle funcionalidady características que la clase base no posee, dando origen a una clase derivada, lacual posee todos los encantos de su clase padre más los suyos propios. Porejemplo, si se define una clase “Procesador Pentium”, podemos derivar una clase“Procesador Pentium MMX”, la cual ofrece todos los servicios de su clase base,clase “Procesador Pentium”, más otros, tales como sus procesos paramultimedia.
Fundamentos de programación en Power Builder
5
Polimorfismo
Es la capacidad que tienen los objetos de soportar métodos con un mismo nombrey actuar de manera diferente según sea su tipo. En el ejemplo de laComputadora, se puede observar como podemos leer de cada uno de susdispositivos de almacenamiento tales como disco duro, disco flexible, CDROMmemoria RAM y ROM, etc. Lo cual se puede hacer por medio de una misma ordenpara todos, tal como leer, actuando esta orden de forma diferente en cadadispositivo, de acuerdo a su tipo, ya que cada uno utiliza un método diferente dealmacenamiento y por tanto de lectura.
Agregación
La agregación es la propiedad por la cual un objeto puede estar compuesto porotros objetos, los cuales funcionan de una manera independiente dentro del objetocontenedor, pero de una manera cooperativa, siguiendo con el ejemplo de laComputadora, se puede observar como esta contiene otros objetos como es el casode motherboard, tarjeta de vídeo, disco duro, etc. Los cuales se pueden considerarobjetos independientes, por ser unidades operativas por si solas, pero que al unirsepueden conformar una unidad mas grande.
Encapsulación
Esta es una característica que presentan los objetos, por medio de la cual sólo dana conocer a los otros objetos, los atributos y métodos a los que los pueden acceder,siendo esta la forma que el objeto se presenta para que los demás se comuniquescon él, esta se podría mencionar como la interfaz del objeto, de acuerdo al ejemploque se trae, una interfaz de un objeto sería análogo a los dispositivos o interfacesque trae la computadora para comunicarse con el mundo exterior, tal como elteclado, Mouse, pantalla, etc. Los cuales nos permite comunicarnos con el objetoComputadora, sin importar la manera misma como lo hace.
Entre los resultados de todas estas poderosas características de los objetostenemos una potencial reusabilidad, tanto hacia adentro como hacia fuera delproyecto, teniendo en cuanta que para esto no solo bastan las herramientas,también hace falta “Cultura hacia el Rehúso”, como resultado de una buenametodología de análisis y diseño, punto que se puede anotar como un acierto masde la tecnología de objetos, ya que sus metodología hacen mucho más fácil eldesarrollo de la aplicación, ya que se trata de emular el mundo realrepresentándolo a partir de los objetos, donde el paso de los procesos de análisis ydiseño a la codificación se hace de una manera casi automática y mucho menostraumática que en el análisis estructurado.
Fundamentos de programación en Power Builder
6
Descripción del entorno de desarrollo
Los Painters
Son las herramientas utilizadas para construir los objetos que van a formar partede una aplicación. PowerBuilder proporciona un Painter para cada tipo de objeto aconstruir. Un Painter está formado por una hoja de trabajo (ventana) y un menú(PainterBar).
La Ventana de PowerBuilder
Inicialmente, PowerBuilder presenta la barra de menú (Menú Bar) y el PowerBar.
El PowerBar
Es el punto de control principal para la construcción de una aplicación. Es desdedonde abrimos los Painter, depuramos y ejecutamos la aplicación, personalizamosel entorno según nuestras necesidades.
Botón New
Este botón lo utilizamos cuando vamos a crear un nuevo objeto.
Fundamentos de programación en Power Builder
7
Botón Open
Este botón lo vamos a utilizar cuando queremos editar un objeto, por ejemplo sideseamos realizar modificaciones en una ventana.
Fundamentos de programación en Power Builder
8
El PainterBar
Cuando se abre un Painter, PowerBuilder muestra una ventana que proporciona elárea de trabajo en donde diseñaremos el objeto a construir. Adicionalmente semuestra el PainterBar, constituido por botones que proveen acceso a lasherramientas disponibles en el Painter y el menú del Painter que reemplaza alMenú Bar en la barra de menú.
Fundamentos de programación en Power Builder
9
Descripción de los principales objetos
El Objeto Application (Aplicación)
Es el punto de inicio de una aplicación. Es un objeto discreto que se guarda en unalibrería PowerBuilder, tal como los demás objetos.
Este objeto define el comportamiento de la aplicación, tales como las librerías ausar, fuentes por defecto para el texto, y que procesos deben ocurrir cuando laaplicación se inicia y finaliza.
Cuando corre una aplicación, el evento Open se activa en el objeto Application,ejecutando el script que contiene para iniciar las actividades de la aplicación.Cuando se finaliza la aplicación, el evento Close se activa, ejecutándose el scriptque contiene, que típicamente cierra las bases de datos o escribe las preferencias aun archivo de datos. Si se produce un error serio durante la ejecución, se activa elevento SystemError.
El objeto Window (Ventana)
Es la interfaz entre el usuario y una aplicación PowerBuilder. Se utiliza para mostrarinformación, solicitar información al usuario y responde a acciones del Mouse y elteclado.
La definición de una ventana incluye propiedades, eventos y funciones. Laspropiedades determinan el estilo de la ventana (como la apariencia). Los eventosson acciones de la ventana; cuando un evento es disparado, el script asociado esejecutado. Las funciones pueden disparar eventos de la ventana, manipular ocambiar la ventana, o proveer información acerca de la ventana.
El objeto DataWindow (Ventana de Datos)
Un objeto DataWindow se utiliza para recuperar, presentar y manipular datos desdeuna base de datos relacional u otra fuente de datos (por ejemplo una hoja de Exceló un archivo de dBase).
Se puede seleccionar diferentes estilos de presentación. Por ejemplo, se puedemostrar los datos en formato Tabular o FreeForm.
El objeto Menu (Menú)
Los menús son listas de comandos u opciones que el usuario puede seleccionar enla ventana activa.
Un menú desplegable es un menú bajo un elemento de la barra de menú. Un menúen cascada es un menú que aparece al lado de un elemento de un menúdesplegable. Cada elemento de un menú es definido como un objeto menú enPowerBuilder.
Fundamentos de programación en Power Builder
10
Functions (Funciones)
PowerBuilder permite definir dos tipos de funciones:
§ Funciones a nivel de objeto, son definidas para un tipo particular deventana, menú u otro tipo de objeto; son encapsuladas dentro del objeto enel cual se definen.
§ Funciones Globales, no son encapsuladas dentro de un objeto, pero songuardadas como objetos independientes.
A diferencia de las funciones a nivel de objeto, las funciones globales no actúansobre una instancia particular de un objeto. Por el contrario, estas funcionesejecutan procesos de propósito general como cálculos matemáticos o manipulaciónde cadenas.
Queries (Consultas)
Una consulta es una sentencia SQL que se guarda con un nombre de tal forma quepuede ser usada repetidamente como la fuente de datos para un objetoDataWindow. Las consultas incrementan la productividad por que son codificadasuna vez y pueden ser rehusadas tan frecuentemente como sean necesarias.
Strutures (Estructuras)
Una estructura es una colección de una o más variables relacionadas de uno o mástipos de datos agrupados bajo un mismo nombre. En algunos lenguajes, comoPascal y Cobol, las estructuras son llamadas registros.
Las estructuras permiten agrupar a entidades relacionadas como una unidad en vezde individualmente.
Existen dos clases de estructuras:
§ Estructuras a nivel de objeto, están asociadas con un tipo particular deobjeto como una ventana o menú. Estas estructuras son usadas en scriptspara el mismo objeto. También se puede definir la estructura para quepueda ser accesible desde otros scripts.
§ Estructuras Globales, no están asociadas con ningún objeto en suaplicación. Podemos hacer referencia a estas estructuras desde cualquierparte de su aplicación.
Fundamentos de programación en Power Builder
11
User objects (Objeto de Usuario)
Las aplicaciones, frecuentemente tienen características comunes. Por ejemplo,usualmente se necesita un botón Cerrar que ejecute un conjunto de operaciones yque cierre la ventana. O un cuadro de lista que muestre todos los departamentos.Podría requerirse también que todos los controles DataWindow ejecuten el mismotipo de chequeo de error. También podría necesitarse un archivo visor predefinidoque pueda conectarse de manera simple dentro de su ventana cuando se lerequiera.
Si usted se encuentra usando repetidamente aplicaciones con las mismascaracterísticas, entonces deberá definir un objeto de usuario. El objeto de usuariose crea una vez y se utiliza tantas veces se necesite.
Tenemos dos tipos de objetos del usuario:
§ Objetos Visuales, es un control o un conjunto de controles, que se puedenreutilizar y tienen un comportamiento definido.
§ Clase de Objetos, son módulos de procesamiento reutilizables que notienen componente visual.
Libraries (Librerías)
Los objetos, tales como ventanas y menús, se guardan en librerías PowerBuilder(archivos PBL). Cuando se ejecuta una aplicación, PowerBuilder recupera losobjetos desde la librería. Las aplicaciones pueden usar tantas librerías como senecesite. Cuando se crea una aplicación, se debe especificar que librerías se va autilizar.
Projects (Proyectos)
Para permitir que un usuario ejecute su aplicación de la misma forma como ejecutaotras aplicaciones, se crea un objeto Proyect. El objeto Proyect puedeempaquetar su aplicación en cualquiera de las siguientes formas:
§ Como un archivo ejecutable individual que contiene todos los objetos de laaplicación.
§ Como un archivo ejecutable y una o más librerías dinámicas delPowerBuilder que contienen objetos que serán enlazados en tiempo deejecución.
Cuando se empaqueta la aplicación, se podrá también proveer algunos recursosadicionales, tales como mapas de bits o iconos. Estos recursos se incluirán en losejecutables o librerías dinámicas, o se distribuirán en forma separada.
Fundamentos de programación en Power Builder
12
Descripción de los principales controles
1. CommandButton
2. PictureCommandButton
3. StaticText
4. SingleLineEdit
5. ListBox
6. DropDownListBox
7. GroupBox
8. CheckBox
9. RadioButton
Fundamentos de programación en Power Builder
13
Pasos para Iniciar una Aplicación
Cuando usted carga PowerBuilder, este lee la última aplicación con la que estuvotrabajando. Para iniciar una nueva aplicación, debe seguir los siguientes pasos:
1. Cerrar todos los painters.
2. En el PowerBar haga clic en el botón New (también puede ejecutar el comandoNew del menú File).
3. En el diálogo New, seleccione el icono Application, en la ficha Start Wizards.Finalmente haga clic en el botón Ok.
4. Finalmente en el diálogo Specify New Application an Library, ingrese elnombre del objeto aplicación, y el nombre y ubicación de la librería. Paraterminar haga clic en el botón Finish.
Fundamentos de programación en Power Builder
14
Desarrollo de una aplicación
Carpeta de Trabajo
La carpeta de trabajo para el desarrollo del curso es: C:\PB70_Basico.
Iniciar la aplicación
El nombre de la aplicación es browser y la librería browser.pbl.
Crear una Ventana de Identificación
Esta ventana permite identificar a la persona que desea ingresar a un sistema, elbotón aceptar se debe habilitar solo cuando el usuario halla ingresado sus datoscompletos.
Fundamentos de programación en Power Builder
15
Creación de una Nueva Ventana
Proceda a crear una nueva ventana, y asígnele los siguientes valores a susprincipales propiedades:
§ Name: w_user
§ Title: Identificación de Usuario
§ Type: Response
Añadir Controles a la Ventana
Proceda a añadir los siguientes controles:
§ 2 StaticText
§ 2 SingleLineEdit
§ 2 CommandButton
Establecer las Propiedades de los Controles
§ Establezca el tamaño adecuado
§ Asígnele un nombre apropiado, por ejemplo sle_user, sle_pass, cb_aceptar,cb_cancelar.
§ A otras propiedades asígnele valores según su criterio.
Programar el ingreso de datos
script - modified for sle_user
if text = "" or sle_pass.text = "" thencb_aceptar.enabled = false
elsecb_aceptar.enabled = true
end if
script - modified for sle_pass
if text = "" or sle_user.text = "" thencb_aceptar.enabled = false
elsecb_aceptar.enabled = true
end if
Fundamentos de programación en Power Builder
16
Programación del Botón Aceptar
script - clicked por cb_aceptar
If sle_user.text <> "gcoronel" ThenBeep(2)MessageBox( "Mensaje","Nombre de usuario incorrecto",StopSign!,Ok! )sle_user.SetFocus()sle_user.SelectText( 1,len(sle_user.text) )
ElseIf sle_pass.text <> "sipan" ThenBeep(2)MessageBox( "Mensaje","Contraseña del usuario es
incorrecta",StopSign!,Ok! )sle_pass.SetFocus()sle_pass.SelectText( 1,len(sle_pass.text) )
ElseMessageBox( "Mensaje","Los datos son correctos",Information!,Ok! )
End If
Programación del Botón Cancelar
Script - Clicked for cb_cancelar
Close( Parent )
Ejecutar la Ventana w_user
Para ejecutar la ventana siga los siguientes pasos:
1. Del menú File ejecute el comando Run/Preview...
2. En el diálogo Run/Preiew seleccione la ventana w_user
3. Haga clic en el botón Ok
Ahora puede interactuar con la ventana como lo haría el usuario final.
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio.
Fundamentos de programación en Power Builder
17
Programar la Ventana WinBrowser
Esta ventana permite buscar un archivo, y si es un programa permite ejecutarlo.
Creación de una Nueva Ventana
Proceda a crear una nueva ventana, y asígnele los siguientes valores a susprincipales propiedades:
§ Name:w_winbrowser
§ Title: WinBrowser
§ Type: Main
Colocar y definir las propiedades de los controles en la ventana
En la ventana que acaba de crear, debe colocarse 6 tipos diferentes de controles.En la lista a continuación, indique el tipo de control y el número de ocurrencias delmismo en la ventana.
Nro. Tipo de Control Nro. De ocurrencias123456
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio.
Fundamentos de programación en Power Builder
18
Defina los controles de tipo StaticText
Para cada uno de ellos:
§ Especifique el texto señalado en el diseño.
§ Asígnele un nombre adecuado.
§ Seleccione una alineación apropiada.
Defina los controles SingleLineEdit
Para cada uno de ellos:
§ Establezca el tamaño apropiado.
§ Asígnele un nombre adecuado.
§ Habilite la propiedad que permita realizar un scroll horizontal.
§ Establezca el estilo del borde según el diseño.
Defina el control DropDownListBox
§ Establezca el tamaño apropiado.
§ Asígnele un nombre adecuado.
§ Defina la lista asociada al control. Use la siguiente lista:
• All files (*.*),*.*• Exe files (*.exe),*.exe• Com files (*.com),*.com• Batch files (*.bat),*.bat
§ Deshabilite la propiedad que ordena la lista.
Defina el control GroupBox para los RadioButtons
§ Asígnele el texto señalado en el diseño.
§ Asígnele un nombre apropiado.
Defina los controles de tipo RadioButton
§ Asígnele un nombre adecuado.
§ El botón Normal debe ser la opción por defecto.
Fundamentos de programación en Power Builder
19
Defina los controles de tipo CommandButton
§ Asígneles un nombre apropiado.
§ El botón Ejecutar debe ser el botón por defecto.
Establecer el orden de tabulación
§ Del menú Format, ejecute el comando Tab Order; ó haga clic en el botónTabOrder del PainterBar.
§ Establezca para cada control, el correspondiente número de orden.
§ Cuando termine, deshabilite el botón TabOrder del PainterBar.
Codificación del script que establece el estado por defecto de loscontroles
§ En el evento open de la ventana se debe establecer el estado por defecto delos controles.
§ El estado por defecto de los controles es:
• En el control File Type debe seleccionar el primer elemento de la lista.• En el control Run State debe seleccionar como estado inicial Normal.• El foco debe ubicarse en el control File Name.
Codificar el script para el botón Browse...
Las especificaciones para el botón Browse... son las siguientes:
§ El script debe determinar qué tipo de archivo ha seleccionado el usuario enel control File Type.
§ Para abrir el diálogo File Select debe invocar a la funciónGetFileOpenName.
§ Al abandonar el diálogo File Select debe visualizarse en el control FileName, el nombre del archivo seleccionado por el usuario.
§ Si el usuario seleccionó un archivo en el diálogo File Select, el script debeentregar el foco al control Run Parameters.
§ Si el usuario abandona el diálogo File Select, ejecutando el botónCancelar, el script debe entregarle el foco al control File Type.
§ Utilice las variables locales que crea necesarias.
Fundamentos de programación en Power Builder
20
Codificación del script para el botón Run
Las especificaciones para el botón Run son:
§ El script debe ejecutar el archivo seleccionado por el usuario.
§ La ejecución debe efectuarse teniendo en cuenta los parámetros indicadospor el usuario en el control Run Parameters, y el estado inicial de laventana de la aplicación según lo establecido en el control Run State.
Codificación del script para el botón Clear
Las especificaciones para el botón Clear son las siguientes:
§ Debe limpiar los controles File Name y Run Parameters.
§ Debe restaurar la selección por defecto para los controles File Type y RunState.
§ Debe entregar el foco al control File Name.
Codificación del script para el botón Delete
Las especificaciones para el botón Delete son las siguientes:
§ Debe sonar la alarma si el usuario no ha especificado el nombre del archivoa eliminar.
§ Si ha especificado un archivo, debe mostrar un menaje solicitandoconfirmación de su eliminación.
§ Si el usuario confirma la eliminación del archivo, además de eliminarlo, debelimpiar el control File Name.
Codificación del script para el botón Help
El botón Help debe invocar al archivo de ayuda de PowerBuilder.
Ejecutar la Ventana w_WinBrowser
Para ejecutar la ventana siga los siguientes pasos:
§ Del menú File ejecute el comando Run/Preview...
§ En el diálogo Run/Preiew seleccione la ventana w_winbrowser
§ Haga clic en el botón Ok
Ahora puede interactuar con la ventana como lo haría el usuario final.
Fundamentos de programación en Power Builder
21
Enlazar los objetos
Ahora debemos enlazar los objetos, como se muestra en el siguiente gráfico.
§ Desde el evento Open del objeto aplicación Browser debe abrir la ventanaw_user.
§ Desde el evento Clicked del botón Aceptar, que se encuentra en la ventanaw_user, se debe abrir la ventana w_WinBrowser, siempre y cuando losdatos del usuario sean los correctos.
Ejecutar la Aplicación
Ahora ya puede ejecutar la aplicación, con el comando Run del menú File.
Fundamentos de programación en Power Builder
22
Diseño de una Interfaz
Objetivos
En este primer módulo se desarrollaran los siguientes puntos:
ü Tipos de Ventanas
ü Descripción de una Interfaz MDI
ü Creación de Menús
ü Manejo de Ventanas
ü Uso de Pronombres
ü Estructuras
ü Paso de Parámetros a una Ventana
ü Recibir un Parámetro de una Ventana
ü Manejo de Variables
Fundamentos de programación en Power Builder
23
Tipos de Ventanas
La propiedad WindowType define el tipo de una ventana, y estas se describen acontinuación.
Ventana Marco (Mdi!)
Es una ventana que abarca toda una aplicación. Todas las otras ventanas que seabren dentro de la aplicación lo hacen dentro del marco de esta ventana. Tienen lapropiedad de que al cerrarse provoca el cierre de todas las ventanas abiertas en suámbito. Pueden tener un menú asociado y es este es el menú general de laaplicación.
Ventana Marco con Micro Ayuda (MdiHelp!)
Variante de la ventana anterior que tiene una línea en la parte inferior dondepodemos enviar mensajes informativos al usuario, sin que esto afecte elrendimiento de la aplicación.
Ventana Principal (Main!)
Probablemente sean las mas utilizadas de una aplicación, en una interfaz MDI sonlas hojas de trabajo, y pueden tener un menú asociado.
Ventana Hija (Child!)
Representa una ventana dependiente de la ventana en la que ha sido abierta,siendo esta la ventana padre. Solo puede moverse dentro de la ventana padre y nose le puede asociar un menú.
Ventana Emergente (Popup!)
Las ventanas de este tipo son secundarias y se abren desde una ventana principal.Se utilizan normalmente como ventanas de soporte. Por ejemplo, si se pide que seingrese el número de un cliente, la ventana emergente podría mostrar todos losnúmeros de clientes con sus nombres, para elegir uno en particular.
Ventana Modal (Response!)
Es una ventana que sirve fundamentalmente para avisar sobre errores o darinformación al usuario. Es una ventana que no puede perder el foco, y bloquea laaplicación todo el tiempo que se encuentre abierta.
Fundamentos de programación en Power Builder
24
Descripción de una Interfaz MDI
Es una aplicación con una interfaz para múltiples documentos. Una aplicación endonde los usuarios trabajan dentro de una ventana marco en donde las diversastareas se distribuyen en múltiples hojas de trabajo. Es usual que los usuariosrequieran en las aplicaciones habilitar varias tareas al mismo tiempo.
Un marco MDI es una ventana con diversas partes: un menú bar, un área delcliente, hojas de trabajo, y usualmente una barra de herramientas y una área deestado donde poder mostrar una micro-ayuda.
Una hoja MDI es una ventana que se abre en el área del cliente de un marco MDI.Usted puede usar cualquier tipo de ventana, excepto las de tipo MDI Frame comohoja MDI.
Ejercicio 01
Iniciar una nueva aplicación con las siguientes especificaciones:
§ Objeto Aplicación : SistNotas
§ Librería : SistNotas.PBL
☺ La librería debe ser creada en su carpeta de trabajo.
Fundamentos de programación en Power Builder
25
Creación de Menús
Vamos a ver en forma práctica la creación de un menú, para lo cual previamenteusted debe abrir el Menu Painter con un nuevo objeto menú.
Ejercicio 02
Crear la barra de menú. Los pasos que debe seguir son los siguientes:
1. Del menú Insert debe ejecutar el comando Submenu Item e ingresar elsiguiente texto: &Proceso, luego presionar la tecla Enter.
2. Del menú Insert debe ejecutar el comando Menu Item At End e ingrese elsiguiente texto: &Consulta, luego presionar la tecla Enter.
3. Repita la ejecución del comando Menu Item At End hasta completar labarra de menú.
4. Luego debe grabarlo con el nombre m_frame.
Fundamentos de programación en Power Builder
26
Ejercicio 03
Definir las opciones del menú Proceso. Los pasos que debe seguir son lossiguientes:
1. Debe iluminar la opción proceso.
2. Del menú Insert debe ejecutar el comando Submenu Item e ingresar elsiguiente texto: Curso, luego presionar la tecla Enter.
3. Del menú Insert debe ejecutar el comando Menu Item At End e ingresarel siguiente texto: Matricula, luego presionar la tecla Enter.
4. Repita la ejecución del comando Menu Item At End hasta completar elmenú Proceso.
5. Luego debe grabarlo.
Fundamentos de programación en Power Builder
27
Ejercicio 04
Redefinir el nombre de los comandos del menú Proceso. Para este ejercicio debeguiarse del la siguiente tabla:
Barra de Menú Comando NombreProceso m_proceso
Curso m_pro_cursoMatricula m_pro_matriculaNotas m_pro_notas- m_pro_lineaSalir m_pro_salir
Por ejemplo para cambiar el nombre del comando Curso debe seguir los siguientespasos:
1. Debe iluminar el comando Curso.
2. En la ventana de propiedades, desbloquear el nombre.
3. Asignarle el nuevo nombre.
4. Volver a bloquear el nombre.
Repita los pasos 1, 2, 3 y 4 para los otros comandos, y no se olvide de grabar loscambios.
Fundamentos de programación en Power Builder
28
Ejercicio 05
Complete el menú según el siguiente cuadro.
Barra de Menú Comando NombreConsulta m_consulta
Por curso m_con_cursoPor Alumno m_con_alumno
Reporte m_ReporteAlumnos m_rep_alumnosNotas m_rep_notas
Ventana m_ventanaVertical m_ven_verticalHorizontal m_ven_horizontalCapas m_ven_capasCascada m_ven_cascada
Ayuda m_ayudaIndice m_ayu_indice- m_ayu_lineaAcerca de... m_ayu_acerca
Fundamentos de programación en Power Builder
29
Ejercicio 06
Usted puede crear atajos para los comandos mas utilizados del menú. Por ejemplocrear el atajo Ctrl + C para la secuencia Proceso/Curso, los pasos que debeseguir son:
1. Debe iluminar el comando Curso en el menú Proceso.
2. En la ficha General del Panel de Propiedades:
1. Marcar la casilla de verificación Shortcut Ctrl..2. En el desplegable Shortcut Key, seleccionar la letra C.
3. Grabar los cambios.
Puede repetir los pasos para los comandos que usted considere necesarios.
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio.
Fundamentos de programación en Power Builder
30
Ejercicio 07
Crear una barra de botones. Usted puede asociar cada comando del menú con ungráfico que se verá como un botón en una barra de botones que se creará demanera automática. Para asociar el gráfico a un comando del menú debe seguir lossiguientes pasos:
1. Debe iluminar el comando del menú.
2. En la ficha Toolbar del Panel de Propiedades:
§ El campo ToolbarItemText define el Tip que aparece cuando apunta albotón con Mouse.
§ El campo ToolbarItemName define el grafico asociado con el comando delmenú. Puede seleccionar uno predefinido ó seleccionar uno de un archivohaciendo clic en el botón que aparece a su costado.
§ El campo ToolbarItemspace define el espacio entre el botón actual y alanterior.
§ El campo ToolbarItemOder define el orden en que aparecerán los botonesen la barra.
§ El campo ToolbarItemBarIndex define a que barra pertenece el botón, porejemplo puede crear dos barras de botones, la segunda tendría valor dos eneste campo.
3. Después de establecer los gráficos para los comandos que usted considerenecesarios, no se olvide de grabar los cambios.
Fundamentos de programación en Power Builder
31
Ejercicio 08
Programemos en comando Curso del menú Proceso, para que muestre unmensaje. La programación se realiza en el Panel Script, se selecciona el comando,luego el evento y se programa.
Ejercicio 09
Crear una ventana de tipo MDI con micro ayuda, asóciele el menú marco m_framey grábelo con el nombre w_frame. Ahora ejecute la ventana desde el comandoRun/Preview del menú File, y pruebe el script creado en el ejercicio anterior.
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio, la librería es sistnotas01.pbl.
Fundamentos de programación en Power Builder
32
Manejo de Ventanas
Función: Open()
Abre una ventana. Open muestra la ventana y hace todas sus propiedades ycontroles disponibles en el script.
Sintaxis
Open ( WindowVar {, Parent } )
Descripción de Argumentos
Argumento DescripciónWindowVar El nombre de la ventana que usted necesita mostrar. Usted
puede especificar un objeto ventana definido en el WindowPainter (el cual es un tipo de dato Window) o una variable deun tipo de dato Window discreto. Open guarda una referencia ala ventana abierta en WindowVar.
Parent Este argumento es opcional, y solo se debe utilizar cuando laventana que se quiere abrir es de tipo Hija o Emergente.
Este argumento es la ventana Padre de la ventana Hija oEmergente que se esta abriendo.
Valor de Retorno
Retorna un valor de tipo Integer. Retorna 1 si se ejecuta en forma satisfactoria, -1si ocurre un error. Si algún argumento es NULL, retorna también NULL.
Ejemplos
El siguiente ejemplo abre una instancia de la ventana w_cursos.
Open( w_cursos )
Las siguientes sentencias abren una instancia de una ventana de tipo w_cursos.
w_cursos wi_cursosOpen( wi_cursos )
Fundamentos de programación en Power Builder
33
El siguiente script abre una instancia de una Ventana Hija de nombre w_datos y laventana w_empleado es la Ventana Padre.
w_datos wi_datosOpen( wi_datos, w_empleado )
El siguiente ejemplo abre dos instancias de la ventana w_empleado.
w_empleado w_e1, w_e2Open(w_e1)Open(w_e2)
Función: OpenSheet()
Abre un hoja dentro de una Ventana Marco MDI y crea un menú item para la hojaseleccionada en el menú especificado.
Sintaxis
OpenSheet ( SheetRefVar {,WindowType },MDIFrame {,Position {,ArrangeOpen }})
Descripción de Argumentos
Argumento DescripciónSheetRefVar Nombre de una variable de cualquier tipo de ventana que no sea
un Marco MDI.WindowType Es un argumento opcional. Una cadena cuyo valor es el tipo de
ventana que se desea abrir. El tipo de dato de WindowTypedebe ser igual o un descendiente de SheetRefVar.
MDIFrame El nombre de la Ventana MDI Marco.Position Es un argumento opcional. El número del menú item (en el
menú asociado con la hoja) en el cual usted necesita tener elnombre de las hojas abiertas. Los items del Menú Bar estánenumerados desde la izquierda, empezando en el valor 1.
ArrangeOpen Es un valor opcional. Es un valor de tipo enumerado queespecifica como se arreglará la hoja en el marco MDI en relacióncon la otras hojas abiertas, los valores que puede tomar son:
§ Cascaded! (Valor por defecto)§ Layered!§ Original!
Fundamentos de programación en Power Builder
34
Valor de Retorno
Retorna un valor de tipo Integer. Retorna 1 si se ejecuta en forma satisfactoria, -1si ocurre un error. Si algún argumento es NULL, retorna también NULL.
Ejemplos
Ejemplo 01
OpenSheet(w_cursos, w_frame, 2, Original!)
Ejemplo 02
window w_childOpenSheet(w_child, "w_cursos", w_frame, 4, Layered!)
Función: Close()
Cierra una ventana.
Sintaxis
Close ( WindowName )
Descripción de Argumentos
Argumento DescripciónWindowName Nombre de la ventana que se desea cerrar.
Valor de Retorno
Retorna un valor de tipo Integer. Retorna 1 si se ejecuta en forma satisfactoria, -1si ocurre un error. Si WindowName es NULL, retorna también NULL.
Ejemplo
Close(w_cursos)
Fundamentos de programación en Power Builder
35
Sentencia Halt
Termina una aplicación. La cláusula CLOSE hace que se desencadene el eventoClose del objeto aplicación.
Sintaxis
HALT {CLOSE}
Fundamentos de programación en Power Builder
36
Uso de Pronombres
PowerScript tiene pronombres que permiten a usted hacer una referencia general aobjetos y controles. Estos son los pronombres:
§ This
§ Parent
§ ParentWindow
§ Super
Usted puede usar los pronombres en el script de cualquier función o evento dondenecesita hacer referencia al nombre de un objeto. Por ejemplo puede usar elpronombre para:
§ Causar un evento en un objeto o control.
§ Manipular o cambiar un objeto o control.
§ Obtener o cambiar los valores de una propiedad.
Todo pronombre tiene un significado y uso que se describe a continuación:
Pronombre Aplicable a Se refiere a
This Ventana, Objeto de Usuario Custom,Menú, Objeto Aplicación y Controles.
Al objeto o control mismo.
Control en una ventana. Ventana que contiene al control.Control en un objeto de usuario. Objeto de usuario que contiene al
control.ParentMenú Item en el menú en el nivel
inmediatamente superior.
ParentWindowMenú. Ventana a la que se encuentra
asociado el menú en tiempo deejecución.
Objeto o Control Descendiente. Parent.Ventana o Objeto de Usuario Al ancestro inmediato de la
ventana descendiente o del objetode usuario.Super
Un control en una ventanadescendiente o en un objeto deusuario.
El ancestro inmediato de laventana Parent del control o delobjeto de usuario.
Fundamentos de programación en Power Builder
37
Estructuras
Las estructuras son objetos que agrupan un conjunto de variables relacionadascomo una sola unidad.
Pueden ser creadas a nivel de objeto, por ejemplo dentro de una ventana. Tambiénpueden ser globales, creadas como objetos independientes.
Ejercicio 10
Crear la estructura global s_curso, como se indica en el siguiente gráfico.
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio, la librería es sistnotas01.pbl.
Fundamentos de programación en Power Builder
38
Paso de Parámetros a una Ventana
Sintaxis 1
OpenWithParm ( windowvar, parameter {, parent } )
Sintaxis 2
OpenSheetWithParm ( sheetrefvar, parameter {, windowtype },mdiframe {, position {, arrangeopen } } )
Las funciones OpenWithParm y OpenSheetWithParm permiten pasar unparámetro a la ventana que se esta abriendo. El parámetro se guarda en el objetoMessage y puede ser uno de los siguientes tipos:
§ String
§ Numeric
§ PowerObject
El objeto Message tiene tres propiedades para guardar el dato. Dependiendo el tipode dato que se le pasa, en el evento open de la ventana debe chequear una de lassiguientes propiedades:
Propiedad del Objeto Message Tipo de Dato del ArgumentoMessage.DoubleParm NuméricoMessage.PowerObjectParm PowerObject (PowerBuilder Object, incluido
estructuras definas por el usuario)Message.StringParm String
Ejemplo 01
OpenWithParm( w_alumnos, “PB1” )
Script – Open For w_alumnos
String DatoDato = Message.StringParm• • •• • •
Fundamentos de programación en Power Builder
39
Ejemplo 02
OpensheetWithParm( w_alumnos,”PB1”,w_frame, 5, Original! )
Script – Open For w_alumnos
String DatoDato = Message.StringParm• • •• • •
Ejemplo 03
s_curso s_origens_origen.Codigo = “PB1”s_origen.Nombre = “PowerBuilder – Nivel Básico”OpensheetWithParm( w_alumnos, s_origen, w_frame, 5, Original! )
Script – Open For w_alumnos
S_curso s_destinoS_destino = Message.PowerObjectParm• • •• • •
☺ La variable utilizada en el evento open de la ventana puede ser una variable local o de tipo instancia,dependiendo si se necesita el parámetro en otros eventos de algún otro control.
Fundamentos de programación en Power Builder
40
Recibir un Parámetro de una Ventana
Solo se puede recibir parámetros de ventanas de tipo Modal (Response!). Paracerrar la ventana se debe usar la función CloseWithReturn. Esta función lo quehace es copiar el parámetro en el objeto Message, así que se debe verificar lapropiedad que corresponde al dato que se espera.
Sintaxis
CloseWithReturn ( windowname, returnvalue )
Ejemplo
String userOpen(w_user)User = Message.StringParmIf User = “admin” Then
Open(w_admin)Else
Open(w_frame)End If
En este ejemplo, si en la ventana w_user ha ingresado el administrador (admin),entonces se abre la ventana de administración (w_admin), de lo contrario se abrela ventana de operación (w_frame).
Fundamentos de programación en Power Builder
41
Manejo de Variables
Alcance
El alcance de una variable determina su visibilidad en la aplicación. En el siguientecuadro explicamos el alcance que puede tomar una variable.
Alcance DescripciónGlobal Es accesible en cualquier parte de la aplicación. Es independiente del
objeto donde se define.Instance Pertenece a un objeto y esta asociado con una instancia del objeto.
Las variables de tipo Instance se crean en cada instancia del objetoen el cual han sido definidas, y se tendrá acceso a estas variablesdesde el script del objeto y los controles asociados con el objeto.
Shared Pertenecen a la definición de un objeto y existe a través de todas lasinstancias del objeto. Las variables Shared retienen el valor cuandoun objeto es cerrado. Solo son accesibles en el script del objeto y loscontroles asociados con el objeto.
Local Es una variable temporal a la cual se puede acceder solo en el scriptdonde es definida. Cuando el script finaliza la variable deja deexistir.
Global declarations
Las variable globales pueden ser definidas en una ventana, un objeto de usuario,un menú, o en el PowerScript painter para cualquier objeto.
Instance y shared declaraciones
Instance y shared variables pertenecen a un tipo particular de objeto: ventana,objeto de usuario, menú, o el objeto aplicación. Antes de que usted pueda declarar,necesita abrir el objeto en el painter.
Local declaraciones
Estas variables se declaran en el script al que pertenecen.
Fundamentos de programación en Power Builder
42
Accediendo a una Base de Datos
Objetivos
En este primer módulo se desarrollaran los siguientes puntos:
ü Descripción de la Base de Datos a Utilizar
ü El DataBase Painter
ü Creación de una Base de Datos
ü Creación de tablas
ü Creación de claves primarias
ü Creación de claves foráneas
ü Creación de Fuente de Datos (DSN)
ü Verificar las Fuentes de Datos
ü Perfiles de Bases de Datos
ü Conexión de una Aplicación PowerBuilder con una Base de Datos
Fundamentos de programación en Power Builder
43
Descripción de la Base de Datos a Utilizar
La base de datos a utilizar se llama SistNotas.DB y por razones académicas solo vaa tener dos tablas, que pasamos a describir a continuación.
Tabla: Curso
Esta tabla sirve para guardar la información de cursos.
Tabla: Alumno
Esta tabla sirve para guardar datos de los alumnos, el curso en el que seencuentran matriculados, con sus respectivas notas.
Relación entre las tablas
Como mencione al inicio de esta sección, por razones académicas esta base dedatos solo va a tener dos tablas, y la cardinalidad es la siguiente:
§ Un curso puede tener uno ó muchos alumnos matriculados.
§ Un alumno solo puede estar matriculado en un solo curso.
☺ En www.LibrosDigitales.NET encontrará una guía completa sobre Modelamiento de Base de Datos.
Fundamentos de programación en Power Builder
44
El Database Painter
Usted puede realizar la mayor parte del trabajo de su base de datos usando elDatabase Painter. Cuando usted abre este painter, PowerBuilder muestra el nombrede las tablas, vistas, y otras entidades contenidas en la base de datos y que ustedtiene acceso. Puede trabajar con la base de datos actual hasta que se conecte conotra base de datos. Puede tener varias conexiones abiertas al mismo tiempo, noobstante, sólo una puede estar activa.
Tareas que puede llevar a cabo desde el painter:
§ Configurar fuentes de datos.§ Crear y modificar perfiles a bases de datos.§ Conectarnos a bases de datos.§ Crear tablas, vistas, claves, índices.§ Modificar los objetos de la base de datos.§ Ver gráficamente la relación entre las tablas.§ Manipular datos.§ Construir y ejecutar sentencias SQL.§ Definir y modificar atributos extendidos.§ Definir atributos extendidos para las columnas.§ Acceso a utilitarios de bases de datos.
Fundamentos de programación en Power Builder
45
Creación de la Base de Datos
Ejercicio 01
Crear la base de datos SistNotas.DB. Para crear la base de datos debe seguir lossiguientes pasos:
1. Abrir el DataBasePainter.
2. En el panel Objects,expanda la ramaODBC/Utilities y ejecute elcomando Create ASADatabase.
3. En el diálogo CreateAdaptive ServerAnywhere Databaseindique la ruta y el nombrede la base de datos (lerecomiendo que utilice elbotón Browse) y luego hagaclic en el botón Ok. Elnombre por defecto delusuario es DBA y su contraseña es SQL.
4. Finalmente tendremos la base dedatos creada, usted podrá darse cuentapor que en el panel Objects, dentro deODBC tendrá una rama SistNotas quecorresponde a la base de datosrecientemente creada.
☺ En www.LibrosDigitales.NET encontrará una guía completa sobre Modelamiento de Base de Datos.
Fundamentos de programación en Power Builder
46
Creación de Tablas
Tablas a Crear
Tabla: Curso
Column Name Data Type Width Null Header/Labelcur_cod char 3 No Códigocur_nom varchar 30 No Nombrecur_vac integer No Vacantescur_mat integer No Matriculadoscur_fec_ini date No Iniciacur_fec_fin date No Finalizacur_pro varchar 30 No Profesor
Tabla: Alumno
Column Name Data Type Width Null Header/Labelalu_cod char 5 No Códigoalu_pat varchar 15 No Paternoalu_mat varchar 15 No Maternoalu_nom varchar 15 No Nombrecur_cod char 3 No Cursoalu_n1 float Yes Nota 1alu_n2 float Yes Nota 2alu_n3 float Yes Nota 3alu_n4 float Yes Nota 4alu_pr float Yes Promedio
Ejercicio 02
Crear la tabla Curso. Para crear la tabla curso debe seguir los siguientes pasos:
1. Ejecutar el comando Create New Table, que lo puede hacer del desplegabledel PainterBar ó del menú Object/Insert.
2. Luego en el panel Columns definir las columnas de la nueva tabla.
Fundamentos de programación en Power Builder
47
3. Después de haber definido las columnas, debe grabar la tabla con el comandoSave que lo puede ejecutar del PainterBar ó del menú File.
Ejercicio 03
Siguiendo los pasos del ejercicio anterior proceda a crear la tabla Alumno.
Fundamentos de programación en Power Builder
48
Propiedades Extendidas
Podemos especificar las propiedades extendidas de los objetos, tales como tablas ycolumnas, tal como se muestra en el siguiente gráfico. En el panel Objects, debehacer doble clic en la columna que desea especificar sus propiedades extendidas.
Ejercicio 04
Defina las propiedades extendidas de las columnas de las tablas creadas.
Fundamentos de programación en Power Builder
49
Creación de Claves Primarias
Un aspecto muy importante en una tabla es la clave primaria que identifica cadauno de los registros de manera única, a continuación veremos en forma prácticacomo se crea una clave primaria.
Ejercicio 05
Crear la Clave Primaria para la tabla Curso. Los pasos que debe seguir son lossiguientes:
1. Seleccionar la tabla curso, lo puede realizar en el panel Objects ó en el panelObject Layout.
2. Ejecutar el comando Create New PrimaryKey, lo puede realizar del desplegable delPainterBar ó del menú Object/Insert.
3. En el panel Primary Key, marcar lacolumna (las columnas cuando sea el caso)que corresponde a la clave primaria.
4. Actualizar la base de datos.
Ejercicio 06
Siguiendo los mismos pasos que se han utilizado para la tabla Curso, proceda acrear la clave primaria para la tabla Alumno.
Fundamentos de programación en Power Builder
50
Creación de Claves Foráneas
La clave foránea de una tabla es otro aspecto muy importante, ya que no solodefine la relación que tiene con otras tablas de la base de datos, si no que tambiénse utiliza para definir reglas de integridad referencial. A continuación veremos enforma práctica como se crea una clave foránea.
Ejercicio 07
Crear la Clave Foránea para la tabla Alumno. Los pasos que debe seguir son lossiguientes:
1. Seleccionar la tabla alumno, lopuede realizar en el panel Objectsó en el panel Object Layout.
2. Ejecutar el comando Create NewForeign Key, lo puede realizar deldesplegable del PainterBar ó delmenú Object/Insert.
3. En la ficha General del panel ForeignKey, seleccionar la columna de la tablaAlumno que corresponde a la clave foránea,y asígnele un identificador, por ejemplofkCurso.
4. En la ficha Primary Key del panelForeign Key seleccionar la tabla Curso.
5. Actualizar la base de datos.
Fundamentos de programación en Power Builder
51
Creación de Fuente de Datos (DSN)
Una fuente de datos (DSN) es una lista de parámetros para la conexión con unabase de datos utilizando ODBC.
Creación de una Fuente de Datos (DSN)
Los pasos que debe seguir son:
1. Cargar el Administrador ODBC, lo puede realizar desde el panel de control ódesde los utilitarios de Database Painter.
2. Seleccionar el tipo de fuente de datos que desea crear, de usuario, de sistemaó de archivo.
3. Ejecutar el botón Agregar.
☺ Pronto se ampliará éste tema, no olvide revisar la actualización en www.LibrosDigitales.NET
Fundamentos de programación en Power Builder
52
4. En el diálogo Crear nuevo origen de datos, seleccionar el controlador segúnla base de datos a la cual nos vamos va conectar, y luego hacer clic en el botónFinalizar.
5. Luego, según el controlador que ha seleccionado usted tendrá un nuevo diálogodonde ingresará los parámetros que le solicita, después debe ejecutar eldiálogo haciendo clic en el botón Aceptar.
6. Finalmente debe cerrar el Administrador ODBC haciendo clic en el botónAceptar.
Ejercicio 08
En el laboratorio se le proporcionara dos bases de datos, para que usted proceda acrear dos fuentes de datos, según el siguiente cuadro:
Base de DatosFuente de Datos(DSN) Comentario
NWind.MDB NWind Búsquelo en su disco duro.PeruBank.DB PeruBank Solicítelo a su profesor.
Fundamentos de programación en Power Builder
53
Verificar la Fuentes de Datos
Ejercicio 09
Revisar el archivo ODBC.INI.
Ejercicio 10
Revisar el Registro de Windows.
HKEY_CURRENT_USER/SOFTWARE/ODBC/ODBC.INI
Fundamentos de programación en Power Builder
54
Perfiles de Bases de Datos
Es un nombre que identifica un conjunto de parámetros en el archivo deinicialización de PowerBuilder (PB.INI), y define una conexión particular con unabase de datos.
Creación de un nuevo perfil de base de datos
Para crear un nuevo perfil de base de datos, debe seguir los siguientes pasos:
1. En el Database Painter, iluminar la rama ODBC.
2. De la barra de menú ejecute el siguiente comando: Object/Insert/Profile.
3. En el diálogo Database Profile Setup – ODBC ingrese los datos necesarios, yluego ejecute el diálogo.
Fundamentos de programación en Power Builder
55
Ejercicio 11
Definir dos perfiles para las dos fuentes de datos creadas anteriormente.
Ejercicio 12
Revisar el archivo PB.INI
Fundamentos de programación en Power Builder
56
Conexión de una AplicaciónPowerBuilder con una Base de Datos
Esquema de la conexión
Hay varias posibilidades para que una aplicación PB se conecte con una base dedatos, pero ahora lo haremos utilizando ODBC, el siguiente gráfico nos ilustra laforma como se lleva a cabo.
El Objeto de Transacciones
Es un objeto no visual, que establece la comunicación entre una aplicación PB y unabase de datos. En el objeto de transacciones especificamos los parámetros quePowerBuilder utiliza para conectarse con la base de datos.
El siguiente gráfico ilustra como una aplicación utiliza el objeto de transaccionespara conectarse con la base de datos.
Fundamentos de programación en Power Builder
57
Objeto de Transacciones por Defecto
Cuando usted inicia la ejecución de una aplicación, PB crea un objeto detransacciones, que es global y por defecto, el nombre de este objeto es SQLCA(SQL Communications Area). Usted puede utilizar este objeto para su aplicación (lomás usual) ó crear uno en particular.
Propiedades del Objeto de Transacciones
La siguiente tabla describe cada propiedad del objeto de transacciones. Para cadauna de las diez propiedades de conexión, también se lista el campo equivalente enel diálogo de Configuración de Perfiles de Bases de Datos.
PropiedadTipoDe
DatoDescripción
En elDatabase
profile
DBMS StringTipo de base de datos a la que nos vamosa conectar.
DBMS
Database StringNombre de la base de datos a la que nosvamos a conectar.
DatabaseName
UserID StringEl nombre o ID del usuario que seconecta a la base de datos. User ID
DBPass StringContraseña del usuario que se conectacon la base de datos.
Password
Lock String
Debería servir para fijar los niveles debloqueo en la base de datos (IsolationLavel), pero su significado varía según elDBMS.
IsolationLevel
LogID StringEl nombre o ID con el que nosconectamos al servidor de bases dedatos.
Login ID
LogPass StringLa contraseña con la que nos conectamosal servidor de bases de datos.
LoginPassword
ServerName StringNombre del servidor donde reside la basede datos. Server Name
AutoCommit Boolean
Si es True, define que PowerBuilder,después de cada sentencia demodificación de datos envíaautomáticamente un COMMIT y cierra latransacción para iniciar una nueva. Si esFalse, es el desarrollador el que se debeencargar de hacer los COMMIT yROLLBACK.
AutoCommitMode
DBParm StringContiene los parámetros específicos paraconexión según el DBMS.
DBPARM
SQLReturnData StringSegún el DBMS. debe devolver datosespecíficos al cliente como respuesta a lassentencias que este envía.
--
SQLCode LongValor de retorno de la base de datos queindica el éxito o el fracaso de la operaciónSQL más reciente llevada a cabo.
--
Fundamentos de programación en Power Builder
58
PropiedadTipoDe
DatoDescripción
En elDatabase
profile
SQLNRows LongNúmero de filas afectadas por laoperación SQL mas reciente. --
SQLDBCode Long Código de error de la base de datos. --
SQLErrText StringMensaje que describe el error ocurrido enla base de datos, y corresponde al códigoobtenido en SQLDBCode.
--
Sentencia: Connect
Sintaxis
CONNECT {USING TransactionObject} ;
Conecta un objeto de transacciones con una base de datos, el parámetroTransactionObject es obligatorio cuando no se esta utilizando el objeto detransacciones por defecto.
Sentencia: Disconnect
Sintaxis
DISCONNECT {USING TransactionObject} ;
Desconecta un objeto de transacciones de una base de datos, el parámetroTransactionObject es obligatorio cuando no se esta utilizando el objeto detransacciones por defecto.
Fundamentos de programación en Power Builder
59
Ejercicio 13
Crear el script que permita la conexión y desconexión de una aplicación con la basede datos SistNotas.DB.
Para el desarrollo de este ejercicio utilizaremos la aplicación creada en la sesiónanterior.
Programar la conexión
Script - Open For SistNotas
// Inicializando el Objeto de TransaccionesSQLCA.DBMS = "ODBC"SQLCA.AutoCommit = FalseSQLCA.DBParm = "ConnectString='DSN=SistNotas;UID=dba;PWD=sql'"
// Realizando la conexiónConnect ;
// Verificando la ConexiónIf sqlca.sqlcode <> 0 Then
Beep(2)MessageBox( "Error en conexión", &
"Número de error: " + string(sqlca.sqlDBCode) + char(13) + &"Mensaje: " + sqlca.sqlErrText + char(13) + Char(13) + &"Programa Abortado" )
HaltEnd IfMessageBox( "Mensaje","Conexión Conforme" )Open( w_frame )
Programar la desconexión
Script - Close for SistNotas
// Desconexión de la base de DatosDisconnect ;
Probar la aplicación
Ahora puede ejecutar la aplicación, y si no ha cometidoningún error, debe tener el siguiente mensaje.
☺ En www.LibrosDigitales.NET encontrará la solución de este ejercicio. La librería es SistNotas02.PBL.
Fundamentos de programación en Power Builder
60
El DataWindows
Objetivos
En este primer módulo se desarrollaran los siguientes puntos:
ü Introducción a los DataWindows
ü Estilos de Presentación para un DataWindow
ü Fuentes de Datos para un DataWindow
ü Estilos de Edición de las columnas
ü Propiedades de Actualización de un DataWindow
ü Acciones Predeterminadas para los botones de un DataWindow
ü Funciones del Control DataWindow
ü Validación de Datos
ü Completar la aplicación
Fundamentos de programación en Power Builder
61
Introducción de los DataWindows
El objeto DataWindow se utiliza para recuperar, presentar, y manipular datos desdeuna base de datos relacional u otra fuente de datos.
En el Objeto DataWindow es sin duda alguna el principal objeto de PowerBuilder, yel más utilizado, ya que con este objeto podemos realizar múltiples tareas, comopor ejemplo:
§ Presentación de datos en diferentes formatos.
§ Flexibilidad de tratamiento de datos, según convenga; fila por fila, o varias filasa la vez.
§ Una misma interfaz y entorno de desarrollo de objetos de acceso a datos einformes.
§ Reusabilidad del código generado mediante el uso del mecanismo de herencia.
§ Gestión automática de bloqueos y transacciones.
§ Generación gráfica de las sentencias de Fuente de Datos.
§ Modificación dinámica de todos los aspectos (visuales y de comportamiento) delobjeto, en tiempo de ejecución.
§ Etc.
Esquema de Funcionamiento
El DataWindow es una clase de acceso y manipulación de datos de la Base deDatos. Trabaja estrechamente con la clase Transaction para desempeñar sutrabajo, la cual, a su vez, se apoya en los drivers correspondientes para acceder ala base de datos. Este modo de funcionamiento le permite que sea en la mayoría delos casos portable entre diferentes bases de datos, debido a que representa unnivel de abstracción por encima de los diferentes drivers.
Como podemos apreciar en el gráfico anterior, existe un Control DataWindow,que se ubica en la ventana, y un Objeto DataWindow; es en el objeto dondedefinimos la fuente de datos, el estilo de presentación, las propiedades de edición,etc. Por otro lado es el Control DataWindow el que tiene todas las funciones quenos permiten tener todo el control sobre los datos que se recuperan.
Podemos afirmar que el Control DataWindow y el Objeto DataWindow forman unapareja inseparable para poder realizar su trabajo, cada uno en forma independienteno nos sirve, también es necesario resaltar que el prefijo para dar nombre a unObjeto DataWindow es d_ y para el Control DataWindow es dw_.
Fundamentos de programación en Power Builder
62
Para realizar la asociación entre un Objeto DataWindow y un Control DataWindowtenemos dos alternativas:
1. Definir el nombre del Objeto DataWindow como propiedad del Control.
2. Definir el nombre del Objeto DataWindow en tiempo de ejecución, como sepuede ver a continuación:
dw_curso.DataObject = “d_curso” // Asociación del objeto con el controldw_curso.SetTransObject( SQLCA ) // Asociación con el objeto de transaccionesdw_curso.Retrieve() // Recuperación de datos
Fundamentos de programación en Power Builder
63
Estilos de Presentación para un DataWindow
El DataWindow tiene varios estilos de presentación, algunos orientados a lamanipulación de datos y otros a la creación de informes, tal como se muestra en elsiguiente gráfico.
Fuentes de Datos para un DataWindow
Los datos que se cargan en el DataWindow provienen de una fuente de datos, lostipos que tenemos a disposición los podemos ver en el siguiente gráfico.
Fundamentos de programación en Power Builder
64
Ejercicio 01
Crear un Objeto DataWindow de nombre d_man_curso, con las siguientesespecificaciones:
§ Estilo: FreeForm
§ Fuente de Datos: Quick Select
§ Tabla: Curso
§ Columnas: Todas
Los pasos que debe seguir son:
1. En la ficha DataWindow del diálogo New, ilumine el icono FreeForm y luegohaga clic en el botón Ok.
2. En el diálogo Choose Data Source for Freeform DataWindow, ilumine elicono Quick Select y luego haga clic en el botón Next.
3. En el diálogo Quick Select, seleccione la tabla Curso y todas sus columnas, yluego haga clic en el botón Ok.
Fundamentos de programación en Power Builder
65
4. En el diálogo Select Color and Border Settings, seleccione las propiedadessegún su criterio ó de lo contrario asuma los valores por defecto, luego hagaclic en el botón Next.
5. En el diálogo Ready to Create FreeForm DataWindow, haga clic en el botónFinish.
Fundamentos de programación en Power Builder
66
6. Ahora que ya tenemos el Objeto DataWindow, debe proceder a grabarlo.
Fundamentos de programación en Power Builder
67
Estilos de Edición de las columnas
Tenemos varios estilos de edición para las columnas, estos estilos permitenuniformizar los datos que ingresan los usuarios, así como también la selección devalor correctos provenientes de una lista, que bien podría ser creada a partir de losvalores de una tabla, como por ejemplo la selección del código de un producto, laselección del código de un curso, etc.
La selección de un estilo de edición se realiza en ficha Edit del panel depropiedades, tal como se muestra en el siguiente grafico.
Fundamentos de programación en Power Builder
68
Ejercicio 02
Según el siguiente cuadro establezca las propiedades de edición de las columnas.
Columna Propiedad ValorCur_cod Style Type
CaseEditUpper (1)
Cur_nom Style TypeCaseAlignment
EditUpper (1)Left (0)
Cur_vac Style TypeMaskSpin ControlSpin IncrementSpin MinSpin Max
EditMask##Sí1140
Cur_mat Style TypeMaskSpin ControlSpin IncrementSpin MinSpin Max
EditMask#0Sí1040
Cur_fec_ini Style TypeMaskSpin ControlSpin Increment
EditMaskdd/mm/yyyySí1
Cur_fec_fin Style TypeMaskSpin ControlSpin Increment
EditMaskdd/mm/yyyySí1
Cur_pro Style TypeCaseAlignment
EditUpper (1)Left (0)
Fundamentos de programación en Power Builder
69
Propiedades de Actualizaciónde un DataWindow
Por defecto el objeto DataWindow solo puede actualizar una tabla. Para indicar laspropiedades de actualización ejecute el comando Update Properties del menúRow, y tendremos acceso al diálogo Specify Update Properties, es en estediálogo donde indicaremos las características de actualización que tendrá elDataWindow.
Ejercicio 03
Establezca las propiedades de actualización de la tabla Curso como se muestra enel siguiente gráfico.
Row/Update Properties...
Fundamentos de programación en Power Builder
70
Acciones Predeterminadaspara los botones de un DataWindow
Dentro del objeto DataWindow podemos insertar una serie de controles. Laintroducción de algunos estos controles se debe principalmente a la posibilidad deejecución de un DataWindow de manera independiente en formato Plung-In dentrode un Visualizador de Páginas HTML. Su funcionalidad se puede emplear también enun entorno de aplicaciones Cliente/Servidor.
En esta oportunidad nos ocuparemos del control Button. Usted puede colocar estecontrol en cualquier posición del DataWindow, y luego se puede acceder a el comosi se tratara de cualquier columna.
El control Button permite la ejecución de una acción, esta puede una acciónpredeterminada ó definida por el usuario. Veamos las principales propiedades deeste control.
Propiedad DescripciónAction La acción que el usuario le asigna al botón.
DefaultPictureDetermina si se utiliza la imagen por defecto si se haseleccionado una acción predeterminada.
Name El nombre del botón.
PictureNameIndica la ubicación y el nombre del archivo que contienela imagen que se mostrará en el botón.
SuppressEventProcessingDetermina si se disparan o no los eventos ButtonClickedy ButtonClicking para un botón en particular.
Text El texto que muestra el botón.
Fundamentos de programación en Power Builder
71
Ejercicio 04
En la banda Footer del DataWindow d_man_curso defina los siguientes botones:
El siguiente cuadro le servirá de guía para establecer las propiedades de losbotones, para una mejor comprensión se han enumerado los botones de izquierda aderecha. Los valores de las propiedades se deben establecer en la Ventana dePropiedades. El valor de la propiedad Name es el que toma por defecto.
Número Propiedad Valor
1TextActionAction Default Picture
<Blanco>Retrieve (2)Si
2TextActionAction Default Picture
<Blanco>Update (13)Si
3TextActionAction Default Picture
<Blanco>InsertRow(12)Si
4TextActionAction Default Picture
<Blanco> DeleteRow(10)
5TextActionAction Default Picture
<Blanco>PageFirst(6)Si
6TextActionAction Default Picture
<Blanco>PagePrior(5)Si
Fundamentos de programación en Power Builder
72
Número Propiedad Valor
7TextActionAction Default Picture
<Blanco>PageNext(4)Si
8TextActionAction Default Picture
<Blanco>PageLast(7)Si
Luego de grabar los cambios podemos realizar una vista preliminar.
Fundamentos de programación en Power Builder
73
Ejercicio 05
Creación de la ventana de mantenimiento de cursos, debe seguir los siguientespasos:
1. Crear una nueva ventana, asígnele el nombre w_man_curso y un tituloadecuado.
2. Agregar un Control DataWindow y asígnele el nombre dw_man_curso yasócielo con el Objeto DataWindow d_man_curso (en el panel depropiedades).
3. codifique el siguiente script en el evento open de la ventana:
Script - Open for w_man_curso
dw_man_curso.SetTransObject( SQLCA )dw_man_curso.Retrieve()
4. Grabar la ventana.
5. Programar el comando Proceso/Curso del menú marco.
Script - clicked for m_pro_curso
OpenSheet( w_man_curso,w_frame,4,Original! )
6. Ahora puede usted ejecutar la aplicación y realizar la prueba respectiva.
Fundamentos de programación en Power Builder
74
Funciones del Control DataWindow
Funciones de Desplazamiento
1. ScrollNextRow()
2. ScrollPriorRow()
3. ScrollToRow ( long row )
4. ScrollNextPage()
5. ScrollPriorPage()
Funciones de Mantenimiento
6. SetTransObject ( transaction transaction )
7. Retrieve ( {, any argument, any argument . . . } )
8. InsertRow ( long row )
9. DeleteRow ( long row )
10. Update ( { boolean accept {, boolean resetflag } } )
11. DeletedCount()
12. ModifiedCount ()
Otras Funciones
13. SetFocus()
14. GetRow()
15. GetColumn()
16. GetColumnName()
17. GetItemDate ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
18. GetItemDate ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
19. GetItemDateTime ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
Fundamentos de programación en Power Builder
75
20. GetItemDateTime ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
21. GetItemDecimal ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
22. GetItemDecimal ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
23. GetItemNumber ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
24. GetItemNumber ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
25. GetItemStatus ( long row, integer column, DWBuffer dwbuffer )
26. GetItemStatus ( long row, string column, DWBuffer dwbuffer )
27. GetItemString ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
28. GetItemString ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
29. GetItemTime ( long row, integer column {, DWBuffer dwbuffer, booleanoriginalvalue } )
30. GetItemTime ( long row, string column {, DWBuffer dwbuffer, booleanoriginalvalue } )
31. SelectRow ( long row, boolean select )
32. SetColumn( NúmeroColumna | NombreColumna )
33. SetRow ( long row )
34. SetRowFocusIndicator ( RowFocusInd focusindicator {, integer xlocation {,integer ylocation } } )
35. Reset()
36. RowCount()
Fundamentos de programación en Power Builder
76
Validación de Datos
La introducción interactiva de datos en un DataWindow se realiza en una fila,columna a columna. El usuario introduce los valores apropiados para cada campo yes responsabilidad del desarrollador crear las reglas de validación necesarias paraaceptar o rechazar el valor introducido. En el Database Painter es posible crearreglas de validación genéricas y luego asociarlas a varias columnas de la estructurade datos, como se ilustra en los siguientes gráficos..
Creación de una Regla de Validación
Asociando una Regla de Validación a una columna
Lo que veremos a continuación es cuando se aplica una regla y como se aceptan orechazan los valores.
Cuando el usuario se encuentra con el cursor en un campo, ese campo tiene dosceldas: un de edición y otra de almacenamiento del dato dentro del buffer primario.Cuando el usuario entra en ese campo, los valores de ambas celdas coinciden. Siempieza a introducir datos en la celda, lo está haciendo en la celda de edición y esen ese momento cuando empieza a ser diferente su contenido de la celda delbuffer.
Fundamentos de programación en Power Builder
77
La validación del dato introducido se realiza en cualquiera de los siguientes casos:
1. El usuario pula tecla Enter.
2. El usuario pulsa la tecla Tab y se mueve dentro de otra columna del objetoDataWindow.
3. El usuario pulsa con el botón del Mouse otra columna del objeto DataWindow.
4. Desde el código se ejecuta la función AcceptText().
Cada una de estas acciones provoca que se intente pasar el valor de la celda deedición a la celda del buffer primario. Durante este traspaso del valor de un sitio aotro se realiza la validación del valor de la celda de edición. Cada vez que seejecuta una de las cuatro acciones anteriores y el usuario ha introducido un valordentro de la celda de edición sucede esta secuencia de preguntas.
¿Es correcto el tipo de datointroducido dentro de la celda?
Esta pregunta la hace directamente PowerBuilder. El usuario refuerza la validaciónde tipos de datos, simplemente asignando, durante el proceso de creación de unDataWindow, una columna de base de datos a una columna del objeto. Si el tipo dedato no es el esperado, Sucede el evento ItemError del control DataWindow.
¿Satisface el valor la regla devalidación asociada a la celda?
La regla de validación se puede asociar a la celda de dos maneras: desde el PainterDatWindow o desde el Painter Database mediante la asociación de un AtributoExtendido de tipo validación a la columna de una tabla. Si existe la regla, se evalúael valor de acuerdo a la misma. Si no cumple, sucede el evento ItemError. Si laregla no existe, se salta este paso.
El evento ItemError nos ofrece la posibilidad de tratar el error. Existen valores deretorno asociados a este evento que nos brindan toda la gama de comportamientosque puede requerir el tratamiento de un error de edición.
Valores de retorno del evento ItemErrorValor de Retorno Comportamiento
0 Rechaza el valor introducido y presenta el mensaje de error.1 Rechaza el valor y no presenta el mensaje.2 Acepta el valor erróneo.
3Rechaza el valor pero permite el cambio de la posición delcursor.
Fundamentos de programación en Power Builder
78
¿Existe realmente un valor dentro de lacelda de edición? ¿Ha cambiado el valor inicial?
El DataWindow es este punto comprueba el contenido de las dos celdas. En caso deque sean iguales, simplemente abandona el proceso de validación. Si no lo son seprosigue con la validación.
¿Existe código en el evento ItemChanges?
Este evento sucede dentro de un control DataWindow cada vez que el foco pasa deuna celda a otra. Si las validaciones que se desean aplicar a la columna son losuficientemente complicadas como para que las reglas de validación tradicional nosean suficientes para su implementación, se realiza la codificación en este evento.Esto sucede frecuentemente para validaciones cruzadas contra valores que no seencuentran en la misma fila del objeto DataWindow. Si el valor no pasa lasvalidaciones, sucede el evento ItemError.
Con el evento ItemChanged sucede lo mismo que con el ItemError; nos permitemodificar el comportamiento inicial en condiciones de error según los valores de latabla siguiente.
Valores de retorno del evento ItemChangedValor de Retorno Comportamiento
0 Acepta el dato.1 Rechaza el dato y provoca un evento ItemError.2 Rechaza el valor pero permite el cambio de la posición del
cursor.
Las estrategias de validación no acaban aquí. Aparte de las reglas de validacióndefinidas dentro del painter DataWindow, tenemos la posibilidad de definir Tablasde Código. Estas tablas de código nos permiten introducir un número pequeño devalores dentro de algunos estilos de edición como puede ser el CheckBox, losBotones de Radio y Listas Desplegables. Estos valores permiten que el usuario, envez de introducir un dato, pueda seleccionar uno de los datos que se le ofrece,minimizando la posibilidad de error.
Si la tabla de códigos es a su vez una tabla de la base de datos se puede usar elestilo de edición DropDownDataWindow, que permite enlazar un objetoDataWindow con otro objeto DataWindow desplegable.
Fundamentos de programación en Power Builder
79
Ejercicio 06
Realice las modificaciones necesarias en la ventana w_man_curso para que tengala apariencia que se muestra a continuación.
Ejercicio 07
Desarrolle una ventana para la matricula de nuevos alumnos.En el diálogo Seleccione Curso solo se debe mostrar los cursos que tienen vacantes,después de seleccionar el curso, debe hacer clic en el botón Matricular
Después de hacer clic en el botón Matricular aparece un diálogo modal donde sedebe ingresar los datos del alumno.
Fundamentos de programación en Power Builder
80
Después de ingresar los datos del alumno, acepta la matricula haciendo clic en elbotón Grabar, ó la cancela haciendo clic en el botón Cancelar.
Ejercicio 08
Desarrolle una ventana para el ingreso de notas.
☺ Los ejemplos los puede bajar de www.LibrosDigitales.NET.
Fundamentos de programación en Power Builder
81
Próxima Entrega
Edición 1.1Dentro de una semana
Prohibida la reproducción total o parcialSin nuestro consentimiento
Derechos de copia reservadoswww.LibrosDigitales.NET