Manual Forms Developer 9i II

GEDICA TRAINING & CONSULTING C.A.
ORACLE FORMS
DEVELOPER
Oracle 9iDS Release 2
Oracle Forms Developer

1
ORACLE FORMS DEVELOPER
CAPÍTULO 1 6
INTRODUCCIÓN IDS – ORACLE FORMS DEVELOPER ..............................6
QUÉ ES IDS...........................................................................................................................7
Componentes De iDS..............................................................................................................7
Interfaces Comunes.................................................................................................................7
Variables de Ambiente..........................................................................................................10
Conectándose A La Base De Datos:.....................................................................................11
Personalizar iDS- Forms.......................................................................................................12
Personalizando Sesión de Forms...........................................................................................12
CAPÍTULO 2 13
FORM DEVELOPER ENVIRONMENT.........................................................................13
Form Developer Características............................................................................................14
Forms Developer Ejecutables...............................................................................................14
Menu Principal De Form Builder..........................................................................................14
Form Builder Módulos..........................................................................................................15
Form Builder Componentes..................................................................................................16
Data Blocks( Bloque de Datos).............................................................................................17
Tipos de Blocks.....................................................................................................................17
Practica 1...............................................................................................................................18
CAPÍTULO 3 19
CREANDO UN FORM MODULE....................................................................................19
CREANDO UN FORM MODULE......................................................................................20
Usando los Wizards (Asistentes):.........................................................................................21
Creando un Nuevo Bloque....................................................................................................21
Creando un Nuevo Data Block Manualmente.......................................................................24
Data Block Funcionalidad.....................................................................................................24
Modificando el Diseño..........................................................................................................25
Guardando un Form Module.................................................................................................29
Compilando un Form Module...............................................................................................29
Ejecutando un Form Module.................................................................................................30
Escoger Un Browser Para Ejecutar Un Form Module..........................................................31
USANDO BLOQUES CON RELACIONES:...........................................................................................32
Data Block Wizard - Master-Detail Page............................................................................33
Practica 2...............................................................................................................................34
CAPÍTULO 4 35

2
DATA BLOCKS Y FRAMES............................................................................................35

MODIFICANDO LA APARIENCIA DE UN DATA BLOCKS......................................................................36
PROPIEDADES DE LOS OBJETOS:..................................................................................36
Múltiples Property Palettes...................................................................................................38
PROPIEDADES DE UN BLOQUE DE DATOS (DATA BLOCKS)................................................................38
Creando un Control Block....................................................................................................41
Eliminando un Data Block....................................................................................................41
Practica 3...............................................................................................................................42
CAPÍTULO 5 43
TEXT ITEMS.....................................................................................................................43
TEXT ITEMS........................................................................................................................44
Creando un Text Item............................................................................................................44
Modificando la apariencia de un Text Item..........................................................................44
Practica 4...............................................................................................................................50
CAPÍTULO 6 51
CREANDO LOVS Y EDITORS........................................................................................51
LOVS Y EDITORS.....................................................................................................................52
LOVS....................................................................................................................................52
Creando una lista de valores.................................................................................................52
Crear un LOV utilizando el LOV Wizard:............................................................................53
Propiedades de las Lista de valores LOV.............................................................................57
Recomendaciones para LOV.................................................................................................58
EDITORS..............................................................................................................................58
Creando un Editor:................................................................................................................59
Asociando un Editor a un text item.......................................................................................59
Practica 5...............................................................................................................................60
CAPÍTULO 7 61
CREANDO ADICIONAL INPUT ITEMS.......................................................................61
ADICIONAL INPUT ITEMS.............................................................................................................62
Creando un Check Box.........................................................................................................62
Propiedades Específicas de un Check Box...........................................................................63
Creando un List Item: ...........................................................................................................63
Beneficios de los List Items:.................................................................................................65
Propiedades Específicas para un List Item............................................................................65
Creando Radio Groups..........................................................................................................66
Beneficios del Radio group...................................................................................................66
Propiedades Específicas para un Radio Group.....................................................................67
Radio Group..........................................................................................................................67
Radio Button.........................................................................................................................67
Practica 6...............................................................................................................................67

3
...............................................................................................................................................68
CAPÍTULO 8 68
NON-INPUT ITEMS..........................................................................................................68
NON-INPUT ITEMS............................................................................................................69
Display Items........................................................................................................................69
Creando un Display Item......................................................................................................69
Image Items...........................................................................................................................70
Creando un Image Item.........................................................................................................71
Propiedades Específicas de Image Item................................................................................71
Buttons..................................................................................................................................71
Propiedades Específicas de un Button..................................................................................72
Calculated Items....................................................................................................................72
Modos de Cálculos................................................................................................................72
Propiedades Específicas para un Calculated Item ................................................................73
Reglas para los Formula Items..............................................................................................73
Reglas para los Summary Items............................................................................................74
Hierarchical Item...................................................................................................................74
Practica 7 ..............................................................................................................................74
CAPÍTULO 9 76
CREANDO WINDOWS Y CONTENT CANVASES......................................................76
WINDOWS Y CANVASES.................................................................................................77
Windows...............................................................................................................................77
Canvas...................................................................................................................................77
TIPOS DE CANVAS:...........................................................................................................77
Creando un Content Canvas..................................................................................................77
Relacion entre el window y el canvas...................................................................................77
Tipos de Windows.................................................................................................................78
Propiedades De Los Windows..............................................................................................78
GUI Hints..............................................................................................................................79
Propiedades funcionales para GUI Hints..............................................................................79
Creando un Nuevo Window..................................................................................................80
Practica 8 ..............................................................................................................................80
CAPÍTULO 10 81
OTROS TIPOS DE CANVAS............................................................................................81

OTROS TIPOS DE CANVAS..............................................................................................82
STACKED CANVAS.....................................................................................................................82
Stacked Canvas Propiedades.................................................................................................82
Viewport Property:................................................................................................................82
Physical Property: ................................................................................................................83

4
Toolbars.................................................................................................................................83
Toolbar Propiedades..............................................................................................................83
Canvas PROPIEDADES.......................................................................................................83
Window Propiedades ...........................................................................................................83
Form Module Propiedades....................................................................................................84
Tab Canvas............................................................................................................................84
Practica 9 ..............................................................................................................................84
CAPÍTULO 11 86
INTRODUCCIÓN A LOS TRIGGERS............................................................................86
FORM BUILDER TRIGGERS...........................................................................................................87
Componentes del Alcance de un Trigger..............................................................................87
Componentes de un Tipo de Trigger.....................................................................................88
Componentes del Código de un Trigger...............................................................................88
Jerarquía de Ejecución..........................................................................................................88
CAPÍTULO 12 90
CREANDO TRIGGERS....................................................................................................90
CREAR UN TRIGGER........................................................................................................91
Propiedades de un Trigger....................................................................................................91
Form Builder Built-in Subprogramas....................................................................................91
USANDO LOS TRIGGERS.................................................................................................92
Practica 10 ............................................................................................................................94
Practica 11 ............................................................................................................................94
Practica 12 ............................................................................................................................94
CAPÍTULO 13 95
MESSAGES Y ALERTS....................................................................................................95
MESSAGES Y ALERTS......................................................................................................96
Controlando los mensajes del sistema:.................................................................................96
ALERTS:...............................................................................................................................97
Creando un Alert:..................................................................................................................97
Propiedades de un alert:........................................................................................................97
Como Mostrar un Alert:........................................................................................................98
Practica 13 ............................................................................................................................98
CAPÍTULO 14 99
INTEGRANDO REPORTES A UNA FORMA...............................................................99
Creando un reporte desde Form Builder.............................................................................100
Propiedades del REPORT...................................................................................................101
Procedimientos de Form para Integrar con Report:............................................................102

5
Capítulo 1
INTRODUCCIÓN
iDS – ORACLE FORMS DEVELOPER

6
QUÉ ES IDS
Es un conjunto de herramientas de Oracle dirigidas a compañías interesadas en que su

negocio crezca en e-commerce y aplicaciones Web.
Componentes De iDS
Oracle iDS consta de los siguientes componentes:
• Oracle Forms Developer

• Oracle Reports
• Oracle Designer
• Oracle JDeveloper
• Oracle Portal
• Oracle Discoverer
Interfaces Comunes
Oracle iDS: Forms y Reports comparten un conjunto de interfaces comunes en cada uno
de sus componentes. Estas ayudan a la flexibilidad y productividad en el desarrollo dentro de
Oracle iDS.
Object Navigator: Es una estructura jerárquica la cual permite localizar y manipular los
objetos de forma fácil y rápida. La jerarquía se muestra por indentación y nodos expandibles.

7
Property Palette: Todos los objetos de un módulo, incluyendo el módulo en si, tienen
propiedades que se pueden ver y modificar a través de esta paleta de propiedades. Entre sus
características esta copiar y rehusar las propiedades de un objeto a otro.
Layout Editor o Layout Model: Es un diseñador gráfico para crear y ordenar los items y
objetos gráficos de su aplicación. Usted puede diseñar el estilo, color, tamaño de los objetos.

8
PL/SQL Editor: es una funcionalidad que permite el desarrollo de Triggers,

procedimientos, funciones y paquetes en Oracle Forms, así como el desarrollo de librerías de
programas de PL/SQL.

9
Variables de Ambiente
Oracle Forms Developer usa muchas variables de ambiente, estas tienen valores
predeterminados, los cuales pueden ser modificados en su ambiente para diferentes aplicaciones.
Forms Builder usa algunas de estas variables para localizar los archivos durante la ejecución.
• FORMS90_PATH: Una ruta que indica a Forms Builder donde buscar los archivos
durante la ejecución de la aplicación.
• REPORTS_PATH: indica a Reports la ruta de los archivos.
• UI_ICON: Indica donde buscar los iconos para Report y las versiones anteriores de
FORMS. Oracle9iDS - FORMS no usa una plataforma especifica de formato de
imágenes cuando despliega iconos (*.icon no es compatible con JAVA). Los formatos
usados son GIF y JPG (ver documentación webicons.pdf de ORACLE).
•
Para añadir iconos personalizados a sus aplicaciones debe seguir el siguiente
procedimiento, el cual es uno de las tres formas que se tienen para el uso de iconos
personalizados.
Añadiendo ICONOS a archivos JAR
• Para crear archivas Java (JAR) para imágenes, se necesita JDK (Java
Development Kit), o Java 2 Standard Edition Development Kit
(J2SDK o SDK). J2SDK es el nuevo nombre usada para denominar
la anterior versión de JDK.
• Oracle9LDS y Oracle9LAS contienen un JDK directorio con la más
reciente versión de SDK. El directorio /bin de esta carpeta, contiene
el utilitario Jar que se encarga de crear y/o extraer archivos de

imágenes en/de archivos Jar, respectivamente.
• Para crear archivos Jar que contengan los iconos que serán usados en
sus aplicaciones FORMS, se debe usar el siguiente comando desde el
directorio donde se encuentran los archivos *.gif (imágenes iconos)

10
<ORACLE9iDS HOME>/jdk/bin/jar –cfv <<nombre-archivo-

