Envoi d'un message électronique par le biais du bloc SEND_REQ
(Traduction du document original anglais)
A propos de nous
Utilisation du bloc SEND_REQ pour envoyer des messages électroniques préconfigurés
Utilisez le bloc SEND_REQ dans l'application pour envoyer l'un des trois messages électroniques configurés précédemment dans Control Expert par programme.
NOTE : Pour envoyer un message électronique avec le bloc SEND_REQ, vous devez synchroniser le service SMTP et l'application de l'automate, c'est-à-dire activer le service SMTP chaque fois que l'automate est en mode RUN.
Représentation en FBD
Paramètres d'entrée
Le tableau suivant décrit les paramètres d'entrée :
Paramètre
Type de données
Description
ADR
Array [0...5] of INT
Chemin de l'équipement de destination, dont l'adresse se termine par SYS, par exemple, rack.emplacement.voie.SYS.
Utilisez la fonction élémentaire ADDR pour effectuer la conversion du format de chaîne vers le format de tableau d'entiers (ARRAY OF INT). Par exemple, si le module est configuré au niveau du rack 0, emplacement 4, voie 0, utilisez : ADDR(‘0.4.0.SYS’).
CODE
INT
Utilisez le code de requête 0x37 (objet d'écriture) pour envoyer la requête SMTP au module de communication Ethernet TSX ETC 101.
EMIS
Array [n...m] of INT
Chaîne de caractères à émettre. La longueur maximale des données à envoyer est de 246 octets. Reportez-vous à la description suivante de la structure de paramètres EMIS.
Le paramètre EMIS contient la chaîne de caractères à envoyer.
Description de EMIS
Valeur
Octet
Mot
Catégorie
0x96
0 (octet de poids faible)
0
Segment
0x15
1 (octet de poids fort)
Type
0
2 (octet de poids faible)
1
Octet réservé 1
0
3 (octet de poids fort)
Octet réservé 2
0
4 (octet de poids faible)
2
Nombre de caractères (n1) commençant à l'octet suivant (c'est-à-dire, le numéro d'en-tête de messagerie)
n1                         (doit être ≤240)
5 (octet de poids fort)
Numéro d'en-tête de messagerie
1, 2, 3
6 (octet de poids faible)
3
Nombre de caractères (n2) à ajouter à la ligne d'objet du message électronique
n2                         (doit être ≤(n1–2))
7 (octet de poids fort)
n2 caractères ajoutés à la ligne d'objet de message électronique1
<défini par l'utilisateur>
8...245 (max.)
4...122 (max.) (= (n1–2)/2)
Corps du message électronique1, 2
<défini par l'utilisateur>
 
1
Les (n1 - 2)/2 mots suivants (119 maximum) contiennent les données au format ASCII qui seront copiées dans le message électronique. Les n2 premiers caractères sont ajoutés à l'objet du message électronique configuré et le reste fait partie du corps du message :
2
Utilisez la balise à deux caractères $N (ou $n) pour insérer un saut de ligne dans le texte du message électronique.
Paramètres d'entrée/sortie
Le tableau ci-dessous décrit le paramètre de gestion GEST, qui est le seul paramètre d'entrée/sortie :
Paramètre
Type de données
Description
GEST
Array [0...3] of INT
Paramètre de gestion composé de 4 mots.
Le paramètre de gestion GEST possède la structure suivante :
Description
Ordre des mots
MSB
LSB
Données gérées par le système
1
Numéro d'échange
Bit d'activité : le premier bit du premier mot. Il indique l'état d'exécution de la communication :
  • 1 = le message électronique est envoyé
  • 0 = le message électronique est terminé
2
Compte rendu d'opération
Compte rendu de communication
Données gérées par l'utilisateur
3
Timeout
4
Longueur : taille de la mémoire tampon de données.
Paramètres de sortie
Le tableau ci-dessous décrit le paramètre de réception des données RECP, qui est le seul paramètre de sortie :
Paramètre
Type de données
Description
RECP
Array [n...m] of INT
La requête n'a pas renvoyé de données.