Le guide Oracle Forms 9i/10g

Ce guide doit permettre de se familiariser avec le générateur d'applications d'Oracle Forms en apportant au lecteur les connaissances suivantes :

• prise en main de l'outil de conception (gestion des formes, menus et librairies PL/SQL) ;
• étude de chaque composant d'un module ;
• déplacements dans le navigateur d'objets ;
• mise en œuvre des fonctionnalités de l'éditeur de présentation ;
• connaissance des notions primordiales (module, bloc, item, déclencheurs) ;
• règles internes de fonctionnement du produit (navigation, relation avec la base, validation) ;
• gestion des blocs basés sur une vue complexe, des sources de données multiples, des procédures stockées, des tables relationnelles et objets contenant des collections ;
• forms et le PL/SQL ;
• gestion d'application multi formes ;
• gestion des erreurs.

Il concerne les versions 9i et 10g du produit.
Cependant, la plupart des concepts étudiés s'appliquent également aux versions antérieures (6i, 5, 4.5).


Il ne concerne pas l'installation du produit ni celle de la base de données associée.

Certains écrans de test fournis en exemple nécessitent l'installation de la librairie Webutil ou de certains composants Java (FormsGraph.jar pour l'intégration de graphiques).

Ce guide est destiné à tout public débutant ou confirmé. Il suppose toutefois l'acquisition, par le lecteur, de bonnes notions de SQL en général et de PL/SQL en particulier.

Le débutant y trouvera matière à découvrir le produit, augmenter ses connaissances, utiliser de nouvelles fonctionnalités à travers les nombreux exemples et écrans de test fournis.
Le confirmé pourra approfondir certains points du produit.

Tous les exemples, codes SQL et PL/SQL ainsi que les écrans de test fournis dans cet article ont été développés et testés avec les versions suivantes :

• Developer Suite 9i et Database 9i ;
• Developer Suite 10g et Database 10g.

Cet article est livré avec de nombreux exemples.

Ils comprennent les éléments suivants :

• scripts de création et d'alimentation des objets de la base nécessaires au fonctionnement des écrans de test ;
• modules Forms, menus et librairies PL/SQL et librairie d'objets de démonstration ;
• éléments d'ajout aux fichiers de configuration ;
• quelques fichiers image.

Pour installer ces exemples sur votre machine, effectuez les opérations suivantes :

• créez un répertoire d'accueil sur votre disque dur (ex. : d:\tutoforms10g) ;
  
  
• téléchargez le fichier d'exemples : tutoforms10g.zip ;
  
  
• décompressez le fichier tutoforms10g.zip ;
  
  
• lisez le fichier tuto_forms_install.htm.
  
  

Vous y trouverez toutes les informations pour installer les exemples, compiler les sources et adapter les fichiers de configuration.

L'écran TUTO_FORMS.FMB rassemble toutes les formes d'exemple disponibles :

• Les Canevas (TEST_CANVAS.FMB) affichent plusieurs types de canavas ( Intégral, empilé, onglet) et démontrent quelques fonctionnalités liées.
• Bloc sur vue complexe (TEST_BLOC_VUE.FMB) démontre l'utilisation d'un bloc basé sur une vue complexe.
• Bloc basé sur procédures stockées démontre la gestion des blocs basés sur des procédures stockées.
• Bloc sur collection (TEST_COLLECTION.FMB) démontre l'utilisation d'un bloc basé sur une collection.
• Bloc basé sur sources multiples (TEST_DATA_SOURCES.FMB) démontre la gestion de plusieurs tables de même structure dans un bloc.
• Bloc sur table objet (TEST_OBJETS.FMB) démontre la gestion d'une table objet munie d'une collection de références.
• Mélange d'items (TEST_ITEMS.FMB) présente la plupart des types d'items.
• Item Liste (TEST_LISTES.FMB) présente l'affichage et la manipulation des items de type Liste.
• Items Image (ALBUM.FMB) est une suite d'écrans démontrant la gestion des images.
• Composant javabean (TEST_GRAPH.FMB) démontre l'utilisation d'un composant javabean (nécessite FormsGraph.jar).
• Items calculés (TEST_CALCUL.FMB) présente l'utilisation d'items calculés.
• Boites d'alertes (TEST_ALERTES_MESSAGES.FMB) démontre l'utilisation des boites d'alertes associées à une table de messages.
• Classe de propriétés (TEST_CLASSES_PROP.FMB) présente l'utilisation des classes de propriétés et des attributs visuels.
• Processus Forms (TEST_CYCLES.FMB) permet d'afficher, pour chaque action, le déclenchement des triggers correspondants.

N'hésitez pas à ouvrir les modules sources et en étudier le contenu.

Chaleureux remerciements à plaineR pour ses propositions et son effort louable de relecture.

L'exécutable se trouve dans le répertoire <ORACLE_HOME>\bin.

Il permet de concevoir les écrans, les menus, de gérer les librairies PL/SQL, les librairies d'objets et permet l'édition des fonctions, procédures et packages stockés dans la base de données.

On peut l'appeler avec les options suivantes :

• Buffer Records in File ;
• Debug Mode ;
• Array Processing ;
• Display Block Menu ;
• Query Only Mode ;
• Quiet Mode.

Exemple

ifbld90 module=orders userid=scott/tiger module_type=menu

l'exécutable se trouve dans le répertoire <ORACLE_HOME>\bin

Il permet de migrer, compiler et générer un exécutable pour une forme, un menu ou une librairie PL/SQL.

Il est utilisé de façon « encapsulée » par le module de conception lors d'une demande de compilation ou de génération, mais également en ligne de commande pour migrer ou générer en masse des modules source.

On peut l'exécuter avec les options suivantes :

-- afficher l'aide
ifcmp90 help=YES

-- convertir le module en fichier texte
ifcmp90 module=myform script=YES

-- convertir le fichier texte en format binaire
ifcmp90 module=myform parse=YES

-- suppression du code source dans une librairie PL/SQL
ifcmp90 module=old_lib.pll userid=scott/tiger strip_source=YES output_file=new_lib.pll

-- spécifier, lors d'un upgrade la version initiale du module (uniquement V2)
ifcmp90 module=myform userid=scott/tiger upgrade=yes version=23
À utiliser conjointement avec upgrade=YES.
spécifier version=20 pour une version 2.0 et version=23 pour une version 2.3

-- transforme les privilèges SQL*Menu 5 en rôles Oracle9i
ifcmp90 userid=system/manager upgrade_roles=YES

-- suppression des messages interactifs
ifcmp90 module=myform userid=scott/tiger batch=YES

-- Affichage de la fenêtre d'options (modes graphiques uniquement)
ifcmp90 module=myform userid=scott/tiger options_screen=YES

-- migration une version antérieure
ifcmp90 module=myform userid=scott/tiger upgrade=YES

-- génération des fichiers binaire et exécutable lors d'une migration
ifcmp90 module=myform userid=scott/tiger upgrade=YES build=NO

-- ajout du mot-clé NOFAIL aux steps lors d'une migration V2.0
ifcmp90 module=myform userid=scott/tiger upgrade=yes version=20 nofail=YES

-- connexion ou non à la base durant la compilation
ifcmp90 module=myform userid=scott/tiger logon=NO

-- ajout d'un caractère à la propriété Largeur d'affichage des items
-- lors de la migration vers la version 9, la propriété RELIEF de l'item occupe un caractère
-- widen_fields permet d'ajouter un caractère à la largeur d'affichage
ifcmp90 module=myform userid=scott/tiger upgrade=yes widen_fields=YES

-- migration depuis une version V2
ifcmp90 module=myform userid=scott/tiger upgrade=yes version=20 crt_file=myfile.crt

-- ajout des triggers KEY-UP et KEY-DOWN lors d'une migration
ifcmp90 module=myform userid=scott/tiger upgrade=yes version=23 add_triggers=YES

-- compilation du code contenu dans les unités de programme
ifcmp90 module=myform userid=scott/tiger compile_all=YES

-- indication du type de module a compiler
ifcmp90 module=orders userid=scott/tiger module_type=menu
module_type peut valoir:

• form
• menu
• library

l'exécutable se trouve dans le répertoire <ORACLE_HOME>\bin

Il permet de lancer l'exécution d'un module Forms en mode web.

Il accepte, en ligne de commande, les paramètres suivants :

Exemple
http://myserver/forms90/f90servlet?form=MODULE1.fmx&debug_messages=YES

Il affiche l'ensemble des objets éditables d'une application Forms organisés en plusieurs sections, sous la forme d'arborescences.

• Applications Forms
• Menus
• Bibliothèques PL/SQL
• Bibliothèques d'objets
• Packages intégrés
• Objets de la base de données

Pour charger un objet dans le navigateur, utilisez le menu Fichier -> Ouvrir

La barre d'outils verticale

Dans l'exemple suivant, nous sélectionnons le nœud Blocs de données et cliquons l'icône (++)

la barre d'outils horizontale

Dans l'ordre de gauche à droite :

• Nouveau formulaire
• Ouvrir
• Enregistrer
• Imprimer
• Couper
• Copier
• Coller
• Connexion
• Compilation
• Exécution
• Exécution avec le débogueur
• Lancer
• Ligne suivante
• Sauter (en exécutant) la procédure
• Pause
• Arrêt
• Assistant présentation
• Assistant bloc de données
• Aide

Le menu Affichage permet de modifier la présentation des objets dans la fenêtre du navigateur :

Organisation hiérarchique affiche tous les objets dans l'ordre standard (module -> blocs -> items )

Organisation visuelle n'affiche que les objets qui seront visibles à l'exécution (fenêtres, canevas, items)

Afficher PL/SQL seulement n'affiche que les objets supportant du code PL/SQL


Lorsque l'éditeur de présentation ou la fenêtre de propriétés est affiché, la sélection d'un ou de plusieurs objets depuis le navigateur les sélectionne également dans l'éditeur de présentation.

Pour sélectionner plusieurs objets, maintenez la touche Ctrl enfoncée et cliquez les objets correspondants.


Déplacement dans le navigateur

En dehors de l'utilisation de la souris, vous pouvez utiliser les flèches du clavier pour vous déplacer dans le navigateur

Flèche bas se déplace vers l'objet suivant
Flèche droite se déplace vers l'objet suivant et le développe s'il contient des sous-objets
Flèche haut se déplace vers l'objet précédent
Flèche gauche se déplace vers l'objet précédent et le referme s'il contient des sous-objets

Ctrl+Flèche droite développe tous les objets d'une section

Ctrl+Flèche gauche referme tous les objets d'une section


Déplacement des objets dans le navigateur

Il est possible de déplacer les objets par simple cliquer/glisser

Cela permet de modifier l'ordre des blocs dans une forme ou des items dans un bloc.
Cela permet également de déplacer un déclencheur d'un objet à l'autre.

Si vous maintenez la touche Shift enfoncée, vous faites une copie de l'objet (l'objet initial reste en place)

remarques:
Vous ne pouvez déplacer un objet que vers un conteneur adéquat.
Lorsque vous déplacez un objet, vous déplacez également les sous-objets qu'il contient.


Dupliquer un objet

Pour dupliquer un objet, il suffit de le sélectionner et d'utiliser la touche Ctrl+D


Changer le nom d'un objet

Il est possible de changer le nom d'un objet sans passer par la fenêtre de propriété.
Il suffit de cliquer deux fois (pas trop vite, il ne s'agit pas d'un double-clic) dans le nom de l'objet que l'on veut modifier


Diviser la fenêtre du navigateur

Il est possible de diviser la fenêtre en plusieurs sous-fenêtres en utilisant le petit rectangle noir situé au-dessus de la barre de défilement verticale

Cliquez dans ce rectangle noir et descendez avec la souris

Il permet de gérer les canevas et donc l'affichage des objets

Il peut être affiché selon quatre méthodes :

• Double-clic sur le nom d'un canevas dans la fenêtre du navigateur d'objets ;
• Via le menu Outils -> Editeur de présentation ;
• Touche F2 ;
• Sélection de l'objet puis clic-droit -> Affichage de l'éditeur de présentation.

Description des différentes zones de travail

La barre d'outils horizontale

En partie haute, deux listes déroulantes permettent de sélectionner le canevas sur lequel l'on souhaite travailler ainsi que le bloc de données
En partie basse gauche, deux listes déroulantes permettent de spécifier le nom et la taille de la police de caractères
En partie basse droite, une liste d'icônes ayant pour fonctionnalité de gauche à droite :

• Caractères gras
• Caractères italiques
• Caractères soulignés
• Zoom avant
• Zoom arrière
• Alignement vertical à gauche
• Alignement vertical centré
• Alignement vertical à droite
• Alignement horizontal en haut
• Alignement horizontal centré
• Alignement horizontal en bas
• Passer l'objet devant
• Passer l'objet derrière

La barre d'outils verticale

La zone centrale de composition

Elle est bordée d'une règle verticale et horizontale (paramétrable)
C'est dans cette zone que seront positionnés les différents objets d'affichage

Lorsque l'éditeur de présentation est ouvert, un menu supplémentaire est affiché :

Une fenêtre de sélection des polices de caractères

Justification permet d'indiquer le type de justification du texte
Interlignage permet d'indiquer le type d'interlignage appliqué au texte
Épaisseur de trait pour régler l'épaisseur de traits des objets graphiques (surfaces et lignes)
Tiret pour régler les types de traits (plein ou pointillé)
Flèche pour ajouter des flèches aux extrémités des traits
Bordure (valide uniquement sur les surfaces rectangulaires) permet de définir les cotés que l'on souhaite afficher
Relief pour indiquer le type de relief de l'élément
Aligner composants permet d'aligner les composants présélectionnés soit entre eux, soit par rapport à la grille
Répéter alignement répète la dernière opération d'alignement
Dimensionner composants permet de dimensionner un groupe d'objets
Répéter dimensionnement répète la dernière opération de dimensionnement
Passer au premier plan passe l'objet sélectionné en premier plan
Passer en arrière-plan passe l'objet sélectionné en arrière-plan
Déplacer vers l'avant passe l'objet sélectionné un cran devant
Déplacer vers l'arrière passe l'objet sélectionné un cran derrière
Opération sur les groupes permet de grouper les composants entre eux

Lors de l'utilisation de l'outil Surface rectangulaire, l'appui sur la touche Ctrl pendant le dessin force le dessin d'un carré
Lors de l'utilisation de l'outil Surface elliptique, l'appui sur la touche Ctrl pendant le dessin force le dessin d'un cercle parfait
Lors de l'utilisation de l'outil trait, l'appui sur la touche Ctrl pendant le dessin force le dessin d'un trait horizontal, vertical ou à 90°
L'outil de mise en forme est utile sur les graphiques de type Arc pour modifier l'angle de l'arc

Quelques exemples d'alignements et de dimensionnements

Empilé place les items bord à bord
Répartir place les items à égale distance

Effets de relief

Adaptation de la grille et de la règle

Permet de spécifier l'unité de mesure, le pas de la grille (c'est-à-dire le nombre d'unités par pas) et enfin le nombre de points magnétiques par pas de grille.
Ces points magnétiques servent au déplacement des objets sur le canevas depuis le clavier (flèches haut, bas, droite, gauche)

L'exemple ci-dessus indique que l'unité de mesure est le Point, qu'il y en a 12 par pas de grille et que chaque pas de grille dispose de deux points magnétiques.
Cela veut dire que le déplacement d'un item avec le clavier se fera par incrément de 6 points

Ce paramétrage est utile pour aligner les différents objets sans utiliser les outils d'alignement.
Si vous souhaitez pouvoir déplacer vos éléments au point près il faut spécifier autant de points magnétiques que de points de pas de la grille

Ajustement des palettes de couleurs

Ce réglage ne peut s'effectuer que lorsque l'éditeur de présentation est ouvert et que vous avez spécifié que la palette était modifiable dans le menu Edition -> Préférences : Mode couleur

Si le mode couleur était spécifié à Lecture seule, vous devez le changer à Modifiable, quitter Forms Builder et relancer.

Afficher la palette depuis le menu Edition -> Options de présentation -> Palette de couleurs…

Vous pouvez modifier n'importe quelle couleur en cliquant sur l'une des cases couleur puis sur le bouton Editer…
Il est également possible de modifier le nom de la couleur dans la case : Couleur courante puis avec le bouton : Renommer.

Rappel, dans toutes les propriétés gérant une couleur, il est possible de la spécifier soit par sa valeur RGB soit par son nom.

En bas à gauche, 8 cases sont vierges pour vous permettre de les personnaliser

Personnalisons la première d'entre elles :
Cliquons sur la première case blanche puis sur le bouton Editer…

sélectionnons un magnifique Brun « Sienne » puis validons avec le bouton OK

Appelons cette nouvelle couleur : Sienne

Nous venons de personnaliser cette couleur qui apparaîtra désormais dans la palette de l'éditeur de présentation.
Nous pourrons également spécifier cette couleur dans les propriétés gérant les couleurs au niveau canevas et items.

Lorsque le module Forms est enregistré, la palette de couleurs en fait également partie.

Il est donc possible d'avoir une palette différente pour chaque module Forms

Les palettes de couleurs par défaut

Forms 9i/10g est livré avec 4 palettes de couleurs qui se trouvent dans le répertoire:
<ORACLE_FORMS_HOME>\tools\Common90\*.pal

• col16.pal
• col256.pal
• default.pal
• gray.pal

Pour les nostalgiques de l'avant-guerre, gray.pal propose une palette composée exclusivement de niveaux de gris.
Pour les nostalgiques de l'après-guerre, col16.pal propose une palette de 16 couleurs…
Col256.pal est quasiment identique à default.pal à la différence que les 8 cases vierges sont déjà colorisées et qu’elle ne contient pas les niveaux de gris.


Le choix d'un système de coordonnées

La première étape cruciale avant de disposer quoi que ce soit dans l'éditeur de présentation consiste à sélectionner un système de coordonnées.
Toutes les valeurs indiquant par la suite une taille ou une position dépendront du système de coordonnées défini.
Ce système étant global à la forme, il est défini au niveau des propriétés du module

Pour afficher la fenêtre de propriétés du module, cliquer sur le nom du module et taper la touche F4 ou double-cliquer sur le nœud

cliquer ensuite dans la case en regard du libellé : Système de coordonnées

deux systèmes de coordonnées sont disponibles :

• caractère
• réel

Si vous choisissez Caractère, aucun autre réglage n'est possible. Le système défini que le caractère est contenu dans une matrice de 9x19 pixels.
Ce système perdure pour des raisons de compatibilité avec les anciennes applications non graphiques

Si vous choisissez Réel, 5 unités sont alors disponibles :

• Pixel
• Centimètre
• Pouce
• Point
• Décipoint

Selon l'unité que vous choisirez, les valeurs spécifiées ultérieurement utiliseront cette unité


Ajouter des composants sur le canevas


Pour ajouter un composant, vérifier d'abord que le bon canevas et le bon bloc de données sont sélectionnés dans les listes déroulantes de la barre d'outils horizontale.
Cliquer un composant dans la barre d'outils verticale et cliquer ensuite à l'intérieur du canevas.( il est possible de fixer d'entrée la taille finale du composant en maintenant le bouton gauche de la souris enfoncé, puis en déplaçant le pointeur. Relâcher le bouton de la souris lorsque le composant a atteint la taille voulue.

Les objets graphiques

Ces objets ne sont pas contenus dans un bloc de données.
Ils sont attachés directement au canevas et, par conséquent et malheureusement non modifiables à l'exécution… (une instruction Set_Frame_Property() aurait pourtant été d'une évidence rare…)

Les items

Ils sont rattachés à un bloc (basé ou non)

Propriétés des objets graphiques:


Rappel : La fenêtre d'affichage des propriétés est activée avec la touche F4

Dressons d'abord la liste des propriétés communes à la majorité des types d'items

Général
Nom désigne le nom interne de l'item (30 caractères maxi commençant par une lettre)

Fonctionnel
Activé indique si l'item est activé (manipulable)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, ENABLED)).
Justification justification de l'item

• Gauche
• Droite
• Centre
• Début
• fin

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, ALIGNMENT)).
Classe de mise en œuvre désigne le nom de classe d'un conteneur javabean
Multiligne indique si l'item accepte les retours à la ligne
Cette propriété ne peut être fixée qu'au moment du design.
Type de césure désigne le type de césure :

• Aucun
• Caractère
• Mot

Cette propriété ne peut être fixée qu'au moment du design.
Respecter maj/min indique si la saisie peut être mixte, seulement minuscules ou seulement majuscules
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, CASE_RESTRICTION)).
Masquer données permet de cacher la saisie de mot de passe
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, CONCEAL_DATA)).
Conserver position du curseur indique si, lors du retour dans l'item le curseur revient à l'exacte position initiale
(si cette propriété est fixée à Non, le contenu de l'item est entièrement sélectionné dès l'entrée du curseur, favorisant les frappes de type : remplace) Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, KEEP_POSITION)).
Saut automatique indique que lorsque la saisie atteint le nombre maximum de caractères, le curseur saute vers l'item suivant
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, AUTO_SKIP)).
Menu instantané permet de désigner un menu instantané sur l'item (menu popup)
Cette propriété ne peut être fixée qu'au moment du design.(Hélas…)

Physique
Position X pour fixer la position horizontale
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, X_POS)).
Position Y pour fixer la position verticale
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, Y_POS)).
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, POSITION, x, y)).
Largeur indique la largeur de l'item
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, WIDTH)).
Hauteur indique la hauteur de l'item
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, HEIGHT)).