jar>> *.gif
• Una vez creado el archivo que contiene las imagines requeridas para
los items de control buttons y tree, el siguiente paso es configurar el
uso de este archivo en formsweb.cfg, el cual es el archivo de
configuración de ciertos parámetros que permiten personalizar la
ejecución y desarrollo de sus aplicaciones. Puede usar el editor de
texto de su preferencia para abrir este archivo de configuración, el
cual se encuentra ubicado en la carpeta <ORACLE9iDS
HOME>/forms90/server para Oracle9LDS or Oracle9LAS. Para
Oracle9LAS, usted debe editar este archivo a través de Oracle9L
Enterprise Manager.
• En la sesión denominada “configuration sections” dentro de
formsweb.cfg, la cual se encuentra localizada al final del archivo,
usted debe crear una nueva configuración para su aplicación
añadiendo las siguientes líneas:
[your Forms name]
form=yourModule.fmx
archive_jini=f90all_jinit.jar, <<nombre-archivo-jar>>
imageBase=codebase
El parámetro “imagebase” configurado a “codebase” significa que

FORMS buscara en forms90/java URL cuando neceste descargar las
imágenes.
Esta aplicación es llamada en la Web usando el siguiente URL:

http:/ / <hostname>:<port>/ forms90/ f90servlet?config= <<your
Forms name>>
Conectándose A La Base De Datos:
Si Ud. quiere construir aplicaciones que accesen objetos de la base de datos, entonces necesita
conectarse a una cuenta de base de datos desde Form Builder.

11
• Seleccione el menú File – Connect

• Ingrese el usuario, el password y el nombre de la base de datos.
Personalizar iDS- Forms

Para personalizar ciertas características de sus aplicaciones como: Tamaño de despliegue
de las ventanas en la web, Utilización de imágenes personalizadas (iconos), Conexión a la base
de datos, Definir Rutas (paths) virtuales, entre otras características, existen los siguientes
archivos de configuración.
• <Oracle9ids HOME>/forms90/server/formsweb.cfg
• <Oracle9ids HOME>/forms90/server/forms90.conf
• <Oracle9ids HOME>/forms90/java/oracle/forms/registry/Registry.dat
Personalizando Sesión de Forms

Para personalizar la ejecución de sus aplicaciones existe una opción de preferencias en
Forms Builder en la cual, entre otros aspectos, usted puede definir:
• Aspectos generales de la compilación
• Dirección de URL y configuración de corrida
• Acceso a librerías
• Características de los Wizards.

12
Capítulo 2
FORM DEVELOPER ENVIRONMENT

13
Form Developer Características.

Con Form Builder usted puede:
• Insertar, Actualizar, Eliminar y Consultar datos
• Mostrar Datos: Texto, Sonido, Video, Imágenes, etc
• Accesar aplicaciones Gráficas y OLE2 directamente
• Usar Menus integrados en las aplicaciones
• Enviar datos directamente a Reporte
Forms Developer Ejecutables

Form Builder comprende dos ejecutables, que usted puede acceder para el diseño de
sus aplicaciones, además de la instancia de OC4J la cual debe ser iniciada para le ejecución
de la aplicación.
• Form Builder
• Form Compiler
FORMS 9i D:\ORANT\BIN\ifbld90.EXE module=module userid=scott/tiger
Menu Principal De Form Builder

El menú principal contiene opciones que le permiten crear, modificar y manipular sus
módulos Form, además de opciones para personalizar su sesión.

14
Form Builder Módulos
Una aplicación en Form consiste de muchos módulos. Un módulo es el mayor

componente de su aplicación. Se pueden encontrar 4 tipos de módulos, los cuales se pueden
combinar para crear una aplicación.
F O R M M O D U L E S : Es el principal componente de una aplicación el cual muestra la
data con la cual el usuario interactuará.
M E N U M O D U L E S : Es utilizado por los usuarios para ejecutar las funciones de su
aplicación, Form Builder provee un menú predeterminado para cada forma, el cual contiene
las operaciones básicas como insertar, actualizar, borrar, consultar. Sin embargo, Ud. Puede
crear un módulo menú con los requerimientos de su conveniencia y adjuntarlo a módulo
form.

15
O B J E C T L I B R A R Y M O D U L E S : es un repositorio común para objetos estándar

de form builder, simplifica la reutilización de objetos y ayuda a mantener la consistencia en
su ambiente de desarrollo.
P L / S Q L L I B R A R Y M O D U L E S : es un conjunto de programas de PL/SQL que

pueden ser llamados desde otros módulos.
Form Builder Componentes

Se pueden encontrar 4 tipos de componentes en Form Builder
• B L O C K S : Cada forma consta de uno o mas bloques. Un bloque es el

dueño lógico de los items. Cada ítem esta asociado a un bloque. Los items
de un bloque están relacionados, pueden corresponder a columnas de una
tabla de la base de datos o pueden necesitar ser parte del mismo ciclo de
navegación.
• I T E M S : Son objetos de interfaz que muestran la data al usuario y le

permiten interactuar con las misma dependiendo del tipo de ítem, hay
diferentes tipos los cuales son agrupados de forma lógica a través de los
bloques y visiblemente a través de los canvases.
• C A N V A S : Es la base sobre la que se sitúa el texto plano y los items. Cada

ítem hacer referencia a un canvas en sus propiedades. Los items de un
mismo bloque se pueden visualizar en canvas diferentes. Un canvas no es un
elemento de interface por si mismo, para verlo a el y a sus componentes, el
canvas se debe mostrar en un window.
• W I N D O W S : un window es por si mismo un frame vacío. Pueden ser de

2 tipos Modales o no modales. Un window modal exige que el usuario
responda o descarte la ventana antes de hacer nada en cualquier otro window
de la aplicación, se distinguen por la falta de barra de desplazamiento y la

16
incapacidad de ser minimizadas a iconos. Un window no modal permite el

acceso a otras ventanas de la aplicación sin descartar la primera, permite al
usuario minimizar, maximizar, mover y cambiar el tamaño de la ventana.
Data Blocks( Bloque de Datos)
Los Blocks proveen mecanismos para agrupar los Items dentro de una Unidad
Funcional. Se puede ver como una colección de items o como una colección de registros,
cada uno de los cuales tiene la misma estructura. Los bloques no tienen representación
física, solamente los Items son visible a los usuarios.
TIPOS DE BLOCKS
Hay 2 tipos principales de blocks en Form Builder

Data Blocks: corresponde a una tabla , a una vista de la base de datos o al resultado de un
stored procedure y controla un numero de registros que corresponden a las filas de la tabla
o vista.

17
Control Blocks: No se corresponde a una tabla o vista y sus registros no se corresponden a

filas de la base de datos. Normalmente representan un conjunto de elementos con valores
únicos, que tienen solo un único registro
Practica 1
1. Utilizando el asistente, crear un form module que consulte todos los registros de la
tabla s_dept.
2. Revise las propiedades de los siguientes objetos creados: Module, Block, Item,
Canva

18
Capítulo 3
CREANDO UN FORM MODULE

19
CREANDO UN FORM MODULE
Puede crear un nuevo form módulo de diferentes formas:
Al ingresar a forms Builder se despliega una pantalla la cual le permite escoger si

crear una forma utilizando los asistentes, crear una forma manualmente, abrir una forma ya
existente, o crear una forma a partir de una plantilla.
Si escoge la 1era. Opción Usar el data block wizard, la siguiente pantalla lo llevará
al asistente, si escoge la opción crear una forma manualmente ya estará dentro de forms
builder de la siguiente forma:

20
Si ya se encuentra dentro de Oracle Forms Builder puede crear una nueva forma,
seleccionando del menú File-New-Form
Usando los Wizards (Asistentes):
CREANDO UN NUEVO BLOQUE
Si ya se encuentra dentro de Oracle Form Builder seleccione la opción Data Block

Wizard del menú Tools, el cual le mostrará una pantalla de bienvenida al asistente,
desmarque el check, si no desea que la pantalla de bienvenida aparezca la próxima vez que
invoque al asistente, Ya sea que en la pantalla de bienvenida de Forms Builder escogió
utilizar el data Block Wizard o ingreso a través de la opción del menú, la pantalla que
aparece será la siguiente:

21
Presione el botón Next>, en la siguiente pantalla deberá escoger que tipo de bloque
construir, con datos provenientes de una tabla o vista o de un stored procedure. Seleccione
Table or View.
Escriba el nombre de la tabla o vista sobre la cual desea construir el bloque, luego
presione el botón refresh y aparecerán las columnas correspondientes a la tabla
seleccionada, esto siempre y cuando se encuentre conectado a la base de datos. Mueva al
cuadro de la derecha denominado database items las columnas que quiere formen parte de
su bloque, luego presione Next> .

22
La siguiente pantalla coloca por defecto el nombre del bloque como la tabla que utilizo, sin
embargo Ud. Puede modificar dicho nombre según sus requerimientos.
Por ultimo aparece una pantalla que lo felicita por haber terminado de forma
satisfactoria la creación del bloque de datos, le muestra dos opciones, la primera finaliza el
bloque y le lleva inmediatamente al asistente para el layout, la segunda solo crea el data
block. Escoja la segunda opción y presione el botón Finish.

23
CREANDO UN NUEVO DATA BLOCK MANUALMENTE
En Form Builder, utilice uno de los siguientes métodos:
• Botón Derecho de Mouse

• Seleccione el Data Block Node y luego seleccione Create Icon en el Object
Navigator
DATA BLOCK FUNCIONALIDAD
Cuando usted crea un Data Block usando los Wizards Form Builder automáticamente crea:
• Los Form Module con las propiedades de base de datos Insert, Update, Delete
• El Frame Object
• Los Items en los Data Blocks

24
• Prompt por cada Item
MODIFICANDO EL DISEÑO
La ejecución del Data Block Wizard lo llevara de manera automática al Layout Wizard. Ud.
también puede invocarlo a través del menú Tools – Layout Wizard, la primera pantalla del
asistente es la siguiente:
Presione Next> y aparecerá la siguiente pantalla, en la cual deberá indicar el tipo de canvas
a crear

25
En la siguiente pantalla deberá indicar el bloque y los items que quiere sean visualizados en
el canvas
Una vez seleccionados los items a ser visualizados presione Next> y la siguiente pantalla le
permitirá modificar el prompt, ancho y alto de los items.

26
En la siguiente pantalla indique cual será el estilo para la pantalla que esta creando.
Luego puede asignar un título a la pantalla, así como la cantidad de registros que se podrán
visualizar y si se creará de forma automática un scroll.

27
La ultima pantalla le indica que Ud. ha finalizado de forma satisfactoria la

realización del diseño de su módulo form, presione Finish .

28
Guardando un Form Module
Puede guardar el form module de las siguientes maneras:
• A través del menú File-Save AS

• Utilizando El icono Save del menú toolbar (barra de herramientas)
Compilando un Form Module
Antes de que un form module pueda ser ejecutado, debe ser compilado y haber generado
un archivo ejecutable con la extensión .FMX Puede compilar el form module de las siguientes
maneras:
• A través del Menú Program – Compile Module

• Utilizando el icono Compile Module de la barra de herramientas.
Compile Module

29
Una vez compilado el form module se genera un archivo con extensión FMX el cual es el
ejecutable.
Ejecutando un Form Module
En Oracle 9iDS puede ejecutar su módulo en modo web desde Form Builder, la cual se
visualizará a través del Browser que este definido. Para lograrlo es necesario tener un listener
HTTP, en este aspecto se debe utilizar el OC4J el cual funciona para tal fin y debe ser iniciado
manualmente, Para iniciar la instancia del OC4J siga la siguiente ruta:
Start -->
Programs -->
Oracle 9i Developer Suite -->
Forms Developer -->
Start OC4J Instance
Cuando el OC4J Listener se haya iniciado, aparecerá una pantalla de MS-DOS

esta pantalla debe permanecer abierta, mientras se estén ejecutando los form module, para
detener el OC4J siga la siguiente ruta:
Start -->
Programs -->
Oracle 9i Developer Suite -->
Forms Developer -->
Shutdown OC4J Instance
Una vez iniciado el OC4J seleccione el módulo que quiere ejecutar y utilice algunas de las
siguientes formas:
• A través del menú Program – Run Form

• Haciendo clic sobre el botón correspondiente a Run Form o Run Form Debug en la
barra de herramientas.

30
Run Form Debug
Run Form
Run Form: Utiliza esta opción al momento de

ejecutar el form module a través del browser definido
Run Form Debug: Utiliza esta opción para depurar el form module durante la ejecución.
Escoger Un Browser Para Ejecutar Un Form Module
Para seleccionar un browser a través del cual ejecutar los módulos de forms builder,
debe seguir los siguientes pasos:
• A través del menú Edit – Preferences.

• Aparece el cuadro de diálogo, seleccione la ficha correspondiente al Runtime.
• en el campo correspondiente al Web Browser Location ingrese la ruta donde se

encuentra el archivo ejecutable del browser a utilizar, o haga clic sobre el botón
browse para localizarlo.

31
Si no es configurado ningún browser en esta opción, entonces será utilizado el browser

predeterminado en el sistema Operativo.
Usando Bloques con Relaciones:
Como ya lo hemos mencionado, un Form Módulo puede contener mas de un bloque,

dichos bloques pueden trabajar solos de forma independiente, o pueden estar relacionados
con otro bloque.
La relación que se crea entre dos bloques se denomina relación Master-Detail y se

realiza entre el primary-foreign key de las tablas sobre las cuales están basadas los bloques.
El bloque Master es el que esta basado en la tabla que contiene el Primary key, y el bloque
Detail esta basado en la tabla con el foreign key.
Adicionalmente puede crear una relación en la cual el detail de una relación Master-
detail sea a su vez el master de otra relación. Por otra parte Un bloque Master puede
contener varios bloques de detalle, tal y como se muestra en la siguiente figura:
MASTER MASTER MASTER
DETAIL DETAIL DETAIL DETAIL
DETAIL

32
Data Block Wizard - Master-Detail Page
Cuando se crea un bloque y ya existe dentro del form module un bloque previo, es
decir cuando se crea un segundo bloque, el Data Block Wizard muestra una pagina
adicional donde puede escoger que el join entre las dos tablas, o lo que es lo mismo entre
los dos bloques se haga de manera automática, marcando el check de auto-join data block,
o especificar los valores presionando el botón Create Relationship...
Una vez creado el Form Module Master-Detail, el data Block Wizard

automáticamente crea un objeto encargado de manejar la relación entre los bloques
asociados. Dicho objeto se denomina Relation. Este nuevo objeto tomara su nombre por
defecto del MasterBloque_DetailBloque. Adicionalmente se crea un trigger para la debida
coordinación entre los dos bloques.

33
Practica 2
1. En el modulo creado en el ejercicio anterior y utilizando el asistente, crear un
bloque de datos que muestre todos los empleado de la s_emp, asociados a cada uno
de los departamentos. Este bloque debe mostrar más de un renglón de registros.
2. Compile y ejecute el modulo
3. Revise los objetos que se han creado e indique su funcionalidad dentro del modulo

34
Capítulo 4
DATA BLOCKS Y FRAMES

35
Modificando la apariencia de un Data Blocks

Se puede modificar la apariencia de un data Block después de que ha sido creado utilizando
cualquiera de los siguientes métodos:
• Ejecutar los Wizards: Ingrese al Data Block Wizard y realice los cambios
necesarios.
• Layout Editor: Ingrese al Layout Editor y haga las modificaciones deseadas
manualmente.
• Data Block Property Palette: Despliegue las propiedades del Bloque y cambie los
valores según su criterio.
• Frame Property Palette: Cambie las propiedades del Frame asociado al Bloque para
modificar la apariencia del arreglo de items.
PROPIEDADES DE LOS OBJETOS:

Cada objeto dentro de una forma, así como el form module como tal, tienen
propiedades que determinan las características y la apariencia de cada objeto. Cuando los
objetos son creados dichos propiedades adquieren un valor por defecto, Sin embargo,
dichos valores pueden ser cambiados a través de la Paleta de Propiedades (Property
Palette).
Para visualizar las propiedades de un objeto, seleccione uno de los siguientes métodos:
• Ingrese al Menú Tools - Property Palette o

• Presione F4 cuando este sobre el objeto
• Haga Doble click en el icono del objeto en el Object Navigator
• Haga Doble click en el objeto en el Layout Editor
• Haga click en el Botón derecho del Mouse

36
Al ejecutar uno de los métodos descritos, se levanta un cuadro que muestra una lista
de las propiedades del objeto en cuestión. La lista que se muestra tiene dos columnas, la
primera con el nombre de la propiedad y la segunda con el valor. Por otra parte las
propiedades están agrupadas dependiendo de la función que ejercen, cada grupo tiene un
título y nodo, dicho nodo se puede expandir o contraer usando el símbolo + o – a la
izquierda del título.
En la parte superior derecha de la lista aparece un ítem denominado FIND a través

del cual puede localizar rápidamente una propiedad dentro de la lista. También en la parte
superior se encuentra un Toolbar que consta de varios botones que permiten copiar y
pegar propiedades, eliminar o agregar, así como congelar la imagen de las propiedades de
un objeto.

37
Ahora bien, cada objeto tiene a su vez varios tipos de propiedades, estas se manejan
de forma diferente dependiendo del tipo de propiedad. En algunos casos el valor se trata de
un texto que se debe ingresar, en otros se debe seleccionar un valor entre un lista.
A la derecha del nombre de la propiedad se encuentra un icono el cual describe el
status de la propiedad. El circulo especifica que la propiedad se encuentra con el valor
predeterminado. El cuadrado indica que el valor de la propiedad ha sido cambiado. Una
Flecha indica que el valor de la propiedad ha sido otorgado por herencia, y una flecha con
una cruz que la propiedad tenia un valor por herencia , pero que dicha herencia se perdió al
modificar el valor.
Múltiples Property Palettes
Desplegando múltiples Property Palettes para un objeto

• Abrir el Property Palette para el objeto
• Presionando la Shift, haga doble click sobre el objeto para mostrar Property Palettes
adicionales
Desplegando Property Palette para múltiples objetos
• Abrir el Property Palette para el primer objeto
• Hacer en el botón Freeze/Unfreeze en el Toolbar
• Muestre el Property Palette del próximo objeto
Propiedades de un Bloque de datos (Data Blocks).

Cada Data Block tiene propiedades las cuales están divididas en los siguientes grupos:
• General: Dentro de este grupo de propiedades se encuentra el nombre del objeto, en
este caso el nombre del Bloque, si esta referenciando a un objeto origen entonces
muestra el nombre del objeto referenciado, y el módulo del cual proviene.

38
• Navigation: La navegación de un bloque se produce normalmente en el orden en el

que se definen los items dentro de el, entre las propiedades de este grupo se
encuentran:
 Navegation Style: Tiene 3 posibles valores, Same Record, Change Record, y

Change Data Block, el valor por defecto es Same record, lo cual indica que
al llegar al ultimo ítem de un registro el cursor se posicionará en el primer
ítem del mismo registro. Si quiere que la navegación continúe al próximo
registro debe cambiar esta propiedad al valor Change record.
 Previous Navegation data Block y Next Navigation data Block: De manera
predeterminada el módulo form navega por el primer bloque que se
encuentra, con estas propiedades se puede cambiar el orden de navegación
entre los bloques.
• Records: Contiene las siguientes propiedades:
 Current Record Visual Attribute Group: Indica el nombre del Visual
atributo que será utilizado para destacar al registro actual en el bloque, es
decir al registro donde se encuentre posicionado el cursor.
 Query Array Size: especifica el numero de registros que forms puede tomar
de la base de datos en un mismo tiempo cuando se ejecuta una consulta.
 Number of Records Buffered: es la cantidad mínima de registros que se

pueden tener en el buffer, el valor mínimo permitido va ser igual al
determinado en la siguiente propiedad.
 Number of Records Displayed: esta propiedad indica el numero máximo

de registros que el bloque puede mostrar en un canvas a un mismo tiempo.

39
 Query all Records: determina si al momento de ejecutar un query se toman

de la base de datos todos los registros del resultado (Yes) o si se toman la
cantidad de registros indicados en la propiedad Query Array Size (No).
 Record Orientation: determina la orientación de registros en el data block,

Horizontal o Vertical.
 Single Record: esta propiedad especifica que el bloque de control debe

tener un solo registro, no debe colocarse dicha propiedad en Yes para un
bloque de Datos.
• Database: Contiene las siguientes propiedades:
 Database Data Block: especifica si se trata de una bloque basado en una

tabla de la base de datos o si se trata de un bloque de control.
 Enforce Primary Key: Chequea que los registros a ser insertados o

actualizados deben cumplan con la clave primaria antes de que se ejecute la
acción en la base de datos.
 Query/Insert/Update/ Delete Allowed : estas propiedades controlan la

autorización para la ejecución de las mismas en un data block.
 Query Data Source Type: Esta propiedad especifica el tipo de consulta que
se efectuara en el data block, tiene los siguientes posibles valore: None,
Table, Procedure, Transactional Triggers o From Clause Query.
 Query Data Source name: Indica el nombre del Objeto desde el cual se hará
la consulta, por ejemplo si se trata de una tabla, aquí se indica el nombre de

40
la tabla. Esta propiedad solo aplica cuando la propiedad anterior tiene uno de
los siguientes valores: table, procedure, From Clause Query.
 Query Data Source Columns: especifica el nombre y tipo de datos de las

columnas asociadas con el objeto a través del cual se hará la consulta, esto
solo aplica cuando la propiedad Query Data Source Type es Procedure o
From Clause Query.
 Where Clause: Dentro de esta propiedad se especifica una condición where

determinada al select implícito del bloque y es automáticamente agregada a
cualquier criterio que usuario coloque cuando se encuentre en Modo Enter
Query durante la ejecución.
 Order By Clause: Define un orden por defecto para los registros a ser
mostrados.
 Optimizer Hint: Especifica una cadena que Forms Builder enviara al

optimizador cuando se construye la sentencia Select implícita en el bloque.
Usando esta cadena el optimizador puede mejorar el rendimiento de la
consulta en la base de datos.
Creando un Control Block
• Haga click en el Blocks node

• Haga click en botón Create Icon
• Seleccione la opción “Build a new data block manually” en la caja de diálogo New
Data Block
Eliminando un Data Block

