COMPONENTES DE UNA APLICACIÓN POWERBUILDER.

Transcripción

1 ENTRENAMIENTO EN POWER BUILDER Ing. Ismael Castañeda Fuentes Departamento de Ingenieía de Sistemas UNIVERSIDAD NACIONAL DE COLOMBIA Bogotá, Diciembre de 2000

2 ENTRENAMIENTO EN POWER BUILDER PowerBuilder es una herramienta computacional que permite la elaboración de aplicaciones cliente/servidor utilizando principalmente elementos gráficos. Las aplicaciones desarrolladas con PowerBuilder se almacenan en una librería (PowerBuilder Library, archivos caracterizados con el tipo *.PBL ). Una vez desarrollada una aplicación PowerBuilder, se crea un archivo tipo *.EXE para que los usuarios ejecuten la aplicación desde Windows cuando lo deseen. La versión 7.0 del entorno integrado para desarrollo de aplicaciones empresariales ofrece mejoras significativas en rendimiento y productividad, y un amplio soporte para componentes estándar, basados en Web. Con el Nuevo Web DataWindow, usted puede desplegar sus aplicaciones en cualquier browser comercial. La completa integración con Enterprise Application Server 3.0, tanto en la etapa de desarrollo, como en la fase de implantación, proporciona alta confiabilidad, disponibilidad y escalabilidad para aplicaciones PowerBuilder desarrolladas para la Web. COMPONENTES DE UNA APLICACIÓN POWERBUILDER. Objetos. Un objeto es una forma de comunicación con el usuario, por ejemplo una ventana o un menú. Nombres de objetos PowerBuilder: Application object Window DataWindow Menu Global functions Queries Structures User objects Libreries Projetcs Eventos. Un evento puede ocurrir cuando un usuario ejecuta una acción con el ratón, el teclado, por una orden del lenguaje PowerScript de PowerBuilder o por el mismo sistema. Ing. Ismael Castañeda Fuentes Página 1 de 55

3 Algunos de los eventos más comunes son: Clic (clicked) Doble clic (DoubleClicked) Modificación (Modified) Abrir (Open) Cerrar (Close) Tomar el foco (GetFocus) Perder el foco (LoseFocus) Cambiar la selección (SelectionChanged) Scripts. Un script es un conjunto de órdenes escritas en lenguaje PowerScript que se deben ejecutar al ocurrir un evento. COMPONENTES DE UNA VENTANA. Controles. Un control es un objeto colocado en una ventana. Los controles son: CheckBox CommandButton DataWindow DropDownListBox DropDownPictureListBox EditMask Graph GroupBox HscrollBar Line ListBox ListView MultiLineEdit OLEcontrol OLECustomControl Oval Picture PictureButton PictureListBox RadioButton Rectangle RichTextEdit RoundRectangle SingleLineEdit StaticText Tab Ing. Ismael Castañeda Fuentes Página 2 de 55

4 TreeView UserObject VscrollBar Focus. Identifica el lugar de la pantalla donde va a suceder la siguiente acción. Para establecer el foco en un sitio deseado, el usuario puede: Mover con el ratón el apuntador a un control y hacer clic. Presionar la tecla del tabulador hasta el control deseado. Un control puede perder el foco cuando el usuario: Hace clic en otro control. Hace clic en otra ventana donde no hay controles. Presiona la tecla del tabulador y pasa a otro control. Atributos. Los objetos y controles tienen atributos que definen su: Apariencia. Comportamiento. LENGUAJE POWERSCRIPT Es un lenguaje de alto nivel basado en objetos con el cual se pueden construir scripts. PowerScript tiene: Comandos, por ejemplo IF... THEN. Funciones predefinidas para manipular objetos, números, textos, para procesar fechas y datos de tiempo, imprimir reportes, ejecutar DDE (Dynamic Data Exchange), manejar archivos; por ejemplo SHOW, MOVE, OPEN, MAX, HIDE. Las funciones regresan un valor (return value) que puede ser utilizado o ignorado. Proposiciones SQL, por ejemplo SELECT, INSERT, UPDATE. Variables: Locales en un script. A nivel de una ventana/objeto. Globales. Convenciones aconsejadas por PowerBuilder para dar nombre a los objetos: OBJETO PREFIJO EJEMPLO CheckBox cbx_ cbx_caja_para_control CommandButton cb_ cb_boton_para_comando DataWindow Control dw_ dw_ventana_para_datos_tabulares DataWindow Object d_ d_objeto_para_datos_tabulares Ing. Ismael Castañeda Fuentes Página 3 de 55

5 DropDownListBox ddlb_ ddlb_caja_para_escoger_opciones DropDownPictureListBox ddplb_ ddplb_lista_de_dibujos EditMask em_ em_formato_para_datos Function f_ f_nombre_de_funcion Graph gr_ gr_grafico GroupBox gb_ gb_caja_para_agrupar HscrollBar hsb_ hsb_deslizamiento_horizontal Line ln_ ln_linea ListBox lb_ lb_caja_para_presentacion ListView lv_ lv_despliegue_de_lista Menu m_ m_menu MultiLineEdit mle_ mle_multiples_lineas OLEcontrol ole_ ole_a_ms_word Oval oval_ Oval_ovalo Picture p_ p_dibujo PictureButton pb_ pb_boton_grafico PictureListBox plb_ plb_caja_con_graficos Project p_ p_proyecto RadioButton rb_ rb_boton_exclusivo Rectangle r_ r_rectángulo RichTextEdit rte_ rte_texto_enriquecido RoundRectangle rr_ rr_rectangulo_bordes_redondeados SingleLineEdit Sle_ sle_linea_para_edicion StaticText st_ st_titulos Tab tab_ tab_carpetas TreeView tv_ tv_explorador Structure s_ s_estructura UserObject u_ u_objeto_del_usuario VscrollBar vsb_ vsb_deslizamiento_vertical Window w_ w_nombre_de_ventana Cuando se están creando los objetos, PowerBuilder sugiere un nombre para el objeto utilizando el prefijo de la tabla anterior y un número. Ellos aconsejan cambiar este número por algo significativo para el usuario que está elaborando el aplicativo. Ing. Ismael Castañeda Fuentes Página 4 de 55

6 EJERCICIO PRÁCTICO El ejercicio deben hacerlo de forma individual y presentarlo funcionando perfectamente, desde ejecutable y desde PowerBuilder. En grupo deben presentar un informe, indicando sus comentarios sobre este documento, errores encontrados, sugerencias para mejorarlo y utilidad al realizar el ejercicio. Elaborar una Aplicación sencilla, que permita manipular información del personal de una Empresa así: a) Listar todos los empleados, b) Buscar los empleados que concuerden con el nombre y/o el primer apellido digitado por el usuario, c) Buscar los empleados de un determinado Departamento. Una vez obtenida la lista, al hacer la selección de un empleado ver sus datos detallados. La aplicación también debe estar en capacidad de ejecutar las acciones de impresión, adición, modificación y borrado de datos de empleados. Como un servicio adicional de la Aplicación, se debe proporcionar una Calculadora que esté en capacidad de ejecutar las cuatro operaciones aritméticas básicas: suma, resta, multiplicación y división de dos valores dados por el usuario. Estructura de la aplicación: Los pasos indicados a continuación corresponden a un procedimiento que se puede seguir utilizando PowerBuilder 7.02 y Sistema Operativo Windows 98 (de forma similar en Windows 95, NT y 2000): 1. Entrar a Windows. 2. Escoger un directorio exclusivo para dejar todos los archivos del ejercicio (recomendado). 3. Copiar en este directorio: Tres (3) archivos tipo *.bmp Tres (3) archivos tipo *.ico 4. Activar PowerBuilder. Ing. Ismael Castañeda Fuentes Página 5 de 55

7 5. Crear una aplicación: 5.1. Crear una nueva aplicación: En barra de herramientas New Start Wizards Application, o, En menú File New Start Wizards Application 5.2. Llenar los datos de la ventana Specify New Application and Library, así: Application Name Escribir el nombre del archivo donde va a quedar la Librería. Library Seleccionar el directorio donde se van a dejar los archivos del ejercicio Finish. Automáticamente PowerBuilder genera un archivo con extensión.pbl y una aplicación con el mismo nombre del archivo. Si se quieren colocar comentarios a la aplicación creda, y/o crear una aplicación con otro nombre, se abre y al guardar, se coloca el nuevo nombre y/o se escriben los comentarios deseados, así: En barra de herramientas Open Object Type: Application Seleccionar el nombre de la aplicación OK Ing. Ismael Castañeda Fuentes Página 6 de 55

8 File Save as Seleccionar archivo Guardar Save Application Aparece nombre de la aplicación y directorio seleccionado (aquí se puede colocar otro nombre a la aplicación, entonces Power Builder crea otra aplicación con el nombre actual) Comments: Escribir un comentario significativo relacionado con la aplicación OK 5.4. Escritorio de la Aplicación: Mediante la opción Library de la Barra de Herramientas se puede tener un explorador (similar al Explorador de Windows) en el cual se pueden visualizar y seleccionar: los directorios, las librerias.pbl existentes y los objetos respectivos. Ing. Ismael Castañeda Fuentes Página 7 de 55

9 5.5. Se debe tener en cuenta que estando una aplicación activa para abrir otra aplicación se debe antes cerrar todos los objetos de ella abiertos y luego seleccionar la aplicación mediante la opción del menú o de la barra de herramientes Select Application Seleccionar propiedades de la aplicación: En escritorio de aplicación: Oprimir botón derecho del ratón Properties Regresar a la ventana inicial (cerrar ventanas abiertas): En barra de herramientas Close, o En menú File Close, o Ctrl + W 6. Elaborar una ventana como la siguiente: 6.1. En barra de herramientas New Object Window OK. Ing. Ismael Castañeda Fuentes Página 8 de 55

10 6.2. Para manejar el objeto creado PowerBuilder 7.02 abrirá por omisión cuatro vistas básicas en una ventana: Layout (donde podrá visualizar la forma del objeto), Script, Control y Properties ; en este caso las propiedades de una ventana son agrupadas bajo tres grupos de características: General, Scroll, Toolbar y Other. Mirar, comprobar y/o modificar características de la ventana: Si se quieren observar y/o modificar las características de la ventana, situándose en la vista de Layout y no está activa la vista de Properties, con el botón derecho Properties Para la ventana Window en el tipo de características General colocar: Identificación o título deseado ( Title : ICF Pantalla para búsqueda) Elementos activos ( Control Menu, Maximize Box, Minimize Box,...) Tipo de ventana ( Window Type ): popup! Ing. Ismael Castañeda Fuentes Página 9 de 55

11 6.4. OK En la serie de características Other Dentro de Position se puede colocar la ubicación y tamaño dentro de la pantalla 6.5. Colocar los objetos deseados dentro de la ventana y darle sus características Insertar el control CommandButton en la ventana, así: En el menú: Insert Control CommandButton En barra de herramientas: Control CommandButton En la ventana, hacer clic en el sitio donde se desea ubicar el control seleccionado Mirar, comprobar y/o modificar las características del control (hay que tener seleccionado el control deseado): En barra de herramientas Properties, o, En la vista de Properties..., o Con botón derecho dentro del control Properties..., o Doble clic dentro del control En la vista de Properties, las características de un ComandButton están agrupadas en: General, Font y Other. Dar al control CommandButton dar las características del control, tales como: Nombre del control (cb_salir). Texto deseado dentro del control. (Salir) Características de aparición. Características de las fuentes. Posición dentro de la ventana OK Ing. Ismael Castañeda Fuentes Página 10 de 55

12 Grabar el trabajo adelantado (Salvar la ventana en la librería): En barra de herramientas Save, o En menú File Save, o En menú File Save as..., o Ctrl + S En la ventana Save Window escribir: OK Nombre de la ventana (por ejemplo, w_icf_basica). Un comentario Para ver cómo va quedando el diseño de la pantalla: En barra de herramientas Preview, o En menú Design Preview, o Ctrl + Shift + P 7. Elaborar una ventana como la siguiente: Esta ventana debe heredar las propiedades de la ventana anterior (ICF -Pantalla básica). Por lo tanto se puede seguir un procedimiento similar, con las siguientes particularidades: 7.1. Cierre la ventana anterior y Cree la nueva ventana: En el menú File Inherit... (si la ventana de la cual hereda está abierta está selección no funcionará) En la ventana Inherit From Window seleccionar la ventana que da las características a heredar. Ing. Ismael Castañeda Fuentes Página 11 de 55

13 OK 7.2. Mirar y/o cambiar las características de la ventana heredada Añadir los otros controles mostrados en la figura (un CommandButton y un RadioButton) Cambiar el texto del CommandButton heredado Salir por Cancelar Los controles deben quedar con las características de visible y enabled 7.6. Grabar el trabajo adelantado (Salvar la ventana en la librería; nombre sugerido: w_icf_busqueda) 7.7. Ver cómo va quedando el diseño y si es necesario hacer las modificaciones que estime convenientes. 8. Elaborar una ventana como la siguiente: Esta ventana debe heredar las propiedades de la ventana anterior (ICF - Pantalla básica para búsqueda), con las siguientes particularidades: 8.1. Mirar y/o cambiar las características de la ventana heredada. Cambiar el texto del RadioButton heredado Otro por Todos 8.2. Añadir los otros controles mostrados en la figura: Dos SingleLineEdit, uno para Nombre y otro para Primer Apellido. Tres StaticText: Nombre, Primer Apellido y Departamento. Un DropDownListBox, con la lista de los siguientes Departamentos: Contabilidad Personal Ventas Mercadeo Desarrollo Recursos Administración Sistemas Ing. Ismael Castañeda Fuentes Página 12 de 55

14 Para agregar la lista de Departamentos, en la vista Properties del DropDownListBox en el grupo de características: Items Dos RadioButton, para Por Nombre y Por Departamento. Un GroupBox, para Buscar. Un PictureButton para Imprimir. Escoger de la lista de archivos *.BMP una figura para el caso que esté disponible el servicio de impresión y otra figura para el caso que no esté disponible. Un DataWindow, identificado como Datos de los Empleados. Allí se mostrarán los resultados de consulta a la base de datos (posteriormente se harán las asociaciones necesarias con los DataWindows object que acceden a la base de datos) Dar las demás características deseadas, tanto a la ventana como a los controles Grabar el trabajo adelantado. (nombre sugerido: w_icf_pordepto_nom) 8.5. Ver cómo va quedando el diseño y si es necesario, hacer las modificaciones que estime convenientes. 9. Elaborar una ventana como la siguiente: El objetivo es tener una calculadora en la cual se va a obtener un resultado aritmético dados dos operandos Crear la ventana y colocar sus características (ventana tipo popup) Colocar los objetos y sus características, así: Dos SingleLineEdit, para primer y segundo operando. Ing. Ismael Castañeda Fuentes Página 13 de 55

15 Cuatro StaticText, uno para colocar el resultado de la operación aritmética (el cual no tendrá texto) y tres para colocar los textos: Primer Operando, Segundo Operando y Resultado. Cuatro CommandButton, uno para cada operación: suma, resta, multiplicación y división. Dos Rectangle, uno para encerrar el resultado y otro para encerrar los CommandButton de las operaciones aritméticas Grabar el trabajo adelantado Ver cómo va quedando el diseño y (si es necesario) hacer las modificaciones que estime convenientes. 10. Colocar el punto de entrada del aplicativo (inicio de ejecución). Inicialmente direccionar directamente a la Calculadora En barra de herramientas Open Object Type: Application Seleccionar el nombre de la aplicación OK Al abrir el objeto Application PowerBuilder abre por omisión tres vistas básicas: Script, Declare instance variables y Non Visual Object List Para programar el evento inicial de la aplicación, escribir el programa (script) para abrir la ventana con el cual inicia el aplicativo; en esta primera etapa será la ventana donde está el diseño de la calculadora. En la vista de Script de la aplicación seleccionar el evento open (abrir) Elaborar un programa asociado con el evento open, similar al siguiente: // open icf_1 // Punto inicial del aplicativo. open (w_icf_calculadora) //Nombre de la ventana que se desea activar. Sugerencia: Cuando se está escribiendo el programa y se necesita el nombre de un objeto o una variable, este nombre se puede traer directamente (no hay necesidad de tipearlo) utilizando las ventanas desplegables: Paste Windows, Paste Global y Paste Instance haciendo la selección apropiada. También se pueden utilizar las otras facilidades que se proporcionan a través de las barras de herramientas y opciones de los menús. Ing. Ismael Castañeda Fuentes Página 14 de 55

16 10.3. Compilarlo (paso opcional): En barra de herramientas: Compile, o En menú: Edit Compile, o Ctrl + L Volver a la ventana principal de PowerBuilder: En barra de herramientas: Close Si no hizo el paso de compilación, confirmar (compilar y grabar) o descartar los cambios realizados, en la ventana de diálogo Application : Sí, o No, o Cancelar. 11. Probar que la aplicación se puede ejecutar: En barra de herramientas: Run, o En menú: File Run, o Ctrl + R 12. Escribir las demás acciones que se desean tener al utilizar la calculadora. Se sugiere que la calculadora efectúe por lo menos las operaciones aritméticas básicas (suma, resta, multiplicación y división) y permita algunas facilidades de manejo de memoria Seleccionar la ventana de la calculadora Elaborar un programa, asociado con el evento modified (modificar), del control que recibe el primer operando, similar al siguiente: // modified sle_operando1 If not IsNumber(This.text) Then MessageBox ("Error", "Se debe dar un número", StopSign!, OK!) This.text = "" This.SetFocus() End if Para el control que recibe el segundo operando, escribir un programa similar al que recibe el primer operando Elaborar un programa, asociado con el evento clicked, del botón que va a ejecutar la operación de suma, similar al siguiente: // clic cb_suma Double oper1, oper2, oper3 oper1 = Double(sle_operando1.text) oper2 = Double(sle_operando2.text) oper3 = oper1 + oper2 st_resultado_n.text = String(oper3) Elaborar programas similares para las operaciones de resta, multiplicación y división Dejar el resultado en blanco, cuando se pase el cursor al campo que recibe el primer o segundo operando (programar el evento getfocus: st_resultado_n.text = ) Probar la aplicación. 13. Seleccionar el botón Salir de la ventana básica: w_icf_basica y asociarle un programa que cierre la ventana (programar el evento clicked), con un programa como el siguiente: Ing. Ismael Castañeda Fuentes Página 15 de 55

17 // clic cb_salir If MessageBox("Salir", "Cerrar esta ventana?", Question!, YesNo! ) = 1 then Close( Parent ) End If 14. Correr la ventana para probar su funcionamiento: En barra de herramientas File Run/Preview Object Type: Windows Object: nombre de la ventana, en este caso: w_icf_basica OK 15. Seleccionar la ventana donde se pueden hacer búsquedas Seleccionar el control Todos (RadioButton) y elaborar un programa para que cuando este control sea el seleccionado, desactive los controles que piden datos. Puede ser un programa como el siguiente: // Ventana: w_icf_pordepto_nom, Objeto: rb_todos, Heredado de: w_icf_busqueda:rb_otro // Evento: Clicked ddlb_departamento.visible = false sle_nombre.visible = false sle_primer_apellido.visible = false st_nombre.visible = false st_primer_apellido.visible = false st_departamento.visible = false dw_datos_empleados.visible = false Correr la ventana para probar su funcionamiento Seleccionar el control Por Nombre (RadioButton). Escribir un programa para que active los campos que piden los datos de nombre. Puede ser un programa como el siguiente: // Ventana: w_icf_pordepto_nom, Objeto: rb_nombre // Evento: Clicked ddlb_departamento.visible = false sle_nombre.visible = true sle_primer_apellido.visible = true st_nombre.visible = true st_primer_apellido.visible = true st_departamento.visible = false dw_datos_empleados.visible = false Correr la ventana para probar su funcionamiento Seleccionar el control Por Departamento (RadioButton). Escribir un programa para que active el control que pide el dato de Departamento. Puede ser un script como el siguiente: // Ventana: w_icf_pordepto_nom, Objeto: rb_departamento // Evento: Clicked ddlb_departamento.visible = true sle_nombre.visible = false sle_primer_apellido.visible = false st_nombre.visible = false st_primer_apellido.visible = false st_departamento.visible = true dw_datos_empleados.visible = false Correr la ventana para probar su funcionamiento. 16. Crear una función que sirva para ejecutar las cuatro operaciones básicas aritméticas: sumar, restar, multiplicar y dividir En barra de herramientas o en el menú seleccionar: NEW Object Function Llenar los datos solicitados: Valor a retornar (Return Type): string Nombre de la función. Ing. Ismael Castañeda Fuentes Página 16 de 55

18 Dar los argumentos: primer operando ( arg_operando1, tipo string, paso por valor), segundo operando ( arg_operando2, tipo string, paso por valor) y operador ( arg_operador, tipo integer, paso por valor) 17. Escribir las instrucciones que van a conformar la función. Puede ser un programa como el siguiente: // Nombre de la funcion: f_operaciones // Objetivo: Hacer un cálculo aritmético // Parámetro 1: Primer operando // Parámetro 2: Segundo operando // Parámetro 3: Operación a realizar así: // 1 Sumar // 2 Restar // 3 Multiplicar // 4 Dividir Double oper1, oper2, oper3 IF arg_operando1 = "" OR arg_operando2 = "" THEN Messagebox ("Error","Los operandos deben ser aritméticos",stopsign!, OK!) return "" END IF oper1 = Double(arg_operando1) oper2 = Double(arg_operando2) Choose Case arg_operador Case 1 oper3 = oper1 + oper2 Case 2 oper3 = oper1 - oper2 Case 3 oper3 = oper1 * oper2 Case 4 If oper2 = 0 Then Return "División por cero" Else oper3 = oper1 / oper2 End If Case else Return "Operación no válida" End Choose Return String (oper3) 18. Cambiar los programas asociados con los botones de operaciones de la ventana de la calculadora para que utilicen la función anterior Para el botón de Resta (-) puede ser un programa como el siguiente (para el evento clic): // clic para cb_resta st_resultado_n.text = f_operaciones ( sle_operando1.text, sle_operando2.text, 2 ) Proceder de manera similar para la suma, multiplicación y división Probar su funcionamiento Comprobar el funcionamiento de la Calculadora para valores con punto decimal. En caso que no funcione, hacer las modificaciones necesarias. 19. Crear una base de datos que implemente lo mostrado en la siguiente figura: Ing. Ismael Castañeda Fuentes Página 17 de 55

19 19.1. Crear localmente una nueva base de datos. Dejar el archivo físico en el directorio donde se están dejando todos los archivos de este ejercicio: En barra de herramientas: Database, o, En el menú: File New Database Database Painter, o, Window Database Painter, o, Shift + F7 Se crea una base de datos local: En Database Painter aparece la vista de Objects, en el árbol Installed Database Interfaces ODBC Utilities Create ASA Database. Ing. Ismael Castañeda Fuentes Página 18 de 55

20 Aparece la ventana Create Adaptive Server Anywhere Database, se deben llenar los datos allí pedidos: Database Name: Camino y nombre del archivo en Windows donde se va a guardar el archivo físico. Se sugiere: Browse, Llegar al directorio deseado, y Dar el nombre al archivo. User ID: Identificación del usuario. Valor por omisión: DBA Password: Clave. Valor por omisión: SQL. OK 20. Es bueno comprobar lo siguiente: En Windows Inicio Configuración Panel de Control Fuentes de datos ODBC (32 bits): Ing. Ismael Castañeda Fuentes Página 19 de 55

21 En ventana Administrador de Orígenes de Datos ODBC : DSN de usuario en donde aparece ahora una nueva entrada ODBC con el nombre del perfil creado ante la base de datos, cuyo controlador será Adaptive Server Anywhere 6.0. Al dar doble click sobre dicha entrada ODBC se aprecia la ventana ODBC Configuration for Adaptive Server Anywhere : en el tab de ODBC aparece el nombre de la fuente de datos ( Data Source Name ); en el tab de Login los datos proporcionados de User ID y Password; y en el tab de Database el nombre y la ubicación de la base de datos creada. Retornando a PowerBuilder, en la vista de Database Painter o en la vista de Database Profiles (las dos opciones de la barra de herramientas) se encuentra ahora la conexión activa (indicada por un chulo sobre el perfil) a la base de datos creada. Al dar con el ratón click derecho sobre el perfil seleccionado Properties: se puede ver la ventana Database Profile Setup ODBC : En el tab Connection se encuentra: el nombre de la fuente de datos ( Data Source Name ) y del perfil ( Profile Name ), además de los datos de User ID y Password; en el tab Preview se observa la sintaxis de la conexión a la base de datos perteneciente al perfil creado. Ing. Ismael Castañeda Fuentes Página 20 de 55

22 En caso de algún problema, hay que arreglarlo o sino la base de datos queda inalcanzable. En casos extremos: borrar la base de datos recién creada, revisar la Configuración ODBC, revisar los Profile, y ver las entradas que puedan estar causando conflicto (si es del caso borrarlas Remove). 21. Crear las tablas (Estando la base de datos activa) Definir las columnas y sus características: nombre, tipo de datos, aceptación o no de nulos, valor por omisión. Colocar letreros significativos para encabezamientos de columnas, rótulos identificadores de campos y comentarios a nivel de tabla y columna. Para ello: En la barra de herramientas Create Table, o, Conectarse a la base de datos, click para desplegar sus componentes dentro de ellos se encuentran Tables y mediante click derecho con el ratón New Table Definir las columnas Save Table as 22. Seleccionada una tabla: Definir llave primaria: click derecho sobre la cualidad Primary key New Primary key Crear índices: click derecho sobre la cualidad Index New Index Crear llaves foráneas: click derecho sobre la cualidad Foreign key New Foreign key Llenarla de datos: Click derecho sobre la tabla Edit Data (grid, tabular o freeform) Insert Row Digitar los datos Save Changes Una vez creadas y llenas todas las tablas de la base de datos cerrar la vista de DataBase Painter, en barra de herramientas Close o, en el menú, File Close. Si se le quiere hacer un cambio posterior a la tabla es posible posicionadndose sobre la tabla y mediante click derecho con el ratón escoger la opción Alter table. Ing. Ismael Castañeda Fuentes Página 21 de 55

23 23. Preparar el sitio donde se van a mostrar los datos de los empleados. Para ese fin, definir los DataWindows Object necesarios. Como primer paso definir un DataWindows que presente en forma tabular los siguientes datos: Nombre y Apellido del empleado y nombre del Departamento donde trabaja. La salida se debe presentar en orden alfabético por Apellido del empleado. Se puede seguir un procedimiento similar al siguiente: En barra de herramientas : New DataWindow Tabular OK, o, En menú: File New DataWindow Tabular OK En la ventana Choose Data Source for Tabular Datawindow (selección de la fuente de datos para el datawindow escogido): SQL Select Next En ventana Select Tables, seleccionar las tablas Empleado y Departamento Open En tabla Empleado: Código del empleado, Nombre del empleado, Apellido del empleado En tabla Departamento: Nombre del departamento En carpeta Sort : Apellido del empleado (hacer drag and drop ). Si se quiere cambiar algo en la sintaxis del código SQL, esto se puede ver con la opción del menú Design Convert to sintax Pasar a diseño de la salida: En barra de herramientas: Return Ing. Ismael Castañeda Fuentes Página 22 de 55

24 23.7. En la ventana Select color and border settings se escogen las opciones de borde y color para el datawindow. En la ventana Ready to create Tabular Datawindow aparecen las selecciones dadas con opción de Regresar (para cambiar alguna opción) o Finalizar A continuación aparece la vista de diseño Design del datawindow acompañada (por omisión) de la vista de propiedades Properties y de la vista de controles Control List, apareceran los datos de las tablas seleccionados. En la vista de diseño se puede colocar encabezados apropiados, cambiar color de fondo y otras cuantas propiedades. Tener en cuenta de que a pesar de haber seleccionado el código del empleado, no se desea en la salida!! Si se quiere volver a la ventana de Select correspondiente, escoger en barra de herramientas SQL (icono que dice SQL) Ver resultado del diseño. En el menú File Run/Preview Hacer modificaciones al diseño Probar inserciones, borrados y modificaciones a la base de datos Grabar el trabajo adelantado: En barra de herramientas: Save En ventana Save DataWindow : Colocar el nombre de la ventana (d_...) Escribir un comentario significativo OK 24. De manera similar elaborar un DataWindows donde se muestre el listado de personas, dado el código del Departamento donde trabajan. Ing. Ismael Castañeda Fuentes Página 23 de 55

25 24.1. Seguir un procedimiento similar a la creación del anterior DataWindows. Adicionalmente, en la ventana donde se seleccionan campos de las tablas (donde también aparecen las carpetas Sort, Where, Group, Having, Compute y Syntax), dar la información del argumento: En menú: Design Retrieval Arguments En ventana Specify Retrieval Arguments : escribir el nombre del argumento (por ejemplo departamento) y seleccionar el tipo de dato (por ejemplo Number) OK En carpeta Where, especificar la condición deseada, por ejemplo: 25. Elaborar un tercer DataWindows que muestre los empleados que tengan el Nombre y/o el Apellido digitado por el usuario Seguir un procedimiento similar a la elaboración del DataWindows anterior. En este caso es necesario especificar dos argumentos (por ejemplo: nombre de tipo String y apellido de tipo String) OK En carpeta Where: especificar la condición deseada, por ejemplo: Column Operator Value Logical "empleado"."empl_nombre" = :nombre Or "empleado"."empl_apellido" = :apellido 26. Elaborar un DataWindows que muestre toda la información contenida en la base de datos relacionada con un empleado. En este caso el argumento de búsqueda puede ser el código del empleado y el estilo de presentación puede ser Freeform. 27. Cambiar el Punto de Inicio del Aplicativo, para que active la ventana que muestra las opciones de búsqueda de personal y adicionalmente conecte la base de datos que se va a utilizar. Elaborar un programa similar al siguiente (evento abrir la aplicación): // open icf_1 // Punto inicial del aplicativo. // // CONEXIÓN AL MOTOR DE BASE DE DATOS // Conexión a un motor de Base de Datos SQL Anywhere con ODBC sqlca.dbms = "ODBC" sqlca.dbparm="connectstring='dsn=entrenamiento;uid=dba;pwd=sql'" MessageBox ("Motor de Base de Datos conectado:",sqlca.dbparm) connect; // Prueba para ver si quedó conectado if sqlca.sqlcode <> 0 then MessageBox ("No se pudo Conectar a la Base de Datos", & "Mensaje enviado por el sistema:~n~r'"+sqlca.sqlerrtext+"'") return end if // open (w_icf_pordepto_nom) //Nombre de la ventana que se desea activar, en este caso la de búsqueda 28. Correr la aplicación y comprobar que funciona el nuevo punto de entrada. Ing. Ismael Castañeda Fuentes Página 24 de 55

26 29. En la ventana donde se presentan las opciones de búsqueda, programar el botón de Buscar para que de acuerdo con la selección hecha (Todos, Por Nombre o Por Departamento), muestre el resultado de la búsqueda Seleccionar el evento clic del botón Buscar y elaborar un programa como el siguiente: // clic para cb_buscar IF rb_otro.checked THEN // Seleccionado todos dw_datos_empleados.visible=true dw_datos_empleados.dataobject='d_lista_empleados' dw_datos_empleados.settransobject(sqlca) dw_datos_empleados.retrieve () END IF IF rb_nombre.checked THEN // Seleccionado Por Nombre dw_datos_empleados.visible=true dw_datos_empleados.dataobject='d_empleados_dado_nombre' dw_datos_empleados.settransobject(sqlca) dw_datos_empleados.retrieve (sle_nombre.text,sle_primer_apellido.text) END IF IF rb_departamento.checked THEN // Seleccionado Por Departamento dw_datos_empleados.visible=true dw_datos_empleados.dataobject='d_empleados_depto' dw_datos_empleados.settransobject(sqlca) // Obtener el dato numérico xxx de la instrucción para pasarselo como entrada al datawindow: dw_datos_empleados.retrieve(double(ddlb_departamento.selectitem(ddlb_departamento.text,1))) END IF Correr la aplicación y comprobar su correcto funcionamiento. 30. Programar el evento doble click doubleclicked para el DataWindows Control de la ventana que permite búsqueda. Por ejemplo: // doble click para dw_datos_empleados integer l_codigo, l_casos IF dw_datos_empleados.dataobject='d_lista_empleados' OR & dw_datos_empleados.dataobject='d_empleados_dado_nombre' OR & dw_datos_empleados.dataobject='d_empleados_depto' THEN END IF l_codigo=getitemnumber(row,1) //Supone que en los DataWindows la primera Columna //corresponde al código del trabajador!!!!!!!!!!!! dw_datos_empleados.dataobject='d_detalle_empleado' dw_datos_empleados.settransobject(sqlca) l_casos=dw_datos_empleados.retrieve (l_codigo) IF l_casos > 0 THEN dw_datos_empleados.retrieve (l_codigo) ELSE MessageBox ("De la Base de Datos","El empleado no tiene tareas asignadas") w_icf_pordepto_nom.cb_buscar.postevent(clicked!) END IF 31. Crear una ventana, que sea el nuevo punto de entrada y exhiba en menús las posibilidades que presenta el aplicativo, ver las siguientes cinco figuras: Ing. Ismael Castañeda Fuentes Página 25 de 55

27 31.1. Para hacer el menú, se puede seguir un procedimiento similar al siguiente: En Barra de herramientas o en menú: New Object Menu Crear los menús y submenús, junto con sus características, para ello: En el menú Insert Submenu item, o, Ctrl+Shift+S, o, Click derecho con el ratón sobre untiled() en la vista untiled() activa y seleccionar: Insert Submenu item En barra de herramientas: Save En ventana Save Menu : Dar Nombre y Comentarios. 32. Escribir los programas asociados con el evento clic para cada una de las opciones de los menús, por ejemplo: Para: Calculadora // click m_servicios.m_calculadora open ( w_icf_calculadora ) Para: Terminar // click m_servicios.m_terminar If MessageBox("Salir","Salir del aplicativo?",question!,yesno!)=1 then Close( ParentWindow ) // Cerrar la ventana donde se encuentra el menu End If //No toma accion en caso negativo Para: Buscar Todos Ing. Ismael Castañeda Fuentes Página 26 de 55

28 // Click m_personal.m_buscar.m_todos open ( w_icf_pordepto_nom) w_icf_pordepto_nom.rb_otro.setfocus() w_icf_pordepto_nom.cb_buscar.postevent(clicked!) Para: Buscar Por Nombre // Clic m_personal.m_buscar.m_pornombre open ( w_icf_pordepto_nom) w_icf_pordepto_nom.rb_nombre.setfocus() Para: Buscar Por Departamento // Clic m_personal.m_buscar.m_pordepto open ( w_icf_pordepto_nom) w_icf_pordepto_nom.rb_departamento.setfocus() 33. A la nueva ventana creada (w_aplicativo_entrenamiento) en la vista de Properties General: colocar nombre, asociar el menú recién elaborado en Menu Name, seleccionar un icono en Icon (desde que los icoconos e imágenes estén en la misma ruta en que se encuentra el aplicativo, no hay necesidad de dejarle la ruta, esto para mayor portabilidad de equipo a equipo). 34. Modificar el punto de Inicio para arranque con la ventana recién diseñada. 35. Agregar facilidades de menú a la ventana de la calculadora, ver ejemplo presentado en las siguientes tres gráficas: Si desea colocar separadores entre los submenus como aparece en las figuras, en Properties General del submenu: colocar en Text: - y seleccionar la opción Default. Ing. Ismael Castañeda Fuentes Página 27 de 55

29 36. Escribir los programas asociados con el evento clic para cada una de las opciones de los menús, por ejemplo: Para: Archivo Cerrar Ventana // click m_archivo.m_cerrarventana Close( ParentWindow ) Para: Archivo Salir del Aplicativo // click m_archivo.m_salirdelaplicativo Close ( w_aplicativo_entrenamiento ) //Ventana principal del aplicativo Para: Editar Borrar Todo // click m_editar.m_borrartodo w_icf_calculadora.sle_operando1.text = "" w_icf_calculadora.sle_operando2.text = "" w_icf_calculadora.st_resultado_n.text = "" Para: Editar Resultado a Memoria // click m_editar.m_resultadoamemoria // Objetivo: Llevar el resultado al clipboard clipboard ( w_icf_calculadora.st_resultado_n.text ) Para: Editar Memoria a Operando 1 // clic m_editar.m_memoriaaoperando1 // Copia el contenido del clipboard al Primer Operando w_icf_calculadora.sle_operando1.text = clipboard ( ) Para: Ayuda Temas // clic m_ayuda.m_temas ShowHelp ( "C:\Archivos de programa\sybase\pb6\help\pbhlp60.hlp", index! ) 37. Elaborar un ejecutable de la aplicación. 38. Salir de PowerBuilder. 39. Correr desde Windows el ejecutable que contiene el aplicativo. Ing. Ismael Castañeda Fuentes Página 28 de 55

30 40. Crear una ventana como la siguiente: En esta ventana se utilizará un nuevo control (TabControl), y el DropDown DataWindow. El Drop Down DataWindow es útil en caso de que se requiera hacer referencia a datos de otras tablas. Ultima Fila Siguiente Fila Anterior Fila Primera Fila Ing. Ismael Castañeda Fuentes Página 29 de 55

31 La estructura de las páginas Departamentos y Niveles es la misma Crear una nueva ventana: En barra de herramientas New Object Window, o, En menú File New Object Window Con el botón derecho sobre la nueva ventana, modificar las propiedades de la ventana Properties : Window Type: Popup. Las opciones Resizable y Maximize Box no deberán seleccionarse Insertar un control Tab en la ventana y darle el tamaño adecuado. En el menú Insert Control Tab, o, En la barra de herramientas Create Tab Control Seleccionar el control insertado y hacer click con el botón derecho del mouse en el área superior que no está ocupada por el TabPage (Cada una de las páginas del control Tab recibe este nombre). En las propiedades generales del tabpage: Properties General: Name: tab_actualizaciones Seleccionar Bold Selected Text (El texto de la página seleccionada se muestra en negrilla) OK Hacer click con el botón derecho dentro de la primera página (la que tiene el texto none) y elegir propiedades generales, Properties General: Name: tabpage_empleados Tab Text: Empleados OK Insertar los demás controles en la ventana (como lo muestra la figura) Un DataWindow control (se usa el botón que se encuentra en la barra de herramientas junto con los demás controles. No confundir con el botón de DataWindow Object que se encuentra en la barra de herramientas superior o PowerBar).En las propiedades del nuevo DataWindow elegir name: dw_act_empleados y seleccionar VscrollBar. Los botones Nuevo (cb_nuevo), Borrar (cb_borrar), Actualizar (cb_actualizar), Cargar Datos (cb_cargar). Los botones para desplazarse por las filas del DataWindow: Primero (cb_primero), Siguiente (cb_siguiente), Anterior (cb_anterior), Ultimo (cb_ultimo) Guardar el trabajo: File Save. El nombre de la nueva ventana será w_actualizaciones Modificar la opción actualizar del menú, para que se abra la nueva ventana: En la barra de herramientas Open Object Type: Menu. Seleccionar el menú ya realizado (p.ej. m_entrenamiento) OK Seleccionar la opción Actualizar en la ventana de edición del menú. Oprimir el botón Script en la barra de herramientas Escribir open(w_actualizaciones) Guardar las modificaciones hechas al menú Correr la aplicación y probar el funcionamiento del menú y la nueva ventana Crear un DataWindow Object en el que se relacionen el código y nombre de los departamentos. En la barra de herramientas New DataWindow: Grid Data Source SQL Select Next En la ventana Select Tables seleccionar la tabla departamento. Open Seleccionar las columnas código de departamento y nombre de departamento. Pasar a diseño de salida o vista de diseño: Return Seleccionar colores y bordes Aceptar selecciones Finalizar Ing. Ismael Castañeda Fuentes Página 30 de 55

32 Colocar los encabezados apropiados. File Save. En la ventana Save DataWindow: Name: ddd_depto (será utilizado como DropDownDatraWindow) OK Cerrar la ventana de edición del DataWindow Crear un DataWindow Object para actualizar los datos relacionados con los empleados. En la barra de herramientas New DataWindow: Grid Data Source SQL Select Next En la ventana Select Tables seleccionar la tabla Empleado Open Seleccionar todas las columnas de la tabla empleado. Pasar a diseño de salida o vista de diseño: Return Seleccionar colores y bordes Aceptar selecciones Finalizar Elegir Properties (con el botón derecho sobre el datawindow, vista de diseño) En la página General: Color ButtonFace Para los encabezados de todas las columnas, en la página general: Border Raised Text modificar el texto Para la columna dept_id (código de departamento): Elegir Properties : En la página General: Borde Lowered. En la página Font: Background WndBkrnd. En la página Edit: Style DropDownDW DataWindow dd_depto (el que se creó en el paso ) Display Column dept_nombre (nombre de departamento) Data Colum dept_id (códigode departamento) Width of DropDown (ancho del DropDown) 300% Seleccionar VscrollBar OK File Save. En la ventana Save DataWindow: Name: d_act_empleados OK Cerrar la ventana de edición del DataWindow Seleccionar el DataWindow dw_act_empleados en la página Empleados. Hacer click con el botón derecho y seleccionar la opción properties del menú poup. DataWindow Object Name browse... d_act_empleados (el que se creó en el apartado anterior:39.2.7) OK Para agregar una nueva página al control Tab, se hace click con el botón derecho sobre el control. En el menú popup Insert Tab Page Hacer click con el botón derecho dentro de la nueva página (la que tiene el texto none) y elegir propiedades generales, Properties General en el menú poup: Name: tabpage_actividades Tab Text: Actividades OK Insertar los demás controles en la ventana (como lo muestra la figura) Un DataWindow control. En las propiedades del nuevo DataWindow elegir name: dw_act_actividades y seleccionar VscrollBar. Los botones Nuevo (cb_nuevo_a), Borrar (cb_borrar_a), Actualizar (cb_actualizar_a), Cargar Datos (cb_cargar_a). Los nombres de los botones deben ser diferentes a los utilizados en la página Empleados. Los botones para desplazarse por las filas del DataWindow: Primero (cb_primero_a), Siguiente (cb_siguiente_a), Anterior (cb_anterior_a), Ultimo (cb_ultimo_a). Ing. Ismael Castañeda Fuentes Página 31 de 55

33 Crear un DataWindow Object en el que se relacionen el código y nombre de los empleados. (se usa el botón DataWindow de la barra de herramientas PowerBar) En la barra de herramientas New DataWindow: Grid Data Source SQL Select Next En la ventana Select Tables seleccionar la tabla Empleado Open Seleccionar las columnas código de empleado, nombre y apellido del empleado. Pasar a diseño de salida o vista de diseño: Return Seleccionar colores y bordes Aceptar selecciones Finalizar Colocar los encabezados apropiados. File Save. En la ventana Save DataWindow: Name: ddd_empleado (será utilizado como DropDownDatraWindow) OK Cerrar la ventana de edición del DataWindow Crear un DataWindow Object en el que se relacionen el código y nombre de los niveles. En la barra de herramientas New DataWindow: Grid Data Source SQL Select Next En la ventana Select Tables seleccionar la tabla nivel. Open Seleccionar las columnas código de nivel y nombre de nivel. Pasar a diseño de salida o vista de diseño: Return Seleccionar colores y bordes Aceptar selecciones Finalizar Colocar los encabezados apropiados. File Save. En la ventana Save DataWindow: Name: ddd_nivel (será utilizado como DropDownDatraWindow) OK Cerrar la ventana de edición del DataWindow Crear un DataWindow Object para actualizar los datos relacionados con los actividades de los empleados. En la barra de herramientas New DataWindow: Tabular Data Source SQL Select Next En la ventana Select Tables seleccionar la tabla Actividad. Open Seleccionar todas las columnas de la tabla Actividad. Pasar a diseño de salida o vista de diseño: Return Seleccionar colores y bordes Aceptar selecciones Finalizar Elegir Properties en el menu poup (con el botón derecho sobre el DataWindow): En la página General: Color ButtonFace Para los encabezados de todas las columnas: Elegir Properties en el menu poup (con el botón derecho): En la página General: Borde 3D Raised. Text modificar el texto En la página Font: Background ButtonFace. OK Para la columna emp_id (código del empleado): Elegir Properties en el menu poup (con el botón derecho): En la página General: Borde 3D Lowered. En la página Font: Background WndBkrnd. En la página Edit: Style DropDownDW DataWindow ddd_empleado (el que se creó en el paso ) Display Column emp_id (código del empleado) Data Colum emp_id (código del empleado) Width of DropDown (ancho del DropDown) 400% Seleccionar VscrollBar OK Ing. Ismael Castañeda Fuentes Página 32 de 55

34 Para la columna niv_id (código del nivel): Elegir Properties en el menu poup (con el botón derecho): En la página General: Borde 3D Lowered. En la página Font: Background WndBkrnd. En la página Edit: Style DropDownDW DataWindow ddd_nivel (el que se creó en el paso ) Display Column niv_id (código del nivel) Data Colum niv_id (código del nivel) Wdth of DropDown (ancho del DropDown) 250% Seleccionar VscrollBar OK File Save. En la ventana Save DataWindow: Name: d_act_actividades OK Cerrar la ventana de edición del DataWindow Seleccionar el DataWindow dw_act_actividades en la página Empleados. Hacer click con el botón derecho y seleccionar la opción properties del menú poup. DataWindow Object Name browse... d_act_actividades (el que se creó en el apartado anterior: ) OK El procedimiento utilizado para agregar las dos páginas restantes (Departamentos y Niveles) es bastante similar al descrito anteriormente Hasta ahora no se han escrito los programas (scripts) para ninguno de los eventos de los controles creados En la ventana w_actualizar, seleccionar la página Empleados (tabpage_empleados) Hacer click con el botón derecho sobre la página y seleccionar la opción script en el menú popup. En el editor, seleccionar el evento constructor del listbox de la parte superior izquierda de la ventana. El siguiente es el código para dicho evento: // Evento: constructor // Control: tabpage_empleados //Se selecciona el Transaction Object, que proporciona la //información para la comunicación con la base de datos y se //deshabilitan los botones de borrar y actualizar. tab_actualizaciones.tabpage_empleados.dw_act_empleados.settransobject(sqlca) tab_actualizaciones.tabpage_empleados.cb_borrar.enabled = false tab_actualizaciones.tabpage_empleados.cb_actualizar.enabled = false Para compilar el script: en la barra de herramientas Compile; o Ctrl+L; o Edit Compile; o también al guardar, se compila automáticamente. Para el botón que de desplazamiento hasta la primera fila (cb_primero), evento clicked: // Evento: clicked // Control: cb_primero dw_act_empleados.setfocus() // El datawindow toma el foco dw_act_empleados.scrolltorow(1) // Se desplaza hasta la fila No. 1 dw_act_empleados.setcolumn(1) // Se selecciona la primera columna Para el botón de desplazamiento a la siguiente fila (cb_siguiente), evento clicked: Evento: clicked Control: cb_siguiente long l_fila_actual Ing. Ismael Castañeda Fuentes Página 33 de 55

35 dw_act_empleados.setfocus() l_fila_actual = dw_act_empleados.getrow() dw_act_empleados.scrolltorow(l_fila_actual + 1) dw_act_empleados.setcolumn(1) //el número de la fila //seleccionada actualmente //se desplaza a la //fila siguiente //se seleccona la primera columna Para el botón de desplazamiento a la fila anterior(cb_anterior), evento clicked: Evento: clicked Control: cb_anterior long l_fila_actual dw_act_empleados.setfocus() l_fila_actual = dw_act_empleados.getrow() //el número de la fila //seleccionada actualmente dw_act_empleados.scrolltorow(l_fila_actual - 1) //se desplaza a la //fila anterior dw_act_empleados.setcolumn(1) //se seleccona la primera columna Para el botón que de desplazamiento hasta la ultima fila (cb_ultimo), evento clicked: Evento: clicked Control: cb_ultimo long l_numfilas dw_act_empleados.setfocus() l_numfilas = dw_act_empleados.rowcount() dw_act_empleados.scrolltorow(l_numfilas) dw_act_empleados.setcolumn(1) Para el botón Cargar Datos (cb_cargar), evento clicked: // Evento: clicked // Control: cb_cargar long l_numfilas //se recibe la información de la base de datos en el datawindow // tab_actualizaciones.tabpage_empleados.dw_act_empleados //se obtiene el número de //filas en el datawindow //se desplaza hasta la última //se selecciona la primera columna tab_actualizaciones.tabpage_empleados.dw_act_empleados.retrieve() l_numfilas=tab_actualizaciones.tabpage_empleados.dw_act_empleados.rowcount() tab_actualizaciones.tabpage_empleados.dw_act_empleados.scrolltorow(l_numfilas) //Si el número de filas en el datawindow es 0 entonces se deshabilita //el botón de borrar, de lo contrario, se habilita. if l_numfilas = 0 then cb_borrar.enabled = false else cb_borrar.enabled = true end if Para el botón de insertar un nuevo empleado (cb_nuevo), evento clicked: // Evento: clicked // Control: cb_nuevo tab_actualizaciones.tabpage_empleados.dw_act_empleados.settransobject(sqlca) long fila_nueva //la nueva filase inserta al final del datawindow fila_nueva = tab_actualizaciones.tabpage_empleados.dw_act_empleados.insertrow(0) Ing. Ismael Castañeda Fuentes Página 34 de 55