Ces propriétés doivent être valides (les positions et tailles ne doivent pas excéder les dimensions de leur conteneur (Canevas ou Fenêtre) sous peine de générer une erreur à l'exécution
Lorsque vous spécifiez une constante ou une variable pour déterminer une position ou une dimension, celle-ci est toujours exprimée avec l'unité définie dans le système de coordonnées. (Si le S.C est en Inch, alors une largeur de 1 vaut donc 1 inch.)



Données

Type de données indique le type de la donnée au sens Oracle du terme

• Char
• Number
• Date alpha
• Integer
• Datetime
• Long
• Rnumber
• Jdate
• Edate
• Time
• Rinteger
• Money
• REF objet

Seuls les types CHAR, DATE, DATETIME, NUMBER et LONG sont natifs et devraient être utilisés. Les autres types ne sont présents que par souci de compatibilité (notamment avec Forms3).
Cette propriété ne peut être fixée qu'au moment du design.
Sémantique de la longueur (Null, BYTE ou CHAR)
Propriété relative aux données de type caractère (CHAR, VARCHAR2) et indique si le caractère est stocké sur un octet (BYTE) ou un caractère (CHAR)
Cette propriété ne peut être fixée qu'au moment du design.
Longueur maximum nombre maximum de caractères saisissable
Cette propriété ne peut être fixée qu'au moment du design.
Valeur initiale valeur assignée par défaut à la création de l'enregistrement
Cette propriété ne peut être fixée qu'au moment du design.
Obligatoire indique si l'item doit être valorisé (non NULL)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, REQUIRED)).
Masque de format spécifie un masque de format
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FORMAT_MASK)).
Valeur minimum autorisée indique la valeur minimum que l'on peut saisir
Valeurs possibles:

• N'importe quelle constante valide
• item (:block_name.item_name)
• variable globale (:GLOBAL.nom_global)
• paramètre (:PARAMETER.nom_param)

Cette propriété ne peut être fixée qu'au moment du design.
Valeur maximum autorisée indique la valeur maximum que l'on peut saisir
Valeurs possibles : idem Valeur maximum
Cette propriété ne peut être fixée qu'au moment du design.
Copier valeur de l'élément indique le nom de l'item d'où recopier la valeur
(le format doit être « nom_bloc.nom_item »)
Cette propriété est utilisée notamment dans la gestion des relations entre blocs
Cette propriété ne peut être fixée qu'au moment du design.
Synchroniser avec permet de désigner un autre item se synchronisation. Lorsqu'un item est modifié, l'autre est automatiquement synchronisé.
Cette propriété ne peut être fixée qu'au moment du design.


Base de données

Élément de base de données indique si l'item correspond à une colonne d'une table
Cette propriété ne peut être fixée qu'au moment du design.
Nom de colonne désigne le nom de la colonne de la table
Cette propriété ne peut être fixée qu'au moment du design.
Clé primaire indique si l'item participe à la clé primaire (et donc obligatoire)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PRIMARY_KEY)).
Interrogation seulement indique si l'item peut être modifiable ou seulement interrogeable
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, QUERY_ONLY)).
Interrogation autorisée indique si l'item peut être utilisé dans une interrogation (ENTER-QUERY)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, QUERYABLE)).
Longueur d'interrogation indique le maximum de caractère pouvant être saisi dans l'item en mode interrogation
Cette propriété ne peut être fixée qu'au moment du design.
Insertion autorisée indique si l'insertion est autorisée
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, INSERT_ALLOWED)).
Mise à jour autorisée indique si la mise à jour est autorisée
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, UPDATE_ALLOWED)).
Mettre a jour seulement si NULL indique que la valeur de l'item ne peut être modifiée que lorsqu'elle vaut NULL
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, UPDATE_NULL)).
Verrouillage d'enregistrement indique si la ligne de la table doit être verrouillée dès la modification de l'item
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, LOCK_RECORD_ON_CHANGE)).


Liste de valeurs (LOV)

Liste de valeurs spécifie le nom de la LOV attachée à l'item
Position X de la liste indique la position horizontale d'affichage du coin supérieur gauche de la LOV
Position Y de la liste indique la position verticale d'affichage du coin supérieur gauche de la LOV
Valider à partir de la liste indique si le contenu de la LOV attachée doit être utilisé pour valider la saisie.


Editeur

Editeur
Position X de l'éditeur
Position Y de l'éditeur


Attributs visuels

Groupe d'attributs visuels permet de spécifier un attribut visuel
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, VISUAL_ATTRIBUTE)).


Couleur

Couleur de premier plan
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FOREGROUND_COLOR)).
Couleur d'arrière-plan
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, BACKGROUND_COLOR)).


Police

Nom de la police permet de spécifier le nom de la police de caractère
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_NAME)).
Taille de la police indique la taille en points
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_SIZE)).
Epaisseur désigne la graisse (de ultramince à ultragras)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_WEIGHT)).
Style indique le style de la police

• Simple
• Italique
• Oblique
• Relief
• Ombré
• Inversé
• Surimpression
• Clignoter

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_STYLE)).
Espacement spécifie l'espacement entre les caractères (de ultradense à ultralarge)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_SPACING)).


Invite

Invite permet de saisir le texte de l'invite
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_TEXT)).
Type d'affichage

• Masqué (l'invite n'est pas affichée)
• Premier enregistrement (l'invite n'apparaît que sur le premier enregistrement)
• Tous les enregistrements (l'invite apparaît que sur chaque enregistrement)

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_DISPLAY_STYLE)).
Justification permet de régler la justification de l'invite

• Gauche
• Droite
• Centre
• Début
• Fin

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, FONT_SPACING)).
Bord d'attache indique à quel bord attacher l'invite

• Début
• Fin
• Haut
• Bas

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_EDGE)).
Alignement indique l'alignement vertical/horizontal de l'invite

• Début
• Fin
• Centre

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_EDGE_ALIGNMENT)).
Décalage d'attachement désigne l'espace entre l'item et l'invite
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_EDGE_OFFSET)).
Décalage d'alignement désigne un décalage par rapport à l'alignement
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_ALIGNMENT_OFFSET)).
Couleur de premier plan spécifie une couleur pour le texte de l'invite
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, PROMPT_FOREGROUND_COLOR)).

Quelques exemples d'alignement et d'attachement d'invite

Aide

Message d'aide permet de saisir un message qui sera affiché dans la barre de message
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, HINT_TEXT)).
Aide automatique indique si les messages d'aide seront affichés
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, AUTO_HINT)).
Bulle d'information permet de saisir un message qui sera affiché sous forme de bulle info
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, TOOLTIP_TEXT)).
Groupe d'attributs visuels de la bulle désigne l'attribut visuel appliqué à la bulle d'information
Cette propriété ne peut être fixée qu'au moment du design.

Item de type texte

Physique

Epaisseur du trait spécifie la largeur de trait d'encadrement
Type de tiret indique la nature du trait de l'encadrement (plein, pointillé,etc.)
Style des extrémités fixe l'aspect graphique des jointures d'encadrement
Angle de rotation spécifie l'angle d'inclinaison du texte
Boite englobante prédéfinie positionnée à Oui indique que l'encadrement reste fixe quelle que soit la longueur du texte. Avec Non, l'encadrement s'ajuste à la taille du texte
Espacement de trait spécifie la valeur de l'interlignage
Renvoi à la ligne autorise le renvoi du texte à la ligne lorsqu'il est trop long
Justification horizontale

• Gauche
• Droite
• Centre
• Début
• Fin

Justification verticale

• Haut le texte est aligné en haut de son cadre
• Centre le texte est centré verticalement
• Bas le texte est aligné en bas de son cadre

Origine horizontale

• Gauche le texte est aligné à gauche du point X
• Droite le texte est aligné à droite du point X
• Centre le texte est centré sur le point X

Relief


Couleur

Couleur de premier plan du bord (couleur de l'encadrement)
Couleur d'arrière-plan du bord (couleur du fond de l'encadrement)
Motif du bord (motif de l'encadrement)


Item de type Bouton de commande

Fonctionnel

Activé désigne si l'élément est actif (Oui) ou inactif (Non)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, ENABLED)).
Libellé indique le libellé du bouton
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, LABEL)).
Touche d'accès indique le caractère qui en combinaison avec la touche Alt déclenchera le code du bouton (inactif si le bouton est de type icône)
Cette propriété ne peut être fixée qu'au moment du design.
Icône permet de placer une image sur le bouton
Cette propriété ne peut être fixée qu'au moment du design.
Nom de fichier icône détermine le nom du fichier image (obligatoirement au format gif ou jpeg)
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, ICONE_NAME)).
Bouton par défaut indique si le bouton a automatiquement le focus
Cette propriété ne peut être fixée qu'au moment du design.
Menu instantané permet d'indiquer le nom d'un menu popup associé au bouton
Cette propriété ne peut être fixée qu'au moment du design.

Navigation

Navigation autorisée au clavier indique si l'item peut recevoir le focus lors de la navigation au clavier
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, NAVIGABLE)).
Navigation à la souris indique si l'item peut recevoir le focus lors de la navigation avec la souris
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, MOUSE_NAVIGATE)).
Elément de navigation précédent indique l'item qui recevra le focus après l'appui de la touche Tab
Élément de navigation suivant indique l'item qui recevra le focus après l'appui de la touche Shift+Tab


Enregistrements

Groupe d'attributs visuels de l'enregistrement courant désigne le nom de l'attribut visuel utilisé pour coloriser l'enregistrement courant
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, CURRENT_RECORD_ATTRIBUTE)).
Distance entre enregistrements spécifie la distance séparant chaque enregistrement.
Cette propriété ne peut être fixée qu'au moment du design.
Nombre d'éléments affichés indique le nombre d'éléments qui seront affichés dans un bloc multienregistrements.
Cette propriété ne peut être fixée qu'au moment du design.


Physique

Canevas permet d'indiquer le nom du canevas sur lequel s'affichera l'item
Cette propriété ne peut être fixée qu'au moment du design.
Page onglet permet d'indiquer sur quel onglet afficher l'item
Cette propriété ne peut être fixée qu'au moment du design.


Item de type Boite à cocher

Fonctionnel

Libellé désigne le libellé qui fera partie de la case à cocher
La différence entre le libellé et l'invite réside dans le fait que le libellé fait partie intégrale de la case à cocher. On peut donc la cocher/décocher en cliquant sur le libellé et pas seulement la case. En standard, l'invite se situe à gauche de l'item et le libellé à droite.
Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, LABEL)).
Valeur lorsque coché indique la valeur que prendra l'item lorsque la boite sera cochée
Valeur lorsque non coché indique la valeur que prendra l'item lorsque la boite sera décochée.
Case à cocher correspondance avec d'autres valeurs permet d'indiquer le choix suite à une valeur ne correspondant à aucune des deux permises.
Dans ce cas, trois choix sont possibles :

• Non autorisé (la valeur est rejetée)
• Coché
• Non coché

La valeur doit être compatible avec le type de données assigné à l'item
Quelques exemples de valeurs:
Vous souhaitez afficher sous forme de boite à cocher une information de type Oui/Non. Cette information est stockée dans votre table sous la forme d'un VARCHAR2(1) pouvant contenir 'O' ou 'N'
Vous indiquerez 'O' dans la propriété Valeur lorsque coché et 'N' dans la propriété Valeur lorsque non coché.
Si cette information est matérialisée dans votre table sous la forme d'un VARCHAR2(3) pouvant contenir 'Oui' ou 'Non', ce sont également ces valeurs que vous indiquerez.
Après l'interrogation de la table, la case sera cochée si le contenu de la colonne est 'Oui' et non cochée si le contenu est 'Non'.
De la même façon, le fait de cocher la case enregistrera la valeur 'Oui' en table, sinon la valeur 'Non'.
Cette propriété ne peut être fixée qu'au moment du design.


Item de type Bouton radio

Fonctionnel

Libellé désigne le libellé qui fera partie du bouton radio
La différence entre le libellé et l'invite réside dans le fait que le libellé fait partie intégrale du bouton. On peut donc le sélectionner en cliquant sur le libellé et pas seulement le bouton radio.
Cette propriété peut être fixée à l'exécution (Set_Radio_Button_Property(…, LABEL)).
Valeur de bouton d'option indique la valeur retournée au radio groupe lorsque ce bouton est sélectionné
Cette propriété ne peut être fixée qu'au moment du design.

Rappel : un bouton radio fait partie d'un radio group. C'est ce dernier qui hérite de la valeur du bouton cliqué.


Item de type Image

Fonctionnel

Format image indique le format de l'image qui sera stockée dans l'item
Les formats reconnus sont les suivants :

• BMP
• CALS
• GIF
• JFIF
• PICT
• RAS
• TIFF
• TPIC

Le format indiqué dans cette propriété est prioritaire sur le format réel de l'image importée. En d'autres termes si vous spécifiez le format GIF, puis que vous importiez une image au format TIFF dans cet item, l'image sera enregistrée en base au format GIF.
Cette propriété ne peut être fixée qu'au moment du design.
Profondeur d'image permet de spécifier le filtre utiliser pour stocker l'image en base

