Mercator 6.1 intègre un client SMTP. Ceci permet d'envoyer des mails directement à partir de Mercator, sans passer par un autre client de message (ex. Outlook).
Afin de pouvoir utiliser cet outil, il faut compléter les 3 paramètres SMTP repris dans "Outils / Options / Autres" :
- Serveur : nom ou adresse ip du serveur SMTP, dans votre réseau local ou chez votre provider (ex. relay.skynet.be, smtp.easynet.be, …)
- Port : en général 25
- Adresse de l'expéditeur : adresse email qui sera utilisée par défaut en tant que "from" et "reply" address.
- Nom de l'expéditeur : nom de l'expéditeur par défaut.
Le client SMTP peut être utilisé facilement dans tout module. La commande à utiliser est
sendmail_smtp() avec les paramètres suivants :
- To : adresse(s) de destination, éventuellement séparées par ,
- CC : adresse(s) CC, éventuellement séparées par ,
- BCC : adresse(s) BCC, éventuellement séparées par ,
- Subject : sujet du mail
- Message : corps du message, sous forme de texte brut ou sous forme HTML (doit obligatoirement commencer par la balise 'HTML' entre '<' et '>')
- Filenames : chemin(s) et nom(s) des fichiers complets des fichiers attachés, éventuellement séparés par ,
- Priorité (paramètre optionnel) : valeur numérique de 1 à 5. Par défaut 3.
- confEnvoi (paramètre optionnel) : valeur .T. / .F. pour demander la confirmation d'envoi. Par défaut .F.
- confLecture (paramètre optionnel) : valeur .T. / .F. pour demander la confirmation de lecture. Par défaut .F.
- extraHeaders (paramètre optionnel) : headers SMTP supplémentaires, tous séparés et terminant par carriage return et ligne feed. Par défaut : vide. Exemple : 'X-Actual-From: MDaemon@ineo.be'+CHR(13)+CHR(10)+'X-MDSend-Notifications-To: [trash]'+CHR(13)+CHR(10)
- forceHtml (paramètre optionnel) : valeur .T. / .F. pour forcer le format de corps de message en HTML. Par défaut .F.
Cette fonction renvoie
- une chaîne vide si le message a pu être envoyé correctement
- un message d'erreur sous forme d'une chaîne de caractères, dans le cas contraire
Exemple :
SMTP_FROM='postmaster@mercator.eu'
SMTP_FROMN='Postmaster Mercator'
local ret
ret=sendmail_smtp('guy.colsoul@mercator.eu','','','Sujet de test','Contenu de test','')
if empty(m.ret)
=stop('Message correctement envoyé !')
else
=stop(m.ret)
endif
Le menu "Outils / Tester SMTP" permet d'envoyer un message de test à quelconque adresse mail de test. Ceci permet de tester la validité des paramètres SMTP et la communication avec le serveur de messagerie. (Ce menu n'est visible que si les options SMTP sont complétées dans "Outils / Options / Autres)
SMTP authentifié
Depuis la version 7.0.20 de Mercator, il est possible d'envoyer un mail via un serveur SMTP qui requiert une authentification. Pour ce faire, il faut rajouter dans Mercator deux variables globales SMTP_LOGIN et SMTP_PASSW qui vont contenir respectivement le login et le mot de passe SMTP. Ces 2 variables peuvent être créées dans un autoexec.prg, ou dans un login.prg (si cette authentification varie en fonction de l'utilisateur) ou directement dans le script d'envoi de mail de l'action "Envoyer mail SMTP" (avant la commande sendmail_smtp)
Exemple de script de création de ces variables :
public SMTP_LOGIN
SMTP_LOGIN="myLogin"
public SMTP_PASSW
SMTP_PASSW="myPassword"
Remarque importante : INEO ne fournit aucune garantie quand à la compatibilité entre le client SMTP de Mercator et votre serveur SMTP. Le client SMTP de Mercator repose sur les outils System.Net.Mail présents dans le FrameWork .net. Dès lors, seules les méthodes d'authentification supportées directement par System.Net.Mail seront disponibles. Il est donc inopportun de demander à INEO des modifications ou adaptations concernant cette authentification.