Exécuter et déboguer Oracle Forms 12C

Lorsqu’une erreur survient pendant le développement d’une application dans Oracle Form Builder, il faut comprendre d’où elle provient.

L’option DEBUG

Oracle Form Builder 12c apporte plusieurs nouveautés, surtout dans le menu principal et la barre d’outils. L’une d’elles, l’option Debug, peut s’avérer très utile. L’option DEBUG a été ajoutée au menu principal de Forms Builder :

Menu Debug dans le menu principal d’Oracle Forms Builder 12c

Comment utiliser l’option DEBUG

Comment utiliser cette option? Suivez les étapes ci-dessous :

Indiquez l’URL de l’application dans les préférences d’Oracle Form Builder
Insérez des points d’arrêt dans votre module avec Oracle Form
Générez le fichier d’exécution de votre module et enregistrez-le dans le chemin requis.
Exécutez votre application sur le serveur WebLogic en ajoutant le paramètre debug.
Notez le nom d’hôte et le numéro de port pendant l’exécution de votre module.
Attachez le débogueur à votre module en saisissant le nom d’hôte et le numéro de port dans la fenêtre contextuelle d’Oracle Form Builder.

C’est tout. Voyons maintenant ces étapes plus en détail.

1. Option Debug - Runtime Preferences

Votre application doit être indiquée dans les Runtime Preferences. Ouvrez la fenêtre des préférences par le menu EDIT-> Preferences… Ajoutez ensuite l’URL de votre application dans l’onglet Runtime et cliquez sur OK.

Onglet Runtime des préférences de Forms Builder avec l’URL du serveur d’applications

2. Option Debug – Insérer ou retirer des points d’arrêt

Insérez des points d’arrêt dans votre module avec Oracle Form Builder

Comment? Dans Oracle Form Builder, sur votre poste de développement, ouvrez votre module, cliquez avec le bouton droit sur le numéro de la ligne où vous voulez lancer le débogage, puis cliquez sur Insert/Remove Breakpoint.

Points d’arrêt marqués en rouge à côté de lignes PL/SQL dans l’éditeur de Forms Builder

3. Option Debug – Fichiers d’exécution et chemin

Générez le fichier d’exécution de votre module et enregistrez-le dans le chemin requis.

Dossier contenant la source .fmb du module et son fichier .fmx généré

4. Option Debug – URL et paramètres

Exécutez votre application sur le serveur WebLogic en ajoutant le paramètre debug, comme suit :

Le nom du module doit être déclaré : &form=customers_demo.fmx
Le paramètre debug doit être réglé à Yes : &debug=yes

http://localhost:9001/forms/frmservlet?config=demo_ren&form=customers_demo.fmx&deb ug=yes

URL de l’application Forms dans le navigateur, terminée par debug=yes

5. Option Debug – URL et paramètres

Notez le nom d’hôte et le numéro de port pendant l’exécution de votre module. Une fois l’application lancée, ces fenêtres contextuelles affichent les paramètres Host et Port :

Fenêtre Forms indiquant le nom d’hôte et le port à saisir dans la boîte Attach Debug

6. Option Debug – Attach Debug

En parallèle, dans Oracle Form Builder, cliquez sur l’option "Attach Debug" du menu Debug. Form Builder ouvre alors cet écran, où vous devez saisir dans la fenêtre Attach Debug les mêmes informations que celles fournies par la fenêtre contextuelle précédente.

Boîte Attach Debug de Forms Builder avec le nom d’hôte et le numéro de port renseignés

Option Debug – Mode débogage

Avancez ensuite dans votre application jusqu’à la section du module où vous voulez examiner l’erreur. Le débogueur interrompt l’exécution du module à la ligne de code qui contient le point d’arrêt.

Forms Builder arrêté sur un point d’arrêt en mode débogage

Oracle Form Builder vous permet alors de déboguer votre code ligne par ligne sur votre poste de développement pour trouver l’erreur, pendant que l’application s’exécute, même sur le serveur WebLogic.

Vous pouvez avancer pas à pas avec F7 ou, pour sauter certaines parties du code, utiliser les autres options proposées ici.

Forms Builder déboguant le code ligne par ligne, fenêtres de débogage ouvertes

Option Debug – Exécution pas à pas

Comment utiliser l’exécution pas à pas (Debug Stepping)?

Boutons de la barre de débogage : Go, Step into, Step over, Step out, Pause et Stop

Commande	Raccourci
Go	`F9`
Step into	`F7`
Step over	`F8`
Step out	`Maj`+`F7`
Pause	–
Stop	–

Voici une image détaillée qui illustre chaque option de débogage et ses effets :

Illustration du déplacement dans le code pour chaque option de pas à pas

Option Debug – Console de débogage

La console de débogage comprend plusieurs fenêtres utiles pour analyser plus en profondeur vos informations.

Stack
Form values
Watch window
Variables
Breakpoints
Global/System variables
PL/SQL Packages

Console de débogage avec ses fenêtres Stack, Variables, Watch, Form Values, PL/SQL Packages et Breakpoints

Option Debug – Fenêtre Stack

La fenêtre Stack : elle permet de suivre les Stack Frames.

Fenêtre Stack affichant le cadre de pile courant

Option Debug – Form Values

La fenêtre Form Values : elle affiche toutes les valeurs initialisées dans les items et les paramètres de votre formulaire; lorsque vous passez sur la ligne de code qui initialise ces items et paramètres, vous y voyez aussi leurs nouvelles valeurs.

Fenêtre Form Values listant les éléments du bloc CUSTOMERS et leurs valeurs

Option Debug – Fenêtre Watch

La fenêtre Watch : vous pouvez y définir une variable pour suivre la valeur qui lui est attribuée à mesure que vous avancez dans le code.

Fenêtre Watch suivant la valeur de la variable FILENAME

Option Debug – Fenêtre Variables

La fenêtre Variables : elle affiche toutes les variables définies dans la section déboguée; lorsque vous passez sur la ligne de code qui initialise ces variables, vous y voyez aussi leurs nouvelles valeurs.

Fenêtre Variables avec la variable FILENAME, sa valeur et son type

Option Debug – Fenêtre PL/SQL Packages

La fenêtre PL/SQL Packages : elle présente la liste des packages PL/SQL et de leurs valeurs.

Fenêtre PL/SQL Packages

Option Debug – Fenêtre Global/System Variables

La fenêtre Global/System Variables : elle présente la liste des variables globales ou système.

Fenêtre Global/System Variables listant des variables système comme CURRENT_BLOCK

Option Debug – Fenêtre Breakpoints

La fenêtre Breakpoints : elle présente la liste de vos points d’arrêt avec le code source et le numéro de ligne, et vous permet aussi de les modifier.

Fenêtre Breakpoints listant chaque point d’arrêt avec sa source et son numéro de ligne