• Original (l'image est stockée telle quelle)
• Monochrome (l'image est transformée en noir/blanc)
• Gris (l'image est transformée en niveaux de gris)
• LUT (l'image est transcrite au format Luminescence, Intensité, brillance)
• RVB (l'image est transcrite au format Rouge, Vert, Bleu)

Cette propriété peut être fixée à l'exécution (Set_Item_Property(…, IMAGE_DEPTH)).
Qualité de la compression
Cette propriété n'est plus supportée depuis la version Forms 9i.
Qualité de l'affichage détermine le niveau de qualité d'affichage de l'image

• Max
• Moyen
• Min

Cette propriété n'est effective qu'à l'affichage et permet de limiter l'espace mémoire utilisé afficher l'image.
Cette propriété ne peut être fixée qu'au moment du design.
Afficher palette détermine si vous souhaitez afficher une palette d'outils de manipulation de l'image. Trois outils sont alors disponibles :

• Zoom
• Pan (permet de déplacer l'image dans la fenêtre)
• Rotate (pour effectuer une rotation de l'image)

Type d'ajustement indique si l'image sera découpée pour tenir dans l'item ou ajustée à la taille de l'item
Cette propriété ne peut être fixée qu'au moment du design.


Item de type Zone de liste

Fonctionnel

Eléments dans la liste permet de spécifier chacun des éléments de la liste
Un clic sur le bouton Liste… fait apparaître une boite de saisie

En haut on saisit le libellé tel qu'il apparaîtra dans la liste et en bas, la valeur qui sera stockée dans l'item
Type de liste désigne le type de liste avec les possibilités suivantes:

• Liste instantanée
• Liste de sélection
• Zone de liste déroulante

Cette propriété ne peut être fixée qu'au moment du design.
Correspondance d'autres valeurs spécifie quelle valeur stocker dans l'item lorsque la colonne ramène une valeur non comprise dans la liste.
Si cette propriété est laissée vide, alors la valeur n'appartenant pas à la liste sera rejetée.
Cette propriété ne peut être fixée qu'au moment du design.

Il est important de noter qu'un item de type Liste est composé de deux éléments:

• Le libellé affiché qui apparaît dans la liste
• La valeur associée au libellé. C'est celle-ci qui sera lue/écrite dans la colonne correspondante de la table.

Item de type Arborescence

Fonctionnel

Autoriser les branches vides permet de spécifier si un nœud peut exister s'il n'a pas d'enfant (sous-branche)
Cette propriété peut être fixée à l'exécution (Set_Tree_Property(…, ALLOW_EMPTY_BRANCHES)).
Sélection multiple indique si plusieurs éléments peuvent être sélectionnés.
Si vous spécifiez : Non, la sélection d'un nœud entraînera la désélection du nœud précédent.
Cette propriété ne peut être fixée qu'au moment du design.
Afficher les symboles indique si les symboles de développement(+) ou réduction(-) doivent être affichés devant chaque nœud
Groupe d'enregistrements désigne le record group qui alimentera l'arborescence.
Interrogation permet de spécifier un ordre SELECT pour l'alimentation de l'arborescence

Cette fenêtre permet de modifier les propriétés du ou des objets sélectionnés.

La barre d'icônes

Ajouter/Supprimer une propriété n'est actif que lorsque l'objet édité est une Classe de propriétés.

Union/Intersection n'est actif que lorsque plusieurs objets sont sélectionnés.

Figer/Libérer la fenêtre :
Par défaut, une seule fenêtre de propriétés est active. Lorsque vous cliquez sur un autre élément depuis le navigateur d'objets ou l'éditeur de présentation, les propriétés de l'ancien objet sont remplacées par celles du nouveau.
Figer la fenêtre permet d'ouvrir une seconde fenêtre de propriétés indépendante de celle (ou celles) précédemment affichée(s).

Rappel :
Vous pouvez afficher l'aide en ligne correspondant à la propriété sélectionnée en frappant la touche F1

L'édition de tout code PL/SQL se fait dans la fenêtre d'édition de code

Pour ouvrir cette fenêtre, plusieurs choix sont possibles:

• Double-clic sur le nom d'un déclencheur ou d'une procédure dans le navigateur d'objets
• Clic droit sur l'objet puis option Editeur PL/SQL
• Menu Outils -> Editeur PL/SQL
• Touche F11 au clavier

Ces listes déroulantes permettent de sélectionner tous les objets de la forme contenant du code PL/SQL sans quitter la fenêtre d'édition

Avant de refermer la fenêtre d'édition, compilez le code avec l'icône
Remarque:
Il ne sera pas possible de générer une version exécutable du module tant qu'il persistera des erreurs dans le code PL/SQL

Si le code contient une erreur, la fenêtre affiche le message correspondant et positionne le curseur sur la ligne en erreur

Cette boite de dialogue permet d'insérer le squelette des instructions PL/SQL ou des fonctions natives de Forms lorsque vous éditez du code PL/SQL.

Elle est affichée via le menu : Outils -> Palette de syntaxe…

Insérer une instruction PL/SQL

Insère, dans l'éditeur PL/SQL le squelette d'une instruction ou d'une construction PL/SQL

La liste déroulante permet de choisir le type de construction souhaitée

• Blocs
• Fonctions
• Boucles
• Curseurs
• Exceptions
• …

Insérer une procédure interne

Permet d'insérer dans l'éditeur PL/SQL le squelette d'une fonction native de Forms

Cette palette est très pratique, notamment pour l'insertion des fonctions natives Forms, lorsque vous n'êtes pas certain de la syntaxe (position, nombre et type des arguments).

Les déclencheurs contiennent du code exécutable. Ils sont nommés et répondent à des évènements spécifiques. (programmation évènementielle)

Par exemple
Le déclencheur When-New-Form-Instance se déclenche au chargement du module.
Le déclencheur Pre-Insert se déclenche avant l'insertion d'une ligne en table
Le déclencheur On-Update se déclenche au moment de la mise à jour d'une ligne
Le déclencheur Key-Next-Item se déclenche lorsque l'utilisateur se déplace sur l'item suivant avec la touche Tab.

Forms gère deux types de déclencheurs:

• Les déclencheurs natifs
• Les déclencheurs créés par le développeur

Les déclencheurs natifs font partie intégrante d'une application Forms. Ils ont un nom spécifique et répondent à un évènement particulier. Ils sont gérés automatiquement par Forms et peuvent être surchargés par de développeur.

Les déclencheurs explicites sont créés et nommés par le développeur. Ils ne répondent à aucun évènement particulier et doivent être appelés explicitement dans le code du programme. Ce ne sont que des procédures contenant du code exécutable.

Il existe cinq familles de déclencheurs natifs:

• PRE-xxx
• ON-xxx
• WHEN-xxx
• POST-xxx
• KEY-xxx

Les déclencheurs de type PRE-xxx se déclenchent juste avant l'évènement qu'ils désignent. (PRE-DELETE se déclenche juste avant l'ordre de suppression)

Les déclencheurs de type ON-xxx se déclenchent à la place de l'évènement qu'ils désignent. (ON-INSERT se déclenche au moment de l'insertion)

Les déclencheurs de type WHEN-xxx se déclenchent au moment de l'évènement qu'ils désignent. (WHEN-NEW-BLOC-INSTANCE se déclenche lorsque le focus arrive dans un bloc)

Les déclencheurs de type POST-xxx se déclenchent juste après l'évènement qu'ils désignent. (POST-COMMIT se déclenche juste après la validation en base)

Les déclencheurs de type KEY-xxx se déclenchent sur une touche ou combinaison de touches du clavier. (KEY-NXTREC se déclenche sur l'appui de la touche sautant à l'enregistrement suivant)

Les déclencheurs peuvent être situés au niveau du module, d'un bloc ou d'un item.
Si un déclencheur de même type est renseigné à chaque niveau, alors le déclenchement et l'ordre de déclenchement dépendent de sa propriété : Ordre de déclenchement qui peut prendre l'une des trois valeurs suivantes :

• Avant se déclenche avant tout autre déclencheur situé à un niveau supérieur
• Après se déclenche après tout autre déclencheur situé à un niveau supérieur
• Substitué annule et remplace tout autre déclencheur situé à un niveau supérieur

Prenons l'exemple d'un déclencheur WHEN-NEW-ITEM-INSTANCE renseigné au niveau item, bloc et forme (entre parenthèses l'ordre d'exécution)

Dès qu'un déclencheur possède la propriété : Substitué, il annule et remplace tout autre déclencheur de même type situé à un niveau supérieur.
(*)(dans le troisième exemple, si l'item n'a pas de déclencheur W-N-I-I renseigné alors celui de niveau bloc se déclenchera)

Ce système permet une gestion élaborée du comportement de l'application, du niveau le plus fin (item) au plus large (forme).
Il est possible, dès qu'un item reçoit le focus, d'exécuter du code au niveau de cet item, puis d'en exécuter un autre au niveau de chaque item du bloc et d'en exécuter encore un autre au niveau de chaque item de toute la forme.

Les alertes sont des boites de dialogue que vous pouvez appeler de n'importe quel endroit de la forme pour afficher un message et récupérer le code d'un bouton pressé par l'utilisateur.

La palette de propriété d'une alerte permet de configurer le titre, le message (maxi 255 caractères) et d’un à trois boutons (avec leur libellé respectif).

Ce sont des bibliothèques externes de code exécutable liées à un ou plusieurs modules Forms.

Elles permettent de centraliser des fonctions, packages et procédures qui seront utilisés par les applications Forms.

Elles offrent l'avantage de n'être chargées en mémoire qu'une fois et d'y résider pendant toute la durée d'exécution de l'application.

C'est l'endroit idéal pour stocker les fonctions communes à plus d'un module.

Ce sont des fichiers indépendants ayant l'extension .PLL pour la version source et .PLX pour la version compilée et exécutable.

Ils sont gérés sous la forme de modules indépendants (.MMB) et peuvent être associés à un ou plusieurs modules Forms.

Ils contiennent les options nécessaires à l'exécution de l'application.
Ils peuvent attacher une ou plusieurs librairies PL/SQL et contenir des unités de programme (procédures, fonctions, packages).

Ils permettent de filtrer les autorisations d'accès aux modules Forms via les rôles implémentés en base.

Ce sont des conteneurs d'objets de données.
Ils sont indépendants de tous canevas et de toutes fenêtres. (le canevas d'affichage étant stipulé au niveau item, les items d'un même bloc peuvent être affichés sur des canevas différents).
Ils contiennent des éléments (items), des déclencheurs (triggers) et des relations.
Ils permettent d'organiser plusieurs éléments dans une structure commune.
Ils sont le plus fréquemment basés.(table, vue, clause From, procédure stockée).
Ce sont eux qui ont la charge de gérer les ordres du DML (SELECT, INSERT, UPDATE, DELETE).
Il est possible de créer des blocs non basés (dit blocs de contrôle).
Dans ce cas, ces blocs ne peuvent contenir aucun item basé et ne mettent en œuvre aucun mécanisme automatique depuis ou vers la base de données.
Ils sont utilisés pour la gestion interne de la forme, mais n'ont aucune interaction directe avec la BDD.

Un bloc basé est généralement lié à une table ou une vue simple (monotable).
Il peut contenir des items correspondant à toutes ou certaines colonnes de la table/vue liée.
Forms gèrera automatiquement les interactions avec la base (SELECT, INSERT, UPDATE, DELETE, LOCK).
Un bloc basé peut contenir des items non basés.

Un bloc peut également être lié à la base avec les éléments suivants :

• Une sous-interrogation (SUB-QUERY). Dans ce cas le bloc est en SELECT seulement et ne gère donc pas automatiquement les opérations du DML. (il faudra les implémenter manuellement)
• Une procédure stockée (chaque opération du DML doit être attachée à une procédure stockée en base)
• Un trigger transactionnel (pour les bases autres qu' Oracle)

Les blocs peuvent être indépendants ou liés par une relation afin de gérer les mécanismes de relation maître/détail entre plusieurs tables.

Ce sont des conteneurs d'objets graphiques.
Ils correspondent à une surface d'affichage.
Ils permettent d'afficher les objets graphiques (surfaces, traits, cercles, encadrements, etc.) ainsi que les items contenus dans les blocs.
Il n'y a pas de limite théorique au nombre de canevas que peut contenir une forme.
Chaque canevas est attaché à une et une seule fenêtre.
Ils peuvent être de cinq types:

• Intégral
• Superposé
• Onglets
• Barre d'outils horizontale
• Barre d'outils verticale

Le canevas intégral est le conteneur de base. Il peut y en avoir plusieurs par fenêtre, mais un seul peut être affiché à la fois.
Le canevas superposé peut, comme son nom l'indique se superposer à un canevas intégral (il peut y en avoir plusieurs par fenêtre). Il permet de n'afficher qu'une partie de façon fenêtrée et de déplacer le contenu dans cette fenêtre à l'aide de barres de défilement.
Le canevas à onglets se superpose également à un canevas intégral et permet de gérer des pages d'onglets (il peut y en avoir plusieurs par fenêtre)
Les canevas de type barre d'outils permettent de réaliser des barres d'outils flottantes ou non. (un seul canevas horizontal et un seul canevas vertical par fenêtre).
La taille physique d'un canevas n'a pas de limite et peut excéder celle de la fenêtre qui l'englobe. Dans ce cas, il est possible d'afficher des barres de déplacement horizontales et verticales pour gérer le défilement.

Ce sont des boites de dialogue modales permettant d'éditer le contenu d'un item de type texte.
Il est possible de gérer le titre de la boite, ses dimensions et ses attributs graphiques.
Ils sont utiles lorsque l'item contient un texte imposant tout en n'affichant que les premières lignes.

Lorsque le focus se trouve sur un item de type texte, on peut appeler la fenêtre de l'éditeur avec la combinaison de touche Ctrl+E

Ce sont des boites de dialogue modales qui permettent d'afficher des listes d'enregistrements pour la sélection ou le contrôle du contenu d'un item.
Elles sont alimentées par un groupe d'enregistrements.
Elles représentent une aide à la saisie et peuvent être considérées comme des vues filtrées.

Par exemple, vous devez saisir dans un écran le numéro de la dernière commande passée par votre client. Le système de numérotation des commandes est tellement compliqué qu'il est impossible de se le rappeler. Une liste de valeur peut alors être invoquée pour afficher la liste des commandes passées par ce client (numéro, date, libellé, etc.) pour vous permettre de la sélectionner sans équivoque.
Une LOV peut également servir à valider une saisie. Si la valeur entrée dans l'item ne correspond pas à celles de la LOV, celle-ci est alors affichée pour sélectionner une valeur valide.
Une LOV permet également d'alimenter, après sélection, d'autres items de votre forme. Cette alimentation n'est pas automatique en mode interrogation.

Ce sont des conteneurs d'objets.
Ils permettent de rassembler des objets de tous types (blocs, déclencheurs, attributs visuels, etc.) dans un groupe qui peut être ensuite inséré dans une forme.
Les groupes d'objets participent à la notion d'héritage et permettent d'une part la centralisation des objets communs à plusieurs formes et d'autre part le respect des normes graphiques et de développement.
On peut les assimiler à des objets complexes constitués d'attributs et de méthodes.

Ce sont des variables permettant de recevoir des valeurs transmises par les modules appelants.

Ils peuvent être l'un des trois types suivants:

• CHAR
• NUMBER
• DATE

Ce sont des menus contextuels pouvant être attachés soit à un canevas soit à un ou plusieurs items.

Ils sont affichés avec un clic droit de la souris sur le canevas ou l'item auquel ils sont rattachés.

Ce sont des conteneurs de code.
Ils contiennent les packages, procédures et fonctions écrites par le développeur.
Leur mise en œuvre est identique à celle utilisée pour les procédures et fonctions stockées ou déclarées dans un bloc PL/SQL anonyme.
Elles ne nécessitent pas les mot-clés : CREATE OR REPLACE.
Elles peuvent contenir des appels à toutes les fonctions natives Forms.
Elles ne sont visibles que dans le module Forms.

Ce sont des conteneurs de propriétés et de déclencheurs.
Elles permettent de définir des ensembles de propriétés communes qui seront ensuite appliqués aux items.

Elles participent à la mise en place et au respect de la charte graphique.

Ce sont des conteneurs de données.
Ils sont statiques ou alimentés par une requête SQL et permettent de constituer des tableaux d'enregistrements.
Ils sont utilisés pour alimenter les LOV et les items de type liste.

Ils permettent d'exécuter un état (report) développé avec l'application Oracle Reports.

Ce sont des conteneurs d'attributs graphiques.
Ils permettent de constituer des ensembles de propriétés graphiques qui seront ensuite appliqués aux items.

Ce sont des conteneurs de canevas et de menus.
Elles peuvent être de type document ou boite de dialogue et peuvent être modales ou non. (Une fenêtre modale permet la navigation entre plusieurs fenêtres. Une fenêtre non modale ne permet pas la navigation entre plusieurs fenêtres.)
Il n'y a pas de limite théorique au nombre de fenêtres d'une application Forms.
Une fenêtre peut contenir un ou plusieurs canevas.
Elle peut également être attachée à un menu.

Une alerte est une boite de dialogue munie d'un titre et affichant un message. Elle dispose d’un à trois boutons configurables afin de récupérer un choix utilisateur.

Elle est utilisée pour présenter un message (d'erreur ou d'avertissement) auquel l'utilisateur doit répondre, car une alerte est modale.

Ce type de boite de dialogue est utilisé pour transmettre une information à l'utilisateur. Comme il s'agit d'une fenêtre modale, l'utilisateur doit cliquer sur l'un des boutons pour fermer cette fenêtre. Il ne peut naviguer sur aucune autre fenêtre.

L'affichage d'une boite d' alerte est réalisé pendant l'exécution en utilisant la fonction native :

Integer := Show_Alert( nom_alerte | id_alerte )

Selon sa configuration, une alerte peut afficher d’un à trois boutons et l'une des trois icônes suivantes :

• Stop
• Avertissement
• Remarque

Le titre de l'alerte, le message (maxi 255 caractères) ainsi que le nombre et le libellé de chaque bouton de réponse sont configurables.

La fonction retourne le numéro du bouton cliqué par l'utilisateur.
Ce numéro prend l'une des trois constantes numériques suivantes:

• ALERT_BUTTON1
• ALERT_BUTTON2
• ALERT_BUTTON3

Il n'y a pas de limite au nombre d'alertes pouvant être créées dans un module.

Création d'une alerte

Cliquer sur le nœud : Alertes dans le navigateur d'objets puis sur l'icône
Une nouvelle boite d'alerte est créée avec un nom attribué par le système.

Faire un double-clic sur le nœud de la nouvelle alerte pour afficher la palette de propriétés.

Dans cet exemple, nous avons besoin d'une alerte munie de deux boutons : Oui et Non, avec Oui par défaut

Renommons l'alerte en : AL_OUI_NON et ajoutons les propriétés nécessaires

La propriété : Type d'alerte permet de choisir le type d'icône qui apparaîtra dans la boite.

Fixons le libellé des deux premiers boutons et indiquons que le bouton par défaut sera le premier (Oui).


Dupliquer une Alerte

Pour dupliquer une alerte existante, cliquez l'alerte que vous voulez dupliquer et tapez Ctrl-D au clavier. (ou menu : Edition->Dupliquer)


Modifier les propriétés d'une alerte à l'exécution

Vous pouvez modifier les propriétés suivantes en cours d'exécution:

Titre

Set_Alert_Property( nom_alerte | id_alerte, TITLE, nouveau_titre ) ;

Texte

Set_Alert_Property( nom_alerte | id_alerte, ALERT_MESSAGE_TEXT, nouveau_texte ) ;

Libellé d'un bouton

Set_Alert_Button_Property( nom_alerte | id_alerte, numéro_bouton, LABEL, nouveau_libellé ) ;

numéro_bouton vaut au choix:

• ALERT_BUTTON1
• ALERT_BUTTON2
• ALERT_BUTTON3

L'identifiant interne d'une alerte peut être récupéré avec la fonction :

ALERT := Find_Alert( nom_alerte ) ;

Cela permet de vérifier que le nom d'une alerte existe bien dans la forme.

Declare
  Al_id      ALERT ;
  LI$Bouton  pls_integer ;
Begin
  Al_id := Find_Alert( 'mon_alerte' ) ;
  If Id_Null( Al_id ) Then
     Message('la boite d''alerte mon_alerte n''existe pas dans la forme');
     Raise Form_Trigger_Failure ;
  Else
     LI$Bouton := Show_Alert( 'mon_alerte' ) ;
     If LI$Bouton := ALERT_BUTTON1 Then
        ...
     Elseif LI$Bouton := ALERT_BUTTON2 Then
        ...
     Else
        ...
     End if ;
  End if ;
End ;

Couplée à une table de messages, la boite d'alerte devient un système d'affichage particulièrement souple et puissant.

Puisque tous les libellés de la boite d'alerte sont modifiables à l'exécution, il est facile (et conseillé) de ne coder aucun message applicatif « en dur » dans les modules, mais de les lire dans une table de messages.

Cela apporte les avantages suivants:

• Inutile d'ouvrir le module pour modifier un message (pas assez explicite pour l'utilisateur, faute d'orthographe, etc.).
• Externalisation des messages applicatifs (les messages sont saisis/modifiés en table à l'aide d'un écran Forms ou d'un insert/update direct en table).
• Utilisation de messages paramétrés (les valeurs exactes sont transmises à la fonction d'affichage) permettant de réduire le nombre de messages de base.
• Facilité de traduction (votre système de messagerie peut tenir compte de la langue de l'utilisateur et d'afficher les libellés dans la bonne traduction).

Cette fonctionnalité est mise en œuvre à travers l'écran de démonstration TEST_ALERTES_MESSAGES.FMB.

Celui-ci permet de tenir à jour la table des messages et de vérifier le fonctionnement des alertes qui leur sont associées

L'écran est basé sur la table MESSAGES créée dans le script d'installation tuto_forms_install.sql

Comme il est visible dans le champ : Texte, chaque message accepte de 0 à 3 paramètres (%1, %2 et %3) qui seront remplacés à l'affichage par les textes que vous fournirez aux fonctions Affiche_Message() et Question().

Le champ : Alerte permet de spécifier dans quelle boite d'alerte sera affiché le message (les alertes AL_ERREUR, AL_MSG_OUI_NON, AL_MSG_NON_OUI sont disponibles dans la bibliothèque d'objets OBJ_TUTO_FORMS.OLB).

Le champ : Stop indique si le message sera bloquant, c'est-à-dire qu'il sera suivi d'une instruction : Raise Form_Trigger_Failure

Le caractère « pipe » (Alt+124) dans le champ : Texte permet de placer des retours ligne à l'intérieur du message. (testez le message n° : 40)

Le bloc en bas d'écran permet de tester chaque message en indiquant le numéro ainsi que les paramètres de remplacement.

Chaque message est affiché via la procédure : Affiche_Message() stockée dans la librairie PL/SQL : TUTO_FORMS.PLL

PROCEDURE Affiche_message
    (
        PN$Code in Number,
        PC$Rep1 In Varchar2 Default Null,
        PC$Rep2 In Varchar2 Default Null,
        PC$Rep3 In Varchar2 Default Null,
        PB$Arret In Boolean Default NULL
    ) IS

  -- Procedure Affiche_message
  --
  -- Affichage d'un message stocké en table
  --
  -- Entree     : PN$Code    Code du message 
  --            : PC$Rep1    Paramètre optionnel de remplacement
  --            : PC$Rep2    Paramètre optionnel de remplacement
  --            : PC$Rep3    Paramètre optionnel de remplacement
  --            : PB$Arret   Flag booleen d'arrêt de surcharge
  --            :            du flag stocké dans le message
  --            :            s'il est renseigné, il annule et remplace
  --            :            la valeur de MESSAGE.STOP
  -- Sortie        :
  -- Ent/Sortie    :
  --
   LR$MESSAGE   MESSAGES%ROWTYPE ;
   LC$Text      Varchar2(300);
   LN$But       Number ;
   Al_id        Alert ;
BEGIN

   Select
      *
   Into
      LR$Message
   From
      MESSAGES
   Where
      CODE = PN$Code
   ;

   LC$Text := LR$Message.TEXTE ;

   -- Retour ligne ? --
   LC$Text := Replace( LC$Text, '|', CHR(10) ) ;

   -- Remplacements --
   If PC$Rep1 is not null Then
      LC$Text := Replace( LC$Text, '%1', PC$Rep1 ) ;
   End if ;
   If PC$Rep2 is not null Then
      LC$Text := Replace( LC$Text, '%2', PC$Rep2 ) ;
   End if ;
   If PC$Rep3 is not null Then
      LC$Text := Replace( LC$Text, '%3', PC$Rep3 ) ;
   End if ;

   Al_id := Find_Alert(LR$Message.ALERTE); 
   IF Not Id_Null(al_id) THEN 

      -- Titre alerte --
      If LR$Message.TITRE is not null Then
         Set_Alert_Property(LR$Message.ALERTE, TITLE, LR$Message.TITRE ) ;
      End if ;
      -- Message --
      Set_Alert_Property(LR$Message.ALERTE, ALERT_MESSAGE_TEXT, LC$Text ) ;

      LN$But := Show_Alert(LR$Message.ALERTE);

   Else
      Message('Alerte ' || LR$Message.ALERTE || ' non présente dans la forme');
      Message(LC$TExt);
   End if ;

   -- Raise --
   If PB$Arret is not null Then
      If PB$Arret = TRUE Then
         Raise form_trigger_failure ;
      End if ;
   Elsif LR$Message.STOP = 'O' Then
      Raise form_trigger_failure ;
   End if ;

Exception
   When no_data_found Then
      Al_id := Find_Alert('AL_ERREUR'); 
      IF Not Id_Null(al_id) THEN 
         Set_Alert_Property('AL_ERREUR', TITLE, 'Messages applicatifs' );
         Set_Alert_Property('AL_ERREUR', ALERT_MESSAGE_TEXT, 'Message : ' 
          || To_char(PN$Code) || ' non trouvé');
         LN$But := Show_Alert('AL_ERREUR' ) ;
      Else
         Message('Alerte AL_ERREUR non présente dans la forme');
         Message('Message : ' || To_char(PN$Code) || ' non trouvé');
      End if ;
      Raise Form_trigger_failure ;

   When Form_trigger_failure Then
      Raise ;
   When others Then
      Null ;
END;

Les boites d'alerte sont également utilisées, dans la librairie TUTO_FORMS.PLL par la fonction Question() qui retourne le numéro du bouton pressé par l'utilisateur.


Conseils pratiques

Dans la plupart des cas, vous n'aurez besoin que de trois boites d'alerte.

- Une alerte générique sans choix utilisateur et qui ne nécessite qu'un seul bouton (OK).

- Une alerte interactive avec choix utilisateur de type Oui/Non (Oui par défaut).

- Une alerte interactive avec choix utilisateur de type Oui/Non (Non par défaut).

Ces trois types d'alertes sont accessibles depuis la bibliothèque d'objets : OBJ_TUTO_FORMS.OLB

Créez les alertes nécessaires à toute votre application, glissez-les dans votre forme de référence ou dans votre librairie d'objets et faites-en hériter chacun de vos modules.

Il deviendra alors facile de stocker en librairie PL/SQL (.PLL) une ou deux procédures d'affichage de vos alertes pour une gestion centralisée de toute la messagerie de votre application.

Une librairie PL/SQL est un module indépendant regroupant des fonctions, procédures et packages PL/SQL.

Il s'agit donc de code et uniquement de code.
Une librairie PL/SQL ne contient aucun objet Forms.

Ces fonctions peuvent être appelées depuis un module Forms, un menu ou un état.
Une librairie n'est chargée qu'une fois en mémoire.

Une librairie PL/SQL regroupe les fonctions communes à plusieurs modules.
Ces fonctions sont stockées dans un module indépendant.
Le fichier source éditable (et portable) reçoit l'extension .PLL
Le fichier exécutable (non portable) reçoit l'extension .PLX

Une librairie PL/SQL doit être attachée à la forme, au menu ou à l'état.

Elle peut elle-même être attachée à une autre librairie PL/SQL

Éditer une librairie

Pour modifier le contenu d'une librairie PL/SQL, ouvrez-la dans Forms Builder
Fichier -> Ouvrir (type : Bibliothèques PL/SQL (*.pll))

le nœud Unités de programmes contient les fonctions, procédures et package stockées dans la librairie

Sous chaque fonction (pour simplifier, fonctions, procédures et packages seront appelées « fonctions » dans la suite du texte) sont représentées trois sections

• Spécification affiche la déclaration de la fonction avec les noms et types des paramètres
• Références affiche la liste des objets utilisés par la fonction
• Référencée par affiche la liste des objets qui utilisent cette fonction

Rappel:
À l'intérieur d'un package, une fonction ou procédure peut être surchargée. Dans ce cas, la section Spécification affiche toutes les syntaxes de la fonction.

le nœud Bibliothèques attachées contient les éventuelles autres librairies attachées


Créer une librairie

Pour créer un nouveau module librairie PL/SQL cliquer le nœud Bibliothèques PL/SQL puis
ou via le menu Fichier -> Nouveau -> Bibliothèque PL/SQL


Éditer une fonction

Pour charger le code d'une fonction dans l'éditeur PL/SQL, faire un double-clic sur l'icône en regard du nom de la fonction ou clic droit et Editeur PL/SQL


Ajouter une fonction

Cliquez le nœud Unités de programme puis


Supprimer une fonction

Sélectionnez la fonction puis


Attacher la librairie à une forme, un menu ou un état

Ouvrez le module correspondant
Cliquez le nœud Bibliothèques attachées puis

Cliquer le bouton Parcourir… afin d'afficher la boite de sélection des fichiers
Sélectionner une librairie
Cliquer le bouton Attacher

À la question : « la bibliothèque contient une information de répertoire non portable : supprimer le chemin ? » répondez toujours Oui

Lors de la livraison de vos modules exécutables (*.fmx, *.mmx, *.plx) sur l'environnement d'exécution, il y a peu de chance que l'arborescence cible contienne exactement les mêmes répertoires et Forms Runtime risque de ne pas trouver le fichier de la librairie. Si vous retirez la notion de chemin physique, alors Forms Runtime recherchera la librairie dans les répertoires indiqués dans la variable d'environnement FORMS90_PATH.


Générer un fichier exécutable

Pour compiler la librairie et générer le fichier exécutable (.PLX) utilisez l'option de menu Programme -> Compiler module ou le raccourci clavier Ctrl+T


Cas des fonctions dupliquées

Il est possible de donner un nom à une fonction stockée en librairie qui porte le même nom qu'une fonction stockée dans une unité de programme d'un module.

Dans ce cas, Forms exécutera la fonction de l'unité de programme.
Si vous gérez seul votre application, ce cas de figure a peu de chance d'être rencontré.
Si, par contre, vous intervenez sur un grand projet au sein d'une équipe de développeurs il est préférable de préfixer le nom des fonctions stockées en librairie.
Par exemple si votre librairie gère un système de messagerie et porte le nom : MSG.PLL, préfixez le nom de vos procédures avec MSG_

La procédure Get_Message sera donc nommée : MSG_Get_Message


Référence à un objet contenu dans la forme, le menu ou l'état

Dans une fonction stockée en librairie, il n'est pas possible de référencer directement un objet contenu dans une forme, un menu ou un état.

Pour lire la valeur d'un objet, vous devez utiliser la procédure Name_In()
Pour écrire la valeur d'un objet, vous devez utiliser la procédure Copy()

Exemples:

-- Procédure MSG_Get_Message() stockée en librairie MSG.PLL --
PROCEDURE MSG_Get_Message ( PN$Num_Message IN NUMBER ) 
Is
   LC$Item  Varchar2(61) := Name_In( 'SYSTEM.TRIGGER_ITEM' ) ;
   LC$Valeur  Varchar2(100) ;
Begin
   -- lecture valeur de l'item en cours -
   LC$Valeur := Name_In( LC$Item ) ;

   -- lecture du paramètre de la forme --
   LC$Valeur := Name_In( 'PARAMETER.NOM_SOCIETE' ) ;

   -- lecture d'une variable globale --
   LC$Valeur := Name_In( 'GLOBAL.NOM_VARIABLE' ) ;

   -- écriture d'une valeur dans la variable globale --
   Copy( 'Oracle', 'GLOBAL.NOM_VARIABLE' ) ;
End ;

Notez qu'avec les fonctions Copy() et Name_In() les noms des conteneurs ne sont pas précédés du caractère : (deux points)


Visibilité des variables stockées en librairie PL/SQL

Cette visibilité dépend de la nature du chargement d'une forme.

Si une forme est chargée en mémoire avec l'instruction Call_Form( …, SHARE_LIBRARY_DATA…) alors la valeur des variables stockées en librairie sera visible par toutes les formes partageant la même session.

Si la forme est chargée en mémoire avec l'instruction Call_Form( …, NO_SHARE_LIBRARY_DATA…) alors la valeur des variables stockées en librairie ne sera visible que par la forme en cours.

Remarque:
Si ce paramètre n'est pas spécifié, il vaut par défaut NO_SHARE_LIBRARY_DATA

Le paramètre SHARE_LIBRARY_DATA permet de partager des variables complexes entre plusieurs formes (records, tableaux, etc.) que les paramètres ou variables globales ne permettent pas.

Un menu est un composant indépendant permettant d'afficher une barre de menus.

Un menu permet d'exécuter certaines actions via les options de la barre.

Cette action peut être le chargement d'une autre forme en mémoire (Call_Form()), l'insertion d'un nouvel enregistrement (Do_Key('Create_record')), le lancement d'un état (Web.Show_Document()), le lancement d'un programme externe (Host()), l'appel d'une procédure stockée, etc.

Un module menu peut contenir les composants suivants:

• Bibliothèques PL/SQL
• Groupes d'objets
• Unités de programme
• Classes de propriétés
• Attributs visuels

Même s'il s'agit d'un module indépendant il ne peut pas être affiché tel quel, mais doit être associé à une forme, via la propriété:
Fonctionnel -> Module menu d'un formulaire.

Les modules menu sont gérés dans l'interface de Forms Builder.

Les fichiers sources ont l'extension .MMB
Les fichiers exécutables otn l'extension .MMX

La version exécutable (*.MMX) d'un menu doit être copiée dans l'un des répertoires mappés dans la variable d'environnement FORMS90_PATH du fichier de configuration <ORACLE_HOME>\forms90\server\default.env

Forms dispose d'un menu standard : DEFAULT
Ce menu est totalement intégré à Forms et ne peut donc être modifié.
Pour utiliser ce menu standard, il suffit d'indiquer son nom dans la propriété Fonctionnel -> Module Menu du module formulaire.

Si vous souhaitez modifier ce menu, Forms met à disposition deux modules menu situés dans le répertoire /demos/dfltmenu

• menudef.mmb menu standard sans barre d'icônes
• menudefs.mmb menu standard avec barre d'icônes

Ces deux menus « francisés » sont livrés avec les fichiers d'exemple


l'éditeur graphique

Bien qu'il soit possible de gérer un module menu depuis la fenêtre du navigateur d'objets, il est plus facile de le gérer depuis l'éditeur de menu.

Pour afficher le menu dans l'éditeur de menu, double-cliquez sur le nœud principal du menu

La sélection des entrées/options, l'ajout et/ou la suppression d'objets est accessible depuis la barre d'outils horizontale

La barre d'outils horizontale

Créer un menu

Pour créer un nouveau module menu depuis Forms Builder, actionner le menu Fichier -> Nouveau -> Menu

Les propriétés du module:

Fonctionnel
Nom désigne le nom interne du menu
Menu principal indique à partir de quelle entrée le menu sera affiché
Nom de fichier menu indique le nom physique du fichier menu
Code de démarrage permet d'implémenter du code PL/SQL qui sera exécuté dès le chargement du menu
Partager bibliothèque indique si les données stockées en librairie seront visibles depuis le menu

Sécurité menu
Sécurité indique si la sécurité par rôles est activée ou non
Rôles module permet d'indiquer la liste des rôles qui seront habilités à afficher le menu


Ajouter une entrée de menu

Une entrée de menu correspond au niveau hiérarchique le plus élevé (Fichier, Edition, Affichage…)

Depuis le navigateur

Cliquer le nœud Menus puis l'icône

Depuis l'éditeur graphique

Cliquer l'icône

Les propriétés d'une entrée de menu

Menu détachable indique si l'utilisateur pourra déplacer l'entrée de menu sur l'écran


Ajouter une option de menu

Une option de menu est attachée à une entrée particulière.
Seule l'option de menu peut exécuter une action

Depuis le navigateur

Cliquer le nœud Menus -> Eléments de l'entrée correspondante puis l'icône

Depuis l'éditeur graphique

Sélectionner l'entrée
Cliquer l'icône

Remarque:
Une option peut être également un autre sous-menu

Les propriétés d'une option de menu

Fonctionnel
Activé indique si l'option sera active à l'exécution
Cette propriété peut être modifiée à l'exécution avec l'instruction:
Set_Menu_Item_Property( …, ENABLED, PROPERTY_TRUE | PROPERTY_FALSE)
Libellé indique le libellé affiché de l'option
Cette propriété peut être modifiée à l'exécution avec l'instruction:
Set_Menu_Item_Property( …, LABEL, 'nouveau libellé' )
Type d'option de menu peut prendre l'une des valeurs suivantes

• Simple
• Case à cocher
• Bouton option
• Séparateur
• Magique

Elément de menu magique désigne le type d'élément magique
Groupe de boutons associés indique le groupe de boutons option
Type de commande peut être

• Null
• Menu
• PL/SQL

Code d'élément menu contient le code PL/SQL associé à l'option
Raccourci clavier permet d'associer une fonction à l'item. Le code de cette fonction doit être saisie dans un déclencheur de type ACCELERATOR1 à ACCELERATOR5
Visible dans le menu indique si l'option est visible à l'exécution
Cette propriété peut être modifiée à l'exécution avec l'instruction:
Set_Menu_Item_Property( …, VISIBLE, PROPERTY_TRUE | PROPERTY_FALSE)
Visible dans la barre d'outils horizontale indique si l'option (l'icône) sera visible dans la barre d'outils horizontale
Visible dans la barre d'outils verticale indique si l'option (l'icône) sera visible dans la barre d'outils verticale
Icône dans menu indique si une icône sera affichée dans l'option de menu
Nom de fichier icône désigne le nom (sans extension) du fichier icône associé à l'option
Cette propriété peut être modifiée à l'exécution avec l'instruction:
Set_Menu_Item_Property( …, ICON_NAME, 'nom_fichier_icone' )

Sécurité menu
Rôles élément permet de sélectionner les rôles qui auront accès à l'option
Afficher sans droit d'accès indique si l'option sera affichée si l'utilisateur n'a pas le rôle adéquat. Si Non, l'option n'est pas affichée. Si Oui, elle est affichée, mais grisée (désactivée)

Physique
Visible indique si l'option sera affichée à l'exécution


Les différents types d'item menu

• Simple c'est le cas des options standard
• Case à cocher
• Bouton option
• Séparateur insère une ligne de séparation entre les options
• Magique désigne une option de type magique

Les types de commande

• Null (obligatoire si l'option de menu est un séparateur)
• Menu (obligatoire si l'option est un sous-menu)
• PL/SQL (par défaut, indique que l'action est du code PL/SQL)
• Plus*
• Form*
• Macro*

* Ces options sont encore présentes par souci de compatibilité avec les anciennes versions. Elles ne devraient plus être utilisées

Les items menu magique

• About (l'action doit être implémentée par le développeur)
• Copy copie le contenu dans le presse-papier
• Clear
• Cut supprime le contenu et le place dans le presse-papier
• Paste colle le contenu du presse-papier
• Help (l'action doit être implémentée par le développeur)
• Quit Affiche une demande d'enregistrement lorsque l'utilisateur quitte la forme
• Undo (l'action doit être implémentée par le développeur)
• Window affiche la liste des fenêtres ouvertes de l'application

Touche d'accélération d'une option

Chaque option de menu peut être dotée d'une touche d'accélération.
Il s'agit d'une lettre qui, tapée avec la touche Alt, provoquera la sélection du menu.
Par défaut, Forms prend la première lettre en majuscule du libellé de l'option.
Par exemple, si le libellé de votre option de menu est Enregistrer, la touche d'accélération par défaut sera le E majuscule. C'est cette lettre qui apparaîtra soulignée à l'exécution et qui déclenchera l'action avec la touche Alt+E

Vous pouvez spécifier une autre lettre en la faisant précéder du caractère : &

Par exemple, si vous souhaitez que la touche d'accélération soit : r, entrez En&registrement dans votre libellé.

Remarque:
Pour insérer le caractère & dans votre libellé de menu, il faut le doubler (Enregistrer && quitter)


Sécurité dans les menus

Il est possible d'activer/désactiver automatiquement un menu, une entrée de menu ou une option en utilisant les rôles créés dans la base.

La barre de menu étant généralement le principal point d'accès aux formes, il est aisé de personnaliser (autoriser/interdire) l'accès aux options de menu en leur affectant une liste de rôles autorisés.

Affecter une liste de rôles au niveau module

La propriété Sécurité menu -> Rôles module du niveau module permet d'afficher la liste des rôles créés en base.
Il est possible de créer de nouveaux rôles simplement en ajoutant leur nom dans la liste (Forms gère automatiquement la création du rôle en base)
Il est également possible de supprimer un rôle de la liste (et donc l'accès au menu pour les utilisateurs) en effaçant son nom dans la liste.

Ensuite, pour chaque entrée de menu et/ou pour chaque option, il est possible de désigner les rôles qui seront autorisés à activer l'option

Par exemple, sur l'option de menu Enregistrer de l'entrée Action, nous n'autorisons que les utilisateurs ayant le rôle CLERKS et/ou MANAGER a activer cette option.

Affichons la fenêtre de propriétés de l'item ACTION.SAVE et cliquons sur le bouton Suite… de la propriété Rôle élément

À l'exécution, si l'utilisateur connecté n'a ni le rôle CLERCKS ni le rôle MANAGERS, le menu sera affiché de deux façons différentes selon la valeur indiquée dans la propriété Sécurité menu -> Afficher sans droit d'accès :

• Si la propriété est valorisée à Oui, l'option sera affichée grisée et non active
  
• Si la propriété est valorisée à Non, l'option ne sera pas affichée

Remarque :
L'application des rôles définis au niveau des options de menu ne sera prise en compte que si la propriété Sécurité menu -> Sécurité est valorisée à OUI

Rappel sur la création des rôles en base

Pour créer et affecter un rôle à un utilisateur, effectuez les actions suivantes:

Créer un rôle

CREATE ROLE nom_role ;

Affecter le rôle à un utilisateur

GRANT nom_role TO nom_utilisateur ;

Assigner le rôle par défaut à la connexion de l'utilisateur

ALTER USER nom_utilisateur DEFAULT ROLE liste_des_roles ;

Pour plus de précisions sur la gestion des rôles et des privilèges, consultez l'article: Administration : Rôles et privilèges


Utilisation du PL/SQL

Le code PL/SQL peut être inséré dans un menu dans les objets suivants :

• Code de démarrage (startup code)
• Propriété Code d'élément menu d'une option
• Unité de programme du module menu

Tout code PL/SQL et appel des fonctions natives sont permis dans un menu.
Si le code PL/SQL manipule des objets situés dans une forme, il ne peut pas les atteindre directement, mais seulement pas indirection avec les fonctions:
COPY()
NAME_IN()

-- Code invalide dans un menu --
:block.item := 12 ;

-- Code valide --
Copy( 12, 'block.item' ) ;

Vous pouvez attacher les librairies PL/SQL à un menu et donc bénéficier de toutes les procédures et fonctions présentes dans ces librairies


Compiler un module menu

Menu Programme -> Compiler module
Ou Ctrl+t

Cette opération compile l'intégralité du code PL/SQL et génère un fichier portant l'extension .MMX

Attention:
Si vous livrez une forme à laquelle un menu est attaché, veillez à livrer le module exécutable du menu (*.MMX)


Les fonctions natives relatives aux menus

Modifier une propriété d'une option de menu

Set_Menu_Item_Property( id_menu | nom_menu, propriété, valeur ) ;

propriété peut être :

• CHECKED
• ENABLED
• ICON_NAME
• LABEL
• VISIBLE

L'identifiant interne d'une option de menu (id_menu) peut être retrouvé avec la fonction Find_Menu_Item()

Declare
  mi_id MenuItem; 
  valeur VARCHAR2(10); 
Begin
  mi_id := Find_Menu_Item('MENU.CHKBOX'); 
  valeur := Get_Menu_Item_Property(mi_id,CHECKED); 
  If valeur = 'TRUE' Then
    Set_Menu_Item_Property(mi_id,CHECKED,PROPERTY_FALSE); 
  Else 
    Set_Menu_Item_Property(mi_id,CHECKED,PROPERTY_TRUE); 
  End if ; 
End ;

Interroger une propriété d'une option de menu

Get_Menu_Item_Property( id_menu | nom_menu, propriété, valeur ) ;
Propriété prend les mêmes valeurs que pour l'instruction Set_Menu_Item_Property()


Remplacer le menu en cours
Replace_Menu ;
Replace_Menu( 'nom_menu_module', type_menu ) ;
Replace_Menu( 'nom_menu_module', type_menu, nom_menu_depart ) ;
Replace_Menu( 'nom_menu_module', type_menu, nom_menu_depart, nom_groupe ) ;
Replace_Menu( 'nom_menu_module', type_menu, nom_menu_depart, nom_groupe, use_file ) ;

Replace_Menu() est une procédure non restreinte. Elle remplace le menu de toutes les fenêtres de l'application.
Si une forme est appelée avec Call_Form(), le menu est remplacé pour les deux formes.

nom_menu_module désigne le nom du module menu. S'il n'est pas indiqué, Forms supprime le menu en cours
type_menu peut valoir PULL_DOWN
nom_menu_depart désigne le point de départ (entrée de menu) dans le menu désigné
nom_groupe permet de spécifier un rôle attaché au menu
use_file ne peut prendre qu'une seule valeur : TRUE

Utilisation de l'instruction Do_Key()

Plutôt que d'assigner une instruction Forms directement dans le code d'une option de menu (Create_Record), provoquez le déclencheur équivalent dans la forme (Do_Key('Create_Record')).

En effet, le premier cas exécutera bien l'instruction native Create_Record qui insérera un nouvel enregistrement dans le bloc en cours. Par contre, le code PL/SQL éventuellement stocké dans le déclencheur Key-Crerec de la forme ne sera pas exécuté. Vous n'aurez donc pas le même résultat que lorsque l'utilisateur utilise le raccourci clavier.

Ne pas afficher le menu Fenêtre

Quel que soit le menu affiché ou même si aucun menu n'est attaché à une forme, Forms affiche toujours, à l'exécution l'entrée de menu : Fenêtre

Si vous ne souhaitez pas afficher cette entrée de menu, vous pouvez appliquer l'une des méthodes suivantes:

Faire un menu vide

Le menu menu_vide.mmb livré avec les exemples est une démonstration de cette fonctionnalité.
Attachez ce menu à votre forme et exécutez-la.
Vous pouvez constater qu'aucune barre de menu ne s'affiche.

Une seule entrée de menu est créée (MAIN_MENU) qui ne contient qu'une seule option (WINDOW)

Affichons les propriétés de cette option:

Libellé doit être laissé vide
Type d'option doit être Magique
Élément de menu doit être Fenêtre
Type de commande doit être Null
Visible dans menu doit être Non


Utilisation des fonctions de la librairie Webutil

Si vous avez installé la librairie Webutil, vous pouvez afficher/masquer simplement la barre d'outils avec les fonctions suivantes

Si vous exécutez votre forme dans la fenêtre du navigateur (separateFrame=False), vous pouvez utiliser la fonction WebUtil_Browser.Show_Menu_Bar() de la librairie

Si vous exécutez votre forme dans une fenêtre indépendante du navigateur (separateFrame=True), vous pouvez utiliser la fonction WebUtil_SeparateFrame.Show_Menu_Bar() de la librairie

IX-A-1. Définition▲

IX-A-2. Concept▲

IX-A-3. Mise en œuvre▲

Ajout d'un bloc

Pour ajouter un bloc à la forme, double-cliquer sur le nœud Blocs de données ou faire un simple clic sur le nœud Blocs de données puis cliquer sur l'icône

Utilisation des assistants

le bloc sera basé sur une table ou une vue

L'écran suivant permet de sélectionner la table ou la vue grâce au bouton Parcourir…

Choisissez la table EMP, puis cliquez sur le bouton OK

La fenêtre de gauche (colonnes disponibles) affiche les champs disponibles dans la table.

Sélectionner un ou plusieurs champs pour les faire passer dans la fenêtre de droite (Éléments base de données) avec les boutons appropriés

puis cliquer sur le bouton Suivant

Donnez un nom au bloc (30 caractères maxi)

La définition du bloc étant achevée nous passons ensuite à l'étape de présentation

Création de la présentation

Aucun canevas n'étant disponible, laissons l'option (Nouveau canevas)
Puis dans la zone Type, choisissons un canevas de type Intégral

De la même façon que nous avons sélectionné les champs du bloc, nous indiquons également la liste des champs qui seront positionnés sur le canevas

Il s'agit là d'indiquer la liste des items qui apparaîtront sur le canevas.
C'est pourquoi il est conseillé, même si vous n'affichez que certaines colonnes de ramener dans le bloc l'ensemble des colonnes de la table dans l'étape précédente.
Même si vous n'en avez pas l'utilité immédiate, cela pourrait changer dans le temps.

L'écran suivant permet de paramétrer un certain nombre de propriétés de chaque champ, comme l'invite, la largeur et la hauteur. (ces propriétés pourront être modifiées ultérieurement dans la fenêtre de propriétés du bloc et des items)

Ensuite, nous indiquons si nous souhaitons présenter un ou plusieurs enregistrements

Une présentation de type Formulaire affiche un seul enregistrement dans le bloc.
Une présentation de type tabulaire affiche un tableau de plusieurs enregistrements.

Enfin, un titre est donné à l'encadrement, le nombre d'enregistrements affichés, la distance entre chaque enregistrement ainsi que l'ajout d'une barre de défilement verticale pour naviguer dans les enregistrements

Voici le résultat de la création de notre bloc.
Forms a créé un item pour chaque colonne de la table avec le type correspondant.

Affichons la liste des propriétés du bloc en sélectionnant son nom dans le navigateur puis en pressant F4

Description des principales propriétés relatives au bloc de données

Lorsque la propriété est modifiable pendant l'exécution, la fonction native associée est indiquée

Général

Nom indique le nom du bloc. Il accepte jusqu'à 30 caractères selon la norme Forms.
Information de référence et Commentaires sont des zones libres de saisie permettant de documenter le bloc.

Navigation

Type de navigation indique comment se déplace le focus lorsque l'on quitte le premier ou le dernier champ de l'enregistrement.
3 valeurs sont possibles:

• Même enregistrement indique que l'on boucle sur le même enregistrement
• Changement d'enregistrement indique que l'on saute à l'enregistrement suivant en quittant le dernier champ (Tab) ou à l'enregistrement précédent en quittant le premier champ (Shit+Tab)
• Changement de bloc de données indique que l'on saute au bloc suivant lorsque l'on quitte le dernier enregistrement (Tab) ou au bloc précédent lorsque l'on quitte le premier enregistrement (Shit+Tab)

Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, NAVIGATION_STYLE)).

Bloc de données de navigation précédent indique quel bloc précèdera dans la navigation.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…,PREVIOUS_NAVIGATION_BLOCK)).

Bloc de données de navigation suivant indique quel bloc succèdera dans la navigation
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…,NEXT_NAVIGATION_BLOCK)).

Enregistrements

Groupe d'attributs visuel de l'enregistrement permet de désigner le nom d'un attribut visuel qui sera appliqué à l'enregistrement courant (l'enregistrement courant est celui que l'utilisateur est en train de visualiser/modifier).
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, CURRENT_RECORD_ATTRIBUTE)).
Taille de tableau d'interrogation indique le nombre maximum d'enregistrements ramenés de la base à la fois avant affichage
Une valeur de 1 permet un affichage instantané puisque Forms affichera l'enregistrement dès qu'il sera ramené de la base
Une valeur de 10 indique que Forms ramènera 10 enregistrements de la base avant de procéder à l'affichage
La valeur par défaut de 0 indique que Forms ramènera tous les enregistrements avant de les afficher. Dans la plupart des cas, cette valeur par défaut conviendra.
Dans le cas d'interrogation de tables très volumineuses, il faudra cependant positionner cette valeur à 50 ou 100 afin de ne pas imposer à l'utilisateur un temps de recherche trop long avant affichage.
Noter également que plus cette valeur sera petite, plus l'on génèrera de trafic réseau.
Cette propriété ne peut être fixée qu'au moment du design.
Nombre d'enregistrements en tampon permet d'indiquer combien d'enregistrement seront lus et stockés dans le tampon disque. Cela permet de réduire le nombre d'accès à la base et donc également le trafic réseau en stockant les enregistrements dans un buffer disque.
La valeur par défaut 0 indique le minimum permis soit le nombre d'enregistrements affichés + 3.
Cette propriété ne peut être fixée qu'au moment du design.
Nombre d'enregistrements affichés indique combien d'enregistrements seront affichés sur le canevas
Cette propriété ne peut être fixée qu'au moment du design.
Interroger tous les enregistrements indique si, lors de l'interrogation, Forms ramènera la totalité des enregistrements en un seul fetch (si Oui) ou seulement le nombre spécifié dans la propriété Taille de tableau d'interrogation (si Non).
Cette propriété ne peut être fixée qu'au moment du design.
Sens des enregistrements détermine l'orientation des enregistrements dans le bloc (Horizontal ou Vertical).
Cette propriété n'est valide que pour un bloc multienregistrements (Nombre d'enregistrements affichés > 1) et ne peut être fixée qu'au moment du design.
Enregistrement unique indique si le bloc ne contient qu'un seul enregistrement (si Oui) ou plusieurs (si Non). Cette propriété est différente de Nombre d'enregistrements affichés.
Cette propriété doit être valorisée à Oui pour un bloc de contrôle (non basé) dans lequel se trouve un item de totalisation.
Il n'est pas possible de spécifier Oui pour un bloc basé.
Cette propriété ne peut être fixée qu'au moment du design.

Base de données

Bloc de base de données indique si le bloc est basé (Oui) ou s'il s'agit d'un bloc non basé ou dit « bloc de contrôle » (Non)
Cette propriété ne peut être fixée qu'au moment du design.
Imposer clé primaire indique que chaque enregistrement inséré ou mis à jour doit contenir une clé primaire
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, ENFORCE_PRIMARY_KEY)).
Interrogation autorisée indique si l'utilisateur peut exécuter une interrogation sur ce bloc.
Si la propriété est fixée à Oui, au moins un item du bloc doit avoir la propriété équivalente positionnée à Oui.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, QUERY_ALLOWED)).
Type de source de données indique la source des données et peut prendre l'une des cinq valeurs suivantes :

• Aucun (bloc non basé)
• Table (table ou vue)
• Procédure (procédure stockée en base)
• Déclencheurs transactionnels (pour des sources de données non Oracle)
• Interrogation de clause From (ordre SELECT)

Seul, le type de source de données Table (ou vue) autorise les opérations du DML (INSERT, UPDATE et DELETE) avec un traitement automatique natif dans Forms
Le type Procédure nécessite l'écriture d'une procédure stockée spécifique pour le verrouillage, l'insertion la mise à jour et la suppression d'enregistrements.
Le type interrogation de clause FROM n'autorise que le mode SELECT. Il représente une alternative intéressante à la vue puisqu'il ne nécessite aucun droit de création au niveau de la base.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, QUERY_DATA_SOURCE_TYPE)).
Nom de source de données indique le nom de la source de donnée (valide uniquement pour les blocs basés sur table/vue, sur procédure ou Interrogation de clause FROM
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, QUERY_DATA_SOURCE_NAME)).
Colonnes de source de données désigne la liste des colonnes (champs) associées à la datasource
(valide uniquement pour les blocs basés sur table, Procédure ou clause FROM
Cette propriété ne peut être fixée qu'au moment du design.
Arguments de source de données spécifie les nom, type et valeur des colonnes.
Cette propriété ne peut être fixée qu'au moment du design.
Alias désigne l'alias de la table utilisé pour les requêtes sur des tables contenant des colonnes objets ou des références
Cette propriété ne peut être fixée qu'au moment du design.
Inclure l'élément REF permet de stocker pour chaque enregistrement du bloc l'OID d'une ligne objet
Cette propriété ne peut être fixée qu'au moment du design.
Clause Where permet de spécifier une clause WHERE par défaut appliquée lors de l'interrogation du bloc. Le mot-clé : WHERE n'est pas nécessaire dans la clause.
Exemple :
EMPNO > 10 AND DEPTNO <> 40
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, DEFAULT_WHERE)).
Clause Order By permet de spécifier une clause Order by par défaut appliquée lors de l'interrogation du bloc. Le mot-clé : ORDER BY n'est pas nécessaire dans la clause.
Exemple :
DEPTNO ASC, DEPTNO DESC
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, ORDER_BY)).
Message d'aide d'optimisation permet d'indiquer un hint d'optimisation qui sera transmis à l'optimiseur
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, OPTIMIZER_HINT)).
Insertion autorisée spécifie si l'insertion dans la table est autorisée ou non
Si cette propriété est fixée à : NON, l'utilisateur ne pourra pas insérer de nouvel enregistrement dans le bloc.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, INSERT_ALLOWED)).
Mise à jour autorisée spécifie si la mise à jour la table est autorisée ou non
Si cette propriété est fixée à : NON, l'utilisateur ne pourra pas modifier d'enregistrement dans le bloc.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, UPDATE_ALLOWED)).
Mode de verrouillage spécifie à quel moment Forms tente de verrouiller l'enregistrement lors d'une modification dans l'interface.
Automatique ou Immédiat force le verrouillage dès que l'enregistrement est modifié dans la forme
Différé n'obtient le verrouillage de l'enregistrement que lors de la phase de Commit.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, LOCKING_MODE)).
Suppression autorisée spécifie si la suppression d'enregistrements est autorisée.
Si cette propriété est fixée à : NON, l'utilisateur ne pourra pas supprimer d'enregistrement dans le bloc.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, DELETE_ALLOWED)).
Mode clé cette propriété ne doit être modifiée que si le bloc n'est pas basé sur une table Oracle, car Forms ne peut pas obtenir de ROWID dans ce cas.
Mettre à jour colonnes modifiées seulement indique à Forms de ne spécifier dans l'ordre UPDATE que les colonnes dont la valeur a été modifiée. Si la Taille du tableau d'interrogation est supérieure à 1, cette propriété est ignorée.
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…, UPDATE_CHANGED_COLUMNS)).
Imposer sécurité sur colonne demande à Forms de placer la propriété du champ à UPDATABLE FALSE si une contrainte de base de donnée interdit à cet utilisateur de modifier cette colonne.
Cette propriété ne peut être fixée qu'au moment du design.
Durée maximum d'interrogation permet d'indiquer un nombre de secondes au-delà duquel l'interrogation est stoppée. Cette propriété n'est utilisée que si la propriété Interroger tous les enregistrements est positionnée à Oui.
Cette propriété selon la documentation peut être fixée à l'exécution (Set_Block_Property(…, MAX_QUERY_TIME)). En réalité il n'en est rien !
À l'exécution, cette instruction génère une erreur de propriété inconnue (erreur de documentation).
Nombre maximum d'enregistrements ramenés permet de spécifier le nombre maximum d'enregistrements ramenés par l'interrogation.
Cette propriété selon la documentation peut être fixée à l'exécution (Set_Block_Property(…,MAX_RECORDS_FETCHED)). En réalité il n'en est rien !
À l'exécution, cette instruction génère une erreur de propriété inconnue (erreur de documentation).

