Tutoriel de création d une application APEX 5-Création de deux pages, de vue d ensemble et de saisie des écritures 5.1 Visualisation et modification d une page Cliquons sur l icône «Page 1» pour accéder à la première page, en modification. On accède à une vue d ensemble des objets de la page 1. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 1
Oracle APEX décrit une page HTML comme une collection d objets «fonctionnels». La page (HTML) est découpée en régions (logiques), qui peuvent être placées en dessous les unes des autres, et/ou organisées en plusieurs colonnes. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 2
Il existe de multiples types de régions. Nous allons utiliser pour la saisie des recettes et des dépenses, d une part une région de type «état HTML» (report) pour afficher les différentes lignes d écritures déjà existantes, et d autre part une région de type «Formulaire» (Form) pour saisir et modifier les informations. Afin de minimiser les manipulations, nous allons continuer à utiliser les assistants proposés par APEX. Mais, il faut préciser que tout ce qui est fait par les assistants, pourrait également être réalisé «pas à pas», é lément par élément». D autre part, une fois qu on a créé quelque chose avec un assistant, il est toujours possible de modifier, compléter ou affiner ce que l assistant a permis d obtenir très rapidement. Nous allons cliquer sur le bouton +, à droite du titre «Regions». Ceci va permettre d accéder à la création d une nouvelle région. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 3
5.2 Création d une nouvelle région Nous allons sélectionner le type de région Form (Formulaire) : Puis cliquer sur le bouton «Next >». Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 4
5.3 Formulaire et Etat, en un seul ensemble d étapes L assistant nous propose ensuite de choisir un type de formulaire. Nous allons utiliser un type de formulaire, pour lequel l assistant est très efficace, le type «Form with Report» : L assistant va créer, pour nous, un état (report) avec des liens vers un formulaire, mais également les mécanismes de fonctionnement entre l état et le formulaire (liens, boutons, appel des actions Oracle Insert, update, delete ). La première étape consiste à choisir le «schéma Oracle». Nous choisissons le schéma (ORACLE) associé à l espace de travail APEX dans lequel nous sommes. Pour cet exemple, le schéma est nommé EXERCICES : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 5
Une fois le schéma Oracle choisi, l assistant nous propose les tables et vues Oracle de ce schéma. Ici, c est la table Ecritures qui doit être sélectionnée : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 6
5.4 Définition de l état de vue d ensemble des écritures La seconde grande étape de cet assistant consiste à définir la page de «vue d ensemble» des écritures déjà existantes. Indiquons une implémentation «Classic» pour l état, et non pas une implémentation «Interactive», qui est plus adaptée à la formulation de requêtes qu à la saisie/modification. On va accepter les autres choix proposés par défaut. Il est à noter que cet état sera affiché sur la page 1 : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 7
Puis l assistant demande quelles rubriques (colonnes) afficher dans la vue d ensemble. Nous sélectionnons toutes les rubriques : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 8
5.5 Lien graphique entre état et formulaire Ensuite, il est proposé de choisir une petite image qui symbolisera le lien entre vue d ensemble et vue détaillée. Acceptons l icône qui est proposée : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 9
5.6 Création du formulaire sur la même page que la vue d ensemble On aborde maintenant la troisième grande étape de cet assistant. C est la description du formulaire qui permettra la saisie et les modifications. Ce formulaire propose, par défaut, une page différente de la page qui comporte la vue d ensemble. Nous allons modifier le choix «Page Number» et y indiquer également la page n 1. De cette façon, vue d ensemble et formulaire seront accessibles sur la même page : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 10
Ensuite, l assistant demande de confirmer le nom de la rubrique (de la table Oracle) qui va permettre de passer de la vue d ensemble au formulaire détaillé. Dans notre cas, il s agit de la colonne EC_ID : Afin de pouvoir insérer de nouvelles lignes dans la table Ecritures, APEX a besoin de connaître quelle méthode utiliser. Lors de la définition de la table Ecritures, une séquence et un déclencheur (trigger) Oracle ont été créés. On va donc à cette étape, accepter ce que l assistant propose : «Existing trigger» : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 11
Maintenant, il faut définir quelles rubriques on souhaite afficher. On va sélectionner les quatre rubriques restantes (autres que la «clé primaire») : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 12
5.7 Actions possible en saisie, mises à jour et suppression Puis l assistant nous demande de préciser quelles opérations, sur les données, on souhaite pouvoir réaliser. On laisse sélectionnés les trois choix Insert, Update et Delete, qui correspondent respectivement à la création de nouvelles lignes, leur modification ou leur suppression : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 13
Une confirmation résume l ensemble des choix effectués. Cliquons sur «Finish» pour créer effectivement les objets APEX décrits : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 14
5.8 Création effective Formulaire/Etat Enfin, un message nous indique que l état (Report) et le formulaire ont été créés. Afin de voir ce qui a été généré, cliquons sur «Run Page». Un dialogue de connexion est affiché : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 15
5.9 Test du formulaire créé avec l assistant Introduisons l identifiant et le mot de passe (du développeur ou de l administrateur d espace de travail APEX). On voit les deux régions créées. La première est «Report on ECRITURES», la seconde est «Form on ECRITURES». Une autre région qui existait au départ est nommée «Page 1». En bas d écran, une barre d outils pour le développeur est disponible : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 16
On va cliquer sur «Edit Page 1» pour accéder aux régions et autres objets existant dans cette page APEX. De multiples objets sont définis dans cette page. Examinons tout d abord les «régions» de la page: Il existe quatre «régions». Deux qui existaient avant l utilisation de l assistant, et deux qui ont été créés, suite à l utiisation de l assistant. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 17
5.10 Suppression de régions «non souhaitées» Nous allons supprimer la région «Breadcrumbs», qui sert à définir des arborescences de navigation. Pour ce faire : Clic sur le lien hypertexte «Breadcrumbs», puis clic sur le bouton «Delete» : Un dialogue de confirmation demande si on veut vraiment supprimer cette région, cliquer sur «Delete region» : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 18
Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 19
Si on examine maintenant les régions de la page, on n a plus que trois régions : Supprimons, de la même façon que ci-avant, la région (inutile) nommée «Page 1» On n a plus maintenant que deux régions : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 20
Pour lancer à nouveau «l exécution de la page 1», on va cliquer sur le bouton «Run» : Maintenant on n a effectivement plus que les deux régions. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 21
On souhaite placer la région «formulaire», à droite de la région «état». On va accéder aux propriétés de la région «Form on ECRITURES» L ordre des régions est défini par la propriété «Sequence», la colonne d affichage par la propriété «Column». Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 22
Changeons ces deux propriétés, sans oublier de cliquer sur «Apply Changes», comme lors de toutes les modifications des écrans APEX. Nouvelles valeurs : Ce qui apparait dans la vue d ensemble des régions : Maintenant, le formulaire est affiché à droite de l état : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 23
Les libellés ne conviennent pas, on va commencer par changer les attributs «Title» des deux régions : Après les changements des titres de régions : Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 24
Puis on va changer les attributs «Text Label / alt» des boutons : Nous allons changer les attributs «Text Label / alt» des deux boutons «Create» en «Ajouter une nouvelle écriture» et «Confirmer la création de cette nouvelle écriture». En ce qui concerne les boutons «Cancel» et «Delete», on modifie ce qui est affiché (attributs «Text Label / alt» ) en «Annuler» et «Supprimer» Pourquoi trois petits points après Supprimer? Parce qu un dialogue de confirmation sera ensuite affiché. (Cf. Xerox /Palo Alto, Apple Lisa puis Macintosh). Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 25
Attention de ne pas modifier les attributs «Button Name» des différents boutons. En effet ces attributs sont utilisés dans la «gestion évènementielle» des pages APEX. Noius avons organisé les régions de la page de visualisation / saisie. Nous allons ensuite continuer à personnaliser le résultat de l assistant. Oracle Apex 3.21 Tutoriel RCI Informatique SAS - 2010 Page C- 26