Exercice 2.4 : Utilisation des règles de navigation

Avant de commencer, vous devez effectuer l'exercice 2.3 : Utilisation du composant de téléchargement en amont de fichiers.

La page new_record.jsp est conçue de manière telle que l'utilisateur doit veiller à ne pas spécifier un numéro d'ID déjà utilisé car chaque enregistrement de la base de données doit avoir un ID unique. Vous trouverez plus d'informations à ce sujet dans l'exercice 1.4 : Création d'enregistrements. Vous devez donc faire en sorte que l'utilisateur ne commette pas cette erreur.

Dans l'exercice suivant, exercice 2.5 : Utilisation de la génération automatique des clés, vous allez utiliser la fonction de génération automatique des clés pour qu'il ne soit plus nécessaire de spécifier soi-même un numéro d'ID. Dans cet exercice, vous allez vérifier si l'ID spécifié est unique et, dans le cas contraire, diriger l'utilisateur vers une page d'erreur qui décrit l'erreur et indique comment la corriger.

Les règles de navigation permettent de diriger l'utilisateur vers une page d'erreur ou vers la page all_records.jsp, selon que l'ID spécifié est unique ou en double. Vous affecterez des alias à ces deux résultats possibles et associerez ensuite ces alias aux pages cible correctes. Dans cet exemple, une erreur survenue dans la page create_record.jsp active l'alias ERROR_CREATE qui dirige alors l'utilisateur vers la page d'erreur. Si l'utilisateur renseigne correctement la page create_record.jsp, l'alias MAIN est activé. Celui-ci est associé à la page all_records.jsp.

Configuration des règles

Présentation visuelle
  1. Cliquez deux fois sur la page new_record.jsp dans le navigateur de projets.
  2. Cliquez sur le bouton permettant de transmettre une nouvelle liste sur la page.
  3. Dans la vue Propriétés, cliquez sur Ajouter une règle. La fenêtre Ajout d'une règle de navigation s'affiche.

    La première règle dirige l'utilisateur vers une page d'erreur appelée create_error.jsp au cas où une erreur se serait produite lors de la création et de la validation du nouvel enregistrement dans la base de données.

  4. Dans la zone Page, tapez /error_create.jsp. Cette page n'existe pas mais pour ce tutoriel, vous pouvez supposer qu'elle existe.
  5. Cliquez sur le bouton d'option Le résultat intitulé.
  6. Tapez ERROR_CREATE dans la zone de texte après le bouton d'option Le résultat intitulé.
  7. Cliquez sur le bouton d'option A cette page uniquement car il n'existe aucune autre page sur le site dans laquelle l'utilisateur peut déclencher cette erreur en entrant un numéro d'ID en double.
  8. Cliquez sur OK.

    La règle suivante dirige à nouveau l'utilisateur vers la page all_records.jsp si ce dernier a spécifié un numéro d'ID valide.

  9. Cliquez sur le bouton Ajouter une règle pour afficher à nouveau la fenêtre Ajout d'une règle de navigation.
  10. Sélectionnez all_records.jsp dans la liste déroulante Page.
  11. Cochez la case Le résultat intitulé et tapez MAIN dans la zone de texte qui suit.
  12. Etant donné qu'il peut s'avérer nécessaire d'utiliser à nouveau cette règle dans une autre page (par exemple, la page update_record.jsp), cliquez sur le bouton d'option concernant toutes les pages sous Cette règle est utilisée pour.
  13. Cliquez sur OK. Les deux règles apparaissent maintenant dans la vue Propriétés.

Renvoi d'alias par l'activation d'un bouton

Présentation visuelle

Il suffit maintenant de faire fonctionner les règles de navigation. Vous allez pour cela ajouter deux instructions return dans le code du bouton de transmission de nouvelle liste. Ces instructions return appellent l'alias approprié afin que l'utilisateur soit dirigé vers la page appropriée, comme indiqué dans la règle de navigation.

  1. Cliquez sur le bouton Post New Listing.
  2. Ouvrez la vue Edition rapide.
  3. Dans la vue Edition rapide, recherchez la ligne contenant les instructions } catch (Throwable e) {.

    Cette fonction catch est exécutée si l'utilisateur a entré un numéro d'ID en double.

  4. Supprimez l'intégralité du code placé entre l'accolade ouvrante { à la fin de cette ligne et l'accolade fermante } suivante, quelques lignes plus bas. Ne supprimez pas les accolades.
  5. A la place du code entre accolades, tapez le texte suivant :

    return "ERROR_CREATE";

  6. A la fin de la syntaxe, supprimez l'intégralité du code qui suit la dernière accolade fermante } et tapez à la place le texte suivant :

    return "MAIN";

    Cette étape supprime l'action gotoPage que vous avez ajoutée au cours de l'exercice 1.4. Ce code n'est plus nécessaire car les règles de navigation remplissent la même fonction.

    Le code du bouton doit se présenter de la manière suivante :

    Exemple de code

  7. Sauvegardez la page et, si nécessaire, testez-la.

En option, vous pouvez créer une page d'erreur simple appelée create_error.jsp qui indique aux utilisateurs qu'une erreur s'est produite lors de la création de leur liste et les invite à entrer une valeur d'ID différente. Vous pouvez ensuite tester ces règles de navigation en essayant d'ajouter une nouvelle liste qui utilise une valeur d'ID existante (telle que 1).

Vous êtes prêt à aborder l'exercice 2.5 : Utilisation de la génération automatique des clés.

Retour d'informations
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.