Base de données évoluée

Type de cible de données DML indique le type de source de données sur lequel est basé le bloc.
Les valeurs possibles sont:

• Aucun
• Table
• Procédure
• Déclencheur transactionnel

Cette propriété peut être fixée à l'exécution (Set_Block_Property(…,DML_DATA_TARGET_TYPE)).
Nom de cible de données DML indique le nom de la source de données sur lequel est basé le bloc.(nom de la table, la vue ou la procédure stockée).
Cette propriété peut être fixée à l'exécution (Set_Block_Property(…,DML_DATA_TARGET_NAME)).

Précalculer récapitultifs indique si Forms doit valoriser les items calculés avant de remplir le bloc.
Cette propriété ne peut être fixée qu'au moment du design
Valeur de retour DML indique si Forms doit utiliser la clause spécifique RETURNING INTO disponible depuis Oracle 9i pour rafraîchir les données du bloc.
Positionner cette propriété à OUI permet de faire l'économie d'un execute_query après la modification des données.

Restrictions:
Une valeur égale à OUI n'est prise en compte que si Forms est connecté à une base 9i ou supérieure.
La clause RETURNING INTO est utilisée pour les insertions et les mises à jour, mais pas pour les suppressions.
Cette clause est sans effet lorsque le bloc contient une colonne de type LONG.


