Module 8 Les Déclencheurs

Transcription

1 Structure d un déclencheur Types d événements déclencheurs Propriétés d un déclencheur Validation des données Les programmes pilotés par événement, tels que Forms, exécutent la logique de programme en réponse à quelque chose qui s est produit. La logique de programme qui répond à un événement est un déclencheur ou trigger. On dit qu un déclencheur «déclenche» quand il est exécuté en réponse à un événement. Forms possède un ensemble prédéfini d événements, de triggers et par défaut, de comportements. Si vous créez un simple formulaire sans aucun trigger, son comportement par défaut permet à l utilisateur d effectuer des opérations de base telles que l insertion, la mise à jour et la suppression de données. Pour ajouter une fonctionnalité à celle par défaut du formulaire vous devez créer des déclencheurs additionnels. Quand vous créez un déclencheur qui se déclenche en fonction d un événement, vous devez également considérer sa portée. Les déclencheurs peuvent être définis pour être déclenchés pour un événement d un élément, d un bloc ou d un niveau formulaire. Structure de base des déclencheurs Pour créer un trigger, sélectionnez le nœud Triggers dans le Navigateur Object Navigator de Form Builder pour la portée appropriée (formulaire, bloc de données ou éléments). La figure suivante montre la position des nœuds trigger du niveau formulaire, du niveau bloc et du niveau élément. OUTILS DE QUATRIÈME GÉNÉRATION

2 Composition d un déclencheur Les déclencheurs sont donc des mécanismes qui permettent de modifier et contrôler le comportement d une forme. Ce sont des programmes PL/SQL qui sont exécutés suite à un événement, par exemple : Une requête Une saisie de données Un déplacement du curseur/souris dans la forme Une interaction avec le clavier/souris Une erreur ou un message Un événement interne de la forme Le nom du déclencheur détermine l événement qui déclenchera son exécution. Oracle Forms offre une gamme de plusieurs déclencheurs prédéfinis. Les éléments à prendre en considération lors de la construction d un déclencheur sont : le type d événement déclencheur, les instructions du déclencheur et le niveau d exécution. 8-2 OUTILS DE QUATRIÈME GÉNÉRATION

3 Les types d événements déclencheurs La première partie du nom du déclencheur (préfixe) indique quand le corps du trigger s exécute relativement à l événement. Les noms prédéfinis de trigger commencent par : PRE- : Ces triggers se déclenchent juste avant que l événement se produise. Par exemple avant d effectuer une requête (PRE-QUERY), avant d enregistrer dans la base de données (PRE-COMMIT), etc. POS- : Permet d exécuter un traitement lorsqu une action est complétée. Par exemple, après avoir inséré un enregistrement dans la base de données (POST-INSERT),avant de quitter la forme (POST-FORM), etc. WHEN- : Permet d augmenter les fonctionnalités de l action en exécutant le déclencheur en même temps. Par exemple, lorsqu une fenêtre est activée (WHEN-WINDOW- ACTIVATED), lorsque l utilisateur clique sur le bouton (WHEN-BUTTON-PRESSED), etc. ON- : Permet de remplacer le traitement fait habituellement lors d une action. Par exemple, pour remplacer le message d erreur par défaut (ON-ERROR) ou un message (ON-MESSAGE), etc. KEY- : Permet de remplacer le traitement fait habituellement avec une clé de fonction. Les instructions du déclencheur Les instructions du déclencheur correspondent au résultat lors de l exécution du programme. Elles sont définies avec l éditeur PL/SQL. Le niveau d exécution Le niveau d exécution identifie le moment où sera déclenché le programme. Il est déterminé en fonction de l objet auquel il est rattaché. Les trois niveaux possibles sont : Niveau du module Form : Le déclencheur est défini au niveau du module Form, ce qui veut dire qu il peut être déclenché avec des événements de toute la Form. Niveau Bloc : : Le déclencheur est défini au niveau du bloc, ce qui veut dire qu il peut être déclenché uniquement lorsque ce bloc est actif. Niveau élément : Le déclencheur est défini au niveau d un élément, ce qui veut dire qu il peut être déclenché uniquement lorsque l élément est actif. OUTILS DE QUATRIÈME GÉNÉRATION

