OPALE - 10.0 - Utilisation - Envoyer un mail avec un document PDF - MAPSNDMAIL
Différence entre versions
(→A partir de la version 10.0) |
|||
(19 révisions intermédiaires par 2 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
− | ==Préambule== <!--T: | + | ==Préambule== <!--T:49--> |
− | <!--T: | + | |
+ | <!--T:50--> | ||
Avec la version "Opale", il est possible d'envoyer des emails avec un document PDF en pièce jointe avec un corps HTML personnalisé via la commande MAPSNDMAIL. | Avec la version "Opale", il est possible d'envoyer des emails avec un document PDF en pièce jointe avec un corps HTML personnalisé via la commande MAPSNDMAIL. | ||
− | <!--T: | + | |
+ | <!--T:51--> | ||
La commande '''MAPSNDMAIL''' prend en paramètre une maquette Designer (paramètre "Mapping format") . Celle-ci doit obligatoirement être générée en PDF. | La commande '''MAPSNDMAIL''' prend en paramètre une maquette Designer (paramètre "Mapping format") . Celle-ci doit obligatoirement être générée en PDF. | ||
Elle doit contenir des zones de type INDEX utilisées comme données dynamiques dans le sujet, le nommage des pièces jointes ou dans le contenu du corps de l'email. | Elle doit contenir des zones de type INDEX utilisées comme données dynamiques dans le sujet, le nommage des pièces jointes ou dans le contenu du corps de l'email. | ||
− | == Généralités sur la commande MAPSNDMAIL== <!--T: | + | == Généralités sur la commande MAPSNDMAIL== <!--T:52--> |
===Avant V10.1=== | ===Avant V10.1=== | ||
+ | <!--T:53--> | ||
La commande MAPSNDMAIL sur IBM i a plusieurs paramètres : | La commande MAPSNDMAIL sur IBM i a plusieurs paramètres : | ||
− | + | ||
− | Spooled file . . . . . . . . . . Name <span style="color:blue">Nom du spool</span> | + | Spooled file . . . . . . . . . . Name <span style="color:blue">Nom du spool</span> |
Spooled file number . . . . . . *LAST *LAST *ONLY 000000-999999 <span style="color:blue">Numéro du spool</span> | Spooled file number . . . . . . *LAST *LAST *ONLY 000000-999999 <span style="color:blue">Numéro du spool</span> | ||
Job Name . . . . . . . . . . . . *CURRENT Name, *CURRENT , *DEV <span style="color:blue">Nom du job</span> | Job Name . . . . . . . . . . . . *CURRENT Name, *CURRENT , *DEV <span style="color:blue">Nom du job</span> | ||
Ligne 42 : | Ligne 45 : | ||
Autres paramètres | Autres paramètres | ||
Code Page . . . . . . . . . . . *SPL *SPL, 037,1147 <span style="color:blue">Spécifier un code page</span> | Code Page . . . . . . . . . . . *SPL *SPL, 037,1147 <span style="color:blue">Spécifier un code page</span> | ||
− | ===A partir de la V10.1=== | + | |
+ | ===A partir de la V10.1=== <!--T:54--> | ||
Depuis la version 10.1 de la suite OPALE, il est possible d'envoyer des emails en mode XPS en utilisant la conversion XPS to PDF. | Depuis la version 10.1 de la suite OPALE, il est possible d'envoyer des emails en mode XPS en utilisant la conversion XPS to PDF. | ||
Pour cela, 2 nouveaux paramètres sont apparus : | Pour cela, 2 nouveaux paramètres sont apparus : | ||
+ | <!--T:55--> | ||
'''Type de langage . . . . . . . . . . . ________ *XPS <br> ''' | '''Type de langage . . . . . . . . . . . ________ *XPS <br> ''' | ||
'''Imprimante XPS / Language . . . ________ Nom, *PDF,''' | '''Imprimante XPS / Language . . . ________ Nom, *PDF,''' | ||
+ | <!--T:56--> | ||
Il est donc possible d'utiliser un format XPS afin d'envoyer un email. (la génération en PDF native n'est plus utile) | Il est donc possible d'utiliser un format XPS afin d'envoyer un email. (la génération en PDF native n'est plus utile) | ||
+ | <!--T:57--> | ||
Type de langage . . . . . . . . . . . '''*XPS'''<br> | Type de langage . . . . . . . . . . . '''*XPS'''<br> | ||
Imprimante XPS / Language . . . '''*PDF ''' | Imprimante XPS / Language . . . '''*PDF ''' | ||
− | == Généralités sur la commande MAPSNDMAIL== | + | == Généralités sur la commande MAPSNDMAIL== <!--T:58--> |
+ | ==Nouveautés 10.8.0== | ||
+ | |||
+ | <!--T:59--> | ||
+ | La version 10.8.0 apporte son lots de nouveautés concernant les envoies d'emails. | ||
+ | |||
+ | ===Paramétrage SMTP sur l'écran de paramétrage d'envoies d'emails=== <!--T:60--> | ||
+ | Avant la version 10.8.0, le paramétrage SMTP se faisait via les variables d'environnement système '''WRKENVVAR'''. | ||
+ | Maintenant ce paramétrage n'est plus géré dans le WRKENVVAR mais directement dans l'écran de paramétrage des envoies d'emails | ||
+ | |||
+ | <!--T:61--> | ||
+ | Cet écran est disponible uniquement si vous disposez des droits SECOFR | ||
− | |||
− | <!--T:8--> | + | <!--T:62--> |
+ | <span style="background-color:Black;color:Lime;">SMTP server IP address Nom du serveur SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server port (25) Numéro du port de connexion</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server Login Nom d'utilisateur pour la connexion au server SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server Password Mot de passe pour la connexion au server SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP Protocol Protocole SMTP (SSL, DTLS, TLS1, TLS1.1, TLS1.2)</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server domain Nom du domain du serveur SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">Temp folder Répertoire temporaire (répertoire MAPSEND par défaut)</span> | ||
+ | Le dossier temporaire est le dossier où sont stockés les fichiers PDF envoyés par mail, les utilisateurs | ||
+ | envoyant des mails doivent avoir les droits d'accès en lecture et écriture sur ce répertoire | ||
+ | <span style="background-color:Black;color:Lime;">Data Queue processing <nowiki>***détail à compléter*** par défaut : MAPSMTP</nowiki></span> | ||
+ | La DTAQ par défaut est MAPSMTP (créée à l'installation), c'est elle qui permet au robot Mapping | ||
+ | d'envoyer automatiquement les spools au serveur de mail. Cette DTAQ doit exister. | ||
+ | <span style="background-color:Black;color:Lime;">Jobd for e-mailing <nowiki>***détail à compléter*** par défaut : MAPDSMTP2</nowiki></span> | ||
+ | La JOBD par défaut est MAPDSMTP2 (créée à l'installation). Elle définit les propriétés des jobs d'envoi de mail par le robot. Cette JOBD doit exister. | ||
+ | <span style="background-color:Black;color:Lime;">Message on success <nowiki>***détail à compléter*** *USER</nowiki></span> | ||
+ | Trois valeurs sont possibles : | ||
+ | - *NONE. Par défaut, aucune commande n'est exécutée. | ||
+ | - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. | ||
+ | - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée | ||
+ | <span style="background-color:Black;color:Lime;">Message on error <nowiki>***détail à compléter*** *USER</nowiki></span> | ||
+ | Les réactions sur succès et sur erreur sont gérées dans le programme MAP_C031P9. Les sources de ce programme sont dans le fichier MAP_SPECIF de la bibliothèque d'installation. | ||
+ | Trois valeurs sont possibles : | ||
+ | - *NONE. Par défaut, aucune commande n'est exécutée. | ||
+ | - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. | ||
+ | - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée | ||
+ | <span style="background-color:Black;color:Lime;">SMTP debug level (SSL, DTLS, TLS1, TLS1.1, TLS1.2)</span> | ||
+ | |||
+ | ===Paramétrage SMTP au niveau de la commande MAPSNDMAIL=== <!--T:63--> | ||
+ | |||
+ | <!--T:64--> | ||
+ | Depuis la version 10.8.0, il est possible de surcharger les valeurs de paramétrage du serveur SMTP au niveau de la commande. Le mail envoyé utilisera alors les informations renseignées dans la commande et ignorera, pour cette envoie uniquement, les paramètres renseignés dans l'écran de configuration général. | ||
+ | |||
+ | <!--T:65--> | ||
+ | La valeur '''*DFT''' fait référence au paramétrage de l'écran de configuration générale. Cette valeur peut être modifiée. | ||
+ | |||
+ | <!--T:66--> | ||
+ | <span style="background-color:Black;color:Lime;">Other parameters</span> | ||
+ | |||
+ | <!--T:67--> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server name or address (<nowiki>*DFT</nowiki>) Nom du serveur SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP server port (<nowiki>*DFT</nowiki>) Numéro du port de connexion</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP login name (<nowiki>*DFT</nowiki>) Login de connexion</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP login password (<nowiki>*DFT</nowiki>) password de connexion</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP protocol (<nowiki>*DFT</nowiki>) Prptocole SMTP</span> | ||
+ | <span style="background-color:Black;color:Lime;">SMTP domain name (<nowiki>*DFT</nowiki>) Nom de domaine</span> | ||
+ | |||
+ | ==Gestion des menus== <!--T:68--> | ||
+ | |||
+ | |||
+ | <!--T:69--> | ||
Le menu d'envoi d'e-mail s'appelle MAPSND. Pour y accéder, il faut entrer la commande : | Le menu d'envoi d'e-mail s'appelle MAPSND. Pour y accéder, il faut entrer la commande : | ||
GO MAPSND | GO MAPSND | ||
− | <!--T: | + | |
+ | <!--T:70--> | ||
[[FILE:MAPSND.jpg|500px]] | [[FILE:MAPSND.jpg|500px]] | ||
− | ===1. Paramétrage du mail=== <!--T: | + | ===1. Paramétrage du mail=== <!--T:71--> |
====Avant la version 10.0==== | ====Avant la version 10.0==== | ||
+ | <!--T:72--> | ||
Cet écran est disponible uniquement si vous disposez des droits SECOFR | Cet écran est disponible uniquement si vous disposez des droits SECOFR | ||
− | + | ||
+ | <!--T:73--> | ||
<span style="background-color:Black;color:Lime;">SMTP server IP address Nom du serveur SMTP</span> | <span style="background-color:Black;color:Lime;">SMTP server IP address Nom du serveur SMTP</span> | ||
Ligne 101 : | Ligne 171 : | ||
- *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée | - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée | ||
− | ====A partir de la version 10.0==== | + | ====A partir de la version 10.0==== <!--T:74--> |
A partir de la version MAPPING OPALE 10.1, un paramètre '''Mode utilisé pour envoyer''' est disponible : | A partir de la version MAPPING OPALE 10.1, un paramètre '''Mode utilisé pour envoyer''' est disponible : | ||
+ | <!--T:75--> | ||
Mode utilisé pour envoyer ____________ (*MAPPING, *IBM) | Mode utilisé pour envoyer ____________ (*MAPPING, *IBM) | ||
+ | <!--T:76--> | ||
Ces deux valeurs possibles sont : '''*MAPPING''' et '''*IBM''' | Ces deux valeurs possibles sont : '''*MAPPING''' et '''*IBM''' | ||
+ | <!--T:77--> | ||
'''*MAPPING''' permets d'avoir un comportement identique aux versions précédentes de MAPPING. En d'autres mots, MAPPING gère les envois des emails via le paramètrage SMTP stipulé en dessous de ce même écran de paramétrage. | '''*MAPPING''' permets d'avoir un comportement identique aux versions précédentes de MAPPING. En d'autres mots, MAPPING gère les envois des emails via le paramètrage SMTP stipulé en dessous de ce même écran de paramétrage. | ||
+ | <!--T:78--> | ||
'''*IBM''' permets de laisser la configuration SMTP de l'IBM-i(API IBM-i) prendre le relais pour les envois des emails. La configuration du server SMTP renseignée dans ce présent écran de configuration n'est alors pas utilisée. | '''*IBM''' permets de laisser la configuration SMTP de l'IBM-i(API IBM-i) prendre le relais pour les envois des emails. La configuration du server SMTP renseignée dans ce présent écran de configuration n'est alors pas utilisée. | ||
::<small>Support : [[OPALE:10.0:Utilisation:Param%C3%A9trage_SMTP_IBM-i|Paramétrage SMTP et envoi d'e-mail via l'API IBM i]]</small><br> | ::<small>Support : [[OPALE:10.0:Utilisation:Param%C3%A9trage_SMTP_IBM-i|Paramétrage SMTP et envoi d'e-mail via l'API IBM i]]</small><br> | ||
− | ===2. Démarrage de la gestion de mail=== <!--T: | + | ===2. Démarrage de la gestion de mail=== <!--T:79--> |
Ce menu permet de démarrer le travail MAPSMTP du sous-système MAPSROBOT. Ce travail doit absolument être démarré pour l'envoi de mail via la commande MAPSNDMAIL. Ce menu appelle la commande STRMAPMAIL. | Ce menu permet de démarrer le travail MAPSMTP du sous-système MAPSROBOT. Ce travail doit absolument être démarré pour l'envoi de mail via la commande MAPSNDMAIL. Ce menu appelle la commande STRMAPMAIL. | ||
− | ===3. Arrêt du mail=== <!--T: | + | ===3. Arrêt du mail=== <!--T:80--> |
Ce menu permet d'arrêter le travail MAPSMTP du sous-système MAPSROBOT. Ce menu appelle la commande ENDMAPMAIL. | Ce menu permet d'arrêter le travail MAPSMTP du sous-système MAPSROBOT. Ce menu appelle la commande ENDMAPMAIL. | ||
− | ===4. Affichage de la file d'attente des mails=== <!--T: | + | ===4. Affichage de la file d'attente des mails=== <!--T:81--> |
Ce menu permet d'afficher l'historique des envois d'e-mail. Il est possible de filtrer par nom d'utilisateur. Ce menu appelle la commande MAPDSPMAIL.<br /> | Ce menu permet d'afficher l'historique des envois d'e-mail. Il est possible de filtrer par nom d'utilisateur. Ce menu appelle la commande MAPDSPMAIL.<br /> | ||
'''Attention''' : L'accès à ce menu bloque les nouveaux envois d'e-mail. Il ne faut donc pas le laisser ouvert. | '''Attention''' : L'accès à ce menu bloque les nouveaux envois d'e-mail. Il ne faut donc pas le laisser ouvert. | ||
− | ===5. Envoi d'un mail=== <!--T: | + | ===5. Envoi d'un mail=== <!--T:82--> |
Ce menu permet l'envoi d'un e-mail avec ou sans pièce-jointe. Ce menu appelle la commande MAPSNDDST. | Ce menu permet l'envoi d'un e-mail avec ou sans pièce-jointe. Ce menu appelle la commande MAPSNDDST. | ||
− | ===6. Envoi d'un spool par mail=== <!--T: | + | ===6. Envoi d'un spool par mail=== <!--T:83--> |
Ce menu permet le maquettage d'un fichier spool IBM i ainsi que sa conversion en PDF et son envoi par e-mail. Ce menu appelle la commande MAPSNDMAIL. | Ce menu permet le maquettage d'un fichier spool IBM i ainsi que sa conversion en PDF et son envoi par e-mail. Ce menu appelle la commande MAPSNDMAIL. | ||
− | ===7. Contrôle du fonctionnement du mail=== <!--T: | + | ===7. Contrôle du fonctionnement du mail=== <!--T:84--> |
Ce menu permet de lister les travaux du sous-système liés à l'envoi d'e-mail (en l’occurrence MAPSMTP). | Ce menu permet de lister les travaux du sous-système liés à l'envoi d'e-mail (en l’occurrence MAPSMTP). | ||
− | ===8. Gérer les fichiers spoules (exécution interactive de MAPPING)=== <!--T: | + | ===8. Gérer les fichiers spoules (exécution interactive de MAPPING)=== <!--T:85--> |
Ce menu permet de gérer les fichiers spool. Cette fonctionnalité est la même que l'option 1 du menu GO MAPPING. Ce menu appelle la commande COGISPLF. | Ce menu permet de gérer les fichiers spool. Cette fonctionnalité est la même que l'option 1 du menu GO MAPPING. Ce menu appelle la commande COGISPLF. | ||
− | ==Mots-clés utilisés pour mapper automatiquement des données du fichier spool en entrée== <!--T: | + | ==Mots-clés utilisés pour mapper automatiquement des données du fichier spool en entrée== <!--T:86--> |
Comme vu précédemment, un prérequis de la commande MAPSNDMAIL est la conception d'une maquette Designer avec une génération en langage PDF. | Comme vu précédemment, un prérequis de la commande MAPSNDMAIL est la conception d'une maquette Designer avec une génération en langage PDF. | ||
Pour obtenir le contenu du fichier spool directement dans le corps de l'e-mail ou avoir l'adresse du destinataire et de l'émetteur pris dans le fichier spool, il existe plusieurs zones dans Designer (type de zone METADATA) : | Pour obtenir le contenu du fichier spool directement dans le corps de l'e-mail ou avoir l'adresse du destinataire et de l'émetteur pris dans le fichier spool, il existe plusieurs zones dans Designer (type de zone METADATA) : | ||
Ligne 146 : | Ligne 220 : | ||
*mapSubject : Utilisé pour prendre des données du fichier spool et les mettre dans le sujet de l'e-mail envoyé | *mapSubject : Utilisé pour prendre des données du fichier spool et les mettre dans le sujet de l'e-mail envoyé | ||
− | ===Utilisation des mots clés=== <!--T: | + | ===Utilisation des mots clés=== <!--T:87--> |
Pour utiliser les mots clés paramétrés dans le projet Designer (listés ci-dessus), il faut y faire référence dans la commande MAPSNDMAIL. | Pour utiliser les mots clés paramétrés dans le projet Designer (listés ci-dessus), il faut y faire référence dans la commande MAPSNDMAIL. | ||
− | <!--T: | + | |
+ | <!--T:88--> | ||
Pour ce faire, voici la liste des paramètres de la commande MAPSNDMAIL avec leurs valeurs respectives : | Pour ce faire, voici la liste des paramètres de la commande MAPSNDMAIL avec leurs valeurs respectives : | ||
− | <!--T: | + | |
+ | <!--T:89--> | ||
{| class="wikitable" | {| class="wikitable" | ||
! Nom du paramètre de la commande MAPSNDMAIL | ! Nom du paramètre de la commande MAPSNDMAIL | ||
Ligne 176 : | Ligne 252 : | ||
|} | |} | ||
− | ==Paramétrage== <!--T: | + | ==Paramétrage== <!--T:90--> |
− | ===Paramétrage de la variable d'environnement pour définir l'expéditeur des emails=== <!--T: | + | ===Paramétrage de la variable d'environnement pour définir l'expéditeur des emails=== <!--T:91--> |
L'adresse e-mail expéditrice des e-mails et son mot de passe doivent être configurés dans des variables d'environnements du serveur MAPPING. | L'adresse e-mail expéditrice des e-mails et son mot de passe doivent être configurés dans des variables d'environnements du serveur MAPPING. | ||
Pour ce faire : | Pour ce faire : | ||
− | <!--T: | + | |
+ | <!--T:92--> | ||
1) Taper la commande : | 1) Taper la commande : | ||
WRKENVVAR | WRKENVVAR | ||
− | <!--T: | + | |
+ | <!--T:93--> | ||
2) Créer les variables d'environnement en *SYS pour le fonctionnement avec le sous-système de Mapping contenant l'adresse e-mail et le mot de passe pour l'authentification du serveur SMTP | 2) Créer les variables d'environnement en *SYS pour le fonctionnement avec le sous-système de Mapping contenant l'adresse e-mail et le mot de passe pour l'authentification du serveur SMTP | ||
<span style="background-color:Black;color:Lime;">MAIL_PASSWORD MONMOTDEPASSE</span> | <span style="background-color:Black;color:Lime;">MAIL_PASSWORD MONMOTDEPASSE</span> | ||
<span style="background-color:Black;color:Lime;">MAIL_LOGIN MONADRESSEMAIL</span> | <span style="background-color:Black;color:Lime;">MAIL_LOGIN MONADRESSEMAIL</span> | ||
− | <!--T: | + | |
+ | <!--T:94--> | ||
L'adresse e-mail de l'expéditeur stipulée dans la commande MAPSNDMAIL devra être MONADRESSEMAIL. | L'adresse e-mail de l'expéditeur stipulée dans la commande MAPSNDMAIL devra être MONADRESSEMAIL. | ||
− | <!--T: | + | |
+ | <!--T:95--> | ||
PS : Dans le cas d'un envoi avec des expéditeurs variables (provenant du spool par exemple), une configuration du serveur SMTP est généralement possible pour autoriser les envois de mail à partir de n'importe quelle adresse mail. | PS : Dans le cas d'un envoi avec des expéditeurs variables (provenant du spool par exemple), une configuration du serveur SMTP est généralement possible pour autoriser les envois de mail à partir de n'importe quelle adresse mail. | ||
− | ===Paramétrage de serveur d'envoi d'emails=== <!--T: | + | ===Paramétrage de serveur d'envoi d'emails=== <!--T:96--> |
Sur l'option 1 du menu GO MAPSND, il faut renseigner les informations du serveur d'envoi d'e-mails : | Sur l'option 1 du menu GO MAPSND, il faut renseigner les informations du serveur d'envoi d'e-mails : | ||
* Adresse IP du serveur | * Adresse IP du serveur | ||
Ligne 203 : | Ligne 283 : | ||
* Domaine du serveur | * Domaine du serveur | ||
− | <!--T: | + | |
+ | <!--T:97--> | ||
'''Attention''' : Il faut absolument posséder un profil SECOFR pour accéder à ce menu. Si tel n'est pas le cas, l'accès au menu sera impossible et aucun message ne sera affiché. | '''Attention''' : Il faut absolument posséder un profil SECOFR pour accéder à ce menu. Si tel n'est pas le cas, l'accès au menu sera impossible et aucun message ne sera affiché. | ||
− | == | + | === Paramétrage de sécurité === <!--T:98--> |
+ | |||
+ | <!--T:99--> | ||
+ | ⚠ Paramétrage présent à partir d'Opale v10.5.0 | ||
+ | |||
+ | <!--T:100--> | ||
+ | Le mode de connexion sécurisé est TLS v1.2 par défaut. | ||
+ | |||
+ | <!--T:101--> | ||
+ | Cependant, il est possible de basculer vers d'autres modes moins fréquents ou moins sécurisés en renseignant une variable d'environnement <code>EMAILPROTOCOL</code>. | ||
+ | |||
+ | <!--T:102--> | ||
+ | Ce paramètre prend une valeur numérique entre 1 et 5. L'absence de ce paramètre entraine le choix du TLS v1.2 . | ||
− | ===Envoi simple d'un email avec PDF joint=== <!--T: | + | <!--T:103--> |
+ | {| class="wikitable" | ||
+ | ! Valeur | ||
+ | ! Protocol | ||
+ | |- | ||
+ | | 1 | ||
+ | | SSL v3 (sinon, v2 en cas de défaut) | ||
+ | |- | ||
+ | | 2 | ||
+ | | DTLS v1 | ||
+ | |- | ||
+ | | 3 | ||
+ | | TLS v1.0 | ||
+ | |- | ||
+ | | 4 | ||
+ | | TLS v1.1 | ||
+ | |- | ||
+ | | 5 (par défaut) | ||
+ | | TLS v1.2 | ||
+ | |} | ||
+ | |||
+ | ==Contenu Texte ou HTML== <!--T:104--> | ||
+ | Depuis la version 10.4.0 de MAPPING IBM-i, il est possible d'expliciter le type de contenu (Texte ou HTML) du corps des emails.</br></br> | ||
+ | '''Attention''' : Le comportement a changé en version 10.8.4 :[[MAPSNDMAIL depuis 10.8.4 - Changement de comportement sur le type de sortie TEXTE ou HTML dans le body du mail]] | ||
+ | ===Contenu Texte=== | ||
+ | Il est possible d'expliciter en texte le type de contenu de l'email envoyé par la commande MAPSNDMAIL. Pour cela il faut préfixer le contenu du body par %%TXT%% ou %%FILE_TXT%% | ||
+ | |||
+ | <!--T:105--> | ||
+ | %%TXT%% : Permet d'envoyer le body en mode texte (valeur par défaut) <br> | ||
+ | Exemple : %%TXT%%Voici le corps de mon email en texte | ||
+ | |||
+ | |||
+ | <!--T:106--> | ||
+ | %%FILE_TXT%% : Le contenu de l'email sera alors le contenu d'un fichier envoyé en mode texte | ||
+ | Exemple : %%FILE_TXT%%/home/monbody.txt (Fichier encodé en ANSI) | ||
+ | |||
+ | ===Contenu HTML=== <!--T:107--> | ||
+ | Il est possible d'expliciter en HTML le type de contenu de l'email envoyé par la commande MAPSNDMAIL. Pour cela il faut préfixer le contenu du body par %%HTML%% ou %%FILE_HTML%% | ||
+ | |||
+ | <!--T:108--> | ||
+ | %%HTML%% : Permet d'envoyer le body en mode HTML<br> | ||
+ | Exemple : %%HTML%%Voici le corps de mon email en <b>html</b> | ||
+ | |||
+ | |||
+ | <!--T:109--> | ||
+ | %%FILE_HTML%% : Le contenu de l'email sera alors le contenu d'un fichier envoyé en mode HTML | ||
+ | Exemple : %%FILE_HTML%%/home/monbody.html (Fichier encodé en ANSI) | ||
+ | |||
+ | ==Exemples== <!--T:110--> | ||
+ | |||
+ | ===Envoi simple d'un email avec PDF joint=== <!--T:111--> | ||
<span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) PAGSTR(1) PAGEND(10) STATE(READY)FROM('hotline@mappingsuite.onmicrosoft.com') | <span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) PAGSTR(1) PAGEND(10) STATE(READY)FROM('hotline@mappingsuite.onmicrosoft.com') | ||
TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps d''email') NAME1('PJ.pdf')</span> | TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps d''email') NAME1('PJ.pdf')</span> | ||
− | ===Envoi simple d'un email avec un corps d'email texte dynamique=== <!--T: | + | ===Envoi simple d'un email avec un corps d'email texte dynamique=== <!--T:112--> |
<span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) | <span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) | ||
PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com') | PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com') | ||
TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps d'email ayant pour donnée dynamique :<nowiki>[[DATE]]</nowiki>') NAME1('PJ.pdf')</span> | TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps d'email ayant pour donnée dynamique :<nowiki>[[DATE]]</nowiki>') NAME1('PJ.pdf')</span> | ||
− | ===Envoi d'un email avec un corps d'email HTML dynamique=== <!--T: | + | ===Envoi d'un email avec un corps d'email HTML dynamique=== <!--T:113--> |
− | <!--T: | + | |
+ | <!--T:114--> | ||
Le principe de cette fonctionnalité est d'utiliser un fichier HTML pour le corps de l'email. | Le principe de cette fonctionnalité est d'utiliser un fichier HTML pour le corps de l'email. | ||
− | <!--T: | + | |
+ | <!--T:115--> | ||
<u>Voici un exemple d'un fichier HTML (mail.html) </u> : | <u>Voici un exemple d'un fichier HTML (mail.html) </u> : | ||
− | + | ||
+ | <!--T:116--> | ||
''<nowiki><body></nowiki> | ''<nowiki><body></nowiki> | ||
<nowiki><img src="http://www.mappingsuite.com/wp-content/uploads/2018/08/Logo_web1.png"></nowiki> | <nowiki><img src="http://www.mappingsuite.com/wp-content/uploads/2018/08/Logo_web1.png"></nowiki> | ||
Ligne 236 : | Ligne 382 : | ||
− | <!--T: | + | <!--T:117--> |
Son appel se fait par l'écriture de son chemin et de son nom dans le paramètre NOTE de la commande MAPSNDMAIL : | Son appel se fait par l'écriture de son chemin et de son nom dans le paramètre NOTE de la commande MAPSNDMAIL : | ||
− | + | <!--T:118--> | |
<span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) | <span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) | ||
PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com') | PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com') | ||
− | TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') <u>NOTE('/home/mapsend/mail.html')</u> NAME1('PJ.pdf')</span> | + | TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') <u>NOTE('%%FILE_HTML%%/home/mapsend/mail.html')</u> NAME1('PJ.pdf')</span> |
− | <!--T: | + | <!--T:119--> |
<u>Voici le résultat obtenu</u> : | <u>Voici le résultat obtenu</u> : | ||
− | <!--T: | + | <!--T:120--> |
[[FILE:LOGOMAPPING.jpg|50px]]<br /> | [[FILE:LOGOMAPPING.jpg|50px]]<br /> | ||
Cher Monsieur MICALETTI ayant pour numéro de client 9214, | Cher Monsieur MICALETTI ayant pour numéro de client 9214, | ||
− | <!--T: | + | <!--T:121--> |
Veuillez trouver ci-joint votre facture nº<span style="color:Red;"> 1 en date du 23/11/2016 . | Veuillez trouver ci-joint votre facture nº<span style="color:Red;"> 1 en date du 23/11/2016 . | ||
− | <!--T: | + | <!--T:122--> |
'''Cordialement''' | '''Cordialement''' | ||
− | ==Troubleshooting== <!--T: | + | ==Troubleshooting== <!--T:123--> |
− | <!--T: | + | <!--T:124--> |
Pour la résolution d'erreurs liées à l'envoi de mail via la commande MAPSNDMAIL, veuillez consulter la page suivante : | Pour la résolution d'erreurs liées à l'envoi de mail via la commande MAPSNDMAIL, veuillez consulter la page suivante : | ||
− | <!--T: | + | <!--T:125--> |
[[OPALE:10.0:KB:Erreur_MAPSNDMAIL|Résolution d'erreurs d'envoi de mail]] | [[OPALE:10.0:KB:Erreur_MAPSNDMAIL|Résolution d'erreurs d'envoi de mail]] | ||
− | ==Voir aussi== <!--T: | + | ==Voir aussi== <!--T:126--> |
+ | |||
− | <!--T: | + | <!--T:127--> |
[[OPALE:10.0:Utilisation:_Paramétrage_du_mail|Paramétrage de l'envoi de mail]] | [[OPALE:10.0:Utilisation:_Paramétrage_du_mail|Paramétrage de l'envoi de mail]] | ||
</translate> | </translate> | ||
Mot clé : MAPSNDMAIL, Envoi email, envoi PDF par mail, Mail | Mot clé : MAPSNDMAIL, Envoi email, envoi PDF par mail, Mail |
Version actuelle datée du 4 juillet 2023 à 13:02
Sommaire
- 1 Préambule
- 2 Généralités sur la commande MAPSNDMAIL
- 3 Généralités sur la commande MAPSNDMAIL
- 4 Nouveautés 10.8.0
- 5 Gestion des menus
- 5.1 1. Paramétrage du mail
- 5.2 2. Démarrage de la gestion de mail
- 5.3 3. Arrêt du mail
- 5.4 4. Affichage de la file d'attente des mails
- 5.5 5. Envoi d'un mail
- 5.6 6. Envoi d'un spool par mail
- 5.7 7. Contrôle du fonctionnement du mail
- 5.8 8. Gérer les fichiers spoules (exécution interactive de MAPPING)
- 6 Mots-clés utilisés pour mapper automatiquement des données du fichier spool en entrée
- 7 Paramétrage
- 8 Contenu Texte ou HTML
- 9 Exemples
- 10 Troubleshooting
- 11 Voir aussi
Préambule
Avec la version "Opale", il est possible d'envoyer des emails avec un document PDF en pièce jointe avec un corps HTML personnalisé via la commande MAPSNDMAIL.
La commande MAPSNDMAIL prend en paramètre une maquette Designer (paramètre "Mapping format") . Celle-ci doit obligatoirement être générée en PDF.
Elle doit contenir des zones de type INDEX utilisées comme données dynamiques dans le sujet, le nommage des pièces jointes ou dans le contenu du corps de l'email.
Généralités sur la commande MAPSNDMAIL
Avant V10.1
La commande MAPSNDMAIL sur IBM i a plusieurs paramètres :
Spooled file . . . . . . . . . . Name Nom du spool Spooled file number . . . . . . *LAST *LAST *ONLY 000000-999999 Numéro du spool Job Name . . . . . . . . . . . . *CURRENT Name, *CURRENT , *DEV Nom du job Job number . . . . . . . . . . . 000000-999999 Numéro du job User . . . . . . . . . . . . . . *CURRENT Name User Mapping format . . . . . . . . . Character value,10 max. Format M-Designer Sequence . . . . . . . . . . . . *ALL *MRG 00000-99999 Numéro de séquence du projet M-Designer Delete file . . . . . . . . . . N Y, N Suppression du spool d'origine ? Start page . . . . . . . . . . . 1 Integer, *SPL Numéro de page de début End page . . . . . . . . . . . . 999999 Integer, *SPL, *LAST Numéro de page de fin Original State . . . . . . . . . 'READY' HOLD, READY Statut de l'email ? PRIORITY . . . . . . . . . . . . '3' 1, 2, 3, 4, 5 Priorité d'envoi Send from . . . . . . . . . . . *USER Emetteur de l'email Send TO . . . . . . . . . . . . _______________________________________________ Destinaire(s) de l'email Send CC . . . . . . . . . . . . _______________________________________________ Copie(s) Send CCI . . . . . . . . . . . . _______________________________________________ Copie(s) cachée(s) Subject . . . . . . . . . . . . _______________________________________________ Sujet de l'email Note . . . . . . . . . . . . . . _______________________________________________ Corps de l'email Name of this file in the mail . 'Doc.pdf' Nom du PDF envoyé par email Path and name of the file . . . ________________________________________________ Chemin d'une éventuelle autre pièce jointe Name of this file in the mail . ________________________________________________ Nom d'une éventuelle autre pièce jointe Delete mail after send . . . . . 'N' Y, N, O Supprimer ou non l'email après son envoi Delete file1 after send . . . . 'N' Y, N, O Supprimer le 1er fichier joint Delete file2 after send . . . . 'N' Y, N, O Supprimer le 2ième fichier joint Autres paramètres Code Page . . . . . . . . . . . *SPL *SPL, 037,1147 Spécifier un code page
A partir de la V10.1
Depuis la version 10.1 de la suite OPALE, il est possible d'envoyer des emails en mode XPS en utilisant la conversion XPS to PDF. Pour cela, 2 nouveaux paramètres sont apparus :
Type de langage . . . . . . . . . . . ________ *XPS
Imprimante XPS / Language . . . ________ Nom, *PDF,
Il est donc possible d'utiliser un format XPS afin d'envoyer un email. (la génération en PDF native n'est plus utile)
Type de langage . . . . . . . . . . . *XPS
Imprimante XPS / Language . . . *PDF
Généralités sur la commande MAPSNDMAIL
Nouveautés 10.8.0
La version 10.8.0 apporte son lots de nouveautés concernant les envoies d'emails.
Paramétrage SMTP sur l'écran de paramétrage d'envoies d'emails
Avant la version 10.8.0, le paramétrage SMTP se faisait via les variables d'environnement système WRKENVVAR. Maintenant ce paramétrage n'est plus géré dans le WRKENVVAR mais directement dans l'écran de paramétrage des envoies d'emails
Cet écran est disponible uniquement si vous disposez des droits SECOFR
SMTP server IP address Nom du serveur SMTP SMTP server port (25) Numéro du port de connexion SMTP server Login Nom d'utilisateur pour la connexion au server SMTP SMTP server Password Mot de passe pour la connexion au server SMTP SMTP Protocol Protocole SMTP (SSL, DTLS, TLS1, TLS1.1, TLS1.2) SMTP server domain Nom du domain du serveur SMTP Temp folder Répertoire temporaire (répertoire MAPSEND par défaut) Le dossier temporaire est le dossier où sont stockés les fichiers PDF envoyés par mail, les utilisateurs envoyant des mails doivent avoir les droits d'accès en lecture et écriture sur ce répertoire Data Queue processing ***détail à compléter*** par défaut : MAPSMTP La DTAQ par défaut est MAPSMTP (créée à l'installation), c'est elle qui permet au robot Mapping d'envoyer automatiquement les spools au serveur de mail. Cette DTAQ doit exister. Jobd for e-mailing ***détail à compléter*** par défaut : MAPDSMTP2 La JOBD par défaut est MAPDSMTP2 (créée à l'installation). Elle définit les propriétés des jobs d'envoi de mail par le robot. Cette JOBD doit exister. Message on success ***détail à compléter*** *USER Trois valeurs sont possibles : - *NONE. Par défaut, aucune commande n'est exécutée. - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée Message on error ***détail à compléter*** *USER Les réactions sur succès et sur erreur sont gérées dans le programme MAP_C031P9. Les sources de ce programme sont dans le fichier MAP_SPECIF de la bibliothèque d'installation. Trois valeurs sont possibles : - *NONE. Par défaut, aucune commande n'est exécutée. - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée SMTP debug level (SSL, DTLS, TLS1, TLS1.1, TLS1.2)
Paramétrage SMTP au niveau de la commande MAPSNDMAIL
Depuis la version 10.8.0, il est possible de surcharger les valeurs de paramétrage du serveur SMTP au niveau de la commande. Le mail envoyé utilisera alors les informations renseignées dans la commande et ignorera, pour cette envoie uniquement, les paramètres renseignés dans l'écran de configuration général.
La valeur *DFT fait référence au paramétrage de l'écran de configuration générale. Cette valeur peut être modifiée.
Other parameters
SMTP server name or address (*DFT) Nom du serveur SMTP SMTP server port (*DFT) Numéro du port de connexion SMTP login name (*DFT) Login de connexion SMTP login password (*DFT) password de connexion SMTP protocol (*DFT) Prptocole SMTP SMTP domain name (*DFT) Nom de domaine
Le menu d'envoi d'e-mail s'appelle MAPSND. Pour y accéder, il faut entrer la commande :
GO MAPSND
1. Paramétrage du mail
Avant la version 10.0
Cet écran est disponible uniquement si vous disposez des droits SECOFR
SMTP server IP address Nom du serveur SMTP
SMTP server port (25) Numéro du port de connexion SMTP server domain Nom du domain du serveur SMTP Temporary folder Répertoire temporaire (répertoire MAPSEND par défaut) Le dossier temporaire est le dossier où sont stockés les fichiers PDF envoyés par mail, les utilisateurs envoyant des mails doivent avoir les droits d'accès en lecture et écriture sur ce répertoire Waiting Dtaq ***détail à compléter*** par défaut : MAPSMTP La DTAQ par défaut est MAPSMTP (créée à l'installation), c'est elle qui permet au robot Mapping d'envoyer automatiquement les spools au serveur de mail. Cette DTAQ doit exister. Sending jobd ***détail à compléter*** par défaut : MAPDSMTP2 La JOBD par défaut est MAPDSMTP2 (créée à l'installation). Elle définit les propriétés des jobs d'envoi de mail par le robot. Cette JOBD doit exister. Action if success ***détail à compléter*** *USER Trois valeurs sont possibles : - *NONE. Par défaut, aucune commande n'est exécutée. - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée Action if error ***détail à compléter*** *USER Les réactions sur succès et sur erreur sont gérées dans le programme MAP_C031P9. Les sources de ce programme sont dans le fichier MAP_SPECIF de la bibliothèque d'installation. Trois valeurs sont possibles : - *NONE. Par défaut, aucune commande n'est exécutée. - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée. - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée
A partir de la version 10.0
A partir de la version MAPPING OPALE 10.1, un paramètre Mode utilisé pour envoyer est disponible :
Mode utilisé pour envoyer ____________ (*MAPPING, *IBM)
Ces deux valeurs possibles sont : *MAPPING et *IBM
*MAPPING permets d'avoir un comportement identique aux versions précédentes de MAPPING. En d'autres mots, MAPPING gère les envois des emails via le paramètrage SMTP stipulé en dessous de ce même écran de paramétrage.
*IBM permets de laisser la configuration SMTP de l'IBM-i(API IBM-i) prendre le relais pour les envois des emails. La configuration du server SMTP renseignée dans ce présent écran de configuration n'est alors pas utilisée.
2. Démarrage de la gestion de mail
Ce menu permet de démarrer le travail MAPSMTP du sous-système MAPSROBOT. Ce travail doit absolument être démarré pour l'envoi de mail via la commande MAPSNDMAIL. Ce menu appelle la commande STRMAPMAIL.
3. Arrêt du mail
Ce menu permet d'arrêter le travail MAPSMTP du sous-système MAPSROBOT. Ce menu appelle la commande ENDMAPMAIL.
4. Affichage de la file d'attente des mails
Ce menu permet d'afficher l'historique des envois d'e-mail. Il est possible de filtrer par nom d'utilisateur. Ce menu appelle la commande MAPDSPMAIL.
Attention : L'accès à ce menu bloque les nouveaux envois d'e-mail. Il ne faut donc pas le laisser ouvert.
5. Envoi d'un mail
Ce menu permet l'envoi d'un e-mail avec ou sans pièce-jointe. Ce menu appelle la commande MAPSNDDST.
6. Envoi d'un spool par mail
Ce menu permet le maquettage d'un fichier spool IBM i ainsi que sa conversion en PDF et son envoi par e-mail. Ce menu appelle la commande MAPSNDMAIL.
7. Contrôle du fonctionnement du mail
Ce menu permet de lister les travaux du sous-système liés à l'envoi d'e-mail (en l’occurrence MAPSMTP).
8. Gérer les fichiers spoules (exécution interactive de MAPPING)
Ce menu permet de gérer les fichiers spool. Cette fonctionnalité est la même que l'option 1 du menu GO MAPPING. Ce menu appelle la commande COGISPLF.
Mots-clés utilisés pour mapper automatiquement des données du fichier spool en entrée
Comme vu précédemment, un prérequis de la commande MAPSNDMAIL est la conception d'une maquette Designer avec une génération en langage PDF. Pour obtenir le contenu du fichier spool directement dans le corps de l'e-mail ou avoir l'adresse du destinataire et de l'émetteur pris dans le fichier spool, il existe plusieurs zones dans Designer (type de zone METADATA) :
Liste des mots clés
- mapFrom : Utilisé pour prendre l'adresse e-mail de l'expéditeur dans le fichier spool
- mapSend : Utilisé pour prendre l'adresse e-mail de destinataire de l'expéditeur dans fichier spool
- mapCopy : Utilisé pour prendre l'adresse e-mail de copy dans le fichier spool
- mapBCopy : Utilisé pour prendre l'adresse e-mail de copie cachée dans le fichier spool
- mapNote : Utilisé pour prendre des données du fichier spool et les mettre dans le corps de l'e-mail envoyé
- mapSubject : Utilisé pour prendre des données du fichier spool et les mettre dans le sujet de l'e-mail envoyé
Utilisation des mots clés
Pour utiliser les mots clés paramétrés dans le projet Designer (listés ci-dessus), il faut y faire référence dans la commande MAPSNDMAIL.
Pour ce faire, voici la liste des paramètres de la commande MAPSNDMAIL avec leurs valeurs respectives :
Nom du paramètre de la commande MAPSNDMAIL | Valeur pour faire référence aux métadonnées de Designer |
---|---|
Send FROM (FROM) | *MAPFROM |
Send TO (TO) | *MAPSEND |
Send CC (CC) | *MAPCOPY |
Send CCI (CCI) | *MAPBCOPY |
Subject (SUBJECT) | *MAPSUBJCT |
Note (NOTE) | *MAPNOTE |
Paramétrage
Paramétrage de la variable d'environnement pour définir l'expéditeur des emails
L'adresse e-mail expéditrice des e-mails et son mot de passe doivent être configurés dans des variables d'environnements du serveur MAPPING. Pour ce faire :
1) Taper la commande :
WRKENVVAR
2) Créer les variables d'environnement en *SYS pour le fonctionnement avec le sous-système de Mapping contenant l'adresse e-mail et le mot de passe pour l'authentification du serveur SMTP
MAIL_PASSWORD MONMOTDEPASSE MAIL_LOGIN MONADRESSEMAIL
L'adresse e-mail de l'expéditeur stipulée dans la commande MAPSNDMAIL devra être MONADRESSEMAIL.
PS : Dans le cas d'un envoi avec des expéditeurs variables (provenant du spool par exemple), une configuration du serveur SMTP est généralement possible pour autoriser les envois de mail à partir de n'importe quelle adresse mail.
Paramétrage de serveur d'envoi d'emails
Sur l'option 1 du menu GO MAPSND, il faut renseigner les informations du serveur d'envoi d'e-mails :
- Adresse IP du serveur
- Port du serveur
- Domaine du serveur
Attention : Il faut absolument posséder un profil SECOFR pour accéder à ce menu. Si tel n'est pas le cas, l'accès au menu sera impossible et aucun message ne sera affiché.
Paramétrage de sécurité
⚠ Paramétrage présent à partir d'Opale v10.5.0
Le mode de connexion sécurisé est TLS v1.2 par défaut.
Cependant, il est possible de basculer vers d'autres modes moins fréquents ou moins sécurisés en renseignant une variable d'environnement EMAILPROTOCOL
.
Ce paramètre prend une valeur numérique entre 1 et 5. L'absence de ce paramètre entraine le choix du TLS v1.2 .
Valeur | Protocol |
---|---|
1 | SSL v3 (sinon, v2 en cas de défaut) |
2 | DTLS v1 |
3 | TLS v1.0 |
4 | TLS v1.1 |
5 (par défaut) | TLS v1.2 |
Contenu Texte ou HTML
Depuis la version 10.4.0 de MAPPING IBM-i, il est possible d'expliciter le type de contenu (Texte ou HTML) du corps des emails.
Attention : Le comportement a changé en version 10.8.4 :MAPSNDMAIL depuis 10.8.4 - Changement de comportement sur le type de sortie TEXTE ou HTML dans le body du mail
Contenu Texte
Il est possible d'expliciter en texte le type de contenu de l'email envoyé par la commande MAPSNDMAIL. Pour cela il faut préfixer le contenu du body par %%TXT%% ou %%FILE_TXT%%
%%TXT%% : Permet d'envoyer le body en mode texte (valeur par défaut)
Exemple : %%TXT%%Voici le corps de mon email en texte
%%FILE_TXT%% : Le contenu de l'email sera alors le contenu d'un fichier envoyé en mode texte
Exemple : %%FILE_TXT%%/home/monbody.txt (Fichier encodé en ANSI)
Contenu HTML
Il est possible d'expliciter en HTML le type de contenu de l'email envoyé par la commande MAPSNDMAIL. Pour cela il faut préfixer le contenu du body par %%HTML%% ou %%FILE_HTML%%
%%HTML%% : Permet d'envoyer le body en mode HTML
Exemple : %%HTML%%Voici le corps de mon email en html
%%FILE_HTML%% : Le contenu de l'email sera alors le contenu d'un fichier envoyé en mode HTML
Exemple : %%FILE_HTML%%/home/monbody.html (Fichier encodé en ANSI)
Exemples
Envoi simple d'un email avec PDF joint
MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N) PAGSTR(1) PAGEND(10) STATE(READY)FROM('hotline@mappingsuite.onmicrosoft.com')
TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps demail') NAME1('PJ.pdf')
Envoi simple d'un email avec un corps d'email texte dynamique
MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N)
PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com')
TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('Ceci est mon corps d'email ayant pour donnée dynamique :[[DATE]]') NAME1('PJ.pdf')
Envoi d'un email avec un corps d'email HTML dynamique
Le principe de cette fonctionnalité est d'utiliser un fichier HTML pour le corps de l'email.
Voici un exemple d'un fichier HTML (mail.html) :
<body>
<img src="http://www.mappingsuite.com/wp-content/uploads/2018/08/Logo_web1.png"> Cher Monsieur [[NOM]] ayant pour numéro de client [[NUMCLI]], Veuillez trouver ci-joint votre facture nº <font color=red> [[NUMFAC]] en date du [[DATE]] </font>. <b>Cordialement</b> </body>
Attention : Dans le fichier HTML, les caractères spéciaux doivent être écrits avec un codage particulier : https://www.commentcamarche.com/contents/489-caracteres-speciaux-html
Son appel se fait par l'écriture de son chemin et de son nom dans le paramètre NOTE de la commande MAPSNDMAIL :
MAPSNDMAIL SPLF(FACTURE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N)
PAGSTR(1) PAGEND(10) STATE(READY) FROM('hotline@mappingsuite.onmicrosoft.com') TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('Mon sujet') NOTE('%%FILE_HTML%%/home/mapsend/mail.html') NAME1('PJ.pdf')
Voici le résultat obtenu :
Cher Monsieur MICALETTI ayant pour numéro de client 9214,
Veuillez trouver ci-joint votre facture nº 1 en date du 23/11/2016 .
Cordialement
Troubleshooting
Pour la résolution d'erreurs liées à l'envoi de mail via la commande MAPSNDMAIL, veuillez consulter la page suivante :
Résolution d'erreurs d'envoi de mail
Voir aussi
Paramétrage de l'envoi de mail Mot clé : MAPSNDMAIL, Envoi email, envoi PDF par mail, Mail