Historique de navigation vers une page accédée par différentes pages parents

Transcription

1 APEX Historique de navigation vers une page accédée par différentes pages parents P.-A. Sunier, Haute Ecole Arc, Neuchâtel avec le concours de A. Berkani & J. Greub 20 avril 2010 Table des matières 1 Problème Solution initiale Principe Réalisation de la solution initiale Création du témoin de navigation Création des 2 régions Affectation du témoin de navigation Solution optimalisée Principe Réalisation de la solution optimalisée Historiques d accès Création du témoin de navigation Affectation du témoin de navigation Création d une deuxième région d historique de navigation Affichage dynamique de la région d historique de navigation Variantes et améliorations Historique des accès au sein de la page Navigation de retour Liens utiles Note de lecture Cet article a été réalisé avec la version d APEX et nous nous sommes inspirés d un blog accessible à l adresse suivante pour la solution initiale: Nous avons écrit cet article, en nous limitant à l essentiel et en postulant que le lecteur a une connaissance minimale d APEX. Article - 1/14- Novembre 2009

2 1 Problème La page 41 de l exemple de la Figure 1 peut être accédée aussi bien par la page 21 que par la page Il faudrait que l information d historique de navigation indique une première fois : Figure 1 - Page 41 appelée par la page 21 ou par la page 13 Page 20 > Page 21 > Page 41 Et une deuxième fois: Page 12 > Page 13 > Page 41 Pour afficher l historique de navigation comme nous venons de le décrire, il faut que l information se construise dynamiquement lors de la navigation. Malheureusement, APEX nous oblige à définir l historique de navigation statiquement lors de la conception des pages ; la page appelée, la 41 de notre exemple, doit être associée à la page appelante mais, c est impossible car elle est appelée indifféremment par la 21 ou la 13. Page appelée Page appelante Figure 2 - Définition statique à la conception de l'historique de navigation Article - 2/14- Novembre 2009

3 2 Solution initiale 2.1 Principe Une solution élégante à ce problème consiste à : Ne pas mettre d historique de navigation standard APEX pour la page 41. Créer 2 régions, au sein de la page 41, qui contiendront les informations d historique de navigation pour la page 21 d une part et pour la page 13 d autre part. Créer un élément d application qui servira de témoin de passage par la page 21 ou 13 lors de la navigation. Lors de l exécution des pages 21 et 13, affecter le témoin de navigation. Lors de l exécution de la page 41, rendre visible l une des deux régions en fonction de la valeur du témoin de navigation. 2.2 Réalisation de la solution initiale Création du témoin de navigation Nous avons créé l élément d application PARENTAPPGROUPES qui nous servira de témoin de navigation. Figure 3 - Témoin de navigation Création des 2 régions Au sein de la page 41, nous avons créé les 2 régions basées sur une requête SQL: histomusee pour servir d historique de navigation en venant de la page 21 histoutilisateur pour servir d historique de navigation en venant de la page 13 Figure 4 - Historique de navigation en venant de la page 21 Nous décrivons ci-après la première région sachant que la deuxième est créée à l identique. Article - 3/14- Novembre 2009

4 Requête SQL La requête SQL doit retourner les données nécessaires à la création de l historique de navigation, à l image de ce que fait APEX. Figure 5 - Requête SQL Condition d affichage La région ne s affichera que si le témoin de navigation PARENTAPPGROUPES aura la valeur DROITSUTILISATEURS; cette valeur sera affectée au témoin si l utilisateur passe par la page 21 [Voir chapitre 2.2.3]. Figure 6 - Condition d'affichage Article - 4/14- Novembre 2009

5 Mise en page Le paramétrage de la mise en page n a pour but que de présenter une région relativement similaire au composant d historique standard d APEX. Figure 7 - Mise en page Article - 5/14- Novembre 2009

6 Attributs de colonne La colonne MUSEE contiendra le lien sur la page 20 et la colonne DROITSUTILISATEURS contiendra un lien sur la page 21 [Voir Figure 1]. Figure 8 - Attributs d'état Article - 6/14- Novembre 2009

7 Colonne de lien de retour de navigation Nous illustrons en Figure 9 le lien de retour vers la page appelante, en l occurrence, la page 2.1 Page appelée Page appelante Figure 9 - Colonne de lien de retour de navigation La 2 ème région aura une colonne de lien de retour qui pointera sur la page 13. [Voir Figure 1] Article - 7/14- Novembre 2009