4 Dans cette section, nous allons examiner une exploitation possible d un déclencheur dans le formulaire JOUET pour rendre plus robuste notre application. 1. Ouvrez le formulaire TOYSTORE basé sur la table JOUET Dans cette application, le champ Toy_id est la clé primaire pour la table JOUET. Oracle ne permet pas d avoir deux enregistrements dans la table JOUET avec le même Toy_id. Les étapes suivantes illustre le fonctionnement : 2. Exécuter le formulaire JOUET basé sur la table JOUET 3. Retrouver l enregistrement qui possède comme Toy_id le numéro Sélectionner dans le menu Record Insert pour créer un nouvel enregistrement 5. Sélectionner dans le menu Record Duplicate pour créer une copie identique à l enregistrement dont le Toy_id est Si vous essayer de faire un commit (menu Action Save) sur le nouvel enregistrement, un message d erreur s affiche «FRM : ORACLE error : unable to Insert Record». 7. Quitter le mode Run-time et Retorner dans le mode design du formulaire. 8-4 OUTILS DE QUATRIÈME GÉNÉRATION

5 Ce type de comportement peut être acceptable si L utilisateur sauvegarde chaque enregistrement au moment même de la modification ou de l insertion. Mais ce n est pas toujours le cas. Supposons que l utilisateur insère cinq enregistrements avant de faire le commit, toute la transaction va échouer, même s il y a juste un enregistrement qui viole l intégrité référentielle. On peut résoudre ce problème en utilisant un déclencheur qui permet de vérifier l existence d un doublon au moment où l enregistrement est validé. Un enregistrement est validé quand l utilisateur quitte cet enregistrement. Les étapes pour créer ce déclencheur sont les suivantes : 1. Dans Object Navigator, placez-vous sur le nœud JOUET et cliquer sur le bouton droit de la souris 2. Sélectionnez Smart Triggers Other 3. L éditeur PL/SQL est alors affichée OUTILS DE QUATRIÈME GÉNÉRATION

6 4. Taper le code suivant dans cette fenêtre, Ensuite cliquez sur le bouton Compile 8-6 OUTILS DE QUATRIÈME GÉNÉRATION

7 Propriétés d un déclencheur Name : Identifie le nom du déclencheur. Il peut être remplacé par un autre de la liste déroulante. Trigger text : Correspond au bloc PL/SQL. La fenêtre de l éditeur PL/SQL s affiche. Trigger style : La seule valeur possible est PL/SQL. Fire in entry query mode : Le déclencheur est toujours exécuté en mode normal. Cette propriété permet de déclencher le programme en mode query également. Execution hierarchy : Permet de spécifier le niveau d exécution lorsque le même déclencheur est défini à plusieurs niveaux. Override signifie que seulement le niveau du déclencheur sera exécuté. After et Before signifient que le déclencheur sera exécuté après ou avant le déclencheur du niveau supérieur. Seulement l exécution du déclencheur du niveau supérieur qui porte le même nom sera déclenché. Les sous-programmes intégrés (Built-in packages) Les sous-programmes intégrés sont des procédures et des fonctions qui sont préprogrammées dans Forms et qui sont disponible pour la construction des blocs PL/SQL. Ils sont listés sous le type d élément Built-in package dans la fenêtre de navigation. OUTILS DE QUATRIÈME GÉNÉRATION

8 Il existe plus de 100 sous-programmes. Certains permettent de naviguer à travers la forme (ex. :go_block,next_record), certains permettent de manipuler les données (ex. :clear_record,execute_query),certains permettent de contrôler l affichage (ex. : move_windows,show_lov),certains permettent de manipuler les interfaces de contrôle (ex. :checkbox_checked,add_list_element). Tous comme les fonctions SQL qui sont définis dans le paquet standard, les sous-programmes définis dans le paquet standard de Forms ne nécessitent pas le préfixe du nom du paquet. Les variables L utilisation des variables est également permise dans les blocs PL/SQL : La référence à une variable doit être préfixée du caractère «:» EX. : :JOUET.toy_id Variable globale : Comprend les variables reliées à l emmagasinage de données. Le mot réservé GLOBAL doit préfixer le nom de la variable. Les variables globales sont définis la première fois qu elles sont assignées et elles restent en mémoire pour toute la session de l utilisateur, à mois qu elles soient volontairement enlevées. o Default_value pour initialiser une variable globale avec une valeur par défaut Ex. : Default_value( 100, global.entrepot ) ; Erase permet de détruire une variable globale Ex. : Erase ( global.entrepot ) ; Variable du système : Pour obtenir de l information sur la localisation du curseur, sur l état de la forme, sur l état du bloc, etc. :SYSTEM.nom_de_la_variable Résultat du déclencheur Le résultat suite à l exécution d un déclencheur est toujours un résultat ou un échec. L échec survient lorsqu il y a une exception qui n est pas traitée dans le bloc PL/SQL. Par exemple, un curseur implicite qui retourne plusieurs rangées, l exception TOO_MANY_ROWS sera levée, si elle n est pas traitée, alors il y aura une erreur qui fera échouer le déclencheur. L échec du déclencheur peut également être contrôlé avec l exception Form_trigger_failure. Pour évaluer le résultat d une instruction, par exemple l appel d un sous programme, les fonctions suivantes sont utilisées : Form_success : Retourne vrai si la dernière action s est terminée avec succès, sinon elle retourne Faux. 8-8 OUTILS DE QUATRIÈME GÉNÉRATION

