Groupe 1A (socle)
Date de création :	22 novembre 2004
Dernière modification :
Diffusion :	Esup-Portail

MAG

Plugin Message

Ce plugin permet d'afficher un message à l'utilisateur.

Comme tout plugin, son utilisation n'est possible qu'après l'avoir enregistré dans MainChannel :

Quatre méthodes sont accessibles aux développeurs pour réaliser différents types de messages :

Message.message(MainChannel, ChannelRuntimeData, MessageBean);

Cette méthode permet d'afficher un message simple associé à un type d'évênement (erreur, warning, information). Ce message est bloquant est permet de traiter une erreur fatale :

Message.message(mainChannel, runtimeData, new MessageBean("Erreur fatale"));

Erreur fatale

Par défaut le type d'évênement est une erreur mais il possible de forcer un type différent :

Message.message(mainChannel, runtimeData, new MessageBean("Opération terminée", Message.INFO));
Message.message(mainChannel, runtimeData, new MessageBean("Pensez à effectuer les modifications", Message.WARNING));
Message.message(mainChannel, runtimeData, new MessageBean("Erreur fatale", Message.ERROR));

Opération terminée

Pensez à effectuer les modifications

Erreur fatale

Message.message(MainChannel, ChannelRuntimeData, MessageBean, String);

Cette méthode est identique à la précédente sauf qu'elle n'est pas bloquante. Un bouton 'OK' apparait dans la feuille et redirige vers l'action définie comme quatrième paramètre :

Message.message(mainChannel, runtimeData, new MessageBean("Cliquez sur OK pour continuer", Message.INFO), "actionSuivante");

Message.message(MainChannel, ChannelRuntimeData, MessageBean, String, Hashtable);

Cette méthode est identique à la précédente sauf que cette fois il est possible de transmettre des paramètres à l'action suivante. Tous les couples clé / valeur contenus dans la Hashtable sont transmis à l'action suivante et pourront être récupérés dans les ChannelRuntimeData. Ces paramètres doivent être des chaînes de caractères :

Hashtable parameters = new Hashtable();
parameters.put("att1", "val1");
parameters.put("att2", "val2");
Message.message(mainChannel, runtimeData, new MessageBean("Cliquez sur OK pour continuer", Message.INFO), "actionSuivante", parameters);

Message.message(MainChannel, ChannelRuntimeData, Vector, String, Hashtable);

Cette méthode permet d'afficher une liste de messages de types différents. Comme la précédente il est possible de spécifier des paramètres qui seront récupérés par l'action suivante :

Vector messages = new Vector();
messages.add(new MessageBean("L'opération 1 a échoué"));
messages.add(new MessageBean("L'opération 2 s'est bien passée", Message.INFO));
messages.add(new MessageBean("L'opération 3 s'est bien passée mais des erreurs subsistent", Message.WARNING));
Hashtable parameters = new Hashtable();
parameters.put("att1", "val1");
parameters.put("att2", "val2");
Message.message(mainChannel, runtimeData, messages, "actionSuivante", parameters);

L'opération 1 a échoué     L'opération 2 s'est bien passée     L'opération 3 s'est bien passée mais des erreurs subsistent

Dans le cas où on ne souhaite pas passer de paramètres à l'action suivante, il suffit de passer une Hashtable vide comme paramètre.

Création : 22 novembre 2004 - Mathieu Larchet (Université Nancy 2)