LNCSNDMAIL - Commande CL

La commande LNCSNDMAIL permet d'envoyer des messages électroniques et d'en contrôler les principales caractéristiques :

les destinataires (direct, en copie) l'objet, le texte du message, la (les) pièce(s)

jointe(s), le niveau de priorité, l'activation de l'accusé de réception.

Les messageries utilisées doivent être compatibles MAPI (ce qui est le cas de

Outlook ou Exchange), sinon vous pouvez également utiliser Lotus Notes ou encore

utiliser un serveur SMTP.

Remarque : Pour envoyer vos messages, il n'est pas nécessaire que le système de

messagerie soit en cours d'exécution sur le poste.

Paramètres

Pièce jointe	DOC	*NONE
+ si autres valeurs
Dossier des pièces jointes	FLR	*NONE
Destinataire (s)	TOINTNET
Adresse de messagerie
Type de destinataire		*TO
+ si autres valeurs
Sujet	SUBJECT
Message	MSG	*NONE
Priorité	PTY	*NORMAL
Confirmation de réception	CFMDEL	*NO
Nom du PC serveur LAUNCHER	EXESRV	*DFT
Option de fin		*ALL
Type de message utilisée	MSGTYPE	*SMTP
Paramètres SMTP :
Adresse email de l'expéditeur	CFGSMTP	*DFT
Adresse email de retour		*DFT
Adresse ou nom du serveur SMTP		*DFT
Port du serveur SMTP		*DFT
Trace des envois effectués		*NO
Profil utilisateur SMTP		*NONE
Mot de passe de l’utilisateur		*NONE
Activer SSL		*NO
Timeout		*NONE
Nombre essais		*NONE
Chemin logfile		*DFT
Protocole SSL		TLS
Signature		*NO
Chiffrer (encrypter) email		*NO
Chemin certificat		*NONE
Mot de passe certificat		*NONE
Sécuriser les headers		*NO
Sujet du wrapper		*NONE
Vérifier adresses email		*NO

Détails

Pièce jointe (DOC)

Nom et chemin de chaque fichier à attacher.
Ce paramètre autorise plusieurs valeurs.

Pour spécifier plusieurs fichiers, entrez un signe '+' dans la ligne "+ si autres

valeurs" et tapez ENTER.

Dossier des pièces jointes (FLR)

Ce paramètre indique le nom du dossier pour les documents envoyés.

Si le chemin complet est indiqué au paramètre DOC, il faut mettre la valeur

*NONE dans ce paramètre.

Destinataire(s) (TOINTNET)

Indique l'adresse de messagerie du ou des utilisateurs auxquels la distribution est envoyée.

Vous pouvez indiquer jusqu'à 100 adresses de messagerie.

Ce paramètre admet des valeurs multiples.

Pour obtenir des zones d'entrée supplémentaires à l'écran, entrez un signe plus

(+) en regard de l'invite "+ si autres valeurs", puis appuyez sur ENTREE.

adresse de messagerie

