• du robot,
• du contre-robot,
• du moniteur.

1. Dans le menu, dans le groupe "Paramétrage", cliquez sur "Paramétrer" puis sélectionnez l'option "Paramètres du robot de surveillance".
2. La fenêtre qui s'affiche reprend les caractéristiques du robot :
   • Nom, machine, répertoire d'accès.
   • Options d'alerte. Ces options d'alerte sont configurables pour :
     • alerte via WDBal,
     • alerte via Email,
     • alerte via programme tiers,
     En cas d'alerte par Email ou WDBal, il est possible de paramétrer le rapport envoyé.

Alerte par WDBal

• En mode partage réseau : répertoire des fichiers de données.
• En mode HFSQL Client/Serveur : serveur utilisé, port et base de données, ainsi que l'utilisateur et le mot de passe.

Alerte par email

• Serveur et port SMTP.
• Utilisateur et mot de passe associé pour utiliser le serveur SMTP.
• Sécurité utilisée.

Utilisation d'un programme tiers

• paramétrer l'envoi du rapport d'erreurs à un programme spécifique. Ce programme tiers se chargera de traiter les messages d'alerte.
  Pour utiliser ce mode de message d'alerte, indiquez le chemin de l'exécutable voulu. Cet exécutable doit être accessible depuis le poste d'installation du robot.
• spécifier une Webhook. L'appel à la webhook sera réalisé après chaque exécution de tests, en passant en paramètre un fichier JSON.
  Pour utiliser une webhook, il suffit de spécifier l'URL de la Webhook à appeler.

• %1 = Numéro identifiant le test
• %2 = Nom du test
• %3 = Nom de la catégorie du test
• %4 = Priorité du test
• %5 = Syntaxe du test (paramètres associées)
• %6 = Solution proposée pour le test
• %7 = Date de l'erreur
• %8 = Heure de l'erreur
• %9 = Message d'erreur renseigné dans la fiche du test
• %10 = Message d'erreur renvoyé par le robot

Appel d'une webhook
L'appel sera réalisé après chaque test exécuté, en passant en paramètre un fichier JSON.

Le fichier JSON a le format suivant :

{
 "RobotName": "Nom robot",
 "ControlName": "Nom du contrôle",
 "ControlCategory": "Nom de la catégorie",
 "Severity": "Niveau erreur"
 "ResponsibleList": "Responsable",
 "FirstError": "DateHeure de la première erreur",
 "ErrorMessage": "Message d'erreur",
 "IsError": 0/1
 "CustomError" : "Message personnalisé"
}

Les éléments présents dans le fichier JSON sont les suivants :

• RobotName : nom du robot de surveillance (utile si vous avez plusieurs robots dans votre organisation et si vous souhaitez tous les orienter vers la même webhook).
• ControlName : nom (libellé) du contrôle.
• ControlCategory : nom (libellé) de la catégorie du contrôle.
• Severity : niveau de gravité du contrôle. En version 26, ce paramètre vaut toujours "Erreur".
• ResponsibleList : liste des utilisateurs recevant les alertes de ce contrôle.
• FirstError : date et heure de la première erreur signalée. Ce membre est utile pour savoir depuis combien de temps un contrôle est en erreur.
• IsError : booléen indiquant si le contrôle est en erreur.
• ErrorMessage : message d'erreur du contrôle.
• CustomError : message de complément d'erreur (qui a été saisi dans les paramètres du contrôle, depuis le moniteur du robot).

Remarque : Si vous souhaitez réaliser une Webhook en WEBDEV :

1. Créez un projet WEBDEV avec une page AWP vide.
2. Dans la page AWP :
   • Déclarez la structure d'export :
     
     // Structure d'export
     STWebHookExport est une Structure
     RobotName est une chaîne
     ControlName est une chaîne
     ControlCategory est une chaîne
     Severity est une chaîne
     ResponsibleList est une chaîne
     FirstError est une DateHeure
     ErrorMessage est une chaîne
     IsError est un booléen
     CustomError est une chaîne
     FIN
      
     gtabInfoWebhook est un tableau de STWebHookExport
   • Récupérez et désérialisez les données avant de les utiliser :
     
     bufDonnéesPOST est un Buffer = PageParamètre(paramBuffer)
     Désérialise(gtabInfoWebhook,bufDonnéesPOST,psdJSON)

Liste des exemples associés :

Exemples didactiques (WEBDEV) : WW_Statut_Liste [ + ] Cet exemple est une implémentation très simple de la webhook mise à disposition par le robot de surveillance. Il suffit d'indiquer l'URL de la page webhook de l'exemple comme webhook à appeler dans les paramètres du robot de surveillance puis de définir les catégories et les contrôles. La page affichera toutes les 2 minutes l'état des contrôles.

Paramétrage du rapport

• La section "Objet de l'email envoyé" permet de construire le titre du message. Des macros permettent d'obtenir des informations spécifiques (nom du robot, nombre de contrôles en erreur, ...).
• La section "Mode d'alerte" permet de choisir le mode d'alerte retenu :
  • Mode "Alerte continue" (par défaut) :
    Si un contrôle donné est en erreur plusieurs fois de suite (par exemple, si le serveur ne répond pas pendant plusieurs minutes), le robot enverra systématiquement une alerte pour chaque erreur.
  • Mode "Panne/reprise"
    Si un contrôle donné est en erreur plusieurs fois de suite (par exemple, si le serveur ne répond pas pendant plusieurs minutes), le robot effectue les opérations suivantes :
    1. Le robot enverra une alerte lors de la première erreur détectée.
    2. Le robot enverra des alertes intermédiaires, toutes les xx minutes. Le délai entre chaque envoi est paramétrable.
    Il est également possible de n'envoyer aucun message intermédiaire.
    3. Le robot enverra un message lorsque le contrôle ne sera plus en erreur (par exemple si le serveur est redémarré).
    Notes :
    • Le mode "Panne/Reprise" s'applique à tous les contrôles (il n'est pas possible de préciser ce mode pour un contrôle en particulier).
    • Si ce mode est activé et que le robot surveille des éléments sensibles, il est conseillé d'envoyer des messages intermédiaires.
    • Exemple de déroulement :
      

      Temps	Etat du contrôle	Mode Alerte continue	Mode Panne/Reprise
      Instant T	Contrôle en erreur	Alerte envoyée	Alerte envoyée
      Instant T+1	Contrôle en erreur	Alerte envoyée	Aucune alerte envoyée
      Instant T+2	Contrôle en erreur	Alerte envoyée	Aucune alerte envoyée
      Instant T+3	Contrôle en erreur	Alerte envoyée	Aucune alerte envoyée
      Instant T+4	Contrôle en erreur	Alerte envoyée	Aucune alerte envoyée
      Instant T+5	Contrôle correct	Aucune alerte envoyée	Alerte envoyée