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 :
- 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.
- 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.
- 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}.
- 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 :
- 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.
- 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.
- Utilisez Supprimer pour supprimer une définition spécifiée pour
le paramètre Contrôleur de messages.
- Cliquez sur Monter et Descendre pour modifier l'ordre des définitions spécifiées pour le paramètre Contrôleur de messages.