Manuel des Scripts Automation Engine > Organisation fonctionnelle > Traitement des erreurs et messages > :SEND_MSG

:SEND_MSG

Instruction de script : Envoie des messages à des utilisateurs connectés à l'interface utilisateur.

Syntaxe

:SEND_MSG Name, Department, Message

Syntaxe	Description / format
Nom	Nom de l'utilisateur qui est connecté à l'interface utilisateur et qui doit recevoir le message. Format : littéral de script, variable de script ou fonction de script Les caractères génériques "" et "?" sont autorisés. "" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère.
Département	Département de l'utilisateur qui est connecté à l'interface utilisateur et qui doit recevoir le message. Format : littéral de script, variable de script ou fonction de script Les caractères génériques "" et "?" sont autorisés. "" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère.
Message	Message qui doit être envoyé. Format : littéral de script, variable de script ou fonction de script

Syntaxe

Description / format

Nom

Nom de l'utilisateur qui est connecté à l'interface utilisateur et qui doit recevoir le message.
Format : littéral de script, variable de script ou fonction de script

Les caractères génériques "*" et "?" sont autorisés. "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère.

Département

Département de l'utilisateur qui est connecté à l'interface utilisateur et qui doit recevoir le message.
Format : littéral de script, variable de script ou fonction de script

Les caractères génériques "*" et "?" sont autorisés. "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère.

Message

Message qui doit être envoyé.
Format : littéral de script, variable de script ou fonction de script

Remarques

Cette instruction de script permet d'envoyer des messages aux utilisateurs. Ceux-ci s'affichent dans la fenêtre des messages correspondante.

Le message n'étant envoyé qu'aux utilisateurs connectés à l'interface utilisateur, Automic recommande d'utiliser l'élément de script SYS_USER_ALIVE, qui permet de vérifier l'état des utilisateurs.

L'erreur "20698" se produit si l'utilisateur n'existe pas. La réaction à cette erreur peut être définie à l'aide de l'instruction de script :ON_ERROR et analysée avec les fonctions de script pour le traitement des erreurs. Le traitement du script se poursuit mais peut également être interrompu si nécessaire.

Les messages envoyés sont consignés et listés dans la catégorie messages de la supervision système. Le type de message est "Information" et la catégorie de message s'appelle "Message".

Notez que les messages envoyés ne sont affichés que si l'option "Afficher seulement les messages d'erreur et d'avertissement" de l'interface utilisateur n'est pas activée.

Le privilège "Voir tous les messages de ce client" permet également d'afficher les messages envoyés aux autres utilisateurs.

Exemples

L'utilisateur "PHILIBERT" du département "INFORMATIQUE" est connecté à l'interface utilisateur reçoit une demande pour démarrer la sauvegarde. Si l'utilisateur n'est pas connecté à l'interface utilisateur, un objet notification est démarré.

:SET &RET# = SYS_USER_ALIVE("BROWN","IT")

:IF &RET# = "Y"
: SEND_MSG "BROWN","IT","Please start backup routine!"
:ELSE
: SET &ACTOBJ# = ACTIVATE_UC_OBJECT(CALL,"DAY_SHIFT")
:ENDIF

Dans l'exemple suivant, l'utilisateur reçoit le même message que dans l'exemple ci-dessus. Une fonction de script est utilisée pour le département et une variable de script pour le message.

:SET &MSG# = "Please start backup routine!"
:SEND_MSG "BROWN",SYS_USER_DEP(),&MSG#

L'exemple suivant utilise des caractères génériques pour envoyer le message à tous les utilisateurs du département "INFORMATIQUE".

:SEND_MSG "*","IT","Please start backup routine!"

Rubriques connexes :

Elément de script	Description
SYS_USER_ALIVE	Vérifie si l'utilisateur est connecté à AE par une interface utilisateur.
SEND_MAIL	Envoie un e-mail à un utilisateur.

Eléments de script - Traitement des erreurs et messages

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle