Configuration de la notification par message électronique
 
A propos de nous
Introduction
Le service de notification par message électronique permet la signalisation d'alarmes et d'événements sur les projets utilisant un contrôleur. Le contrôleur surveille le système et peut créer automatiquement un message électronique d'alerte contenant des données, des alarmes et/ou des événements. Les destinataires du message électronique peuvent se trouver sur le réseau local ou à distance.
NOTE : Testez le bloc de message électronique avant de l'utiliser dans une application. Si vous configurez de manière incorrecte un bloc MSTR pour qu'il reçoive un message électronique lorsqu'un problème est détecté, le message électronique risque de ne pas être envoyé comme prévu.
Types de système de messagerie
Le protocole SMTP fournit deux mécanismes de transmission des messages email :
Mécanisme
Condition
Résultat
Connexion directe
L'expéditeur et le destinataire sont connectés au même service de transport.
Les messages email sont envoyés à l'hôte.
Système de relais
L'expéditeur et le destinataire ne sont pas connectés au même service de transport.
Les messages email sont relayés d'un serveur à l'autre.
Pour relayer les messages, le serveur SMTP utilise les adresses de :
  • l'hôte de destination,
  • la boîte aux lettres de destination.
Client de service de messagerie
Le module de tête de contrôle 140NOC78100 inclut un client SMTP. Lorsque le module reçoit une demande spécifique issue du projet, il envoie un message email au serveur de messagerie.
Affichage de la page SMTP
Pour afficher la page SMTP, procédez comme suit :
Etape
Action
1
Cliquez sur Services dans l'arborescence de navigation, dans le volet gauche de l'éditeur d'équipement.
Résultat : La page Services s'affiche.
2
Dans la page Services, dans le champ SMTP sélectionnez Activé. Cliquez ensuite sur Appliquer.
Résultat : SMTP apparaît dans l'arborescence de navigation.
3
Sélectionnez SMTP dans l'arborescence de navigation.
4
Cliquez sur Appliquer pour enregistrer les modifications et laisser la fenêtre ouverte ou cliquez sur OK pour enregistrer les modifications et fermer la fenêtre.
Configuration du service de messagerie
Une condition ou un événement défini par l'utilisateur déclenche la création d'un message par un bloc MSTR. Chaque message utilise l'un des trois en-têtes définis par l'utilisateur. Chaque message envoyé depuis le contrôleur peut contenir du texte et des variables (au maximum 238 octets).
Le projet sélectionne l'en-tête approprié. Chaque en-tête contient les éléments suivants :
Les propriétés ci-dessous peuvent être affichées et modifiées dans la page SMTP :
Propriété
Description
Adresse IP du serveur SMTP
Entrez l'adresse IP du serveur de messagerie.
Port du serveur SMTP
Le numéro du port TCP par défaut utilisé pour SMTP est 25. Configurez le port comme défini par votre serveur de messagerie local.
Authentification par mot de passe
Si vous devez protéger l'accès, cochez l'option Authentification par mot de passe. Renseignez les champs suivants :
  • Nom de connexion
    • Tout caractère imprimable autorisé
    • 64 caractères maximum
  • Mot de passe
    • Tout caractère imprimable autorisé
    • 64 caractères maximum
NOTE : Vous pouvez également utiliser un nom de connexion (ID système) et un mot de passe pour authentifier la connexion au serveur de messagerie SMTP. La méthode d'authentification prise en charge par SMTP est LOGIN.
En-tête de message email
Chaque en-tête contient les éléments suivants :
  • L'identifiant de l'expéditeur dans le champ De
    • 32 caractères maximum (sans espace)
  • La liste des destinataires dans le champ A
    • Séparez les adresses par une virgule.
    • 128 caractères maximum
  • Partie fixe du message dans le champ Objet1
    • 32 caractères maximum
1 Le champ Objet comporte deux parties :
  1. partie fixe (32 caractères maximum)
  2. partie dynamique (206 caractères maximum)
Un administrateur autorisé peut définir et mettre à jour le texte et les variables. Définissez les 3 en-têtes de message indiquant le niveau d'importance. Par exemple :
  • En-tête 1 : Problème signalé par l'automate 10.
  • En-tête 2 : Notification de la sous-station 10.
  • En-tête 3 : Message d'information du système de distribution d'eau.
La liste d'expéditeurs définie pour chacun des trois en-têtes permet de transmettre rapidement chaque type d'information aux personnes concernées. Le projet ajoute des informations spécifiques, telles que l'équipement, le processus et l'emplacement. Ces informations pertinentes sont ajoutées au corps du message email. Le message complet est ensuite envoyé au serveur de messagerie pour être distribué aux destinataires. Ces destinataires peuvent être des ingénieurs, des responsables de projet ou des responsables de processus.
Utilisation du bloc MBP__MSTR pour le service de messagerie
Chaque opération est identifiée par un code. Pour envoyer un message email, utilisez le bloc MBP_MSTR avec le code fonction 13.
Paramètres MBP_MSTR
Le tableau suivant décrit les paramètres MBP_MSTR :
Paramètre
Type de données
Description
enable
aucun
activé = active l'opération MBP_MSTR sélectionnée
abort
aucun
activé = interrompt l'opération MBP_MSTR active
active
aucun
actif = l'instruction est active
error
aucun
actif = l'opération MBP_MSTR est interrompue avant l'exécution complète
success
aucun
actif = opération réussie
control
INT, UINT
Le bloc de contrôle est le premier mot parmi plusieurs mots de maintien contigus dépendants du réseau et le premier mot parmi 9 mots contigus saisis dans le nœud supérieur.
Les 8 autres mots sont :
affiché : identifie l'un des MBP_MSTR = 13
premier implicite
affiche l'état de l'erreur détectée (voir Codes d'erreur détectée du service de messagerie)
deuxième implicite
affiche la longueur (nombre de mots transférés)
troisième implicite
non utilisé
quatrième implicite
Octet de poids fort : adresse de l'emplacement du module de tête 140NOC78100 ou 0xFE pour 140 CPU 651 •0.
Octet de poids faible : 0 (non utilisé)
cinquième implicite
non utilisé
sixième implicite
non utilisé
septième implicite
non utilisé
huitième implicite
non utilisé
databuf
INT, UINT
Le paramètre databuf est l'adresse du tampon contenant les données insérées dans le corps du message email. Les données doivent être au format ASCII à partir du deuxième mot.
NOTE :
  1. L'octet de poids faible du premier mot contient un en-tête de message valide (configuré) (la valeur doit être 1, 2 ou 3).
  2. L'octet de poids fort du premier mot contient la longueur de la partie dynamique du champ objet du message. La longueur est comprise entre 0 et 238 caractères.
Description du paramètre databuf
Le premier mot du paramètre databuf contient les informations suivantes :
Numéro d'octet
Description
Valeur
1 (octet de poids faible)
En-tête de message email
{1, 2, 3}
2 (octet de poids fort)
Nombre n de caractères supplémentaires dans l'objet
défini par l'utilisateur (entre 0 et 238)
Le deuxième mot et les suivants (maximum 119) contiennent les données (format ASCII) qui seront copiées dans le message email. Les n premiers caractères sont ajoutés à l'objet configuré pour les messages email. Les caractères restants (2* N-2-n) sont inclus au corps du message. N représente le nombre de mots.
Branche du service de notification par message électronique
La branche du service de notification par message électronique contient les objets suivants :
Service
Description
emailIndex (1)
Valeur d'index dans la table du service de messagerie
smtpStatus (2)
Etat global du service SMTP :
  • idle (1) : aucune configuration
  • operational (2) : opérationnel et en cours d'exécution
  • stopped (3) : arrêté
smtpSrvAddr (3)
Adresse IP du serveur SMTP distant
smtpMailSentCnt (4)
Nombre total de messages email envoyés au réseau et acquittés par le serveur
smtpErrCnt (5)
Nombre total de messages email :
  • non envoyés au réseau
  • envoyés mais non acquittés par le serveur
L'objet smtpLastErr (6) détaille les erreurs détectées.
smtpLastErr (6)
Dernier code d'erreur détectée (voir les détails dans la rubrique Configuration d'un module de communication avec TFE (rubrique de la MIB privée)
smtpLastMailElapsedTime (7)
Nombre de secondes écoulées depuis l'envoi réussi du dernier e-mail
smtpLnkSrvStatus (8)
Etat du lien entre le module de communication et le serveur SMTP distant :
  • NOK (1) = le serveur SMTP n'est pas accessible.
  • OK (2) = le serveur SMTP est accessible.
smtpSrvChkFailCnt (9)
Nombre de détections de défaillance de la liaison au serveur SMTP
Modes de fonctionnement et envoi de requêtes
Comme le programme du contrôleur envoie la requête email, le contrôleur ne peut pas envoyer un message email lorsqu'il est en mode arrêt ou lorsqu'il télécharge un projet. Dès que le contrôleur passe en mode opérationnel, le bloc fonction envoie une requête lors du premier balayage de projets.
Les compteurs de diagnostics sont réinitialisés à 0 après un démarrage, le téléchargement d'un projet ou la reconfiguration du service de messagerie.