41
• Seleccione el Data Block a borrar

• Haga click en el Delete Icon
• Haga click en Yes en caja de alerta
Practica 3
1. Para cada uno de los bloques de datos de la practica anterior cambie los valores de
las propiedades de los bloques para que:
• Muestre los datos ordenados por numero de departamento y nombre
empleado
• No permita realizar inserción de empleados a un departamento
• No permita actualizar los datos de un departamento
2. Compilar y Ejecutar para probar los cambios
3. Añadir un bloque de control

42
Capítulo 5
TEXT ITEMS

43
TEXT ITEMS
Un text item es un objeto de interfaz a través del cual se puede consultar, insertar,
actualizar y borrar datos, usualmente corresponde a una columna de la tabla de la base de
datos a la cual esta asociado el bloque que lo contiene. Cuando se crea un item este por
defecto es Text item.
Creando un Text Item
Puede crear un text item de cualquiera de las siguientes maneras:
• Cuando utiliza el Data Wizard por defecto se crean los text items de las
columnas de la tabla.
• Usando el botón text item de la barra de herramientas del Layout Editor.
• Usando el icono Create en el object navigator.
• Convirtiendo un item existente en un text ítem.
Boton Text Item

En el layout editor
Modificando la apariencia de un Text Item
Un text ítem tiene propiedades las cuales están divididas en los siguientes grupos:
• General: en este grupo de propiedades se encuentra :

44
 Name: Muestra el nombre del item.

 Item Type: para definir el tipo de item
 Subclass Information: si esta referenciando a un objeto origen entonces
muestra el nombre del objeto referenciado, y el módulo del cual proviene.
• Functional:
 Enabled: Determina cuando un ítem puede ser o no manipulado, si la

propiedad se encuentra en No, el ítem queda incautivo y su apariencia
cambia en la ejecución.
 Multi-Line: Permite que un text item pueda almacenar múltiples líneas de
text, siempre y cuando el tipo de dato del mismo sea varchar2 o long.
 Case Restriction: convierte el texto al valor de la propiedad, Upper, Lower,
Mixed.
 Conceal Data: encripta el valor del texto para que el usuario no pueda
visualizarlo.
 Sep Cursor Position: mantiene la posición del cursor hasta que se reingrese
en un item.
 Automatic Skip: hace que el cursor avance de manera automática al
siguiente item cuando el actual este lleno, va a depender de la longitud con
la que se definió el text ítem.
 Popup menu: asocia un menú emergente o menú flotante al ítem.
• Navigation: este conjunto de propiedades permite alterar la navegación por defecto

de los items, la cual esta determinada por el orden en que estos se encuentra dentro
del Bloque de datos.
 Keyboard Navigable: permite la navegación al ítem, con el orden

determinado a través del Teclado o Mouse. Cuando la propiedad es NO,

45
Form Builder avanza al siguiente ítem navegable siguiendo la secuencia

definida.
 Previous Navigation Item y Next Navigation Item: Determina el ítem

anterior y el siguiente ítem que deben ser accesados al salir del ítem actual.
Los items que aquí se incluyan debe pertenecer al mismo bloque del ítem
actual.
• Database: dentro de este grupo se encuentran las propiedades que permiten

establecer una relacione entre el text item y la base de datos.
 Database item: determina que el valor del item es almacenado en un bloque

basado en una tabla de la base de datos. El valor NO, indica entonces que se
trata de un ítem de control.
 Column name: establece que el ítem corresponde a una columna de la tabla a
la cual esta asociado el data block.
 Primary Key: Indica que el ítem corresponde a una columna que es la clave
primaria de la tabla sobre la que esta construido el bloque.
 Query Only: indica que el ítem puede ser consultado pero no incluido en un
Insert o Update.
 Query allowed: determina que el ítem puede ser utilizado para consultas.
 Case Insesitive query: determina que la diferencia entre mayúsculas y
minúsculas de los valores, será reconocida durante la ejecución de la
consulta.
 Insert allowed: determina la autorización para que el item pueda ser
insertado.
 Update allowed: determina la autorización para que el item pueda ser
modificado.

46
 Update only if null: determina la autorización del item solo cuando su valor
actual es nulo.
• Physical: Contiene propiedades acerca de la ubicación del ítem:
 Visible: Determina si el ítem será mostrado al usuario, o si por el contrario

solo se utilizara para guardar un valor que el usuario no podrá visualizar.
 Canvas: indica en cual canvas será mostrado el ítem.
 Tab Page: Cuando el ítem se visualiza en un canvas de Ficha , esta
propiedad indica la ficha en la que se mostrara el ítem.
 X position: Posiciona el ítem en la posición que se indique de la coordenada
X con respecto al canvas o a la pantalla.
 Y position: Posiciona el ítem en la posición que se indique de la coordenada
Y con respecto al canvas o a la pantalla.
 Width: Indica el ancho del ítem según el la propiedad Coordinate Units de la
forma.
 Height: Indica el alto del ítem según el la propiedad Coordinate Units de la
forma.
 Bevel: Cambia la apariencia del borde del ítem
 Rendered:
 Show Vertical scrollbar: coloca un scroll vertical, útil para text ítem
multilínea.
• Record:
 Current Record Visual Attibute Group: Especifica el nombre del visual

atributo a usar en el item cuando se muestre el registro actual.
 Distance Between Records: Especifica la cantidad de espacios entre
instancias del Ítem en un bloque multiregistros.

47
 Number of Items Displayed: Especifica el numero de instancias a mostrar

del ítem cuando se este en un bloque multiregistros.
 Font : agrupa las propiedades que afectan la letra del el dato a mostrar en el
item.
 Font Name: Especifica el nombre de la fuente, dependiendo de las
disponible en el sistema operativo.
 Font Size: especifica el tamaño de la letra en puntos.
 Font Weigth : especifica el ancho de la letra, tiene opciones como médium,
bold etc.
 Font Style: Especifica el estilo de la letra, como por ejemplo con sombras,
cursiva etc.
 Font spacing: especifica el ancho del contenido, es decir la cantidad de
espacios que habrá entre caracteres de una palabra.
• Color:
 Foreground Color: determina el color a la fuente.

 Background Color: Determina el color del fondo donde se mostrara el texto.
• Prompt:
 Prompt: Especifica el texto de la etiqueta para el ítem.

 Prompt Display Style: especifica el estilo en que se mostrará el prompt con
respecto al item, es decir, si se mostrará solo en el primer registro, en todos
los registros, o si se ocultará.
 Prompt Justification: Especifica como el prompt será justificado.

48
 Prompt attachment Edge: Especifica el lugar con respecto al time donde se

mostrará la etiqueta, Sobre el item, Bajo el item etc.
 Prompt aligment: especifica como el prompt es alineado con respecto a su
ubicación en el ítem.
 Prompt attachment offset: especifica la distancia entre el ítem y el prompt.

49
Practica 4
4. Para cada uno de los bloques de datos de la practica anterior cambie los valores de
las siguientes propiedades
• Hint property  Ayuda en español
• Format property  Numérico con miles y decimales y fecha dd/mon/yyyy
• Enabled property  Identificadores a SI
• Justification preperty Números a Right y Caracteres a Left
• Cambiar Orden de Navegación
5. Compilar y Ejecutar para probar los cambios

50
Capítulo 6
CREANDO LOVS Y EDITORS

51
LOVs y Editors
LOVS
Un LOV (lista de valores) es un cuadro de diálogo especial que muestra un grupo de
registros, permitiendo elegir una fila del grupo, devolviendo un único valor. Se utiliza como
una forma de elegir un conjunto de especifico de valores. Se puede por ejemplo, asociar un
LOV con un text item, tanto para proporcionar una forma sencilla de ingreso de datos,
como para proporcionar una lista de valores contra los que se pueda validar la entrada de
los datos.
Los LOV tienen las siguientes cualidades:
• Puede ser una Lista Dinámica o Estática

• Pueden ser independientes de un Text Item, lo cual significa que se puede acceder a
la lista a través de un Text item o fuera de este.
• Flexible y Eficiente: puede utilizar el mismo LOV para varios ítem, y
adicionalmente reutilizar la data que se encuentra en ella cargada, o acceder a la
base de datos en cada llamada a la lista.
Creando una lista de valores
La lista de Valores es un objeto dentro del Form module, que puede ser visto a
través del Object navigator. No trabaja por si sola, para que funcione debe tener asociado
otro objeto de la forma denominado Record Group.
Un Record Group es un objeto de Form Utilizado para almacenar arreglos de datos,

o grupos de registros para que estos sean luego mostrados a través de un LOV. El arreglo
de datos puede proceder de una sentencia Select, es decir de una consulta a la base de datos,
la lista Select de la consulta proporciona la estructura de la columnas del Record Group.
Por otra parte el Record Group puede ser estático, es decir, los valores no provienen de
una consulta, sino que están definidos a través de un cuadro de diálogo especial.

52
Los Record Group Pueden ser utilizados a través de lista de valores, en parámetros
de datos que pasan registros a reportes o gráficos, o como estructuras de datos PL/SQL.
Varias Lista de valores pueden estar basadas en un mismo Record Group.
Existen dos formas de crear lista de valores, a través del asistente (LOV Wizard) o
de forma manual.
Crear un LOV utilizando el LOV Wizard:

• Ingrese al menu Tools – LOV Wizard o en el object navigator presione el icono
Create posicionado previamente en el Objeto LOV, en este caso se despliega un
cuadro de diálogo en el cual escogerá la opción “ Use the LOV Wizard” .
Inmediatamente se despliega la primera pagina del asistente, donde debe indicar si

la lista de valores se realizará sobre un Record Group ya existente, o si por el contrario se
creará un nuevo record Group.

53
en la siguiente pantalla debe indicar el query sobre el cual se basara el nuevo Record
Group a crear
La siguiente pantalla le permite seleccionar cuales columnas de su Record Group

serán desplegadas en su Lista de valores.

54
En la siguiente pagina puede configurar propiedades como el título de las columnas

al visualizar la lista, el ancho de las columnas y por ultimo el text item donde se colocar el
valor retornado por la lista, este ultimo es opcional.
Luego, la pagina siguiente le permite establecer el tamaño del cuadro de diálogo que
mostrara la lista de valores, ancho y alto del mismo, así como asignar un título a la lista.

55
Algunas Propiedades de la lista de valores pueden ser definidas en la siguiente pantalla,

tales como, el nro. De registros que serán tomados de la base de datos a un mismo tiempo,
si la consulta se ejecutará cada vez que se despliegue la lista de valores, o si se incluye un
cuadro de diálogo para que el usuario agregue criterios a la búsqueda antes de desplegar la
información.

56
En la siguiente pantalla UD. Puede relacionar su lista de valores con un Text item, haga clic
en Finish para completar la creación de la lista de valores.
El asistente ejecutado genero dos objetos, la lista de valores (LOV) y el record Group.
Propiedades de las Lista de valores LOV.
Después de crear su lista de valores, Ud. Puede modificar las propiedades de la

misma a través de la paleta de propiedades. Las propiedades de un LOV se dividen en
varios grupos: General, Functional, Physical, Visual attributes, Color, Font e Internacional.
Las que pertenecen al grupo Functional son características propias de un LOV, y las
describiremos a continuación:
• Title: Especifica un título para la Lista de Valores.

