Ajouter les gestionnaires d'événements (hébergement 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 prend comme premier paramètre le nom du client et comme second paramètre le login du client. Pour plus de simplicité, nous utiliserons un fichier batch appelé test-handler.bat et qui se présente comme suit :


echo "--------------" >> c:\windows\temp\event_handler.log
rem information sur la date et l'heure de l'événement
date /T >> c:\windows\temp\event_handler.log
rem information sur le compte client créé
echo "client created" >> c:\windows\temp\event_handler.log
rem nom du client
echo "name: %1" >> c:\windows\temp\event_handler.log
rem nom d'utilisateur du client
echo "login: %2" >> c:\windows\temp\event_handler.log
echo "--------------" >> c:\windows\temp\event_handler.log

Ce script imprime des informations dans un fichier afin que nous puissions en contrôler l'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 de contrôle :

  1. Allez dans Accueil > Gestionnaire d'événements (dans le groupe Logs & Statistiques).
  2. Cliquez sur Nouv. gestionnaire d'événements. La page des propriétés du gestionnaire d'événements s'ouvre :
  3. Choisissez l'événement auquel vous voulez affecter un gestionnaire dans la liste déroulante Evé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ée' dans la liste déroulante Priorité puis tapez la valeur dans le champ.

    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'est la commande c:\program files\parallels\plesk\scripts\test-handler.bat" <new_contact_name> <new_login_name>.

    Remarque : Si le nom des répertoires ou le nom du fichier contient des espaces, il faut mettre le chemin entre guillemets.

  7. Cliquez sur OK.

Remarque : Remarque : Dans la commande, nous avons écrit les paramètres entre crochets obliques <new_contact_name> and <new_login_name>. Avant que le gestionnaire ne soit lancé, ces paramètres seront remplacés par le nom et le login du client créé. La liste complète des paramètres disponibles est donnée ci-dessous. Souvenez-vous que pour les opérations de suppression, les paramètres de type new_xxx contiennent une chaîne vide. Et avec les opérations de création, les paramètres de type old_xxx contiennent une chaîne vide.

Maintenant, si vous vous connectez à votre Parallels Plesk Panel et créez un nouveau client en indiquant comme valeur 'Some client' dans le champ Contact name, et 'some_client' dans le champ Login, le gestionnaire sera appelé et les enregistrements suivants seront ajoutés au journal c:\windows\temp\event_handler.log :


Sat Jun 26 21:46:34 NOVT 2004
client created
name: Some client
login: some_client

Si vous voulez indiquer un voire plusieurs gestionnaire(s) supplémentaire(s), répétez les étapes ci-dessus.

Pour en savoir plus sur les événements qui peuvent être traités par le Gestionnaire d'événements, reportez-vous au Guide d'administration avancée de Parallels Plesk Panel disponible à partir du site Web Parallels.