9 Form_failure : Retourne vrai s il y a eu une erreur non fatale et elle retourne faux si l action s est terminée avec succès ou s il y a eu une erreur fatale. Form_fatal : Retourne vrai s il y a eu une erreur fatale, dans les autre cas, elle retourne faux. Ex. : go_block( employe ) ; If form_success then Execute_Query; End if Pour determiner l erreur survenue suite à une instruction, les fonctions suivantes sont utilisées : Événements déclencheurs Error_code : Retourne le numéro interne de l erreur en format numérique. Error_text : Retourne la description de l erreur sous forme d une chaîne de caractères. Error_type : Retourne FRM si c est une erreur interne de Forms ou ORA si c est une erreur interne du serveur. Les événements déclencheurs sont trop nombreux pour les expliquer. Consultez l aide en ligne pour connaître l ensemble de tous les déclencheurs, leurs descriptions ainsi que des exemples d utilisation. Le tableau ci-dessous présente les déclencheurs les plus fréquemment utilisés. Déclencheur Événement Traitement de bloc When-create-record When-clear-block When-remove-record Interface When-button-pressed When-windows-activated Lorsqu un nouvel enregistrement est crée Lorsque les rangées d un bloc sont effacées Lorsque une rangée est supprimée ou effacée. Lorsque l utilisateur clique sur le bouton, Par exemple pour naviguer vers un autre bloc ou pour afficher une liste de valeur. Lorsque la fenêtre est activée. When-checkbox-changed Lorsque l utilisateur change l état de la boîte à OUTILS DE QUATRIÈME GÉNÉRATION

10 cocher When-image-pressed Validation When-validate-item When-validate-record Lorsque l utilisateur clique sur l image Ces déclencheurs permettent d ajouter des fonctionnalités aux éléments. Navigation Pre-form et Post-form Pre-block et Post-block Interrogation Pre-query Post-query Manipulation des messages On-error On-message Ces déclencheurs sont exécutés lors du démarrage de la forme ou lorsque l utilisateur quitte la form. Ces déclencheurs sont exécutés avant d activer le premier élément du bloc ou avant de quitter le bloc. Ce déclencheur est exécuté avec la fonction Execute query et juste avant de transmettre la commande Select au serveur. Ce déclencheur est exécuté pour chacune des rangées qui est retournée suite à une requête. Ce déclencheur est exécuté lorsqu une erreur survient. Il est utilisé pour afficher un autre message d erreur ou pour exécuter un autre traitement à partir d une erreur spécifique. Pour remplacer un message issue par le système. Validation des données Oracle Forms effectue des validations à différents niveaux. Lorsque la validation d un niveau échoue, le contrôle est alors retourné à ce niveau pour que l utilisateur puisse apporter les modifications nécessaires. Les validations effectuées sont dans l ordre suivant : Niveau de l élément : La première validation consiste à vérifier si la valeur saisie pour l élément est conforme aux propriétés définies. Par exemple, le masque d édition, le type de données, les valeurs permises, les valeurs obligatoires, etc. Suite à ces validations. Forms exécute le déclencheur When-validate-item, s il y en a un défini OUTILS DE QUATRIÈME GÉNÉRATION

11 Niveau d enregistrement : Cette validation consiste à vérifier si les données de la rangée sont valides. Par la suite, si le déclencheur When-validate-record est défini, il est alors exécuté. WHEN-VALIDATE-ITEM Ce déclencheur est le plus fréquemment utilisé, il permet de : Définir une validation plus complexe qu avec les propriétés Chercher l information nécessaire pour des éléments dont la valeur est dérivée Au niveau élément, il est déclenché lorsque : L utilisateur change la valeur de l élément (incluant NULL) Un autre déclencheur modifie la valeur de l élément L exécution du programme se fait immédiatement lorsque le curseur quitte l élément. EX. : Select Toy_name Into :JOUET.toy_name From JOUET Where toy_id = :JOUET.toy_id; Exception When no_data_found then Message ( le numero du jouet est inexistant ) ; Raise form_trigger_failure ; When others then Message (sqlperm); S il n y a pas de traitement d exception, le message suivant sera affiché lorsque le déclencheur échoue : FRM trigger raised unhandled exception. WHEN-VALIDATE-RECORD Ce déclencheur s exécute lorsqu un enregistrement a été modifié et que le curseur passe à un autre enregistrement. Il est utilisé lorsqu une validation implique plus d un élément. OUTILS DE QUATRIÈME GÉNÉRATION