• Record Group: especifica el nombre del record group sobre el cual esta basado la
lista.
• Column Mapping Properties: al presionar este botón se despliega un cuadro de
diálogo, en el que se muestran y se configuran las columnas a mostrase, el ancho de
estas y el text item donde retornara el valor de las mismas.

57
• Filter Before Display: determina que puede ser utilizado un criterio de búsqueda
para los elementos de la lista.
• Automatic Display: Permite que la lista se despliegue de manera automática cuando
el cursor se ubique en el item al cual esta asociado la lista.
• Automatic Refresh: indica que el record Group ejecutara la consulta cada vez que se
despliegue la lista.
• Automatic Select:
• Automatic Skip: Permite que el cursor avance de manera automática al próximo
ítem navegable, una vez se haya seleccionado un valor de la lista de valores.
• Automatic Position: Indica que Form ubicara de manera automática la lista cerca del
item que la invoca.
• Automatic Column Width: Indica que Form determinara de forma automática el
ancho de las columnas dependiendo del ancho necesario para mostrar el título de la
columna, si la propiedad se encuentra en NO, entonces utilizara el ancho definido.
Recomendaciones para LOV
• Evite realizar largos Queries

• Si usa columna para validar los valores introducidos por los usuarios en un Text
Item, coloque esta de primero en el SELECT
• Opcionalmente puede usar las cláusulas WHERE, GROUP y ORDER BY
EDITORS
Un editor es un cuadro de diálogo con editor de texto sencillo que permite la
introducción de líneas de testo en un text item. Generalmente, el editor por default de Form
Builder es suficiente. Sin embargo, Ud. Puede diseñar sus propios editores personalizados
como un objeto de un Form Módulo y asociar estos al text item que lo necesite.

58
Creando un Editor:
Seleccione el nodo Editors en el object navigator y haga clic en el icono create de la

barra. Un nuevo objeto editor será mostrado en la lista.
Ingrese a las propiedades del editor, y configúrelo según su requerimiento. Las
propiedades permiten especificar el tamaño de la ventana, los atributos visuales, el título
del editor entre otras propiedades.
Asociando un Editor a un text item
Puede asociar uno de los tres tipos de editors con un Text Item para esto configure
las propiedad Editor de un Text Item a una de las siguientes:
• Null (Editor por Default de Forms)

• Editor_name (Editor Personalizado)
• SYSTEM_EDITOR (Editor Externo)

59
Practica 5
1. Crear una forma maestro detalle que permita manipular los datos de las
ordenes de compra y sus items.
2. Crear una lista de valores sobre el Item CUSTID, SALE_REP_ID y
PRODID. Las listas deben mostrar código y nombre o descripción del
elemento y retornar el id valores sobre los items señalados.
3. Crear un editor personalizado y asociar Item Comments.

60
Capítulo 7
CREANDO ADICIONAL INPUT ITEMS

61
Adicional Input Items

Son tipos de items que permiten ingreso de datos por parte del usuario. Entre estos
se encuentran los siguientes:
• Check boxes
• List Items
• Radio Groups
A través de estos items se puede interactuar con la base de datos de las siguientes maneras:
• Insertar valores
• Actualizar valores existentes
• Borrar valores existentes
• Consultar valores existentes
Creando un Check Box
El Check Box es un objeto de interfaz el cual tiene dos estados que indican ON o
OFF, por lo tanto lo que se visualiza de este item es si se encuentra marcado (checked) o
desmarcado (unchecked). Sin embargo no esta limitado a dos valores, ya Ud. Especifica
que valor representa el Checked, que valor representa el Unchecked, y como serán
procesados otros valores distintos a los definidos, sin con checked o unchecked.
Un check Box puede ser creado de 3 maneras diferentes:
• Utilizando el Check Box Tool en el Layout Editor

• Usando el Create Icon en el Object Navigator
• Convirtiendo un Item existente

62
Boton Check Box

En el layout editor
Propiedades Específicas de un Check Box

• Data Type: especifica el tipo de dato al cual pertenece el item, puede se Char,
Number o Date.
• Label: Especifica la etiqueta que es mostrada adjunta al item.
• Access Key: Especifica la combinación de teclas que pueden ser usadas para
navegar a este item.
• Value When Checked: especifica el valor del item cuando el estado del item sea
marcado.
• Value When Unchecked: especifica el valor del ítem cuando el estado del ítem sea
desmarcado.
• Check Box Mapping of Other Values: Determina como serán procesados otros
valores difrentes a los definidos para el checked y el unchecked, las opciones son
Not Allowed, Checked y Unchecked.
• Mouse Navigate: Permite navegar dentro del item con el mouse.
Creando un List Item:

Un List Item es un objeto que muestra un conjunto de datos predefinidos, se usa
para seleccionar un valor de la lista, uno y solo uno puede ser seleccionado a un mismo
tiempo.
Hay 3 tipos de list item:
• PopList: aparece como un Campo con ícono adjunto a la derecha del mismo, al
hacer clic sobre este se muestra el contenido de la lista.

63
• Tlist: aparece como un cuadro el cual muestra los elementos de la lista, si el cuadro
no es suficiente para mostrar el contenido de la lista, el ítem tiene un scroll asociado
a la derecha del mismo para desplazar los valores y así poder visualizarlos.
• Combo Box: aparece como un campo con una flecha hacia abajo a la derecha del
mismo, la cual se utiliza para desplegar el contenido de la lista. Adicionalmente
acepta que el usuario ingrese datos.
Un List item puede ser creado de 3 maneras diferentes:

64
• Utilizando el List Item Tool en el Layout Editor

• Convirtiendo un Item existente
Boton List Item

En el layout editor
Beneficios de los List Items:

• Es un objeto de interfaz para desplegar un conjunto de valores predefinidos
• Hay tres estilos disponibles
• Es una alternativa para un radio groups
• Puede ser una alternativa para un LOV
Propiedades Específicas para un List Item

• Elements in List: abre un cuadro de diálogo en el cual se muestran y se configuran
los valores a mostrar en la lista. Dicho cuadro tiene dos partes:
• List Elements: contiene los elementos que aparecerán en la lista.
• List Item Values: Especifica el valor del elemento mostrado
• List Style: Especifica el estilo del list ítem, puede ser PopList, tlist y combo box.
• Mapping of Other Values: determina como serán procesados otros valores.
• Mouse Navigate: permite navegar en la lista con el mouse.

65
Creando Radio Groups

Un Radio Group es un conjunto de radio bottons. Cada radio botton representa un
valor diferente. Solo se puede escoger un radio botton dentro de un radio group.
Beneficios del Radio group

• Desplegar dos o mas opciones fijas
• Es una alternativa de un List Ítem
• Es una alternativa de un Check Box
Un Radio Group puede ser creado de 3 maneras diferentes:
• Creando un nuevo Radio Group Item en el Layout Editor
• Convirtiendo un Ítem existente

66
Boton Radio Group

En el layout editor
Propiedades Específicas para un Radio Group

RADIO GROUP
• Data Type: especifica el tipo de dato al cual pertenece el radio group, puede ser
Char, Number o Date.
• Mapping of Other Values: Determina como serán procesados otros valores.
• Mouse Navigate: permite navegar en el radio group con el mouse.
RADIO BUTTON
1. Name: identifica a cada radio button dentro del radio group.

2. Access Key: Especifica la combinación de teclas que pueden ser usadas para navegar a
este item.
3. Label: especifica el texto que aparece adjunto al radio button.
4. Radio Button Value: especifica el valor que el radio button representa dentro del radio
group.
Practica 6
4.1. Sobre el form module del ejercicio anterior realice los siguientes cambios:
 Convierta el item “payment_type” en un List Item
 Convierta el item Order_filled en un Check Box, Marcado significara
“Y” y desmarcado “N” o Null
4.2. Sobre el Form Module de Departamento/Empleado cree un Radio-Group Item
sobre el item

67
Capítulo 8
NON-INPUT ITEMS

68
NON-INPUT ITEMS
Es un tipo de items que no permite el ingreso de datos por parte del usuario. Están
divididos en dos grupos, los que pueden mostrar datos y los que no pueden hacerlo.
Nonimput Items que permite mostrar datos:
• Display Item
• Image Items
• Calculated Items
Nonimput items que no pueden mostrar datos
• Buttons
• Hierarchical Tree Items
Display Items
Un display item es similar aun text item, excepto por que no puede ser editado y no
es navegable durante la ejecución de la forma. Los usuarios solo pueden leerlo, no pueden
ingresar datos a través de ellos.
Los Display Items, pueden:
• Desplegar Datos Derivados
• Desplegar información adicional, sin tomar como base una tabla
• Conservar Recursos
Creando un Display Item

Un display item puede ser creado usando:
• Usando el botón de la barra de herramientas para Display item en el layout editor.
• Usando el icono create en el object navigator para crear un item y luego
modificando la propiedad Item Type.

69
Boton Display Item en

el Layout Editor
Image Items
Un image item es una interfase especial de control, que permite almacenar y
desplegar una imagen, la imagen no puede ser manipulada en la ejecución y puede ser
importada desde la base de datos o desde archivos del sistema operativo.
Puede utilizar un image item de las siguientes formas:

• Tomando la imagen de una columna LONG RAW o BLOB de una tabla de la base
de datos.
• Usando un trigger que muestra la imagen dinámicamente.
• Cortando y pegando la imagen directamente en el canvas.
Form Builder soporta los siguientes formatos imágenes:
• BMP
• CALS
• GIF
• JFIF
• TIFF
• JPEG
• PICT
• RAS
• TPIC
Para Asociar una imagen a un IMAGE ITEM se utilizar el procedimiento
read_image_file(), el cual utiliza los siguientes parámetros de entrada:
• Nombre del Archivo Imagen
• Tipo de Formato

70
• Item Imagen Name

Ver detalles del procedimiento en la ayuda en línea de Forms
Creando un Image Item

Un image item puede ser creado usando:
• Usando el botón de la barra de herramientas para image ítem en el layout editor.
• Usando el icono create en el object navigator para crear un ítem y luego
modificando la propiedad Item Type.
Botón Image Item

En el Layout Editor
Propiedades Específicas de Image Item

• Image Format: especifica el formato de la imagen
• Image Depth:
• Compression Quality
• Display Qualitty
• Show Palette
• Sizing Style
• Show Horizontal Scrollbar
• Show Vertical Scrollbar
Buttons
Un button ítem es un objeto especial que al hacer click sobre el permite ejecutar una
acción, usualmente es mostrado como un rectángulo con una etiqueta dentro que lo
describe, por su naturaleza no pueden almacenar o mostrar datos.
Los estilos de Buttons son:
• Text Button: se visualiza con una etiqueta de texto dentro del botón.

71
• Iconic: se visualiza con la imagen de un icono, son utilizados generalmente

en barras de herramientas.
Puede utilizar el Button para:
• Desplegar un LOV
• Invocar un Editor
• Invocar otra Ventana
• Hacer commit de los datos
• Realizar cálculos
Propiedades Específicas de un Button