8 2.2.3 Affectation du témoin de navigation La page 21 contient un calcul qui va mettre la valeur DROITSUTILISATEURS à l élément d application PARENTAPPGROUPES qui fait office de témoin de navigation. Il en est de même pour la page 13 mais, avec une autre valeur de témoin. Figure 10 - Affectation du témoin de navigation Article - 8/14- Novembre 2009

9 3 Solution optimalisée Notre solution initiale inspirée d un blog résout le problème mais induit du bruit dans le référentiel et risque de pénaliser les travaux de maintenance. En effet, le jour où le développeur doit rechercher au sein du référentiel d APEX les historiques de navigation, il va très certainement passer à côté des 2 régions que nous avons créées pour simuler l historique des accès. Dès lors, la proposition, ci-après, faite par A. Berkani est de créer un deuxième historique d accès pour la page 41 et de montrer dynamiquent l historique valide comme nous l avons fait précédemment pour les 2 régions. 3.1 Principe Créer un historique des accès, en plus de l historique standard, pour traiter le chemin alternatif (par les pages 12 et 13 pour notre exemple). Créer un élément d application qui servira de témoin de navigation par la page 21 ou 12. Créer un calcul d application conditionné aux pages 21 et 13 qui affecte la page en cours à notre élément d application. Créer une région d historique supplémentaire sur la page 41. Rendre conditionnelle l affichage des 2 régions d historique de la page 41à la valeur de l élément d application (témoin de navigation). 3.2 Réalisation de la solution optimalisée Historiques d accès En plus de l historique standard, nous avons créé un deuxième historique nommé Historique alternatif des accès. Figure 11-2 composants partagés d'historique des accès Article - 9/14- Novembre 2009

10 Au sein de l historique standard créé par APEX, nous avons retiré les pages 12 et 13 qui représentent notre navigation alternative vers la page 41. Figure 12 - Historique standard créé par APEX Au sein du deuxième historique de navigation que nous avons créé, nous enregistrons le chemin de navigation alternatif Historique alternatif des accès par les pages 12, 13 et 41. Figure 13 - Historique alternatif créé pour notre proposition de solution Création du témoin de navigation Nous avons créé l élément d application PARENTAPPGROUPES qui nous servira de témoin de navigation. Figure 14 - Témoin de navigation - Article 10/14- Novembre 2009

11 3.2.3 Affectation du témoin de navigation Nous avons créé un calcul d application qui s appliquera à notre témoin de navigation, l élément d application PARENTAPPGROUPES. Ce calcul s effectue avant l en-tête et consiste à affecter à notre témoin de navigation la page en cours. Figure 15 - Affectation du témoin de navigation Nous avons mis comme condition que le calcul ne s effectue que pour les pages 21 et 13. Figure 16 - Condition d'exécution du calcul d'affectation du témoin de navigation - Article 11/14- Novembre 2009

12 3.2.4 Création d une deuxième région d historique de navigation Nous avons créé, au sein de la page 41, une deuxième région pour l historique alternatif de navigation. Figure 17 - Région pour l'historique alternatif de navigation Affichage dynamique de la région d historique de navigation Nous conditionnons l affichage de la région alternative à la page 13, l affichage de la région standard est elle conditionnée à la page 21. Figure 18 - Condition d'affichage de la région alternative d'historique de navigation - Article 12/14- Novembre 2009

13 3.3 Variantes et améliorations Historique des accès au sein de la page 0 S il existe un historique des accès sur la page 0, il faut la conditionner pour qu elle ne s affiche pas sur la page 41 ou que pour la valeur adéquate du témoin de navigation. Figure 19 - Historique de navigation sur la page Navigation de retour Selon la logique de traitement, respectivement de navigation, de l application, il peut être nécessaire de mettre un retour de navigation sur la page appelante. Pour notre cas, la page appelante doit être déterminée à l exécution ; pour ce faire, nous supprimons le branchement statique vers la page 21 ou 13 et créons un branchement dynamique basé sur le contenu de notre témoin de navigation, soit l élément d application PARENTAPPGROUPES. Figure 20 - Assistant de création d'un branchement basé sur un élément d'application - Article 13/14- Novembre 2009

14 Figure 21 - Elément d'application comme action de branchement Si nécessaire, il est aussi possible d effectuer un réacheminement dynamique vers les pages 21 ou 13 à partir des boutons en remplaçant l indication de page 41 en Figure 22 par PARENTAPPGROUPES. Figure 22 - Réacheminement dynamique 4 Liens utiles Site Oracle Portail de l atelier de génie logiciel de la HE-Arc Site de formation à Oracle APEX Rubrique: Enseignement / Atelier de génie logiciel / Oracle APEX - Article 14/14- Novembre 2009