Indiquez l'adresse de messagerie de la personne ou de l'entreprise à laquelle la distribution est envoyée (jusqu'à 253 caractères par adresse).

type de destinataire

Indique le type de destinataire utilisé.

Les valeurs possibles de type de destinataire sont les suivantes :

*TO

L'adresse de messagerie correspond au destinataire principal de la distribution.

*CC

L'adresse de messagerie recevra une copie de la distribution envoyée au destinataire principal.

*BCC

L'adresse de messagerie recevra une copie de la distribution.

Cependant, le destinataire de la copie ne sera pas désigné sur la distribution comme étant destinataire de la distribution.

Sujet (SUBJECT)

Description de la distribution. Vous pouvez indiquer jusqu'à 44 caractères.

Ce paramètre est obligatoire et ne peut pas commencer par un blanc ni être

constitué uniquement de blancs.

Message (MSG)

Indique le texte du message à envoyer aux destinataires.

Les valeurs possibles sont :

message

Saisir un message d'une longueur de 5000 caractères maximum.

Pour effectuer des sauts de lignes, taper %PARA% entre le texte de fin d'une

ligne et le début de texte de la ligne suivante.

*NONE

La valeur *NONE indique que l'envoi du mail ne contient pas de message.

*DOCMSG

La valeur *DOCMSG permet à l'utilisateur d'envoyer un document contenu dans le corps du message.

Ce fichier peut être dans différents formats (texte, HTML, RTF).

Remarque : la valeur *DOCMSG n'est admise que pour la messagerie SMTP.

Priorité (PTY)

Indique le niveau de priorité de la distribution (faible, normal ou élevé).

Les valeurs possibles sont les suivantes :

*NORMAL

La distribution n'est pas prioritaire.

*HIGH

La distribution est prioritaire.

*LOW

La distribution est de faible priorité.

Confirmation de réception (CFMDEL)

Indique si l'expéditeur désire recevoir une confirmation de réception lorsque le

destinataire reçoit la distribution.

Les valeurs possibles sont les suivantes :

*NO

L'expéditeur ne demande pas de confirmation de réception.

*YES

Une confirmation de réception est demandée.

Nom du serveur MAIL (EXESRV)

Spécifie le nom du serveur sur lequel l'envoi doit être exécuté.

Ce nom peut correspondre à un autre poste de travail.

Le nom du Host ou l'adresse IP sont des choix valides.

Les valeurs possibles sont :

*DFT

Le traitement est exécuté sur le serveur référencé dans le fichier LNCDFTP

réservé à la définition des options LAUNCHER Office (mot clé MSGSRV).

*DEV

Le traitement est exécuté sur le poste de l'utilisateur interactif courant.

Cette valeur ne pas être utilisée dans un trvail soumis.

adresse IP ou nom de l'hote

Le traitement est exécuté sur un PC du réseau, désigné ici par son nom d'hote, ou son adresse TCP/IP.

Remarque : Il est impératif que le programme LAUNCHER Office soit démarré sur le poste sur lequel les demandes sont exécutées.

Type de messagerie utilisé (MSGTYPE)

Ce paramètre indique le type de messagerie utilisé pour l'envoi du message ou du document vers le destinataire final.

*SMTP

La messagerie utilisée est de type SMTP.

*MAPI

La messagerie utilisée est de type MAPI.

*LOTUS

La messagerie utilisée est de type LOTUS.

Paramètres SMTP (CFGSMTP)

Ces paramètres sont requis dans le cas d'une messagerie SMTP.

Adresse email de l'expéditeur

Indique l'adresse email utilisé pour l'envoi des messages.

Les valeurs possibles sont :

*DFT

L'envoi utilise l'adresse email spécifié dans le mot clé MSGSND présent dans le fichier LNCDFTP.

adresse_email

Spécifiez l'adresse email de la personne qui envoi la distribution.

Adresse email de retour

Spécifie l'adresse de la personne qui réceptionne les réponses aux messages envoyés.

Adresse ou nom du serveur SMTP

Spécifie l'adresse IP du serveur SMTP utilisée.

Port du serveur SMTP

Port du serveur SMTP dans le cas ou le serveur n'utilise pas le port 25.

Trace des envois effectués

Valeur par défaut : *NO.

*YES :Permet de s'assurer que l'envoi du message s'est déroulé sans erreur.

Ce fichier est formaté par des séparateurs (;), pour pouvoir être importé dans une base de données ou EXCEL.
Utilisez WRKLNCDFT pour spécifier le chemin et le nom du fichier logfile.

Profil utilisateur SMTP

Profil utilisateur SMTP.

Mot de passe utilisateur SMTP

Mot de passe de l’utilisateur SMTP.

Activer SSL

Valeur par défaut : *NO.

SSL est utilisé pour accéder au serveur de messagerie SMTP spécifié.
Le protocole TLS est utilisé par défaut. Changez le paramètre Protocole SSL si vous voulez utiliser le protocole SMTPS.

Timeout

Définit le temps d'attente pour l'envoi d'un e-mail. Par défaut, aucun délai n'est spécifié (*NONE). C'est le temps de traitement du serveur SMTP une fois la connexion établie. Indiquez un délai en secondes.

Nombre essais

Indiquez le nombre d'essais pour envoyer un e-mail si le serveur SMTP n'est pas accessible. Par défaut, aucune nouvelle tentative (*NONE).

Indiquez un nombre de nouvelles tentatives.

Chemin logfile

Si la trace des envois effectués est activée (*YES), par défaut le chemin du logfile (*DFT) est défini avec la commande WRKLNCDFT. Vous pouvez spécifier ici un autre chemin que *DFT.

Protocole SSL

Par défaut: le protocole TLS (commande STARTTLS) est utilisé.
Le port #587 est généralement utilisé avec le protocole TLS.
Vous pouvez spécifier le protocole SMTPS, également appelé SMTP/SSL, SMTP over SSL ou SMTPS et utilise généralement le port #465.

Signer email

Mettre *YES pour signer l’email. Le chemin et le mot de passe du certificat sont obligatoires. Par défaut : *NO.

Chiffrer (encrypter) email

Le corps du mail est chiffré selon PKCS #7. Le chemin et le mot de passe du certificat sont obligatoires. Par défaut : *NO.

Chemin certificat

Chemin du certificat(fichier .p12) utilisé pour signer et/ou chiffrer l'email.

Mot de passe certificat

Mot de passe du certificat(fichier .p12) utilisé pour signer et/ou chiffrer l'email.

Sécuriser headers

Protection des en-têtes grâce à l'utilisation d'un message RFC 822. Un wrapper message/rfc822 est utilisé pour appliquer les services de sécurité S/MIME aux headers.
Voir norme RFC 8551 pour plus de détails. L'email sera reçu en pièce jointe par le destinataire.

Sujet du wrapper

Si SecureHeaders=*YES, par défaut le destinataire recevra un email sans objet et une pièce jointe contenant l'email spécifié. Vous pouvez spécifier ici un sujet afin d'éviter que l'email aille dans les spams.

Vérifier adresses email

Mettre *YES pour effectuer une vérification des adresses email des destinataires selon la norme RFC 5322, avant envoi. Par défaut : *NO.

Exemple

LNCSNDMAIL TOINTNET(('tech@easycom-aura.com' *CC) ('INFO@EASYCOM-AURA.COM')) SUBJECT('ENVOI DE MAIL') MSG('Ceci est un test d''envoi de mail avec LAUNCHER Office') CFGSMTP('TECH@EASYCOM-AURA.COM''TECH@EASYCOM-AURA.COM' '183.145.89.12')

Autre exemple

Envoi d’un fichier HTML en corps de mail avec SMTP. Accusé de réception demandé. Enregistrement des envois activé.

LNCSNDMAIL TOINTNET(('tech@easycom-aura.com') +

('sales@easycom-aura.com' *BCC)) +

SUBJECT(&OBJET) MSG(*DOCMSG) CFMDEL(*YES) +

EXESRV(*CURRENT) +

CFGSMTP('info@easycom-aura.com' +

'info@easycom-aura.com' +

'smtp.aura.fr' 0 *DFT *YES) +

DOCMSG('C:\A\R_11WORD.HTML')