Barre de défilement

Ces propriétés permettent d'indiquer si une barre de défilement est associée au bloc de données et quelles sont ses caractéristiques.

IX-B-1. Définition▲

IX-B-2. Concept▲

IX-B-3. Mise en œuvre▲

Nous allons créer une relation maître/détail entre un bloc basé sur la table des départements (DEPT) et la table des employés (EMP).

Créons un nouveau module Forms dans le navigateur d'objet et double-cliquons sur le nœud : Blocs de données

créons le bloc sur la table DEPT

Puis le bloc détail basé sur la table EMP

Cliquez le bouton : Créer une relation… pour définir la relation établie entre les deux blocs

Puisqu'il s'agit de tables relationnelles standard, cliquons l'option : Fondée sur une condition de jointure

puis indiquons le nom du bloc maître de la relation

La fenêtre de récapitulation de l'assistant indique alors le nom du bloc maître ainsi que deux listes déroulantes permettant de constituer la condition de jointure.

La liste : Élément détail affiche la liste des items du bloc détail (EMP en l'occurrence).
La liste : Élément maître affiche la liste des items du bloc maître (DEPT).

Nous lions la colonne DEPTNO des deux tables.
Cette relation permettra, lorsque le curseur est sur un enregistrement du bloc maître d'afficher dans le bloc détail uniquement les employés appartenant au département sélectionné.

Puisque nous avons choisi d'afficher les deux blocs dans un style tabulaire, voici l'écran final tel qu'il a été construit par Forms.

Forms a créé un objet de type relation (DEPT_EMP) dont voici les propriétés

Comme n'importe quelle propriété, celles-ci sont modifiables.

La condition de jointure ne peut pas excéder 255 caractères et il ne faut pas saisir le caractère : devant les noms de blocs.

La propriété : Comportement d'enregistrement supprimé peut prendre l'une des trois valeurs suivantes :

• En cascade permet, lors de la suppression de l'enregistrement maître de supprimer en cascade les enregistrements détail au moment du commit
• Isolée permet de supprimer un enregistrement maître sans affecter les enregistrements détail
• Non isolée indique qu'il est impossible de supprimer un enregistrement maître si un détail existe

Lors de la création de la relation, Forms a créé trois triggers automatiquement :

- Un trigger de niveau forme :

• ON-CLEAR-DETAIL

- Deux triggers au niveau du bloc maître :

• ON-POPULATE-DETAILS
• ON-CHECK-DELETE-MASTER

Ainsi que deux unités de programme :

• PROCEDURE Clear_All_Master_Details()
• PROCEDURE Query_Master_Details()

Si la relation est de type Isolée, le trigger ON-CHECK-DELETE-MASTER est supprimé de la forme.

Si la relation est de type Cascade, un trigger PRE-DELETE est ajouté au bloc maître.

Remarque
Dans le cas de relations maître/détail/détail, la suppression automatique en cascade n'est appliquée que sur le premier bloc détail. Pour les sous-blocs détail, il faudra gérer manuellement la suppression en ajoutant les triggers PRE-DELETE.

La propriété Différé en liaison avec la propriété Interrogation automatique indique la façon dont Forms réagira lorsque l'utilisateur changera d'enregistrement maître.

IX-C-1. Définition▲

IX-C-2. Concept▲

IX-C-3. Mise en œuvre▲

Dans le script d'installation livré avec l'article, se trouve la création de la vue : EMP_DEPT, dont l'ordre SQL est le suivant :

 

Sélectionnez

CREATE OR REPLACE VIEW EMP_DEPT 
( 
  EMPNO, 
  ENAME, 
  DEPTNO, 
  DNAME 
) AS 
SELECT 
  e.empno, 
  e.ename, 
  d.deptno, 
  d.dname
FROM 
  emp e, 
  dept d
WHERE 
  e.DEPTNO = d.DEPTNO
;

Cette vue est la mise en commun de colonnes de la table EMP et de colonnes de la table DEPT

L'écran de démonstration TEST_BLOC_VUE.FMB livré avec les exemples est basé sur cette vue.

L'insertion dans les tables EMP et/ou DEPT s'effectue dans le code PL/SQL du déclencheur ON-INSERT

La mise à jour des tables EMP et/ou DEPT s'effectue dans le code PL/SQL du déclencheur ON-UPDATE

Ces deux déclencheurs appellent l'unité de programme : ins_upd_emp_dept()

 

Sélectionnez

-------------------------------------------------
-- Gestion manuelle du DML sur la vue EMP_DEPT --
-------------------------------------------------
PROCEDURE ins_upd_emp_dept IS
  LN$Dummy PLS_INTEGER := 0 ;
BEGIN
  -- Table DEPT --
  Begin
  Select 1
  Into LN$Dummy
  From DUAL
  Where exists( select deptno from dept where deptno = :EMP_DEPT.DEPTNO ) ;
    -- Trouve, MAJ --
      Message('Update de la table DEPT');
      UPDATE DEPT
      SET    DNAME = :EMP_DEPT.DNAME
      WHERE  DEPTNO = :EMP_DEPT.DEPTNO ;
  Exception
      When no_data_found Then
    -- Insertion --
      Message('Insertion dans la table DEPT');
      INSERT INTO DEPT ( DEPTNO, DNAME )
      VALUES ( :EMP_DEPT.DEPTNO, :EMP_DEPT.DNAME ) ;
  End ;
  
  -- Table EMP --
  Begin
  Select 1
  Into LN$Dummy
  From DUAL
  Where exists( select empno from emp where empno = :EMP_DEPT.EMPNO ) ;
    -- Trouve, MAJ --
      Message('Update de la table EMP');
      UPDATE EMP
      SET    ENAME = :EMP_DEPT.ENAME
      WHERE  EMPNO = :EMP_DEPT.EMPNO ;
  Exception
      When no_data_found Then
    -- Insertion --
      Message('Insertion dans la table EMP');
      INSERT INTO EMP ( EMPNO, ENAME )
      VALUES ( :EMP_DEPT.EMPNO, :EMP_DEPT.ENAME ) ;
  End ;
  
END;

Un clic sur le bouton : Requête de la vue… permet d'afficher le code SQL de la vue.

Dans cet exemple, le bloc EMP_DEPT est basé sur une requête de type : clause FROM

l'ordre select est donc stocké directement dans la propriété : Nom de source de données d'interrogation.

Il est alors très facile de rendre la vue dynamique en modifiant à l'exécution les termes des clauses WHERE et/ou ORDER_BY.

Il est même possible de modifier le nom de la table source du bloc, si la nouvelle table contient les mêmes colonnes que la table précédente.

Ce type de manipulation dynamique est implémenté dans l'écran de démonstration : TEST_DATA_SOURCES.FMB.

Dans cet exemple, le bloc principal est basé sur la table : JANVIER (dont le script de création et d'alimentation est livré avec l'article).

Deux autres tables FEVRIER et MARS partagent une structure identique.

La liste déroulante : Choisir un mois permet de sélectionner le mois (et donc la table) souhaité.
La manipulation dynamique consiste à changer dynamiquement la propriété du bloc : Nom de source de données avec la fonction native Set_Block_Property().

Code du déclencheur : WHEN-LIST-CHANGED

Sélectionnez

If :CTRL.CHOIX is not null Then
    :global.choix := :ctrl.choix ;
    clear_form ;
    :ctrl.choix := :global.choix ;
    Set_Block_Property('TEST2', QUERY_DATA_SOURCE_NAME, :global.CHOIX );
    go_block('TEST2');
    execute_query;
End if ;

Correspondance des colonnes entre la vue et les items Forms

Lorsque votre bloc est basé sur une vue existante en base, la propriété du bloc : Colonnes de source de données est automatiquement renseignée par Forms.

Par contre, si votre bloc est basé sur une vue fictive, vous devez renseigner cette propriété en indiquant, pour chaque colonne de la vue le nom, le type et la longueur ou la précision.

Ajoutez manuellement au bloc les items correspondant en veillant à leur donner les mêmes caractéristiques.

IX-C-4. Techniques avancées▲

CREATE OR REPLACE VIEW EMP_NDEPT 
( 
  EMPNO, 
  ENAME, 
  DEPTNO, 
  DNAME 
) AS 
SELECT 
  e.empno, 
  e.ename, 
  e.deptno, 
  d.dname
FROM 
  emp e, 
  dept d
WHERE 
  e.DEPTNO = d.DEPTNO
ORDER BY
  d.dname,
  e.ename
/

SELECT 
  e.empno, 
  e.ename, 
  e.deptno, 
  d.dname
FROM 
  emp e, dept d
WHERE 
  e.DEPTNO = d.DEPTNO
ORDER BY
  d.dname,
  e.ename
;

IX-D-1. Définition▲

IX-D-2. Concept▲

IX-D-3. Mise en œuvre▲

Avant de baser un bloc sur des procédures stockées, celles-ci doivent bien évidemment exister en base.

La première étape consiste à créer le paquetage et ses cinq procédures.

Le paquetage EMP_PKG livré avec le script d'installation met en œuvre ce mécanisme.

Il contient deux jeux de procédures :

- Un jeu permettant de mettre en œuvre un bloc basé sur un REF CURSOR
- Un jeu permettant de mettre en œuvre un bloc basé sur un tableau PL/SQL

Voici les types nécessaires à l'exécution de ces procédures:

Nous définissons un enregistrement constitué de colonnes de la table EMP

 

Sélectionnez

  -- Record de type EMP --
  TYPE emp_rec IS RECORD(
    Empno   emp.empno%TYPE,
    Ename   emp.ename%TYPE,
    Job     emp.job%TYPE,
    Sal     emp.sal%TYPE,
    Comm    emp.comm%TYPE);

Nous définissons une variable de type REF CURSOR typée sur l'enregistrement préalablement créé.

 

Sélectionnez

  -- Si le bloc est basé sur un REF CURSOR --
  TYPE emp_cursor IS REF CURSOR RETURN emp_rec;

Nous définissons un tableau PL/SQL qui sera transmis aux procédures par Forms.

 

Sélectionnez

  -- Tableau d'enregistrements pour les procédures --
  TYPE emptab IS TABLE OF emp_rec INDEX BY BINARY_INTEGER;

Les procédures d'insertion, mise à jour, suppression et verrouillage doivent recevoir un argument de type tableau PL/SQL (TABLE INDEX BY).


Procédure retournant un REF CURSOR

Sélection des enregistrements

Elle utilise la procédure EMP_PKG.EMP_REFCUR()

 

Sélectionnez

  ----------------------------
  --  Select avec REFCURSOR --
  ----------------------------
  PROCEDURE emp_refcur
   (
      emp_data IN OUT emp_cursor
     ,p_num IN VARCHAR2
     ,p_nom IN VARCHAR2
     ,p_job IN VARCHAR2
     ,p_sal IN VARCHAR2
     ,p_com IN VARCHAR2
   ) IS
  BEGIN
    -- sauvegarde clause where --
    GC$Num := p_num ;
    GC$Nom := p_nom ;
    GC$Job := p_job ;
    GC$Sal := p_sal ;
    GC$Com := p_com ;

    OPEN  emp_data FOR SELECT empno, ename, job, sal, comm
    FROM  emp
    WHERE EMPNO LIKE Nvl( p_num || '%', EMPNO )
    AND   ENAME LIKE Nvl( p_nom || '%', ENAME )
    AND   JOB LIKE Nvl( p_job || '%', JOB )
    AND   ( SAL LIKE Nvl( p_sal || '%', SAL ) OR p_sal is null )
    AND   ( COMM LIKE Nvl( p_com || '%', COMM ) OR p_com is null )
    ORDER BY ENAME ;
  END emp_refcur;

Cette procédure accepte une variable IN OUT du type du REF CURSOR déclaré dans les spécifications du paquetage et cinq autres variables (p_num … p_com) pour gérer le mode ENTER-QUERY.

Cette procédure ouvre et retourne le curseur alimenté par l'ordre SELECT.

Insertion

Elle utilise la procédure EMP_PKG.EMP_INSERT2()

 

Sélectionnez

  --------------------------------------
  -- Insertion trigger transactionnel --
  --------------------------------------
  PROCEDURE emp_insert2(t IN emptab) IS
  BEGIN
    FOR i IN t.first..t.last LOOP
    INSERT INTO emp (empno, ename, job, sal, comm)
    VALUES(t(i).empno, t(i).ename, t(i).job, t(i).sal, t(i).comm);
    END LOOP ;
  END emp_insert2;

Cette procédure reçoit une variable de type tableau d'enregistrements.


Mise à jour

Elle utilise la procédure EMP_PKG.EMP_UPDATE2()

 

Sélectionnez

  ----------------------------------------
  -- Mise à jour trigger transactionnel --
  ----------------------------------------
  PROCEDURE emp_update2(t IN emptab) IS
  BEGIN
    FOR i IN t.first..t.last LOOP
        UPDATE emp
        SET  ename  = t(i).ename,
             job    = t(i).job,
             sal    = t(i).sal,
             comm   = t(i).comm
        WHERE empno = t(i).empno;
    END LOOP ;
  END emp_update2 ;

Cette procédure reçoit une variable de type tableau d'enregistrements.


Suppression

Elle utilise la procédure EMP_PKG.EMP_DELETE2()

 

Sélectionnez

  -----------------------------------
  -- Delete trigger transactionnel --
  -----------------------------------
  PROCEDURE emp_delete2( t IN emptab ) IS
  BEGIN
    FOR i IN t.first..t.last LOOP
        DELETE FROM emp
        WHERE  empno = t(i).empno;
    END LOOP ;
  END emp_delete2;

Cette procédure reçoit une variable de type tableau d'enregistrements.


Verrouillage

Elle utilise la procédure EMP_PKG.EMP_LOCK2()

 

Sélectionnez

  ---------------------------------
  -- Lock trigger transactionnel --
  ---------------------------------
  PROCEDURE emp_lock2( t IN emptab ) IS
    v_rownum NUMBER;
    verrou exception;
    pragma exception_init ( verrou, -54 ) ;
  BEGIN
    FOR i IN t.first..t.last LOOP
        SELECT empno
        INTO   v_rownum
        FROM   emp
        WHERE  empno = t(i).empno
        FOR UPDATE OF ename NOWAIT;
    END LOOP ;
  EXCEPTION
    When verrou then
        Raise_Application_Error( -20100, '^Verrouillage de l''enregistrement impossible^' ) ;
  END emp_lock2;

Cette procédure reçoit une variable de type tableau d'enregistrements.

Ces procédures acceptent en argument un tableau PL/SQL, permettant à Forms d'envoyer en une seule fois tous les enregistrements nécessitant un traitement.

Nous pouvons maintenant construire dans Forms un bloc basé sur ces procédures

Créons un nouveau module ainsi qu'un nouveau bloc avec l'assistant

Cliquons le bouton Procédure stockée.

Dans la zone Procédure, nous indiquons le nom de la procédure de sélection (EMP_PKG.EMP_REF_CUR) puis cliquons le bouton Régénérer.

La liste des colonnes du REF CURSOR s'affiche dans la case Colonnes disponibles afin de sélectionner celles qui apparaîtront dans le bloc.

Nous les sélectionnons toutes:

L'assistant demande ensuite d'entrer le nom de la procédure d'insertion.
Saisissons EMP_PKG.EMP_INSERT2 et cliquons le bouton Régénérer.

Répétons cette opération pour les procédures de mise à jour (update2), suppression (delete2) et verrouillage (lock2).

Choisissez à la fin un bloc de type tabulaire avec affichage de 5 enregistrements.

Lorsque le bloc est créé, vous pouvez afficher de nouveau l'assistant bloc de données via le menu : Outils -> Assistant bloc de données.

Cette fois, il est possible de visualiser (modifier) chaque procédure via son onglet spécifique.

Que s'est-il passé ?

Ouvrons la fenêtre de propriétés du bloc

La propriété : Type de source de données a été valorisée avec : Procédure
La propriété : Nom de source de données a été valorisée avec le nom de la procédure stockée qui retourne le curseur.

Le bouton : Suite… de la propriété : Colonnes de source de données permet d'afficher les colonnes ramenées depuis le curseur.

Le bouton : Suite… de la propriété : Arguments de source de données permet d'afficher les arguments transmis au curseur.

l'argument EMP_DATA est de type REFCURSOR est doit être en mode IN OUT.
Les autres arguments, nécessaire à la recherche en mode interrogation sont de mode IN.

La case : Valeur permet de transmettre une valeur au paramètre.
Cette valeur peut être un littéral ou une référence à un item (:BL_EMP_REFCUR.EMPNO).
C'est cette valeur qui sera transmise au curseur, notamment en mode interrogation.

Voyons maintenant les propriétés : Base de données évoluée

Les divers noms de procédures ont été valorisés, ainsi que les propriétés Colonnes et Arguments.

On voit que les arguments sont de type TABLE d'enregistrements (EMP_PKG.EMPTAB).

Vous pouvez dès lors exécuter la forme et lancer l'interrogation sur le bloc, puis ajouter, modifier, supprimer les enregistrements.



Procédure retournant un Tableau PL/SQL

La construction d'un bloc basé sur une procédure ramenant un tableau PL/SQL est identique à celle précédemment utilisée.

Dans l'assistant bloc de données, dans le nom de la procédure d'interrogation, entrez EMP_PKG.EMP_QUERY

 

Sélectionnez

  -------------------------
  -- Select avec tableau --
  -------------------------
  PROCEDURE emp_query(emp_data IN OUT emptab) IS
    ii NUMBER;
    CURSOR empselect IS
      SELECT empno, ename, job, sal, comm FROM emp
      ORDER BY ename ;
  BEGIN
    OPEN empselect;
    ii := 1;
    LOOP
      FETCH empselect INTO
        emp_data( ii ).empno,
        emp_data( ii ).ename,
        emp_data( ii ).job,
        emp_data( ii ).sal,
        emp_data( ii ).comm;
      EXIT WHEN empselect%NOTFOUND;
      ii := ii + 1;
    END LOOP;
  END emp_query;

Les procédures d'insertion, mise à jour, suppression et verrouillage sont identiques.

IX-D-4. Techniques avancées▲

Declare
    LC$Msg Varchar2(2000) ;
Begin

If DBMS_ERROR_CODE = -20100 Then
    -- Récupération du message inséré dans Raise_Application_Error --
      LC$Msg := substr(DBMS_ERROR_TEXT, 
            instr(DBMS_ERROR_TEXT,'^')+ 1 ,
            ( instr(DBMS_ERROR_TEXT,'^',-1) - instr(DBMS_ERROR_TEXT,'^') - 1) ) ;

    message(LC$Msg, acknowledge ) ;
Else
    message('erreur : ' || DBMS_ERROR_TEXT, acknowledge ) ;
End if ;

End ;

  ---------------------------------
  -- Lock trigger transactionnel --
  ---------------------------------
  PROCEDURE emp_lock2( t IN emptab ) IS
    v_rownum NUMBER;
    verrou exception;
    pragma exception_init ( verrou, -54 ) ;
  BEGIN
    FOR i IN t.first..t.last LOOP
      SELECT empno
      INTO   v_rownum
      FROM   emp
      WHERE  empno = t(i).empno
      FOR UPDATE OF ename NOWAIT;
    END LOOP ;
  EXCEPTION
    When verrou then
      Raise_Application_Error( -20100, '^Verrouillage de l''enregistrement impossible^' ) ;
  END emp_lock2;

IX-E-1. Définition▲

IX-E-2. Concept▲

IX-E-3. Mise en œuvre▲

Dans le script d'installation livré avec l'article, se trouve la création d'une table : ARTICLES, contenant une collection d'objets. Cette collection définit pour chaque article les emplacements de stockage ainsi que la quantité en stock pour chaque emplacement.

 

Sélectionnez

-- Type d'un emplacement --
CREATE TYPE TYP_CASE AS OBJECT
 (
   EMP   VARCHAR2(10),
   QTE    NUMBER
 )
/
 
-- Table d'emplacements --
CREATE TYPE TAB_TYP_CASE AS TABLE OF TYP_CASE
/

-- Table des articles --
CREATE TABLE ARTICLES
 (
   CODE    VARCHAR2(20),
   LIBELLE VARCHAR2(100),
   PRIX    NUMBER(8,2),
   QTETOT  NUMBER(8),
   CASES   TAB_TYP_CASE
 )
 NESTED TABLE CASES STORE AS CASES_NT
 STORAGE
 (
   INITIAL 5K
   NEXT 5K
   PCTINCREASE 0
   MINEXTENTS 1
   MAXEXTENTS 500
 )
/

Chaque article peut donc pointer sur plusieurs emplacements indiquant la quantité stockée dans l'emplacement.

La forme d'exemple TEST_COLLECTION.FMB livrée avec l'article permet de gérer la table ARTICLES.

Le premier bloc (ARTICLES) est naturellement basé sur la table du même nom.

Le second bloc (CASES) doit être constitué manuellement.

Deux items (de même type que les attributs de la collection) sont ajoutés à ce bloc:

• EMP de type Varchar2(20)
• QTE de type NUMBER

La propriété du bloc : Type de source de données d'interrogation est positionnée à : Interrogation de clause FROM

La propriété du bloc : Nom de source de données d'interrogation est positionnée avec la requête temporaire : Select 1,2 from dual

Cette requête sera adaptée dynamiquement à chaque fois que l'enregistrement du bloc principal changera.


Particularités des blocs

- Le bloc principal (ARTICLES)

Pour ne pas insérer dans la table ARTICLES une collection NULL, nous devons programmer l'insertion explicitement dans un déclencheur de niveau bloc : ON-INSERT

Déclencheur On-Insert

Sélectionnez

------------------------------------------------
--  l' insertion est effectuée explicitement  --
--  car le nouvel enregistrement ne peut pas  --
--  contenir une collection NULL              --
------------------------------------------------
INSERT INTO ARTICLES
  (
    CODE,
    LIBELLE,
    PRIX,
    QTETOT,
    CASES
  )
  VALUES
  (
    :ARTICLES.CODE,
    :ARTICLES.LIBELLE,
    :ARTICLES.PRIX,
    :ARTICLES.QTETOT,
    TAB_TYP_CASE() -- insertion collection vide
  )
  ;

Notez que nous insérons une collection vide, ce qui est différent de l'insertion d'une collection NULL.
En effet, il n'est pas possible d'ajouter des éléments à une collection NULL.

Pour afficher les lignes de la collection du second bloc, nous devons adapter dynamiquement la requête, en codant un déclencheur : WHEN-NEW-RECORD-INSTANCE

Déclencheur When-New-Record-Instance

Sélectionnez

Declare
   LC$Req  Varchar2(256) ;
Begin
   If :ARTICLES.CODE Is not null Then
      -- requête dynamique du bloc secondaire --
      LC$Req := '(SELECT cases.EMP, cases.QTE FROM TABLE ( SELECT cases FROM articles WHERE code = ''' 
        || :ARTICLES.CODE || ''') cases)' ;
      Go_Block('CASES' );
      Clear_Block ;
      Set_Block_Property( 'CASES', QUERY_DATA_SOURCE_NAME, LC$Req ) ;
      Execute_Query ;
      Go_Block('ARTICLES') ;
   Else
      Go_Block('CASES' );
      Clear_Block ;
      Go_Block('ARTICLES') ;
   End if ;
End ;

- Le bloc secondaire (CASES)

Gérons manuellement les ordres du DML en ajoutant les déclencheurs nécessaires :

ON-INSERT

Déclencheur : ON-INSERT

Sélectionnez

-- Insertion d'une ligne dans la collection --
INSERT INTO TABLE
 (  
   SELECT
      cases
   FROM
      articles
   WHERE
      code = :ARTICLES.CODE
 )
 Values
 (
   TYP_CASE( :CASES.EMP, :CASES.QTE )
 );

ON-UPDATE

Déclencheur : ON-UPDATE

Sélectionnez

-- Mise à jour de la ligne de la collection --
UPDATE TABLE
 (  
   SELECT
      cases
   FROM
      articles
   WHERE
      code = :ARTICLES.CODE
 ) cases
 SET
   VALUE(cases) = TYP_CASE( :CASES.EMP, :CASES.QTE ) 
 WHERE
   cases.emp = :CASES.EMP
 ;

ON-DELETE

Déclencheur : ON-DELETE

Sélectionnez

-- Suppression de la ligne de la collection --
DELETE FROM TABLE
 (  
   SELECT
      cases
   FROM
      articles
   WHERE
      code = :ARTICLES.CODE
 ) cases
 WHERE
   cases.emp = :CASES.EMP
 ;

ON-LOCK

Déclencheur : ON-LOCK

Sélectionnez

   Null ;

IX-E-4. Techniques avancées▲

Cette section traite particulièrement de blocs basés sur une table objet contenant une collection de références.

IX-F-1. Définition▲

IX-F-2. Concept▲

IX-F-3. Mise en œuvre▲

Dans le script d'installation livré avec l'article, se trouve la création d'une table : ARTICLES_OBJ, contenant une collection de références. Cette collection définit, pour chaque article les emplacements de stockage ainsi que la quantité en stock pour chaque emplacement sous la forme de références (OID) pointant sur la table objet : EMP_OBJ.

Script de création des objets

Sélectionnez

-- Type Emplacement --
CREATE OR REPLACE TYPE TYP_EMP AS OBJECT
 (
   EMP   VARCHAR2(10),
   ART   VARCHAR2(20),
   QTE   NUMBER
 )
/

-- Type référence emplacement --
CREATE OR REPLACE TYPE REF_TYP_EMP AS OBJECT
(
  ref_emp REF TYP_EMP
)
/  

-- Table de références emplacements --
CREATE OR REPLACE TYPE TAB_REF_TYP_EMP AS TABLE OF REF_TYP_EMP
/

-- Type objet Articles --
CREATE OR REPLACE TYPE TYP_ARTICLES AS OBJECT
(
  CODE     VARCHAR2 (20), 
  LIBELLE  VARCHAR2 (100), 
  PRIX     NUMBER (8,2), 
  QTETOT   NUMBER (8), 
  REMP     TAB_REF_TYP_EMP
)
/

-- Table objet ARTICLES --
 CREATE TABLE ARTICLES_OBJ OF TYP_ARTICLES 
 NESTED TABLE REMP STORE AS REMP_NT
/

-- Table objet EMPLACEMENTS --
 CREATE TABLE EMP_OBJ OF TYP_EMP 
/

Chaque article peut donc pointer sur plusieurs emplacements indiquant la quantité stockée dans l'emplacement.

La forme d'exemple TEST_OBJETS.FMB livrée avec l'article permet de gérer la table ARTICLES_OBJ ainsi que sa collection de références.

Le premier bloc (ARTICLES) est naturellement basé sur la table ARTICLES_OBJ.
Le second bloc (CASES) doit être constitué manuellement.

Deux items (de même type que les attributs de la table objet EMP_OBJ) sont ajoutés à ce bloc:

• EMP de type Varchar2(20)
• QTE de type NUMBER

La propriété du bloc : Type de source de données d'interrogation est positionnée à : Interrogation de clause FROM
La propriété du bloc : Nom de source de données d'interrogation est positionnée avec la requête temporaire : Select 1,2 from dual

Cette requête sera adaptée dynamiquement à chaque fois que l'enregistrement du bloc principal changera.


Particularités des blocs

- Le bloc principal (ARTICLES)

Pour ne pas insérer dans la table ARTICLES_OBJ une collection NULL, nous devons programmer l'insertion explicitement dans un déclencheur de niveau bloc : ON-INSERT

Déclencheur : ON-INSERT

Sélectionnez

------------------------------------------------
--  l' insertion est effectuée explicitement  --
--  car le nouvel enregistrement ne peut pas  --
--  contenir une collection NULL              --
------------------------------------------------
INSERT INTO ARTICLES_OBJ 
VALUES
(
  TYP_ARTICLES
   ( 
      :ARTICLES.CODE, 
      :ARTICLES.LIBELLE, 
      :ARTICLES.PRIX, 
      :ARTICLES.QTETOT, 
      TAB_REF_TYP_EMP() - collection vide
   )
) ;

Notez que nous insérons une collection vide, ce qui est différent de l'insertion d'une collection NULL.
En effet, il n'est pas possible d'ajouter des éléments à une collection NULL.

Pour afficher les lignes de la collection du second bloc, nous devons adapter dynamiquement la requête, en codant un déclencheur : WHEN-NEW-RECORD-INSTANCE

Déclencheur : WHEN-NEW-RECORD-INSTANCE

Sélectionnez

Declare
   LC$Req  Varchar2(256) ;
Begin
   If :ARTICLES.CODE Is not null Then
      ------------------------------------------
      -- requête dynamique du bloc secondaire --
      ------------------------------------------      
      LC$Req := '(SELECT emp.ref_emp.emp EMP, emp.ref_emp.qte QTE FROM ' ;
      LC$Req := LC$Req || 'TABLE( SELECT REMP FROM articles_obj WHERE CODE = ''' ;
      LC$Req := LC$Req || :ARTICLES.CODE || ''') emp WHERE emp.ref_emp.art = ''' || :ARTICLES.CODE || ''')' ;
        
      Go_Block('CASES' );
      Clear_Block ;
      Set_Block_Property( 'CASES', QUERY_DATA_SOURCE_NAME, LC$Req ) ;
      Execute_Query ;
      Go_Block('ARTICLES') ;
   Else
      Go_Block('CASES' );
      Clear_Block ;
      Go_Block('ARTICLES') ; 
   End if ;
End ;

Les informations de la table EMP_OBJ sont ramenées par l'intermédiaire des références stockées dans la collection REF_EMP.


- Le bloc secondaire (CASES)

Gérons manuellement les ordres du DML en ajoutant les déclencheurs nécessaires:

Déclencheur : ON-INSERT

Sélectionnez

-- Insertion d'une ligne (REF) dans la collection --
Declare
    LC$Req Varchar2(256) ;
Begin
    LC$Req := 'INSERT INTO TABLE
    ( SELECT remp FROM ARTICLES_OBJ WHERE code = ''' || :ARTICLES.CODE  || ''')
    VALUES
    ( REF_TYP_EMP ( (SELECT REF(a) FROM EMP_OBJ a WHERE a.ART = ''' 
      || :ARTICLES.CODE || ''' AND a.EMP = ''' || :CASES.EMP || ''') ) )' ;

    Forms_Ddl( LC$Req ) ;
End ;

Pour ajouter une référence à la collection (bloc CASES), une LOV est disponible sur le champ EMP. Celle-ci affiche les enregistrements de la table EMP_OBJ dont le code article est égal à celui du bloc maître.

Déclencheur : ON-DELETE

Sélectionnez

-- Suppression de la ligne (REF) de la collection --
DELETE FROM TABLE
( SELECT remp FROM ARTICLES_OBJ WHERE code = :ARTICLES.CODE ) emp
WHERE 
   emp.ref_emp.art = :ARTICLES.CODE
And
   emp.ref_emp.emp = :CASES.EMP 
;

Déclencheur : ON-LOCK

Sélectionnez

   Null ;

Lors de l'enregistrement, la quantité totale d'articles est calculée à partir des références stockées dans la collection, puis la table ARTICLES_OBJ est mise à jour.

Déclencheur : KEY-COMMIT

Sélectionnez

Declare
   LN$Cpt pls_integer ;
   LN$Cur pls_integer ;
Begin
   -- Enregistrement --
   Commit_form ;

   -- Mise à jour de la quantité totale
   -- pour l'article en cours
   UPDATE ARTICLES_OBJ
   SET   QTETOT = (
   SELECT 
      SUM(emp.ref_emp.qte)
   FROM 
      TABLE( SELECT REMP FROM articles_obj WHERE CODE = :ARTICLES.CODE ) emp
   WHERE 
      emp.ref_emp.art = :ARTICLES.CODE
   )
   WHERE CODE = :ARTICLES.CODE    
   ;

   Forms_Ddl( 'commit' ) ;

   -- Raffraichissement de l'écran --
   Go_block('ARTICLES');
   LN$Cur := :SYSTEM.CURSOR_RECORD ;
   Execute_query ;
   Go_Record( LN$Cur ) ;

End ;

IX-F-4. Techniques avancées▲

INSERT INTO ARTICLES_OBJ VALUES
(
  TYP_ARTICLES( 'ART02', 'Article 2', 12, 10, 
  TAB_REF_TYP_EMP
  ( 
     REF_TYP_EMP ( (SELECT REF(a) FROM EMP_OBJ a WHERE a.ART = ... AND a.EMP = ...) )
  )
  )  
) ;

Declare
  LR$Ref  REF EMP_OBJ ;
Begin
  Select
     Ref(a)
  Into
     LR$Ref
  From
     EMP_OBJ
  ...

Le canevas correspond à une surface d'affichage.
Il est obligatoirement associé à une fenêtre et une seule (Window).

Une fenêtre peut contenir plusieurs canevas de type Intégral et plusieurs canevas de type Empilé et/ou Onglet, mais un seul canevas intégral n'est visible à la fois.

La lucarne correspond à une « fenêtre » d'affichage physique du canevas
Par exemple, un canevas peut avoir des dimensions de 2000x1000 pixels, mais la lucarne d'affichage n'en affichera qu'une certaine partie.
Cela permet de « faire tenir » un canevas dans une zone d'affichage bien délimitée avec l'affichage d'éventuels ascenseurs pour se déplacer sur le canevas à travers la lucarne qui est fixe.

Forms supporte quatre types de canevas :

• Intégral
• Empilé
• Onglet
• Barre d'outils

Le canevas intégral

Il s'agit de la surface d'affichage par défaut. Il est appelé canevas parent dans la mesure ou il représente la surface d'affichage principale sur laquelle sont affichés les graphiques, les items des blocs ainsi que les canevas de type empilé et/ou onglet.

Chaque fenêtre de l'application doit contenir au moins un canevas intégral.

Lorsque vous créez un nouveau module Forms, une des premières choses à faire est de créer un canevas intégral. C'est sur cette surface que vous afficherez les objets graphiques et les items.

Création de plusieurs canevas intégraux sur une même fenêtre

Forms, à l'exécution ne peut afficher au même instant qu'un seul canevas intégral pour une même fenêtre. Il doit donc « décider » lequel sera affiché dans l'instant et considéré comme le canevas courant.

Par défaut, Forms place le focus sur le premier item navigable du premier bloc de la forme. C'est donc le canevas intégral qui contient cet item qui deviendra le canevas courant.
Lorsque la navigation déplace le focus vers un item hébergé par un autre canevas intégral, c'est celui-ci qui devient le canevas courant.

Au moment de la conception, vous pouvez définir au niveau des propriétés de la fenêtre quel sera le canvas principal.


Le canevas empilé

Comme son nom l'indique, il s'agit d'un canevas qui se superpose au canevas intégral.
Lorsqu'il est affiché, il masque la partie du canevas intégral sur lequel il est posé.
Il peut être masqué ou affiché par programme à l'exécution.

Vous pouvez créer autant de canevas empilé que souhaité.
Vous pouvez ajuster ses propriétés visuelles afin de souligner graphiquement sa présence( couleur de fond différente du canevas intégral par exemple).
Vous pouvez également lui donner les mêmes attributs graphiques que le canevas intégral donnant l'impression à l'utilisateur qu'il s'agit de la même zone d'affichage.

La particularité du canevas empilé réside dans le fait qu'il est « fenêtrable ».
Cela veut dire que vous pouvez forcer son affichage à l'intérieur d'une zone fixe et faire défiler le canevas à l'intérieur de cette zone sans que le canevas intégral ne soit impacté.
Cette technique permet de gérer des tableaux d'enregistrements (de type feuille de calcul) beaucoup plus larges que la taille du canevas intégral.
Un canevas empilé peut être affiché/masqué à l'exécution et permet d'afficher sur un même canevas intégral des objets totalement différents.


Le canevas à onglets

Il s'agit d'un canevas muni d'un ou de plusieurs onglets.
Il permet d'afficher un grand nombre d'items dans chaque onglet, sachant qu'un seul onglet est visible à la fois.
Chaque onglet bénéficie d'un libellé sur lequel l'utilisateur peut cliquer et d'une surface d'affichage égale à celle du canevas qui l'héberge.


Le canevas barre d'outils

Ce type de canevas est utilisé pour créer des barres d'outils.
Il peut être horizontal et dans ce cas affiché en haut de la fenêtre juste sous la barre de menu, ou vertical et dans ce cas affiché sur le côté gauche de la fenêtre.

Il peut y en avoir plusieurs pour chaque fenêtre et il est possible de les afficher/masquer selon le contexte à l'exécution.


Le concept de la lucarne (VIEW)

La lucarne est un concept fondamental dans la notion de canevas.
Une lucarne peut être représentée comme une fenêtre d'affichage à l'intérieur d'un canevas permettant d'afficher tout ou partie du canevas.

En dehors des canevas empilés, la lucarne d'un canevas est intimement liée à la tille de la fenêtre qui l'héberge.
Modifier la taille de la lucarne d'un de ces canevas modifiera automatiquement celle de la fenêtre et inversement.

Pour un canevas empilé, il est possible de modifier la taille de cette lucarne à l'exécution.
Pour les autres types de canevas, cette taille est identique à celle de la fenêtre qui l'héberge.
Par contre, vous pouvez pour chaque type de canevas modifier le point d'origine (supérieur gauche) de la lucarne à un endroit spécifique du canevas.
Lorsqu'un canevas intégral est plus large que sa lucarne (qui correspond à la taille de la fenêtre), il est possible de modifier ce point d'origine pour afficher dans la lucarne des parties du canevas invisibles jusque là.

Créer un canevas depuis le navigateur d'objets

Pour créer un nouveau canevas depuis la fenêtre du navigateur d'objets, cliquez sur le nœud : Canevas puis sur le bouton de création

Un nouveau canevas apparaît avec un nom automatiquement attribué par Forms et de type intégral.


Créer un canevas onglet ou empilé depuis l'éditeur de présentation

Pour créer un nouveau canevas empilé ou onglet depuis la fenêtre d'édition de présentation, cliquez l'icône du canevas désiré, puis dessinez avec la souris (bouton gauche enfoncé) le rectangle définissant la taille du canevas souhaité.
Relâchez le bouton de la souris.

Icône de canevas onglet
Icône de canevas empilé

Remarque:
Un canevas onglet ou empilé est toujours attaché à un canevas intégral.
Si vous disposez de plusieurs canevas de type intégral dans votre application, veillez à le sélectionner dans l'éditeur de présentation avant d'insérer votre nouveau canevas

Les propriétés du canevas

Cliquez le nom du canevas dans le navigateur et faites apparaître sa fenêtre de propriétés en tapant F4.

Général

Nom désigne le nom du canevas (30 caractères)
Cette propriété ne peut être fixée qu'au moment du design.
Type de canevas peut prendre l'une des 5 valeurs suivantes :

• Intégral (par défaut) désigne un canevas parent de plus bas niveau
• Empilé désigne un canevas qui sera superposé à un canevas intégral
• Barre d'outils horizontale désigne un canevas représentant une barre d'outils
• Barre d'outils verticale désigne un canevas représentant une barre d'outils
• Onglet désigne un canevas qui supportera un ou plusieurs onglets

Cette propriété ne peut être fixée qu'au moment du design.
Informations de référence permet l'héritage d'une classe de propriétés
Commentaires est une zone de saisie libre

Fonctionnel

Afficher au premier plan sur saisie désigne la façon dont Forms affiche les canevas. Si la valeur est Oui, Forms affiche le canvas au premier plan, même s'il ne contient pas l'item qui a le focus. Si la valeur est Non, le canvas n'est affiché au premier plan que si l'item en cours correspond à ce canevas
Cette propriété n'est utilisée que lorsqu'au moins deux canevas sont associés à une même fenêtre
Cette propriété ne peut être fixée qu'au moment du design.
Menu instantané permet d'attacher un menu instantané (popup) au canvas
Cette propriété ne peut être fixée qu'au moment du design.

Physique

Visible indique si le canevas est visible par défaut
Cette propriété peut être fixée à l'exécution (Set_View_Property(…, VISIBLE)).
Lorsque le canevas est de type Empilé, deux propriétés supplémentaires sont actives:

• Afficher barre de défilement horizontale ajoute au canevas un ascenseur horizontal
• Afficher barre de défilement verticale ajoute au canevas un ascenseur vertical

Lorsque le canevas est de type Onglet, 4 propriétés particulières sont actives:

Ainsi qu'une section supplémentaire : Police pour définir les attributs graphiques du libellé de l'onglet

• Nom de police
• Taille de police
• Épaisseur
• Style
• Espacement

Fenêtre
Position X de la lucarne sur le canevas spécifie la position horizontale de la lucarne (VIEW) sur le canevas
Cette propriété peut être fixée à l'exécution (Set_View_Property(…, VIEWPORT_X_POS_ON_CANVAS)).
Position Y de la lucarne sur le canevas spécifie la position verticale de la lucarne (VIEW) sur le canevas
Cette propriété peut être fixée à l'exécution (Set_View_Property(…, VIEWPORT_Y_POS_ON_CANVAS)).
Largeur désigne la largeur du canevas exprimée dans le système de coordonnées
Cette propriété peut être fixée à l'exécution (Set_Canvas_Property(…, WIDTH)).
Hauteur désigne la hauteur du canevas exprimée dans le système de coordonnées
Cette propriété peut être fixée à l'exécution (Set_Canvas_Property(…, HEIGHT)).
Les 2 propriétés peuvent être fixée simultanément à l'exécution(Set_View_Property(…, VIEW_SIZE))
Largeur de la lucarne désigne la largeur de la lucarne (VIEWPORT) exprimée dans le système de coordonnées
Cette propriété peut être fixée à l'exécution (Set_View_Property(…, WIDTH)).
Hauteur de la lucarne désigne la hauteur de la lucarne (VIEWPORT) exprimée dans le système de coordonnées
Cette propriété peut être fixée à l'exécution (Set_View_Property(…, HEIGHT)).
Relief désigne l'apparence visuelle du canevas et peut prendre l'une des six valeurs suivantes:

• Relâché
• Enfoncé
• Aucun
• Incrusté
• Ressorti
• Simple

Attributs visuels

Groupe d'attributs visuels désigne l'attribut visuel assigné au canevas

Couleur

Couleur de premier plan indique la couleur des objets de premier plan
Couleur d'arrière-plan indique la couleur du fond
Motif de remplissage indique un motif de remplissage

International

Orientation désigne le sens d'affichage des objets (par défaut de gauche à droite)


Propriétés de l'onglet d'un canevas onglet

Général

Nom désigne le nom interne de l'onglet
Cette propriété ne peut être fixée qu'au moment du design.
Activé indique si l'onglet est actif (et donc cliquable). Si la propriété est fixée à Non, l'onglet reste visible, mais son libellé est grisé.
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, ENABLED)).
Libellé désigne le libellé de l'onglet
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, LABEL)).

Physique

Visible indique si l'onglet est visible
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, VISIBLE)).

Attributs visuels

Groupe d'attributs visuels désigne l'attribut visuel assigné au l'onglet
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, VISUAL_ATTRIBUTE)).

Couleur

Couleur de premier plan indique la couleur des objets de premier plan
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, FOREGROUND_COLOR)).
Couleur d'arrière-plan indique la couleur du fond
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, BACKGROUND_COLOR)).
Motif de remplissage indique un motif de remplissage
Cette propriété peut être fixée à l'exécution (Set_Tab_Page_Property(…, FILL_PATERN)).

International

Orientation désigne le sens d'affichage des objets (par défaut de gauche à droite)


Les fonctions natives relatives aux canevas et lucarnes

Afficher un canevas

Show_View( 'nom_canevas' | id_canvas) ;
Set_View_Property( 'nom_canevas' | id_canevas, VISIBLE, PROPERTY_TRUE ) ;

Masquer un canevas

Hide_View( 'nom_canevas' | id_canvas) ;
Set_View_Property( 'nom_canevas' | id_canevas, VISIBLE, PROPERTY_FALSE ) ;

Modifier les propriétés d'un canevas

Set_Canvas_Property('nom_canevas' | id_canvas, nom_propriete, valeur [,valeur] ) ;

nom_propriete peut être:

• BACKGROUND_COLOR définit la couleur du fond.
• CANVAS_SIZE détermine la largeur et hauteur (width, height).
• FILL_PATTERN indique le motif utilisé pour le fond.
• FONT_NAME indique le nom de la police.
• FONT_SIZE taille de la police en points.
• FONT_SPACING espacement des caractères.
• FONT_STYLE style de la police.
• FONT_WEIGHT graisse de la police.
• FOREGROUND_COLOR Couleur de premier plan.
• HEIGHT hauteur du canevas.
• TOPMOST_TAB_PAGE nom de l'onglet qui apparaît en premier lieu.
• VISUAL_ATTRIBUTE nom d'un attribut visuel.
• WIDTH largeur du canevas.

La valeur de ces propriétés peut être obtenue avec la fonction :

Get_Canvas_Property('nom_canevas' | id_canvas, nom_propriete ) ;

Modifier les propriétés d'une lucarne

Set_View_Property( 'nom_lucarne' | id_lucarne, nom_propriete, valeur [,valeur] ) ;

nom_propriété peut être l'une des valeurs suivantes:

• DIRECTION direction appliquée aux objets bidirectionnels. Les valeurs valides sont : DIRECTION_DEFAULT, RIGHT_TO_LEFT, LEFT_TO_RIGHT. DISPLAY_POSITION coordonnées X et Y d'affichage de la lucarne.
  
• HEIGHT hauteur de la lucarne.
  
• POSITION_ON_CANVAS coordonnées X et Y du point supérieur gauche de la lucarne dans le canevas.
  
• VIEWPORT_X_POS position X d'une lucarne relative à la fenêtre pour un canevas de type empilé.
  
• VIEWPORT_Y_POS position Y d'une lucarne relative à la fenêtre pour un canevas de type empilé.
  
• VIEWPORT_X_POS_ON_CANVAS position X d'une lucarne relative au canevas pour un canevas de type empilé.
  
• VIEWPORT_Y_POS_ON_CANVAS position Y d'une lucarne relative au canevas pour un canevas de type empilé.
  
• VIEW_SIZE largeur et hauteur de la lucarne.
  
• VISIBLE indique si la lucarne doit être affichée ou masquée.
  
• WIDTH largeur de la lucarne.

La valeur de ces propriétés peut être obtenue avec la fonction :

Get_View_Property( 'nom_lucarne' | id_lucarne, nom_propriete ) ;

La forme de test TEST_CANVAS.FMB livrée avec l'article permet de comprendre la gestion des différents types de canevas.

Peu de chose à dire sur le canevas intégral (CV_1) qui est obligatoire et partage la taille de la fenêtre qui l'accueille.

La partie supérieure droite de l'écran affiche un canevas de type empilé (CV_EMP_1).

Le bouton Changer le canevas empilé -> permet de permuter à l'exécution le canevas empilé CV_EMP_1 avec l'autre canevas empilé CV_EMP_2.
Ceci permet de voir comment présenter différentes informations à l'utilisateur selon le contexte avec l'instruction Show_View().

Dans le premier canevas empilé (CV_EMP_1) se trouve un autre bouton Descendre qui permet de modifier la position du coin supérieur gauche de la lucarne associée à ce canevas et d'afficher la partie basse, non visible au départ avec l'instruction:
Set_View_Property('Nom_canevas', VIEWPORT_Y_POS_ON_CANVAS, nouvelle _position) ;

Les fonctions Show_View() et Set_View_Property() suffiraient à elles seules à modifier l'affichage s'il n'y avait pas le problème de l'item qui a le focus !

En effet, Forms s'arrange toujours pour afficher le canevas (et la partie du canevas) sur lequel est affiché l'item qui a le focus.
Dans notre exemple, l'instruction Show_View() du bouton Changer le canevas suffit si le focus n'est pas dans un des items du bloc affiché par le canevas empilé.
Par contre, si le focus est positionné dans l'un des items de ce bloc, cette instruction reste dans effet, car Forms affichera toujours le canevas qui supporte l'item en cours.
Dans ce cas, il vaut mieux utiliser une instruction Go_Block() ou Go_item() qui déplacera le focus et forcera l'affichage du canevas correspondant.

En d'autres termes les instructions Show_View(), Hide_View() et Set_View_Property() sont sans effet si elles s'appliquent à un autre canevas que celui correspondant à l'item en cours.


La partie inférieure de l'écran affiche un canevas de type onglet.

Le deuxième onglet offre la particularité de démontrer la manière de présenter un tableau de type « feuille de calcul ».
On voit que la première colonne reste fixe pendant que les colonnes suivantes peuvent être défilées grâce à la barre de défilement horizontale.

Tous les items appartiennent au même bloc (BL_5).

Le premier est affecté à la page PG_1 du canevas de type onglet alors que les autres items sont affectés à un autre canevas de type empilé (CV_EMP_3) superposé au canevas à onglet et dont la taille de la lucarne est ajustée pour tenir dans la page onglet.

Une liste de valeurs est un outil d'aide à la saisie.
Elle se matérialise sous la forme d'une boite de dialogue dans laquelle sont affichées les valeurs qui correspondent à l'information attendue dans le champ en cours de saisie.

Une telle liste permet de filtrer les valeurs et donc d'obliger l'utilisateur à saisir une valeur conforme.

Une LOV est alimentée par un groupe d'enregistrements (Record group), lui-même alimenté par un ordre SELECT.

On peut considérer une LOV comme une vue n'affichant que les valeurs souhaitées.

Elle peut être affichée par programme ou à la demande de l'utilisateur.

Il existe deux façons de créer une liste de valeurs:

• À l'aide de l'assistant
• Manuellement

Pour créer une LOV dans la forme en cours, cliquez sur le nœud : LOV dans le navigateur d'objets puis cliquez sur l'icône , ou double-cliquez sur le nœud : LOV
Une boite de dialogue vous demande si vous souhaitez utiliser l'assistant ou créer la LOV manuellement

Création d'une LOV à l'aide de l'assistant

Cet écran permet d'indiquer si la LOV sera basée sur un groupe d'enregistrements existant ou sur un groupe que vous allez définir.

Créons le groupe d'enregistrements

Il s'agit de définir la requête SQL qui permettra d'alimenter le groupe d'enregistrements.
Toute instruction SQL valide portant sur une ou plusieurs tables/vues est autorisée, incluant les opérateurs UNION, UNION ALL, INTERSECT et MINUS, ainsi que l'utilisation de variables de substitution (en l'occurrence un item ( :nom_bloc.nom_item) ou un paramètre ( :PARAMETER.nom_paramétre))

Dans l'exemple, nous ramenons les colonnes DEPTNO, DNAME et LOC de la table DEPT.

Le bouton : Générer interrogation SQL… permet de construire la requête à l'aide d'un outil graphique.
Le bouton Importer interrogation SQL… permet de récupérer une requête stockée dans un fichier.
Le bouton : Vérifier la syntaxe permet de s'assurer que la requête ne comporte pas d'erreur.

L'écran suivant permet de définir quelles colonnes du groupe d'enregistrements seront affichées dans la LOV (un même groupe peut alimenter plusieurs LOV).
Nous souhaitons afficher les colonnes DEPTNO et DNAME.

Chaque colonne peut être adaptée au niveau des titres, largeur d'affichage ainsi que l'item de la forme qui recevra la valeur sélectionnée.
Pour sélectionner l'item de retour de la valeur, cliquez la colonne correspondante puis sur le bouton : Rechercher l'élément récepteur.

Cette liste affiche les items de la forme pour vous permettre de sélectionner celui qui recevra la valeur de la LOV.
Répéter l'opération autant de fois que nécessaire afin d'alimenter tous les items de réception.

L'écran suivant permet de définir quelques caractéristiques de la LOV:

• Le titre qui sera affiché dans le titre de la fenêtre de dialogue
• Les largeur et hauteur en unités du système de coordonnées en cours

Une information de positionnement automatique de la LOV lors de son affichage:

• Laisser Forms Runtime positionner ma LOV indique que l'application décidera des coordonnées d'affichage de la LOV à l'exécution (généralement près d'un coin de l'item sur lequel la LOV est attachée).
• Je veux positionner manuellement permet de définir précisément les coordonnées X et Y d'affichage du coin supérieur gauche de la LOV.

Cet écran permet d'indiquer le nombre de lignes qui seront lues à chaque fois depuis la base.

La case à cocher : Régénérer les données stipule que le groupe d'enregistrements sera rafraîchi à chaque fois que le LOV sera invoquée. Il est prudent de décocher cette case si le groupe d'enregistrements ramène un nombre très important de lignes, afin d'éviter le temps d'attente avant l'affichage de la LOV. Dans ce cas, le groupe sera alimenté seulement à la première invocation de la LOV.

La case à cocher : Autoriser l'utilisateur à filtrer oblige l'utilisateur à saisir un ou plusieurs caractères dans la LOV pour réduire le nombre de lignes ramenées.

Une fois les éléments récepteurs définis dans l'écran précédent, vous pouvez indiquer les items du bloc sur lesquels la LOV pourra être invoquée (à l'aide des touches Ctrl+L).

Après le retour de l'assistant, nous constatons la présence d'un nouveau groupe d'enregistrements et d'une nouvelle LOV dans le navigateur.
À tout moment, il est possible de modifier les propriétés associées à ces objets en faisant apparaître la fenêtre de propriétés (F4).

La propriété de la LOV : Propriétés de correspondance de colonnes permet de (re)définir la correspondance entre les colonnes de la LOV et les items de réception des valeurs dans le bloc.

L'item :EMP_DEPT.DEPTNO recevra la valeur de la colonne DEPTNO de la LOV.
L'item :EMP_DEPT.DNAME recevra la valeur de la colonne DNAME de la LOV.

Le bouton : Parcourir… affiche la liste des items du bloc si vous souhaitez changer l'item de réception.
La largeur d'affichage de chaque colonne de la LOV ainsi que son titre sont également modifiables.

Compilons et exécutons la forme.

Positionnons le curseur sur le champ Deptno.

La barre de statut en bas d'écran affiche : Liste de valeurs… pour indiquer qu'une LOV est disponible sur ce champ.
Déclenchons l'affichage de la LOV avec les touches Ctrl+L

La boite de dialogue apparaît et affiche les lignes ramenées par le groupe d'enregistrements.

La liste des valeurs peut être réduite par l'utilisateur en saisissant une lettre au clavier.

Rappel : la fonction de recherche n'agit que sur la première colonne de la LOV


Création manuelle d'une LOV

La création manuelle d'une LOV ne fait que créer un Nouvel objet LOV dans le navigateur.
C'est a vous de gérer le groupe d'enregistrements qui sera lié et de régler les propriétés de la LOV, propriétés détaillées dans la section suivante.


Les propriétés d'un objet LOV

Fonctionnel

Titre Chaîne de caractères apparaissant dans le titre de la boite de dialogue
Cette propriété peut être changée à l'exécution en utilisant la fonction Set_Lov_Property( nom_lov | id_lov, TITLE, nouveau_titre )
Type de liste
Groupe d'enregistrements permet d'indiquer le nom du groupe d'enregistrement qui alimentera la LOV
Cette propriété peut être changée à l'exécution en utilisant la fonction Set_Lov_Property(nom_lov | id_lov, GROUP_NAME )
Correspondance des colonnes permet d'indiquer l'item du bloc qui recevra la valeur de la colonne de la LOV
Permet également d'indiquer le titre de la colonne ainsi que sa largeur
Une largeur égale à 0 permet de ne pas afficher la colonne dans la LOV
Filtrer avant afficher indique que la LOV sera affichée vide et que l'utilisateur devra insérer un ou plusieurs caractères de filtrage avant l'affichage des valeurs
Affichage automatique positionné à Oui permet d'afficher automatiquement la LOV dès que le focus entre dans l'item qui la supporte.
Positionné à Non, l'utilisateur doit commander manuellement l'affichage de la LOV avec les touches Ctrl+L
Régénération automatique positionné à Oui demande à Forms de réactualiser le groupe d'enregistrements à l'aide de l'ordre SELECT à chaque fois que la LOV est invoquée. Cela permet de s'assurer que les données présentées sont actualisées.
Positionné à Non indique que le groupe d'enregistrement ne sera alimenté par l'ordre SELECT que lors de la première invocation de la LOV.
Le positionnement de cette propriété mérite une considération particulière:
Si les données affichées dans la LOV doivent absolument refléter l'état actuel de la base alors la propriété doit être valorisée à OUI.
Si la LOV est basée sur un groupe d'enregistrements qui ramène un nombre très important de lignes et qu'il n'est pas nécessaire que celles-ci reflètent absolument l'état actuel de la base, vous devez positionner cette propriété à Non.
(Un groupe d'enregistrement basé sur un ordre SELECT qui ramène un très grand nombre de lignes « gèlera » l'application durant la période d'alimentation du groupe d'enregistrements. Si cette LOV doit être fréquemment utilisée dans l'écran vous risquez fort de vous attirer les foudres de l'utilisateur !)
La régénération du groupe d'enregistrements intervient également lorsque la LOV est utilisée pour la validation de l'item.
Cette propriété peut être changée à l'exécution en utilisant la fonction Set_Lov_Property(nom_lov | id_lov, AUTO_REFRESH, PROPERTY_TRUE | PROPERTY_FALSE )
Sélection automatique la propriété Oui provoque le fonctionnement suivant :
Si, après filtrage la LOV n'affiche plus qu'une seule ligne, alors la saisie est autovalidée comme si l'utilisateur avait pressé le bouton OK.
Si elle est positionnée à Non, l'utilisateur doit valider la boite de dialogue, même si une seule ligne reste affichée dans la LOV.
Saut automatique lorsque la valeur vaut Oui, la sélection dans la LOV renseigne l'item qui la supporte et le curseur saute automatiquement à l'item suivant
Lorsqu'elle vaut Non, l'item est renseigné en sortie de LOV, mais le curseur reste à sa place.
Cette propriété peut être changée à l'exécution en utilisant la fonction Set_Item_Property(nom_lov | id_lov, AUTO_SKIP, PROPERTY_TRUE | PROPERTY_FALSE )
Position automatique indique si le positionnement à l'affichage est géré par l'application ou s'il doit tenir compte des propriétés Position X et Position Y.
Largeur de colonne automatique indique si Forms adapte la largeur des colonnes de la LOV en fonction de la plus grande largeur, ou s'il utilise les propriétés fixées dans la fenêtre de correspondance de colonnes.


Physique

Position X indique dans le système de coordonnées en cours la position en abscisse du coin supérieur gauche de la LOV
Position Y indique dans le système de coordonnées en cours la position en ordonnée du coin supérieur gauche de la LOV
Ces deux propriétés peuvent être changées à l'exécution en utilisant la fonction Set_Lov_Property(nom_lov | id_lov, POSITION, position_x, position_y )

Largeur indique dans le système de coordonnées la largeur de la LOV
Hauteur indique dans le système de coordonnées la hauteur de la LOV
Ces deux propriétés peuvent être changées à l'exécution en utilisant la fonction Set_Lov_Property(nom_lov | id_lov, LOV_SIZE, largeur, hauteur )


Utilisation d'une LOV pour valider un item

Il est possible, lorsqu'une LOV est attachée à un item de l'utiliser pour valider le contenu de l'item.
Pour ce faire, il suffit de positionner à Oui la propriété de l'item : Valider à partir de la liste.
Toute valeur saisie dans cet item qui n'est pas retrouvée dans la LOV ne sera pas acceptée.
Ce fonctionnement évite d'avoir à saisir du code supplémentaire pour valider la saisie.

Rappel : seule la première colonne de la LOV est utilisée pour valider la valeur saisie.


Fonctions natives liées à l'utilisation d'une LOV

Fonctions liées à une LOV

Varchar2 = Get_Lov_Property( nom_lov | id_lov , nom_propriété ) ;
Set_Lov_Property( nom_lov | id_lov , nom_propriété, valeur [,valeur] ) ;
nom_propriété peut être:

• AUTO_REFRESH (TRUE | FALSE)
• GROUP_NAME (nom du groupe d'enregistrements)
• HEIGHT (hauteur)
• WIDTH (largeur)
• X_POS (position x)
• Y_POS (position y)

Lov = Find_Lov( nom_lov ) ;
Cette fonction retourne l'identifiant interne de la LOV dont le nom est passé en argument.
La valeur de retour peut être testée avec la fonction Id_Null() qui retourne TRUE ou FALSE

Declare
  Lv_id  Lov ;
Begin
 Lv_Id := Find_Lov( 'ma_lov' ) ;
 If Id_Null( Lv_Id ) Then
   Message('La LOV : ma_lov n''existe pas' );
   Raise Forms_trigger_failure ;
End if ;
End ;

Fonctions liées à une colonne d'une LOV

Varchar2 = Get_Lov_Column_Property( nom_lov | id_lov , numéro_colonne, nom_propriété ) ;
Set_Lov_Column_Property( nom_lov | id_lov , nom_propriété, numéro_colonne, valeur ) ;

nom_propriété peut être:

• TITLE (libellé de la colonne)
• WIDTH (largeur de la colonne)

Boolean Show_Lov( nom_lov | id_lov [, position x, position y] ) ;
Cette fonction déclenche l'affichage de la LOV dont le nom est passé en argument.
Il est possible d'indiquer également les coordonnées X et Y de positionnement du bord supérieur gauche de la fenêtre.

Declare
  LB$Ok  Boolean ;
Begin
  LB$OK := Show_Lov( 'ma_lov' ) ;
  If not LB$Ok Then
    Message('Vous n'avez sélectionné aucune valeur');
    Raise Form_Trigger_Failure ;
  End if ;
End ;

Fonctions liées à un groupe d'enregistrements

Find_Group()
Create_Group()
Create_group_From_Query()
Add_Group_Column()
Add_Group_Raw()
Populate_Group()
Populate_Group_From_Query()
Get_Group_Char_Cell()
Get_Group_Date_Cell()
Get_Group_Number_Cell()
Get_Group_Record_Number()
Get_Group_Row_Count()
Get_Group_Selection_Count()
Get_Group_Selection()

Les fonctions liées au groupe d'enregistrements sont détaillées dans le chapitre : Les groupes d'enregistrements.


Fonctions liées à un item

Varchar2 = Get_Item_Property( nom_item | id_item , nom_propriété ) ;
Set_Item_Property( nom_item | id_item , nom_propriété, valeur ) ;
nom_propriété peut être:

• AUTO_SKIP (TRUE | FALSE)
• LOV_NAME (nom de la LOV)
• LOV_X_POS (position X de la LOV)
• LOV_Y_POS (position Y de la LOV)
• VALIDATE_FROM_LIST (TRUE | FALSE )

List_Values( [ RESTRICT | NO_RESTRICT ] ) ;
Permet de forcer l'affichage d'une LOV sur l'item en cours lorsqu’une LOV lui est attachée.
RESTRICT permet de tenir compte de la valeur actuelle de l'item afin de restreindre la liste. Si celle-ci ne ramène plus qu'une seule valeur, elle n'est pas affichée et retourne cette valeur dans l'item.


Déclencheur lié à une LOV

KEY_LISTVAL
Permet d'intercepter la demande d'affichage de la LOV et d'exécuter le code voulu avant son affichage par List_Values() ou Show_Lov().

C'est le déclencheur idéal pour construire ou associer dynamiquement un groupe d'enregistrements différent à la LOV.


Manipulation au cours de l'exécution

Il n'est pas possible de créer une LOV au cours de l'exécution. Celle-ci doit avoir été préalablement créée lors de la conception.
Toutefois, le groupe d'enregistrements qui l'alimente peut faire l'objet d'un certain nombre de manipulations.

Ce que vous pouvez faire en cours d'exécution:

• Changer le titre de la LOV, ses dimensions et son positionnement
• Modifier le titre et la largeur d'affichage de chacune des colonnes de la LOV
• Attacher un autre groupe d'enregistrements existant
• Rafraîchir le groupe d'enregistrements
• Créer dynamiquement un groupe d'enregistrements et l'attacher à la LOV

Cas d'école : Gestion dynamique d'un groupe d'enregistrements

En fonction des éléments saisis dans l'écran par l'utilisateur, notre LOV doit afficher des données qui ne proviennent par toujours de la même table.
Le nombre et le nom des tables visées n'étant pas figés, nous ne pouvons pas créer au moment du design autant de groupes d'enregistrements que nécessaire.

Nous allons donc créer le groupe d'enregistrements dynamiquement au cours de l'exécution, le remplir et l'attacher à la LOV avant son affichage.

La procédure suivante : Build_Group() accepte trois arguments :

• Le nom de la table
• Le nom de la colonne contenant le code
• Le nom de la colonne contenant le libellé

Elle peut être invoquée depuis un déclencheur Key-Listval sur l'item :

Begin
  If ... Then
     Build_Group( 'Table1', 'code','Libelle' ) ;
  Else
     Build_Group( 'Table2', 'id','nom' ) ;
  End if ;
End ;

-- Unité de programme : Build_Group --
PROCEDURE Build_Group
  (
   PC$Nom_table IN VARCHAR2,
   PC$Nom_colonne_1 IN VARCHAR2,
   PC$Nom_colonne_2 IN VARCHAR2
  )
 IS
  LC$Req Varchar2(512) ; -- chaîne d'accueil de la requête
  RG_NAME Varchar2(15) := 'RG_GROUP' ; -- Nom du groupe
  rg_id RecordGroup ; -- Identifiant interne du groupe
  errcode NUMBER ; -- code retour
  LB$Ok Boolean ;
BEGIN
  -- constitution de la requête --
  LC$Req := 'Select ' 
          || PC$Nom_colonne_1 || ',' 
          || PC$Nom_colonne_2 || ' From ' 
          || PC$Nom_table || ' order by 1' ;

  -- recherche de l'identifiant interne du groupe --
  rg_id := Find_Group( rg_name );
  IF Not Id_Null(rg_id) THEN
    -- il existe déjà, on le supprime --
    Delete_Group( rg_id ) ;
  Else
    -- création du groupe --
    rg_id := Create_Group_From_Query( rg_name, LC$Req ) ;
  End if ;

  -- remplissage du groupe --
  errcode := Populate_Group( rg_id );

  -- Attachement du groupe à la LOV --
  Set_Lov_Property( 'ma_lov', GROUP_NAME, rg_id ) ;

  -- Ajustement du titre de la LOV --
  Set_Lov_Property( 'ma_lov', TITLE, 'Le titre de la LOV' ) ;
 
  -- Ajustement des colonnes de la LOV --
  Set_Lov_Column_Property( 'ma_lov', 1, TITLE, 'Code' ) ;
  Set_Lov_Column_Property( 'ma_lov', 1, WIDTH, 30 ) ;

  Set_Lov_Column_Property( 'ma_lov', 2, TITLE, 'Libellé' ) ;
  Set_Lov_Column_Property( 'ma_lov', 2, WIDTH, 110 ) ;

  -- Affichage de la LOV --
  LB$OK := Show_Lov( 'ma_lov' ) ;

END;

Un paramètre Forms est une variable typée permettant de transmettre une valeur lors de l'appel de cette forme (par mécanisme d'appels interformes ou depuis la ligne de commande).

Il s'agit donc d'un mécanisme de passage de valeur entre plusieurs formes.
Le passage reste toutefois mono directionnel.
Un paramètre est transmis par la forme appelante vers la forme appelée, mais sa valeur ne peut pas être récupérée par la forme appelante.

Un paramètre doit avoir été explicitement défini dans une forme pour pouvoir être passé par la forme appelante et interprété par la forme appelée.

Son domaine de visibilité est restreint à la forme qui le contient.

Un paramètre peut être de l'un des trois types suivants:

• CHAR (longueur maxi : 64Ko)
• NUMBER
• DATE

La valeur d'un paramètre peut être lue, mais aussi modifiée dans la forme.

Ce mécanisme permet de transmettre un ou plusieurs paramètres à une forme appelée via les instructions CALL_FORM(), OPEN_FORM() et NEW_FORM()

Plusieurs paramètres peuvent être transmis d'un coup à la forme appelée via les fonctions natives de gestion de liste de paramètres.

Il n'y a pas de limite au nombre de paramètres pouvant être créés dans un module.

Création d'un paramètre

Cliquer sur le nœud : Paramètres dans le navigateur d'objets.
Un nouveau paramètre est créé avec un nom attribué par le système.

Faire un double-clic sur le nœud du nouveau paramètre pour afficher la palette de propriétés.

La propriété : Longueur maximum est réservée aux paramètres de type Char et ne peut, dans ce cas excéder 64 Ko
Une valeur initiale peut être appliquée. C'est cette valeur qui sera conservée par la forme si ce paramètre n'est pas transmis explicitement par la forme appelante.


Dupliquer un Paramètre

Pour dupliquer un paramètre existant, cliquez le paramètre que vous voulez dupliquer et tapez Ctrl-D au clavier. (ou menu : Edition->Dupliquer)


Modifier la valeur d'un paramètre à l'exécution

Vous pouvez modifier la valeur d'un paramètre à tout moment comme celle d'un item ou d'une variable globale.

Le nom du paramètre doit être préfixé avec :PARAMETER

Si votre paramètre s'intitule : DATE_ENTREE, vous pouvez interroger cette valeur avec la syntaxe suivante:
Var_locale := :PARAMETER.DATE_ENTREE ;

Et le modifier de la façon suivante:
:PARAMETER.DATE_ENTREE := nouvelle_valeur ;

Évidemment, la valeur doit correspondre en type avec celui du paramètre.


Mécanisme de transmission des paramètres

Les paramètres sont transmis à la forme appelée via une liste de paramètres.

Un objet de type liste de paramètres doit être créé, puis les paramètres doivent être ajoutés à cette liste.

Nous souhaitons transmettre à la forme appelée les deux paramètres suivants:

• Le numéro de client (NUMBER)
• Une date de commande (DATE)

La forme appelée contient deux paramètres pour accueillir ces valeurs:

• NUM_CLI pour le numéro client
• DATE_CDE pour la date de commande

Dans le déclencheur qui servira de support à l'appel de la nouvelle forme, nous créons une variable de type liste de paramètres et lui affectons les valeurs correspondantes :

-- Code PL/SQL d'appel de la forme 'FACTURES'
DECLARE 
   List_id ParamList; -- variable de type liste de paramètres
BEGIN 
  -- création de la liste --
  List_id := Create_Parameter_List('param_list'); 

  -- ajout à la liste du numéro client --
  Add_Parameter(List_id, 'NUM_CLI',TEXT_PARAMETER, :BLOC.NUM_CLI); 
  
  -- ajout à la liste de la date de commande --
  Add_Parameter(List_id, 'DATE_CDE', TEXT_PARAMETER, To_char( SYSDATE, 'DD/MM/YYYY' );  

  -- Appel de la nouvelle forme avec la liste de paramètres --
  Open_Form( 'FACTURES', ACTIVATE, NO_SESSION, List_id );
End;

Fonctions natives relatives aux paramètres

Ajout d'un paramètre à une liste
ADD_PARAMETER( nom_liste | id_liste, nom_param, type_param, valeur ) ;

Création d'une liste de paramètres
CREATE_PARAMETER_LIST( nom_liste ) ;

Une liste de même nom ne peut pas déjà exister dans la forme. Si tel est le cas, vous devez d'abord la supprimer avec la fonction Destroy_Parameter_List()

Suppression d'un paramètre à la liste
DELETE_PARAMETER( nom_liste | id_liste, nom_param ) ;

Delete_Parameter( 'param_list', 'NUM_CLI' ) ;

Destruction d'une liste de paramètres
DESTROY_PARAMETER_LIST(nom_liste | id_liste ) ;

Declare 
   pl_id ParamList; 
Begin 
   pl_id := Get_Parameter_List('param_list'); 
   If NOT Id_Null(pl_id) Then
      Destroy_Parameter_List(pl_id); 
   End if; 
End;

Lecture du type de paramètre et de sa valeur
GET_PARAMETER_ATTR( nom_liste | id_liste, nom_param, type_param, valeur ) ;
type_param et valeur sont des variables de type OUT

Declare
  List_id  ParamList;
  LN$Type  NUMBER ;
  LC$Val   VARCHAR2(1000);
Begin
   List_id := Get_Parameter_List('param_list');
   Get_Parameter_Attr( list_id, 'NUM_CLI', LN$Type, LC$Val ) ;
   Message('La valeur de NUM_CLI est : ' || LC$Val ) ;
End ;

Le contenu de la variable numérique LN$Type peut prendre l'une des constantes suivantes:

• DATA_PARAMETER
• TEXT_PARAMETER

Récupération de l'identifiant interne d'une liste de paramètres
GET_PARAMETER_LIST( nom_liste ) ;

Modification du type et/ou de la valeur d'un paramètre existant dans la liste
SET_PARAMETER_ATTR( nom_liste | id_liste, nom_param, type_param, valeur ) ;
nom_liste représente un littéral ou une variable de type VARCHAR2 indiquant le nom donné à la liste lors de sa création. ( la valeur DEFAULT est réservée à Forms et ne peut être utilisée pour nommer une liste).
id_liste est l'identifiant interne le la liste, pouvant être obtenu avec la fonction Get_Parameter_List()
nom_param représente un littéral ou une variable de type VARCHAR2 indiquant le nom donné au paramètre
type_param est de type Varchar2 et peut prendre l'une des deux valeurs suivantes:

• TEXT_PARAMETER pour transmettre une valeur simple
• DATA_PARAMETER pour transmettre le nom d'un groupe d'enregistrement (uniquement pour l'appel d'objets Graphics ou Reports)

valeur représente un littéral, une variable ou un objet Forms.

Les paramètres peuvent être transmis entre différentes formes via les listes de paramètres.

Ils peuvent également être transmis dans une ligne de commande ou via une section du fichier de configuration formsweb.cfg

Transmission depuis la ligne de commande
ifweb90 MODULE=FACTURES USERID=scott/tiger NUM_CLI=12859 DATE_CDE=« 10/10/2004 »

Transmission via le fichier de configuration formsweb.cfg

Les paramètres peuvent être transmis à la forme par l'intermédiaire du fichier de configuration formsweb.cfg via le mot-clé : otherparams

Si vous devez référencer le contenu d'un paramètre depuis un menu ou une procédure de librairie PL/SQL, utilisez la fonction Name_In().

-- Procédure en librairie PL/SQL --
...
If Name_In( 'PARAMETER.NUM_CLI' ) = 25698 Then
   ...
End if;
...

Forms maintient automatiquement, pour chaque forme, une liste de paramètres par défaut nommée DEFAULT (raison pour laquelle vous ne pouvez pas créer une liste qui porte ce nom).

Cette liste défaut contient la liste des paramètres actuels de la forme et peut être transmise comme n'importe quelle autre liste.