• Label: Especifica el texto que aparecerá en el botón durante la ejecución de la
forma.
• Mouse Navigate: Determina que form Builder navegara al item cuando se haga
click usando el mouse.
• Default Button: especifica que el botón será el botón por defecto del el bloque.
• Iconic: determina que el botón mostrará un icono en lugar de la etiqueta
• Icon Filename: especifica el nombre del archivo que contiene el icono a mostrar
• Tooltip: especifica un texto de ayuda que aparece cuando el puntero del mouse se
desplace por el botón.
• Tooltip Visual Attribute Group: especifica el nombre del visual atributo para dar
formato al tooltip del botón.
Calculated Items
Permite que usted declare un ítem basado en un cálculo de una o más variables. Son
de sólo lectura.
Modos de Cálculos
• Formula
 Calcula los valores de un item como resultado de un cálculo horizontal
 Envuelve variables tipo Bind, como items, variables globales y parámetros.

72
• Summary
 Calcula los valores de un item como resultado de un cálculo vertical
 Los summary son realizados en los valores de un item sobre todos las filas
de un Block
Los calculated items son solo de lectura, el usuario no puede insertar o modificar el
valor de estos. Generalmente se utiliza el display items para mostrarlos.
Propiedades Específicas para un Calculated Item

• Calculation Mode: especifica el modo de calculo para el ítem, puede ser None,
Formula y Summary.
• Formula: especifica una expresión PL/SQL que determina el valor del item.
• Summary Function: Especifica el tipo de función summary a ser aplicada, puede ser
AVG, COUNT, MAX, MIN,STDDEV, SUM, VARIANCE
• Summarized Block: especifica el bloque al cual se le aplicara el calculo, es
requerido si el calcultion mode es Summary
• Summarized Item: especifica el ítem al cual se le aplicara el calculo, es requerido si
el calcultion mode es Summary
Cuando el modo de cálculo del ítem es Summary, este ítem debe pertenecer al mismo
bloque del ítem al cual se le va a aplicar el cálculo, de lo contrario debe pertenecer a un
bloque de control que tenga la propiedad Single Record en Yes.
El tipo de datos del ítem calculado debe ser numérico, a menos que la función a aplicar sea
MAX o MIN.
Reglas para los Formula Items

• No pueden invocar un Restricted Built-ins
• No pueden ejecutar declaraciones DML
• No pueden terminar una expresión de PL/SQL con un punto y coma

73
Reglas para los Summary Items

• El Summary Item debe residir en:
• El mismo Block del Summary Item, o
• Un control block con la propiedad Record Property configurada a Yes
• El Summarized Item debe residir en:
 Un Data Block con las propiedades Query All Records o Precompute
Summaries configuradas a Yes
 O, en un Control Block
• El tipo de dato para el Summary debe ser Númerico, a menos que utilice un MAX o
MIN
Hierarchical Item
Un hierarchical item es un objeto a través del cual se muestran datos y se navega
sobre un ellos de forma similar a como el Object Navigator de iDS muestra y permite
navegar sobre los componentes de sus herramientas. Este objeto tiene las siguientes
características:
• Los datos mostrados pueden ser valores contenidos en un Record Group
Object o Query Text.
• En tiempo de ejecución los datos pueden ser añadidos, removidos,
modificados o evaluados sus elementos en la jerarquía, a través de
programación.
• La cantidad de data mostrada en un momento dado dependerá de la
expansión o contracción de los nodos de la jerarquía, bien sea que se
programe o que el usuario presione click sobre ellos.
Practica 7
5. Sobre la forma del ejercicio anterior realice los siguientes cambios
5.1. Agregue tres items adicionales de Non-Input para el nombre o descripción de los
items: CUSTID, SALE_REP_ID Y PRODID
5.2. Por cada Item muestre la fotografía o imagen asociada al producto.
5.3. Muestre en la forma el Logo de la Empresa.

74
5.4. Incluya botones para activar la lista de valores de la practica 5

5.5. Incluya un item donde se muestre el total por cada item de la orden, el cual es el
resultado de multiplicar la cantidad del producto por el precio menos el descuento
5.6. Muestre el total por cada departamento

75
Capítulo 9
CREANDO WINDOWS Y CONTENT
CANVASES

76
WINDOWS Y CANVASES
Windows
Es un contenedor para todos los objetos visuales que forman parte de una aplicación
hecha en Form Builder, es similar a un Frame vacío, el cual provee los controles para la
ventana que habilita funcionalidades tales como: mover, minimizar, maximizar y
redimensionar. Un Form módulo puede tener varios Windows.
Canvas
Un canvas es la base sobre la que se sitúa el texto plano y los objetos visuales. Cada
objeto hace referencia a un único canvas en su lista de propiedades, los items de un bloque
de datos se pueden dividir en varios canvas.
TIPOS DE CANVAS:
Form Builder ofrece varios tipos de canvas, son los siguientes:

• Canvas Content
• Canvas Stacked (apilado)
• Canvas Tab (ficha)
• Canvas Vertical Toolbar.
• Canvas Horizontal Toolbar.
Creando un Content Canvas

Un Canvas Content o de contenido es el canvas base que ocupa por completo el
contenido de la ventana en el cual se muestra, es el tipo de canvas predeterminado.
Relacion entre el window y el canvas.

Un canvas no es un elemento de interfaz autónomo, para verlo a el y a sus
elementos es necesario mostrarlo en un window, debe crearse un canvas content para cada
ventana dentro de la aplicación. Cuando la aplicación se ejecuta solo un canvas content
puede ser mostrado en una ventana a un mismo tiempo. Los canvas content se muestran
siempre en todo el window, por lo tanto si un window es redimensionado el canvas se

77
redimensiona de manera automática. En un window pueden estar asociados varios canvas

de diferentes tipos.
 Todo canvas debe estar asociado a un Window.
 Todo window debe tener al menos un canvas.
Tipos de Windows
Hay dos tipos de Windows
• Modal: es una ventana que exige que el usuario responda o descarte la ventana
antes de hacer nada en cualquier otra ventana de la aplicación.
• Modeless (No modal): es la opción por defecto, permite el acceso a otras ventanas
de la aplicación sin descartar la primera. A menudo las ventanas Modeles tienen
características que las distinguen, como la falta de barras de desplazamiento y la
incapacidad de ser minimizadas a iconos.
Los windows en Form Builder se definen por lo que hacen, existen dos estilos:
• Window Document: Es una ventana no modal que visualiza un elemento de la
aplicación, que generalmente un canvas de contenido relacionado con la parte
principal de la aplicación.
• Window Dialog: es una ventana generalmente modal que muestra opciones u otras
formas de controlar la operación de la aplicación.
Cuando Crea un form módulo, Form Builder crea un window automáticamente, el cual
es llamado WINDOW1. Ud. Puede borrar o renombrar a WINDOW1, e incluso modificar
sus propiedades.
Propiedades De Los Windows.

• Physical Property:
 X position: Determina la Coordenada X para la ventana.
 Y position: Determina la coordenada Y para la ventana.
 Width: Determina el ancho de la ventana.
 Height: determina el alto de la ventana:

78
 Bevel: determina como se mostraran los bordes de la ventana.

 Show Horizontal Scrollbar: asigna un scrollbar horizontal en la ventana.
 Show Vertical Scrollbar: Asigna un scrollbar vertical en la ventana.
• Functional Property:
 Title: especifica el título que aparece en la barra de título de la ventana.
 Primary canvas: especifica el nombre del canvas que será mostrado en la
ventana cuando esta sea invocada.
 Window Style: determina si estilo del documento es Document o Dialog.
 Modal: determina si se trata de una ventana modal o no.
 Hide on Exit: Indica que un window Modeles o no Modal debe ocultarse de
forma automática cuando el usuario navegue fuera de este.
 Icon Filename: Especifica el nombre del archivo de icono que será
visualizado al ser minimizada la ventana.
GUI Hints
Son recomendaciones para el window manager acerca de la apariencia y

funcionalidad del Window. Si el window manager soporta un específico GUI Hints y esta
propiedad es configurada a Yes. Forms puede usarla
Propiedades funcionales para GUI Hints

• Close allowed: habilita el mecanismo para cerrar la ventana.
• Move Allowed: permite mover de lugar la ventana.
• Resize Allowed: permite redimensionar el tamaño de la ventana durante la
ejecución.
• Maximize Allowed: permite maximizar el tamaño de la ventana.
• Minimize Allowed: permite que la ventana sea minimizada a un icono.
• Inherit Menu: indica que la ventana mostrara el menú asociado al form módulo.

79
Creando un Nuevo Window.

Ud. Puede crear windows adicionales al generado automáticamente por form, los
cuales serán mostrados en su aplicación , aplicando los siguientes pasos:
• Haga Clic sobre el nodo window del Object navigator

• Haga clic en el icono create, un nuevo window aparecerá en el object navigator
• Modifique las propiedades del nuevo window según sus requerimientos.
Practica 8
1. Revisar las propiedades de los objetos Windows y Content Canvas de los módulos
creados en las practicas anteriores
2. Cambiar las propiedades de estos objetos, compilar y ver los resultados.
3. Crear un window a al modulo orden-items que sirva para mostrar información de ayuda,
descriptiva del objetivo de la forma

80
Capítulo 10
OTROS TIPOS DE CANVAS

81
OTROS TIPOS DE CANVAS
Ya en el capitulo anterior se menciono que existen varios tipos de canvas, y se

definió el canvas Content, en este capitulo definiremos los tipos de canvas restantes.
Stacked Canvas
Es un tipo de canvas que puede mostrarse sobre otros canvas, incluyendo el canvas
content asignado al window. Un window puede mostrar un canvas content y cualquier
numero de canvas stacked, estos son usualmente más pequeños que el window en el cual se
muestran.
La vista de un canvas stacked va determinada por el Viewport, este es un atributo de
un canvas, y determina la parte visible del mismo.
Los canvas stacked permiten la creación de diversos efectos especiales, por ejemplo,
si un data block contiene mas ítems que los que la ventana puede mostrar, el scroll bar
permite visualizar los ítems que quedan fuera de la ventana. Esto puede causar que
importantes items queden fuera de vista, para resolver este caso, se puede tener un conjunto
de items permanentes en un canvas content mientras que el resto de los ítem están en un
canvas stacked el cual se desplaza para mostrar el resto de los items.
Stacked Canvas Propiedades
VIEWPORT PROPERTY:
• Viewport X position: especifica la coordenada X donde comenzará la parte visible

del canvas.
• Viewport X position: especifica la coordenada Y donde comenzará la parte visible
del canvas.
• Viewport width: determina el ancho del la parte visible del canvas.
• Viewport height: determina el alto de la parte visible del canvas.

82
PHYSICAL PROPERTY:
• Show horizontal Scrollbar: determina si el canvas tendrá una barra desplazamiento

horizontal.
• Show Vertical Scrollbar: determina si el canvas tendrá una barra desplazamiento
vertical.
Toolbars
Es un tipo de canvas especial que usted puede crear para manejar button y otros
elementos gráficos.
Hay tres tipos:
• Vertical toolbar: se utiliza para posicionar los botones de arriba hacia abajo, a la
derecha o a la izquierda de la ventana.
• Horizontal toolbar: se utiliza para posicionar los botones de izquierda a derecha, en
la parte superior o en la parte inferior de la ventana.
• MDI toolbar: se utiliza para aplicaciones form builder que usan multiples windows
Toolbar Propiedades
CANVAS PROPIEDADES
• Canvas Type: especifica el tipo de canvas, para un canvas toolbar, debe ser
Horizontal toolbar o Vertical Toolbar.
• Window: especifica el window en el cual se mostrara el canvas.
• Width: determina el ancho del canvas
• Heigth: determina el alto del canvas.
WINDOW PROPIEDADES
• Horizontal Toolbar Canvas: determina cual será el toolbar horizontal definido para
el window
• Vertical Toolbar Canvas: determina cual será el toolbar vertical definido para el
window

83
FORM MODULE PROPIEDADES
• Form Horizontal Toolbar Canvas: indica la barra horizontal que se mostrará en el

MDI de la ventana.
• Form Vertical Toolbar Canvas: indica la barra vertical que se mostrará en el MDI de
la ventana.
Tab Canvas
Es un tipo especial de canvas que permite organizar y mostrar la información en

paginas o fichas separadas, al igual que los canvas stacked , los canvas tab pueden ser
desplegados sobre un canvas content.
Un tab page es un sub-objeto de un canvas tab, y se le denomina así, a las paginas o

fichas del canvas. Un canvas tab puede contener una o varias página s, una página puede
desplegar un conjunto de items, la pagina tiene una etiqueta en la que el usuario hace clic
para acceder a los datos que en ella se encuentran. Cada pagina del canvas tiene el mismo
tamaño dentro del canvas.
Practica 9
1. Crear un forma que muestre las ordenes de compra y sus productos asociados, con las
siguiente características:
1.1. A nivel de la Orden mostrar el nombre del vendedor y asociarle una lista de valores
que permita seleccionar el vendedor de la orden. Activar esta lista a través de un
botón
1.2. Permitir seleccionar el tipo de pago excluyentemente. Si el tipo de pago es cheque
o tarjeta, permitir incluir el numero de cheque o tarjeta y el banco emisor.
Dependiendo de la selección la etiqueta de estos campos debe indicar de que se
trata.
1.3. A nivel de items de la orden, mostrar todos los datos del producto permitiendo
hacer scroll horizontal sin perder de vista el numero de item, código y descripción
del producto, este ultimo debe ser mostrado al seleccionar el producto de una lista o
introducir el código.

84
1.4. Mostrar el total de bolívares por producto, el cual se calcula multiplicando la

cantidad por el precio menos el descuento.
1.5. Al final mostrar el total de la orden, la cual será la suma del total por producto mas
IVA.

85
Capítulo 11
INTRODUCCIÓN A LOS TRIGGERS

86
Form Builder Triggers

Un trigger es un programa que es ejecutado de manera automática (disparado)
cuando ocurre el evento para el cual fue programado. Puede utilizarlos para agregar o
modificar nuevas funcionalidades. Cada trigger esta asociado a un evento en especifico,
Form Builder define un amplio rango de eventos por los cuales se puede dispara un trigger.
Entre esos eventos se encuentran los siguientes:
• Eventos relacionados con consultas

• Ingreso de datos y validación de los mismos.
• Navegación y movimiento físico del mouse.
• Interacción con items en la forma
• Eventos internos en la forma
• Errores y mensajes.
Componentes del Alcance de un Trigger
El alcance de un trigger esta determinado por su posición en la jerarquía de objetos

de la forma, es decir, el tipo de objeto bajo el cual ha sido creado el trigger.
Existen 3 posibles niveles en los que se puede crear un trigger:

• A nivel de la forma: el trigger aplica para el módulo completo.
• A nivel del bloque: el trigger afecta a un bloque y se dispara solo este bloque es el
bloque actual
• A nivel del ítem: al trigger afecta a un ítem individualmente y se dispara solo
cuando este ítem es el ítem actual.

87
Algunos items pueden ser definidos solo en ciertos niveles, por ejemplo un Trigger Post
Query, no puede ser definido a nivel del ítem,
Componentes de un Tipo de Trigger
Se dividen 5 tipos diferentes dependiendo del tipo de evento que los dispara. El
nombre de un trigger identifica el tipo al que pertenece, su nombre siempre contiene un
guión (-). La primera parte del nombre antes del guión es la que identifica el tipo.
KEY- : se dispara al activar una tecla de función.

ON -:
PRE- : se dispara antes de una acción específica.
POST- : Se dispara justo después de una acción.
WHEN-
Componentes del Código de un Trigger

El código de un trigger define la acción a ejecutarse cuando este se dispare, escriba
este código como un bloque anónimo PL/SQL usando el editor PL/SQL, pudiendo utilizar
sentencias como las siguientes:
• Definiciones estándar de PL/SQL (asignaciones, bucles).

• Sentencias SQL que son validas en PL/SQL
• Llamadas a programas como procedimientos y funciones que se encuentran el la
forma, en una librería o en la base de datos.
• Llamadas a programas propios de Oracle Forms Developer
Jerarquía de Ejecución
Si existe mas de un trigger con el mismo nombre en una forma, Oracle Forms lanza
por defecto el asociado al elemento mas bajo en la jerarquía, es decir, si por ejemplo en un
módulo form existe el trigger WHEN-NEW-ITEM, a nivel de la forma, del bloque y del

88
ítem, se dispara el que esta asociado al ítem como tal, y los demás son ignorados, debido al
que el mas bajo en la jerarquía es el nivel del ítem. Sin embargo esta secuencia puede ser
alterada cambiando la propiedad execution Hierarchy.

89
Capítulo 12
CREANDO TRIGGERS

90
CREAR UN TRIGGER
Puede crear un trigger utilizando alguna de las siguientes maneras:
• Cuando hace clic en un objeto en el object navigator o en el layout editor usando el
botón derecho del el mouse, un menú se despliega que incluye la opción Smart
Triggers, esta opción expande una lista de los triggers comunes que son apropiados
para utilizarse en el objeto en el que se encuentra.
• En el object navigator, seleccione el nodo triggers de la forma, bloque o ítem que

quiere sea el dueño de el trigger.
Propiedades de un Trigger
• Name: especifica el nombre del trigger, esta predeterminado.
• Trigger Style: Por defecto el valor PL/SQL
• FIRE in Enter Query Mode: Determina que el trigger pueda ser disparado cuando se
encuentre en modo Enter Query.
• Execution Hierarchy: determina la jerarquia del trigger, Override, Before o after
Form Builder Built-in Subprogramas
Form Builder provee un conjunto de programas predefinidos como parte de este

producto. Estos programas están definidos como packages, procedimientos y funciones.
Pueden ser utilizados en cualquier trigger , o subprograma de la forma. Sin embargo, la
funcionalidad de algunos de estos programas no esta permitida en ciertos tipos de trigger
A continuación algunos de los programas de form que pueden ser utilizados en los triggers
para agregar funcionalidad a los items.
 ENTER_QUERY: Limpia el bloque actual y lo prepara para recibir los criterios
de busque da la consulta.
 EXECUTE_QUERY: limpia el bloque actual, abre la consulta y toma el numero
de registros seleccionados.

91
 EXIT_FORM: sale de la forma actual, o cancela el query si esta se encontraba en

Modo Enter Query.
 GET_ITEM_PROPERTY: retorna el valor que tiene un propiedad especifica de
un item.
 GO_BLOCK: navega al bloque especificado.
 GO_ITEM: navega al ítem especificado.
 HIDE_VIEW: oculta el canvas
 LIST_VALUES: invoca a la lista de valores adjunta al ítem actual.
 MESSAGE: muestra el texto especificado
 SET_ITEM_PROPERTY: permite modificar los valores de las propiedades de un
item.
 SHOW_ALERT: muestra un alerta definido u devuelve un valor numérico
cuando el usuario seleccione uno de los 3 posibles botones del mismo.
 SHOW_LOV: invoca un alista de valores, y devuelve un valor booleano
indicando que el usuario tomo un valor de la lista.
 SHOW_VIEW: muestra el canvas indicado.
 WRITE_IMAGE_FILE: Escribe la imagen de Form Builder Image Item en el
archivo especificado
 READ_IMAGE_FILE: Lee una imagen de un tipo especifico y la despliega en un
Form Builder Image Item
 FORM_SUCCESS: esta funciona sirve para saber subprograma de form se
ejecuto satisfactoriamente.
USANDO LOS TRIGGERS

A continuación una lista descriptiva de los triggers mas comúnmente utilizados:
When-Button-Pressed: Se activa cuando el usuario selecciona un botón
When-window-Closed: Se activa cuando el usuario cierra una ventana utilizando el Close
comando del Window-manager.

92
When-Checkbox-Changed: Se dispara cuando el usuario cambia el estado de un Check

Box, haciendo click con el mouse o utilizando el teclado
When-Radio-Changed: Se dispara cuando el usuario selecciona un diferente radio button en
un radio group, o cuando quita la selección del radio button actualmente seleccionado.
When-Image-Pressed: Se dispara cuando el usuario utiliza el mouse para: Hacer un click
sobre la imagen o doble click en la imagen
When-List-Changed: Se dispara cuando el usuario selecciona un elemento diferente en un
list item
When-List-Activated: Se dispara cuando el usuario hace doble click en un elemento de un
list item que es desplegado en una lista
ON-ERROR: Se activa normalmente en Form Builder cuando un mensaje de error es
presentado, utilizado para manejar errores de Form Builder y de Oracle Server, y para
personalizar mensajes de error
ON-MESSAGE: Se activa normalmente en Form Buildder cuando un mensaje del sistema
es usado, se utiliza para suprimir o personalizar un mensaje.
PRE-QUERY: Se activa durante el proceso de Execute Query or Count, justo antes de que
Form Builder construya y use la declaración SELECT. Se define a nivel del Block. Se
dispara una vez
POST-QUERY: Cuando una consulta es abierta en un block, el Post-Query trigger se
dispara cada vez que Form Builder hace el fetch de un registro dentro del block. Se
dispara una vez por cada registro colocado en el Block. Se define a nivel del Block. Se
dispara una vez. Se utiliza para llenar non-database items y estadísticas de cálculos
When-Validate-Item: Se activa durante el proceso de validación del Item. Especialmente
cuando el estatus de validación del Item es New o Changed.
When-Validate-Record: Se activa durante el proceso de validación del Record.
Especialmente cuando el estatus de validación del Record es New o Changed.
Pre-Form: Se dispara con el evento de entrar a una Forma permite restringir acceso a la
forma e Inicializar variables globales
Post-Form Se dispara al salir de una forma permite limpiar la forma antes de salir y enviar
mensajes a los usuarios

93
Pre-block: Se dispara con el evento de entrar a un bloque

Post-block Se dispara al salir de un bloque permite limpiar el bloque antes de salir.
Practica 10
1. Aplique funcionalidad a la forma creada en la práctica anterior a través del uso de los
triggers adecuados, a saber: botones, imágenes, etc.
2. Al ingresar una nueva orden de compra, añadir un número de línea, cuyo valor debe ser
secuencial y automático.
3. Al crear una orden la fecha de la orden debe ser igual a la del día y no se permite
modificarla
Practica 11
4. En el modulo orden-producto, al ejecutar la consulta de las ordenes existentes la forma
debe mostrar los datos asociados a los códigos del cliente, vendedor, producto
Practica 12
5. En los campos fecha valide que al incluir una nueva orden la fecha de la orden no sea
mayor a la fecha del día.
6. En los campos vendedor, cliente y producto, valide que se introduzcan códigos
existente

