Utilisation de l'option Contrôleur de messages

Si vous souhaitez afficher des messages dans vos pages Web, vous devez configurer une ressource de messages dans l'assistant Configuration d'exécution des outils Web i. Vous devez également définir un paramètre de sortie comme contrôleur de messages dans l'assistant d'interaction Web.

Option Traitement des messages dans l'assistant Configuration d'exécution des outils Web i

La ressource de messages peut être configurée dans la seconde page de l'assistant Configuration d'exécution des outils Web i.

Cette option vous permet de :

  1. Spécifiez le fichier de messages utilisé pour le traitement des messages dans la zone Ressource de messages. Si vous n'avez pas coché l'option Utiliser le fichier de messages i, ce fichier est un fichier de propriétés. Le fichier de propriétés doit être créé dans le dossier JavaSources ou dans un sous-dossier du dossier Java™ Resources. L'option Parcourir vous permet de rechercher le fichier de propriétés dans le dossier JavaSources.

    Si vous avez coché l'option Utiliser le fichier de messages i, la ressource de message est un fichier de messages IBM® i. L'option Parcourir vous permet de rechercher le fichier de messages sur un hôte distant. *LIBL et *CURLIB sont pris en compte pour les fichiers de message i.

    Si seul le nom du fichier de messages est spécifié, il est identifié par *LIBL.

  2. Sélectionnez Utiliser le fichier de messages i si le fichier de messages sépcificé dans la zone Ressource de messages est un fichier de messages i.

Option Contrôleur de messages dans l'assistant d'interaction Web

La fenêtre Spécification de contrôle de messages s'ouvre lorsque vous affectez la valeurvrai pour le Contrôleur de messages pour tout paramètre de sortie de la page "Conception du formulaire de résultats" ou des pages "Mappage et liaison des paramètres de sortie aux zones de sortie" dans l'assistant d'interaction Web. Ce paramètre de sortie correspond au paramètre contrôleur de messages.

Utilisez cette fenêtre pour associer les valeurs renvoyées par le paramètre contrôleur de messages aux ID message et définir le composant Web qui affichera le message.

  1. Dans la zone Valeur de paramètre, indiquez la valeur qui sera associée à l'ID message. Vous pouvez modifier les entrées de cette zone. Vous pouvez également sélectionner deux valeurs spéciales :
    • *OTHER - Autres valeurs non spécifiées
    • *BLANK - Blancs. Cette valeur est active uniquement si le type de paramètre contrôleur de messages n'est pas numérique.

    Pour renvoyer plusieurs valeurs, le paramètre contrôleur de messages doit être défini comme un tableau.

    Si le paramètre contrôleur de messages est de type caractère, il peut être utilisé pour renvoyer le texte de substitution des variables de substitution figurant dans le message. Un espace sépare le texte de substitution et l'ID message. Les espaces figurant dans le texte de substitution sont supprimés sauf s'ils sont délimités par des guillemets. Par exemple, si la valeur renvoyée par le programme est
    MSG0001 John " D o e "
    l'ID message est MSG0001, le premier texte de substitution est John et le second texte de substitution est D o e. Pour définir le guillemet dans le texte de substitution, codez-le deux fois. Par exemple, si la valeur renvoyée par le programme est
    MSG0002 ab""c...
    le texte de substitution est ab"c....

    Si la ressource de messages spécifiée dans l'assistant Configuration d'exécution des outils Web i est un fichier de messages i, vous pouvez fournir un texte de substitution de 1024 octets maximum. Chaque texte de substitution doit être correctement formaté. Par exemple, une variable de substitution de 4 octets doit être formatée comme suit : "   a". Quatre octets doivent donc être fournis.

    Si la ressource de messages spécifiée dans l'assistant Configuration d'exécution des outils Web i est un fichier de propriétés, vous devez coder les variables de substitution du message en respectant le format {n}, où n représente un numéro de substitution compris entre 0 et 3, ce qui signifie que 4 variables de substitution sont autorisées. Exemple de format de message :
    MSG0001=Mon prénom est {0}. Mon nom est {1}.
  2. Utilisez la zone ID message pour spécifier l'ID message à afficher. Vous pouvez modifier les entrées de cette zone. Vous pouvez également sélectionner trois valeurs spéciales :
    • *NONE - Aucun message n'est associé à la valeur de paramètre.
    • *PARM - La valeur de paramètre est utilisée comme ID message.
    • *SELECT - Vous êtes invité à sélectionner un message i.

      Cette option apparaît si un fichier de messages i est sélectionné dans l'assistant de configuration d'exécution.

  3. Utilisez la zone Composant Web pour indiquer les composants Web à spécifier pour afficher les messages. Vous pouvez pour cela utiliser les composants Web suivants Zone de liste, Libellé, Boîte de sélection ou Zone de texte. Ces composants Web ne peuvent pas être associés à un paramètre d'entrée ou de sortie. Vous ne pouvez pas modifier la zone.
    • *DEFAULT - Le message ne s'affiche pas dans un composant Web. Le message est converti en un message Struts. Si la version Struts du projet Web est antérieure à la version 1.1, le message est converti en objets ActionError Struts. Dans le cas contraire, des objets ActionMessage Struts sont créés. Pour afficher les messages, vous devez ajouter les balises Struts appropriées aux fichiers JSP. Si les fichiers JSP sont générés par l'assistant d'interaction Web, les balises sont ajoutées automatiquement. Les balises générées dépendent de la version Struts du projet Web. Si la version Struts est antérieure à la version 1.1, le système génère la balise suivante :
      <html:errors/> 
      Sinon, il génère la balise suivante :
      <html:messages id="msg" message="true">
      <bean:write name="msg"/><br>
      </html:messages>
  4. Sélectionnez Nouveau pour ajouter une valeur de paramètre, un ID message et un composant Web à associer au paramètre Contrôleur de messages.
  5. Utilisez Supprimer pour supprimer une définition spécifiée pour le paramètre Contrôleur de messages.
  6. Cliquez sur Monter et Descendre pour modifier l'ordre des définitions spécifiées pour le paramètre Contrôleur de messages.

Commentaires en retour