Ajouter une liste de valeurs LOV dans une page Oracle APE...

Dans notre exemple, nous allons créer une liste de valeurs pour l'élément de page P2_DEPTNO (colonne deptno de la table emp) et l'associer ensuite à un élément de page de type List SELECT.

Chaque étape est illustrée avec une image-écran que vous pouvez consulter dans la galerie de ce tutoriel.

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

Accéder au tutoriel Comment créer une application Oracle APEX

Les étapes pour ajouter une liste de valeurs LOV dans une page Oracle APEX

Commencez par vous connecter à votre espace de travail et sélectionnez ensuite l'application Administration du personnel. Rapellez-vous, nous avons précédemment créé cette application dans le tutoriel Comment créer votre première application Oracle apex.

    Image-écran 1 de la galerie - Page application APEX

Cliquez sur le lien Composants partagés pour afficher la page Composants partagés comme le montre l'exemple ci-dessous

    Image-écran 2 de la galerie -  Page composants partagés APEX

Dans la section Interface Utilisateur, cliquez sur le lien Liste de valeurs (LOV) pour afficher la page de création.
L'exemple ci-dessous affiche une liste de valeurs (LOV) nommée Lignes d'état par page utilisée par APEX pour sélectionner le nombre
de ligne à afficher par page.

    Image-écran 3 de la galerie -  Page liste de valeurs LOV

Cliquez sur le bouton Créer > pour ajouter une nouvelle liste de valeurs LOV.

    Image-écran 4 de la galerie -  Source liste de valeurs LOV


cochez l'option Entièrement nouveau et cliquez sur le bouton Suivant >.

    Image-écran 5 de la galerie -  Nom et type liste de valeurs LOV
   
Dans la zone Nom, entrez liste-depts,
Dans la zone Type, Cochez l'option Dynamique et
Cliquez sur le bouton Suivant >.

    Image-écran 6 de la galerie -  Valeurs statiques et d'interrogation de la liste de valeurs LOV
   
Dans la zone texte Interrogation, entrez la requête SQL ci-dessous :

    select dname d, deptno r
    from   dept
    order by 1   

Cette requête affiche les colonnes dname et deptno de la table dept. d et r étant respectivement l'alias des colonnes dname et deptno.

Il est indispensable de respecter ce format de requête pour créer une liste de valeurs LOV. Oracle APEX affiche la première colonne dans la liste et
retourne la valeur de la deuxième colonne à la page Oracle APEX.

Cliquez sur le bouton Créer une liste de valeurs (LOV) pour terminer.

Oracle APEX réaffiche la page des listes de valeurs LOV avec la liste de valeurs que nous venons d'ajouter.

    Image-écran 7 de la galerie -  Page liste de valeurs LOV actualisée

Cliquez sur l'icône dans la barre d'outils en haut à droite de la page pour accéder aux pages de l'application.

    Image-écran 8 de la galerie -  Page Apex


Nous allons maintenant associer la liste de valeurs LOV liste_depts au champ texte P2_DEPTNO afin d'afficher une liste déroulante.

Pour cela, dans la zone Page, tapez 2 et pressez la touche Entrée pour afficher la page 2.

    Image-écran 9 de la galerie -  Page 2 application APEX
   
Cliquez sur l'élément de page APEX pour afficher ses propriétés.

    Image-écran 10 de la galerie -  Défintion élément de page APEX

Dans cette étape, nous allons modifier 2 propriétés : le type d'élément et la liste de valeurs LOV associée.

Actuellement, le type d'élément courant est Champ de texte. Nous allons sélectionner le type Select LIST.

Dans la zone Afficher en tant que, sélectionnez [Select LIST] sous champ de texte.

Cliquez ensuite sur l'onglet Liste de valeurs LOV.
 
    Image-écran 11 de la galerie - Associer liste de valeurs LOV à un élément List SELECT
   
Dans la zone Liste de valeurs (LOV) nommée, sélectionnez liste_depts.
Cliquez sur le bouton Appliquer les modifications.

Exécutez votre application et sélectionnez une ligne de l'état sur la table EMP et vous obtiendrez le résultat suivant.

    Image-écran 12 de la galerie - Affichage page formulaire EMP avant-après modification

Dans le prochain tutoriel, nous ajouterons des validations pour contrôler la saisie de l'utilisateur et l'avertir en cas d'erreur.