94
Capítulo 13
MESSAGES Y ALERTS

95
MESSAGES Y ALERTS
Form Builder muestra mensajes durante la ejecución de la aplicación para informar

al usuario sobre eventos ocurridos en la sesión. El desarrollador , puede querer suprimir o
modificar algunos de estos mensajes, dependiendo de sus requerimientos.
Form Builder se comunica con el usuario de las siguientes maneras:

• Mensajes de Información: son mensajes que dicen al usuario sobre el estado actual
del procesamiento, se muestra en la línea de mensajes, y pueden ser suprimidos con
el trigger On-Message.
• Mensajes de Error: estos informan al usuario sobre un error que ocurre, se muestran
en la línea de mensajes, y pueden ser suprimidos con un trigger On-Error.
• Mensaje Working: este mensaje informa al usuario que la forma esta actualmente
procesando, se muestra en la línea de mensaje y puede ser suprimido asignando
True a la variable de sistema SUPPRESS_WORKING.
• Mensajes de alerta (Alerts): Muestran mensajes que requieren de una respuesta o
acción por parte del usuario, es mostrado en una ventana modal.
Controlando los mensajes del sistema:

Ud. Puede definir cuales mensajes quiere sean mostrados y cuales serán suprimidos
de acuerdo al nivel de severidad del mensaje. Form Builder clasifica cada mensaje con un
nivel de severidad que indica si se trata de un mensaje muy importante o uno trivial. A
mayor numero mayor es la severidad del mensaje.
La calcificación va del nivel 0, el cual muestra todos los mensajes al 25, los
mayores de 25 son mensajes que no pueden ser suprimidos. En un trigger se puede
especificar que solo los mensajes mayores a una severidad especifica sean mostrados, los
menores serán suprimidos, esto se hace asignado el valor del nivel de severidad a la
variable del sistema MESSAGE_LEVEL, la cual por defecto tiene el valor 0, lo que indica
que todos los mensajes deben ser mostrados.

96
ALERTS:
Un alerts es un aviso con el cual la aplicación se comunica con el usuario, se
despliega un cuadro de diálogo especial que muestra un mensaje o realiza una pregunta
sencilla que solicita un tipo de respuesta del tipo si o no del usuario, el cuadro tiene un
icono y hasta 3 botones como OK y Cancel, Yes o NO, etc. Tan bien se puede especificar
uno de estos 3 botones como el botón por defecto.
Existen 3 tipos de avisos, de stop, de información y de precaución.

• Los avisos de stop o parada, muestran el icono de una señal de parada con el
mensaje.
• El aviso de precaución muestra el icono de una exclamación con el mensaje.
• El aviso de información muestra el icono de información con el mensaje.
Creando un Alert:
Para crear un alert ejecute los siguientes pasos:
• Se selecciona la cabecera alerts en el object navigator y se hace clic en el icono
create.
• Defina las propiedades del alert según sus requerimientos.
Propiedades de un alert:
• Name: indica el nombre del objeto, es definido por el desarrollador.
• Title: Título de la ventana de alerta.
• Alert style; define el tipo de alert, es decir, de parada, de precaución o de
información.
• Button1, button2, button3: etiquetas para cada una de las 3 posibles botones del
aviso, si se deja en blanco uno de los botones , no se muestra en la ventana.
• Default Alert Button: determina el botón que estará por defecto.
• Message: indica el mensaje que aparecerá en lo que se despliegue el alert.

97
Como Mostrar un Alert:

Utilizando el subprograma SHOW_ALERT desde el código de un trigger, se puede
mostrar un aviso, este programa devuelve el numero alert_button1, alert_button2 o
alert_button3 dependiendo del botón seleccionado por el usuario. Después se puede
comprobar el numero devuelto y tomar las acciones apropiadas para cada caso en el código
del trigger.
Codificando un poco, se pueden crear alerts reutilizables y que muestren mensajes

dinámicos que hagan referencia a valores o items específicos.
Practica 13
1. Crear al modulo Orden – Productos, un procedimiento que muestre los mensajes en
español de los errores o mensajes mas comunes que pueden ocurrir, tales como:
1.1. Valores obligatorios
1.2. Cursor en el primer registro
1.3. Incorrectos valores introducidos (Letras en vez de números, fecha errada, vendedor
inexistente, producto inexistente, entre otros).

98
Capítulo 14
INTEGRANDO REPORTES A UNA
FORMA

99
A través de Form Builder podemos interactuar con Oracle Reports y de esta manera
construir pantallas que luego permitan colocar la información que en ellas se encuentra en
un reporte.
Para lograr estos existe un Objeto en el object navigator de form Builder

denominado Report, es por medio de este objeto que lograremos la conexión.
Creando un reporte desde Form Builder

Debemos seguir los siguientes pasos:
• Sitúese en el nodo Report del object navigator.
• Haga clic sobre el icono create del object navigator.
En ese momento se despliega un cuadro de diálogo como el siguiente
en dicho cuadro tiene dos Radio Button para seleccionar la opción con la cual trabajará.
La primera opción le permite crear un nuevo reporte, adicionalmente tiene un check box
para indicar si el reporte a crear estará basado en un bloque de la forma actual. Si
selecciona esta opción se abrirá Oracle Reports de manera automática, si marcó el check
para que el reporte este basado en uno de los bloques de la forma, entonces al crear el
reporte se asume dicho bloque como el query del reporte.

100
La segunda opción es para escoger trabajar con un reporte que ya esta elaborado,
simplemente indique el nombre del reporte.
Esto crea un objeto dentro del nodo report, con el nombre REPORT XX, ahora debe
configurar las propiedades de dicho objeto.
Propiedades del REPORT

• Name: Nombre del objeto report
• Filename: nombre del archivo ejecutable del reporte a mostrar de Oracle Report
• Execution Mode: esta es la forma como se ejecutara el reporte desde form, hay 3
posibles opciones, Batch y rutime. El modo Batch no permite la interacción con el
usuario durante la ejecución, y el modo runtime si.
• Comunication Mode: Modo en que se hará la comunicación con Report las
opciones son synchronous, asynchronous. Sincrónico indica que el control no
retornara a la aplicación que hace la llamada a Report hasta tanto la ejecución del
mismo no haya finalizado, asincrónico, devuelve el control a la aplicación
inmediatamente.
• Data source Data Block: Nombre del bloque de la forma con el cual esta asociado
el reporte, es opcional, para que el reporte muestra la misma información que es
vista en la pantalla, este valor debe estar asignado, de lo contrario Forms solo llama
a un reporte aunque sus datos sean diferentes.
• Query Name: es el nombre del query del Reporte.
• Report Destination Type: Es la forma como saldrá el reporte, las opciones son
File, Screen, Printer, Preview, Mail, Cache.
• Report destination Name: Nombre del dispositivo de salida, por ejemplo el
nombre de la impresora si la salida es Printer.
• Report Destination Format: específica el formato en el cual saldrá el reporte
cuando la opción de salida es File, Por ejemplo PDF, HTML entre otros.
• Report Server: Especifique el nombre de la cola de la maquina donde se ejecutará
el reporte.

101
• Other Report Parameters: una lista de parámetros que pueden ser pasados al
reporte.
Procedimientos de Form para Integrar con Report:
Para hacer la llamada al reporte es necesario ejecutar algunos programas de Form

diseñados para tal fin, dicha llamada puede realizarse desde un trigger, como por ejemplo al
presionar un botón para imprimir.
• RUN_REPORT_OBJECT: Ejecuta el reporte desde form con los valores que ya

están configurados para el mismo. Parámetro de entrada report_id.
• FIND_REPORT_OBJECT: es una función que recibe el nombre del objeto report y
si existe retorna el id del mismo.

102
• SET_REPORT_OBJECT_PROPERTY: permite modificar las propiedades

definidas para un objeto report

103

Manual Forms Developer 9i II

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual Forms Developer 9i II

Uploaded by

Copyright:

Available Formats

GEDICA TRAINING & CONSULTING C.A.

Oracle Forms Developer

ORACLE FORMS DEVELOPER

Oracle Forms Developer

DATA BLOCKS Y FRAMES............................................................................................35

Oracle Forms Developer

OTROS TIPOS DE CANVAS............................................................................................81

Oracle Forms Developer

Oracle Forms Developer

Oracle Forms Developer

Es un conjunto de herramientas de Oracle dirigidas a compañías interesadas en que su

• Oracle Forms Developer

Oracle Forms Developer

Oracle Forms Developer

PL/SQL Editor: es una funcionalidad que permite el desarrollo de Triggers,

Oracle Forms Developer

el utilitario Jar que se encarga de crear y/o extraer archivos de

Oracle Forms Developer

<ORACLE9iDS HOME>/jdk/bin/jar –cfv <<nombre-archivo-

El parámetro “imagebase” configurado a “codebase” significa que

Esta aplicación es llamada en la Web usando el siguiente URL:

Conectándose A La Base De Datos:

Oracle Forms Developer

• Seleccione el menú File – Connect

Personalizar iDS- Forms

Personalizando Sesión de Forms

Oracle Forms Developer

Oracle Forms Developer

Form Developer Características.

Forms Developer Ejecutables

FORMS 9i D:\ORANT\BIN\ifbld90.EXE module=module userid=scott/tiger

Menu Principal De Form Builder

Oracle Forms Developer

Form Builder Módulos

Una aplicación en Form consiste de muchos módulos. Un módulo es el mayor

Oracle Forms Developer

O B J E C T L I B R A R Y M O D U L E S : es un repositorio común para objetos estándar

P L / S Q L L I B R A R Y M O D U L E S : es un conjunto de programas de PL/SQL que

Form Builder Componentes

• B L O C K S : Cada forma consta de uno o mas bloques. Un bloque es el

• I T E M S : Son objetos de interfaz que muestran la data al usuario y le

• C A N V A S : Es la base sobre la que se sitúa el texto plano y los items. Cada

• W I N D O W S : un window es por si mismo un frame vacío. Pueden ser de

Oracle Forms Developer

incapacidad de ser minimizadas a iconos. Un window no modal permite el

Data Blocks( Bloque de Datos)

Hay 2 tipos principales de blocks en Form Builder

Oracle Forms Developer

Control Blocks: No se corresponde a una tabla o vista y sus registros no se corresponden a

Oracle Forms Developer

Oracle Forms Developer

CREANDO UN FORM MODULE

Puede crear un nuevo form módulo de diferentes formas:

Al ingresar a forms Builder se despliega una pantalla la cual le permite escoger si

Oracle Forms Developer

Usando los Wizards (Asistentes):

CREANDO UN NUEVO BLOQUE

Si ya se encuentra dentro de Oracle Form Builder seleccione la opción Data Block

Oracle Forms Developer

Oracle Forms Developer

Oracle Forms Developer

CREANDO UN NUEVO DATA BLOCK MANUALMENTE

En Form Builder, utilice uno de los siguientes métodos: