Ajouter les gestionnaires d'évènements (Windows)

Pour ajouter un gestionnaire d'évènements :

Créons par exemple un gestionnaire d'évènements pour l'évènement "création d'un compte client". Le gestionnaire acceptera un nom de client en tant que premier paramètre et un nom d'utilisateur comme deuxième paramètre. Pour plus de simplicité, nous utilisons un fichier batch appelé "test-gestionnaire.bat" similaire à :

echo "--------------" >> c:\windows\temp\event_handler.log
rem information on the event date and time
date /T >> c:\windows\temp\event_handler.log
rem information on the created customer account
echo "customer created" >> c:\windows\temp\event_handler.log
rem customer's name
echo "name: %1" >> c:\windows\temp\event_handler.log
rem customer's username in Plesk
echo "login: %2" >> c:\windows\temp\event_handler.log
echo "--------------" >> c:\windows\temp\event_handler.log

Ce script imprime quelques informations dans un fichier pour qu'il soit possible de contrôler son exécution.

Supposons que notre script se trouve dans le répertoire c:\program files\parallels\plesk\scripts\. Enregistrons-le en créant un gestionnaire d'évènements via le Panneau d'administration :

1. Allez dans Outils & Paramètres > Gestionnaire d'évènements.
2. Cliquez sur Ajouter un gestionnaire d'événements.
3. Choisissez l'évènement auquel vous voulez affecter un gestionnaire dans le menu déroulant Événements.
4. Choisissez le degré de priorité pour l'exécution du gestionnaire ou indiquez une valeur de votre choix. Pour cela, sélectionnez personnalisé dans la liste déroulante Priorité et saisissez la valeur.

   Quand vous affectez plusieurs gestionnaires à un seul évènement, vous pouvez préciser l'ordre d'exécution des gestionnaires, en configurant des priorités différentes (une plus grande valeur correspond à une priorité plus élevée).

5. Sélectionnez l'utilisateur système au nom duquel le gestionnaire sera exécuté.
6. Dans la zone de saisie Commande, entrez la commande devant s'exécuter quand l'évènement sélectionné se produit. Dans notre exemple : c:\program files\parallels\plesk\scripts\test-handler.bat" <new_contact_name> <new_login_name>.

   Remarque : si les noms des répertoires ou des fichiers contiennent des espaces, le chemin d'accès doit être entre guillemets.

7. Cliquez sur OK.

Remarque : dans la commande, nous avons indiqué les paramètres entre chevrons <new_contact_name> et <new_login_name>. Avant l'exécution du gestionnaire, ils seront remplacés respectivement par le nom et le nom d'utilisateur du client créé. Vous trouverez la liste complète des paramètres disponibles dans l'Appendice C : Paramètres des évènements transmis par les gestionnaires d'évènements.

Maintenant, si vous vous connectez à Plesk et créez un compte client en indiquant comme valeur "Some Customer" dans le champ Nom du contact et "some_customer" dans le champ Nom d'utilisateur, le gestionnaire sera appelé et les enregistrements suivants seront ajoutés au journal c:\windows\temp\event_handler.log :

Mon March 15 21:46:34 NOVT 2010
customer created
name: Some Customer
username: some_customer

Si vous voulez indiquer un ou plusieurs gestionnaires supplémentaires, répétez les étapes ci-dessus.