Leçon 1.7 : Filtrer une liste d'enregistrements relationnels

La création d'une liste d'enregistrements relationnels filtrée comprend une étape supplémentaire qui consiste à filtrer la liste pour que seuls certains enregistrements soient affichés. Comme vous l'avez fait pour créer la page update_record.jsp, vous allez spécifier un paramètre dans la page all_records.jsp et utiliser un lien pour envoyer ce paramètre à la page filtered_records.jsp.

1. Dans la vue Explorateur de projets, faites un double clic sur le fichier filtered_records.jsp pour l'ouvrir. Supprimez le texte par défaut.
2. Faites glisser un composant Liste d'enregistrements relationnels à partir du tiroir Données de la palette et déposez-le sur la page. La fenêtre Ajout d'une liste d'enregistrements relationnels s'affiche. Nommez cette liste d'enregistrements filtered_recordlist. Assurez-vous que l'option Ajouter des contrôles de données est sélectionnée et cliquez sur Suivant.
3. Développez l'entrée W5SAMPLE et sélectionnez ADS. Cliquez sur Suivant.
4. Sous la rubrique Tâches, cliquez sur Filtrer les résultats. La fenêtre Filtres s'affiche. Pour créer la condition de filtrage, cliquez sur le bouton Ajouter sous l'onglet Conditions. La fenêtre Conditions s'affiche. Sélectionnez MAINCATEGORY dans la liste Colonne. Sélectionnez l'option Variable.
5. Tapez #{param.CAT} dans la zone Valeur. A l'exécution, l'évaluation de ce code donnera la valeur du paramètre CAT de la demande. La fenêtre Conditions doit se présenter comme suit :
   
   Cliquez sur OK pour fermer la fenêtre Conditions, puis sur Fermer pour fermer la fenêtre Filtres. Cliquez sur Suivant.
6. Là encore, vous pouvez choisir les colonnes à afficher dans la table de données. Conservez uniquement les colonnes suivantes :
   • TITLE
   • DESCRIPTION
   • MAINCATEGORY
   • PRICE
   • PHONE
7. Organisez les colonnes dans l'ordre suivant :
   • TITLE
   • DESCRIPTION
   • MAINCATEGORY
   • PRICE
   • PHONE
8. La fenêtre Ajout d'une liste d'enregistrements relationnels doit se présenter comme suit :
   
   Cliquez sur Terminer. La liste d'enregistrements relationnels est ajoutée à la page. Elle ressemble à celle de la page all_records.jsp, mais comme elle est filtrée par catégorie, elle affichera une seule catégorie d'articles à la fois.
9. Enregistrez la page. Elle doit ressembler à ceci :
   

1. Ouvrez le fichier all_records.jsp. Dans la vue Palette, cliquez sur le tiroir Composants Faces étendus pour l'ouvrir.
2. A partir de la palette, faites glisser un composant Lien et déposez-le directement sur le contrôle de sortie {MAINCATEGORY} de votre table de données. La boîte de dialogue Configuration de l'URL s'affiche.
3. Dans la zone URL, tapez filtered_records.jsp comme page cible du lien et n'entrez rien dans la zone Libellé. Lorsque vous déposez un lien directement sur un contrôle de sortie et que vous laissez la zone Libellé à blanc, le lien adopte automatiquement le texte du contrôle comme libellé. Dans le cas présent, ce libellé est {MAINCATEGORY}. Cliquez sur OK.
4. Cliquez sur le lien, puis, dans la vue Propriétés, cliquez sur l'onglet Paramètre, juste en dessous de l'onglet hx:outputLinkEx.
5. Cliquez sur Ajouter un paramètre pour créer un nouveau paramètre. Tapez CAT dans le champ Nom du nouveau paramètre.
6. Pour lier le paramètre CAT à la colonne MAINCATEGORY du formulaire d'entrée, sélectionnez le champ Valeur et cliquez sur le bouton Sélection d'un objet de données de page qui apparaît dans ce champ. La fenêtre Sélection d'un objet de données de page s'affiche.
7. Sous l'onglet Objets de données, cliquez successivement sur all_recordlist (Service Data Object) > all_recordlist (ADS) > MAINCATEGORY (String). Cliquez sur OK.
8. Enregistrez la page et testez-la. Lorsque vous cliquez sur un nom de catégorie, vous êtes dirigé vers la page filtered_records.jsp, qui affiche uniquement les annonces de vente des articles appartenant à cette catégorie.

Cette leçon est à présent terminée. Vous avez appris à limiter l'affichage aux enregistrements qui répondent à un critère spécifique, le but étant de permettre aux utilisateurs de visualiser les petites annonces par catégorie d'articles.