Comment créer votre première application Oracle apex

rappels des avantages oracle apex

Ce tutoriel est une prise en main de l'outil de développement oracle APEX, il constitue le prolongement de notre livre blanc sur oracle APEX dans lequel nous avons, entre autres, expliqué le fonctionnement du moteur oracle APEX et l'utilisation des composants oracle apex :
- Accès aux données de la base oracle avec une application oracle apex
- La logique d’une application oracle apex
- Les composants à utiliser pour naviguer à l’intérieur d’une application oracle apex

Avantages oracle apex

- Prise en main facile de l’outil,
- Interface utilisateur en langue française,
- Maintenance facile,
- Utilisation en réseau local, Internet ou en mode déconnecté (PC portable),
- Puissant et convivial,
- Outil gratuit.

Pour plus d’information :

Livre Oracle APEX écrit en français par Ahcène BOUROUIS aux  Editions ENI

Formation initiation à Oracle APEX

Formation de niveau avancé à oracle apex

Les étapes de création d’une application oracle apex dans ce tutoriel

Si vous ne possédez pas d'installation Oracle APEX sur votr machine, créez gratuitement un compte Oracle APEX sur le site hébergé d'Oracle, cela vous prendra quelques minutes. Cliquez sur ce lien pour demander un espace de travail Oracle APEX ?

Une image-écran exemple complète chaque étape de cette documentation, rendez-vous à la fin de ce guide d'initiation Oracle APEX pour visualiser ces copies d'écrans.

1 - Connectez-vous à l’espace de travail Oracle APEX.

C’est la page d’identification du compte Oracle APEX.

Image-écran 1 de la galerie - Page de connexion oracle apex

Entrez le login et le mot de passe pour vous connecter à votre espace de travail Oracle APEX.

2 - Lancez Application Builder.

Il s’agit de la page d’accueil Oracle APEX :
4 onglets : Accueil, cette même page, Application Builder, SQL Workshop et Utilitaires
A gauche de la page, 3 boutons Application Builder, SQL Workshop et Utilitaires
A droite de la page, plusieurs mens : Administration, Migrations, Schéma d’espace de travail, Tâches propres au site et Liens.

Image-écran  N° 2 de la galerie – Page accueil oracle apex

Cliquez sur l’icône Application Builder pour démarrer l’outil de développement Oracle APEX.

3 - Créez une nouvelle application Oracle apex.

Cette page affiche la liste des applications créées à l’intérieur de l’espace de travail courant. Une barre de sélection vous permet de choisir le mode d’affichage et les critères de sélection.

Image-écran  N° 3  de la galerie –  Page application builder oracle apex

Cliquez sur le bouton Créer > pour créer une nouvelle application Oracle apex

4 - Choisissez une méthode de création de votre application Oracle apex.

Cette page affiche 3 options :

• Créer une application

• Créer à partir d’une feuille de calcul
• Application de démonstration

Image-écran  N° 4  de la galerie –  fenêtre méthodes de création application oracle apex

Cochez la case Créer une application et cliquez sur le bouton Suivant >

5 - Identifiez votre application Oracle apex.

Cette page pour permet d’identifier de votre application avec un nom et un identifiant. Vous y indiquerez le mode création (application entièrement nouvelle ou à partir d’un modèle de conception d’application Oracle apex existant.
Enfin, vous précisez le schéma utilisateur attaché à votre espace de travail.

Image-écran  N° 5  de la galerie –  nom application oracle apex

Dans la zone Nom, entrez un nom en clair pour votre première application comme par exemple Administration du personnel.
Dans la zone Application, laissez le moteur générer automatiquement un identifiant.
Cochez le bouton d’option Entièrement nouveau
Dans la zone Schéma, laissez le schéma par défaut. Dans votre cas, il correspond au schéma que vous avez associé à l’espace de travail au moment de sa création.
Cliquez sur le bouton Ajouter une page

6 - Ajoutez une page dans votre application Oracle apex.

Cette page affiche 6 types de page, chaque type de page correspond à un mécanisme particulier
Page vierge, l’assistant Oracle APEX créé une page vide.
Page Etat, l’assistant Oracle APEX créé une page avec une région de type Etat.
Page Panneau, l’assistant Oracle APEX créé une page avec une région de type panneau.
Page Panneau tabulaire, l’assistant Oracle APEX crée une page avec une région de type panneau tabulaire.
Page Maître-détail, l’assistant créé deux pages.
La première page avec une région de type Etat basée sur la table « maître ».
La seconde page avec une région de type panneau basé sur la table « maître » et une région de type panneau tabulaire sur la table « détail ».
 Page Etat et panneau, l’assistant Oracle APEX créé deux pages.
La première avec une région de type Etat. La seconde page avec une région de type panneau. Un lien hypertexte sera associé à chaque ligne de la région Etat de la première page permettra d’afficher les données de cette ligne dans la région Panneau de la deuxième page.

Image-écran  N° 6  de la galerie –  ajouter une page dans une application oracle apex

Cochez l’option Etat et Panneau
Dans la zone Nom de table, sélectionnez la table EMP
Dans la zone Implémentation, sélectionnez Classique
La case Inclure les pages d’analyse doit être décochée.

7 - Ajoutez de nouvelles pages dans votre application Oracle apex.

Observez qu’Oracle APEX a ajouté deux pages en haut de votre page web : Page 1 et Page 2.
A ce stade, on peut ajouter d’autres pages à l’aide des types de page comme nous l’avions indiqué ci-dessus.

Image-écran  N° 7  de la galerie – ajouter autres pages dans une application oracle apex

Cliquez sur le bouton Suivant > situé en haut de la page Oracle APEX.

8 - Ajoutez des onglets dans votre application Oracle apex.

Oracle APEX offre différents moyens de navigation à l’intérieur d’une application. A ce stade, l’assistant Oracle APEX vous propose de générer automatiquement des onglets à l’intérieur de votre application. Trois possibilités vous sont offertes :
Aucun onglet, cette application ne possèdera aucun onglet.
Un niveau d’onglets, un onglet sera ajouté à chaque page de l’application.
Deux niveaux d’onglets, cette option permet d’avoir un sous menu d’onglets.  L’onglet parent sera affiché au dessus de la page, les onglets enfants seront affichés en dessous.

Image-écran  N° 8  de la galerie – ajouter des onglets dans une application oracle apex

Oracle APEX n’a pas usurper son titre d’outil de développement rapide d’applications Web pour bases de données Oracle. Cette fonctionnalité permet de partager des composants existants entre différentes applications Oracle APEX.  Outre la copie d’un ou plusieurs composants, Oracle APEX permet à l’application cliente de s’abonner auprès de l’application de référence afin de de recevoir toutes les modifications effectuées sur les composants partagés entre applications. Sympa. non !

9 - Copiez des composants partagés à partir d’une autre application Oracle APEX.

Oracle APEX n’a pas usurper son titre d’outil de développement rapide d’applications Web pour bases de données Oracle. Cette fonctionnalité permet de partager des composants existants entre différentes applications Oracle APEX.  Outre la copie d’un ou plusieurs composants, Oracle APEX permet à l’application cliente de s’abonner auprès de l’application de référence afin de de recevoir toutes les modifications effectuées sur les composants partagés entre applications. Sympa. non !

Image-écran  N° 9  de la galerie – copier des composants partagés dans une application oracle apex

Cochez l’option Un jeu d’onglets et cliquez sur le bouton Suivant >.

10 - Définissez  le mode de connexion à votre application Oracle APEX.

Cet assistant vous guide dans la définition du mode d’authentification de votre application Oracle APEX. Trois options sont possibles :
Application Express, dans ce cas l’utilisateur connecté doit exister en tant qu’utilisateur Oracle APEX.
Aucune authentification, dans ce cas, aucune authentification n’est demandée. C’est le cas des sites internes grands publics.
Compte de base de données, dans ce cas, l’utilisateur connecté doit exister en tant qu’objet Utilisateur de la base de données.

Image-écran  N° 10  de la galerie – mode authentification application oracle apex

Dans notre cas, cochez l’option Application Express.
Dans la zone langue, sélectionnez Français – France (fr).
Dans la zone préférence de la langue utilisateur dérivée de l’application, laissez l’option par défaut.
Dans la zone Format de la date,  laissez le format par défaut.

11 - Choisissez le thème d’interface graphique votre application Oracle apex.

Comme vous pouvez le voir dans l’image-écran ci-dessous, Oracle apex vous propose vingt thèmes prêts à l’emploi. Le thème définit l’ensemble des modèles de composants graphiques d’une application Oracle APEX. Il regroupe des modèles de pages, de boutons, d’onglets, de régions, etc.
C’est au moment de l’exécution de votre application, qu’Oracle apex va chercher ces modèles pour construire la page HTML à la volée. On ne peut pas faire plus rigoureux et plus homogène pour définir une charge graphique dans une application web.
Une fois votre application créée, vous pouvez ajouter autant de thèmes que vous souhaitez et basculer de l’un vers l’autre, histoire de vérifier le rendu et de choisir l’interface graphique la plus proche de vos pratiques. Bien entendu, vous pouvez créer vos propres thèmes graphiques. Mais pour cela, on va attendre un peu.

Image-écran  N° 11  de la galerie – Choisir le thème de l'application oracle apex

Cochez le thème 20, à se stade, vous pouvez choisir un autre thème si le thème 20 vous déplait.

12 - Confirmez la création de votre application Oracle apex.

Vous êtes arrivé au terme de processus de création de votre première application. Oracle APEX  vous affiche un résumé des principaux attributs tels le nom, l’identifiant, le schéma, etc. comme le montre l’image ci-dessous.
A ce stade, il est possible de revenir en arrière pour modifier certains paramètres de l’application. Pour cela, il faut cliquer sur le bouton < Précédent.

Image-écran  N° 12  de la galerie  –confirmer la création de l'application oracle apex

Cliquez sur le bouton Créer pour terminer la création de votre application Oracle APEX.

13 - Page de définition de  votre application Oracle apex.

Le moteur Oracle APEX génère les composants de votre application, les stocke dans le méta modèle et vous affiche la page ci-dessous. Un message affiché en haut de la page avec « Application créée avec succès ».
Quatre gros boutons : Exécuter l’application, Objets de prise en charge, composants partagés et Export/Import apparaissent également.
On trouve ensuite la liste des pages de l’application.
La page 1 correspond à la page de Type ETAT sur la table EMP.
La page 2 correspond à la page de Type PANNEAU sur la table EMP.
La page 101 a été générée automatiquement et correspond au mode d’authentification choisi  Application Express.
Cliquez sur le bouton Exécuter l’application représentant les feux tricolores.

Image-écran  N° 13  de la galerie  –page de définition de l'application oracle apex

Cliquez sur le bouton Créer pour terminer la création de votre application Oracle APEX.

14 - Page Etat sur table EMP.

Cette page affiche la liste des employés de la table EMP. L’assistant a également ajouté un lien hypertexte à chaque ligne de cette table, il  est matérialisé par un petit crayon à gauche de l’état.

Image-écran  N° 14  de la galerie  – Page état table EMP de l'application oracle APEX

Cliquez sur le bouton « crayon » de la première ligne de l’état.

15 - Page Panneau  sur table EMP.

Cette page affiche un panneau ou formulaire contenant les colonnes de la ligne sélectionnée précédemment. Trois boutons permettent à l’utilisateur d’annuler une action et revenir à la page précédente. Il peut supprimer cette ligne ou appliquer les modifications effectuées dans les différents champs en saisie.
On peut observer également une barre d’outils du développeur affichée en base de la page Oracle APEX, cela indique que nous sommes en mode de développement.
Page d'accueil, pour revenir à la page d'accueil Oracle apex.
Application 9461,  pour revenir à la page de définition de l'application 9461.
Modifier page 2, pour revenir à la page de définition de la page 2.
Créer,  pour créer une nouvelle page ou un composant à l'intérieur de la page en cours.
Session pour afficher le statut de la session avec ses attributs (numéro session, nom utilisateur et autres éléments d'application).
Activité, pour afficher l'historique de l'activité du développeur pour cette application.
Déboguer, pour exécuter l'application en affichant les noms des processus, des variables et leurs valeurs. Ce lien fonctionne en mode bascule. Cliquez de nouveau sur le lien pour arrêter ce mode.
Afficher les liens de modification, pour accéder directement à la définition de chaque élément. Cette fonctionnalité est utile pour la mise au point de l'application.

Image-écran  N° 15  de la galerie  – Page panneau table EMP de l'application oracle APEX

Cliquez sur le lien Modifier une page 2 pour accéder à la définition de cette page.

16 - Définition d’une page Oracle APEX

Cette page affiche la liste des composants d’une page Oracle APEX. La partie de gauche – Affichage de page -  affiche les caractéristiques de la page, ses éléments visuels (régions, boutons, éléments) ainsi que les processus et calculs que le moteur Oracle APEX doit effectuer avant l’affiche de la page Web.
La partie centrale – Traitement de page – regroupe les calculs, processus et branchements que le moteur Oracle Apex doit effectuer à chaque soumission de la page, c'est-à-dire à chaque fois que l’utilisateur actionne un lien, un bouton, un onglet ou un lien hypertexte.
La partie affichée à droite de cette page affiche la liste des composants partagés utilisés dans cette application.

Image-écran  N° 16  de la galerie  – détail composants dans une page oracle apex

Cliquez sur le lien Déconnexion située dans la barre de navigation. Il s’agit de la ligne affichée  en haut à droite d’une page Oracle APEX.

Ce tutoriel a été utilisé pour créer un exemple d'application Oracle apex sur le site d'oracle APEX en ligne.

Conclusion

Que faut-il retenir de ce tutoriel ?
Nous venons de créer une application Web qui interagit avec la base de données sans aucune programmation. Cette application permet de visualiser, modifier, créer et supprimer les lignes de la table EMP.

Vous avez noté que le déploiement d'une application Oracle APEX ne nécessite aucune installation client.
Dans note cas, ,nous avons développé et exécuté l'application exemple Oracle APEX avec simplement un navigateur web.
Pour lancer cette application en mode Oracle APEX runtime, il suffit de taper l'URL affiché par le framework au moment de l'exécution dans votre navigateur préféré et le tour est joué.
Pour publier une application Oracle APEX, il suffit donc de communiquer cette URL aux utilisateurs destinataires et leur faire enregistrer en tant favori Web.

Bien entendu, cette application est rudimentaire je vous le concède. Dans le prochain tutoriel nous allons l'améliorer :

- Ajouter une LOV (liste de valeurs) au code département, cette LOV affichera les noms des départements et retournera le code. L'utilisateur n'aura plus à saisir de code.

- Ajouter des validations pour vérifier la saisie des autres champs.
- Ajouter un logo et plusieurs utilisateurs à notre application.

Vous pouvez aussi faire des suggestions et commenter ce tutoriel afin qu'il soit amélioré.