OPALE - 10.0 - Utilisation - Envoyer un mail avec un document PDF - MAPSNDMAIL/en

Différence entre versions

De MappingDoc
(Page créée avec « ==Other links== »)
(Mise à jour pour être en accord avec la nouvelle version de la source de la page)
Ligne 1 : Ligne 1 :
 
<languages />
 
<languages />
−
==Introduction==  
+
==Préambule==  
  
−
With Opale and the MAPSNDMAIL command, you can now send e-mails that have PDF documents attached to them and a customised HTML body.
 
  
−
The '''MAPSNDMAIL''' command uses a Designer template as a parameter ("Mapping format" parameter). The template has to be generated in PDF.
+
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.
−
It has to include INDEX zones used as dynamic data in the subject, attachment name, or in the e-mail body.
 
  
−
==General principles of the MAPSNDMAIL command==
 
  
−
The MAPSNDMAIL command on IBM i uses multiple parameters:
+
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.
  
−
Spooled file . . . . . . . . . .                Name                                  <span style="color:blue">Spooled file name</span>
+
== Généralités sur la commande MAPSNDMAIL==
−
  Spooled file number  . . . . . .  *LAST        *LAST *ONLY  000000-999999            <span style="color:blue">Spooled file number</span>
+
===Avant V10.1===
−
  Job Name . . . . . . . . . . . .  *CURRENT      Name, *CURRENT , *DEV                  <span style="color:blue">Job name</span>
+
 
−
  Job number . . . . . . . . . . .                000000-999999                          <span style="color:blue">Job number</span>
+
La commande MAPSNDMAIL sur IBM i a plusieurs paramètres :
 +
 
 +
 
 +
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>
 +
  Job Name . . . . . . . . . . . .  *CURRENT      Name, *CURRENT , *DEV                  <span style="color:blue">Nom du job</span>
 +
  Job number . . . . . . . . . . .                000000-999999                          <span style="color:blue">Numéro du job</span>
 
  User . . . . . . . . . . . . . .  *CURRENT      Name                                  <span style="color:blue">User</span>
 
  User . . . . . . . . . . . . . .  *CURRENT      Name                                  <span style="color:blue">User</span>
−
  Mapping format . . . . . . . . .                Character value,10 max.                <span style="color:blue">Designer Format</span>
+
  Mapping format . . . . . . . . .                Character value,10 max.                <span style="color:blue">Format M-Designer</span>
−
  Sequence . . . . . . . . . . . .                *ALL  *MRG      00000-99999            <span style="color:blue">Designer project sequence number</span>
+
  Sequence . . . . . . . . . . . .                *ALL  *MRG      00000-99999            <span style="color:blue">Numéro de séquence du projet M-Designer</span>
−
  Delete file  . . . . . . . . . .  N            Y, N                                  <span style="color:blue"> Delete the original spooled file?</span>
+
  Delete file  . . . . . . . . . .  N            Y, N                                  <span style="color:blue">Suppression du spool d'origine ?</span>
−
  Start page . . . . . . . . . . .  1            Integer, *SPL                          <span style="color:blue">Starting page number</span>
+
  Start page . . . . . . . . . . .  1            Integer, *SPL                          <span style="color:blue">Numéro de page de début</span>
−
  End page . . . . . . . . . . . .  999999        Integer, *SPL, *LAST                  <span style="color:blue">Ending page number</span>
+
  End page . . . . . . . . . . . .  999999        Integer, *SPL, *LAST                  <span style="color:blue">Numéro de page de fin</span>
−
  Original State . . . . . . . . .  'READY'      HOLD, READY                            <span style="color:blue">Email status?</span>
+
  Original State . . . . . . . . .  'READY'      HOLD, READY                            <span style="color:blue">Statut de l'email ?</span>
−
  PRIORITY . . . . . . . . . . . .  '3'          1, 2, 3, 4, 5                          <span style="color:blue">Sending priority</span>
+
  PRIORITY . . . . . . . . . . . .  '3'          1, 2, 3, 4, 5                          <span style="color:blue">Priorité d'envoi</span>
−
  Send from  . . . . . . . . . . .  *USER                                                <span style="color:blue">Email sender</span>
+
  Send from  . . . . . . . . . . .  *USER                                                <span style="color:blue">Emetteur de l'email</span>
−
  Send TO  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Email recipient</span>
+
  Send TO  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Destinaire(s) de l'email</span>
−
  Send CC  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Carbon Copy</span>
+
  Send CC  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Copie(s)</span>
−
  Send CCI . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Blind Carbon Copy</span>
+
  Send CCI . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Copie(s) cachée(s)</span>
−
  Subject  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Email subject</span>
+
  Subject  . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Sujet de l'email</span>
−
  Note . . . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Email body</span>
+
  Note . . . . . . . . . . . . . .    _______________________________________________    <span style="color:blue">Corps de l'email</span>
−
  Name of this file in the mail  .  'Doc.pdf'                                            <span style="color:blue">Name of the PDF file sent via email</span>
+
  Name of this file in the mail  .  'Doc.pdf'                                            <span style="color:blue">Nom du PDF envoyé par email</span>
−
  Path and name of the file  . . .    ________________________________________________    <span style="color:blue">Path of a potential additional attachment</span>
+
  Path and name of the file  . . .    ________________________________________________    <span style="color:blue">Chemin d'une éventuelle autre pièce jointe</span>
−
  Name of the file in the mail  .    ________________________________________________    <span style="color:blue">Name of a potential additional attachment</span>
+
  Name of this file in the mail  .    ________________________________________________    <span style="color:blue">Nom d'une éventuelle autre pièce jointe</span>
−
  Delete mail after send . . . . .  'N'          Y, N, O                                <span style="color:blue">Delete the email after it was send</span>
+
  Delete mail after send . . . . .  'N'          Y, N, O                                <span style="color:blue">Supprimer ou non l'email après son envoi</span>
−
  Delete file1 after send  . . . .  'N'          Y, N, O                                <span style="color:blue">Delete the first attachment</span>
+
  Delete file1 after send  . . . .  'N'          Y, N, O                                <span style="color:blue">Supprimer le 1er fichier joint</span>
−
  Delete file2 after send  . . . .  'N'          Y, N, O                                <span style="color:blue">Delete the second attachment</span>
+
  Delete file2 after send  . . . .  'N'          Y, N, O                                <span style="color:blue">Supprimer le 2ième fichier joint</span>
−
                           Other parameters
+
                           Autres paramètres
−
  Code Page  . . . . . . . . . . .  *SPL          *SPL, 037,1147                        <span style="color:blue">Specify a 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===
 +
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 <br>  '''
 +
'''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'''<br> 
 +
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
 +
 
 +
 
 +
  <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===
 +
 
 +
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.
 +
 
 +
<span style="background-color:Black;color:Lime;">Other parameters</span>
 +
 
 +
  <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==
  
−
==Managing menus==
 
  
−
The menu that allows you to send e-mails is called MAPSND. To access it, run command:
+
Le menu d'envoi d'e-mail s'appelle MAPSND. Pour y accéder, il faut entrer la commande :
 
  GO MAPSND
 
  GO MAPSND
 +
  
 
[[FILE:MAPSND.jpg|500px]]
 
[[FILE:MAPSND.jpg|500px]]
  
−
===1. E-mail configuration===
+
===1. Paramétrage du mail===
−
This screen is only accessible if you have been granted SECOFR rights.
+
====Avant la version 10.0====
 +
 
 +
Cet écran est disponible uniquement si vous disposez des droits SECOFR
 +
 
  
−
<span style="background-color:Black;color:Lime;">SMTP server IP address                  Name of the SMTP server</span>
+
<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)                    Connection port number</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 domain                      SMTP server domain name</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;">Temporary folder                        Temporary folder (MAPSEND folder by default)</span>
+
  <span style="background-color:Black;color:Lime;">Temporary folder                        Répertoire temporaire (répertoire MAPSEND par défaut)</span>
−
  The temporary folder is where PDF files that where sent via e-mail are stored, users who send e-mails need access to read and edit this folder.
+
  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;">Waiting Dtaq                            <nowiki>***detail to be completed*** by default: MAPSMTP</nowiki></span>
+
  <span style="background-color:Black;color:Lime;">Waiting Dtaq                            <nowiki>***détail à compléter*** par défaut : MAPSMTP</nowiki></span>
−
  MAPSMTP is the default DTAQ (created upon installation), it allows the Mapping robot to send the spooled files automatically to the e-mail server. This DTAQ needs to exist.  
+
  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;">Sending jobd                              <nowiki>***detail to be completed*** by default: MAPDSMTP2</nowiki></span>
+
  <span style="background-color:Black;color:Lime;">Sending jobd                              <nowiki>***détail à compléter*** par défaut : MAPDSMTP2</nowiki></span>
−
  MAPDSMTP2 is the default JOBD (created upon installation). It defines the properties of the robot's e-mail sending jobs. This JOBD needs to exist.
+
  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;">Action if success                        <nowiki> *USER</nowiki></span>
+
  <span style="background-color:Black;color:Lime;">Action if success                        <nowiki>***détail à compléter*** *USER</nowiki></span>
−
  Three possible values:
+
  Trois valeurs sont possibles :
−
  - *NONE. By default, no command is run.
+
  - *NONE. Par défaut, aucune commande n'est exécutée.
−
  - *USER. By default, the SNDUSRMSG TOUSR(&USER) command is run.
+
  - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée.
−
  - *SYSOPR. By default, the SNDUSRMSG TOUSR(*SYSOPR) command is run.
+
  - *SYSOPR. Par défaut, la commande SNDUSRMSG TOUSR(*SYSOPR) est exécutée
 
   
 
   
−
  <span style="background-color:Black;color:Lime;">Action if error                          <nowiki> *USER</nowiki></span>
+
  <span style="background-color:Black;color:Lime;">Action if error                          <nowiki>***détail à compléter*** *USER</nowiki></span>
−
  Success and error reactions are managed in the MAP_C031P9 program. Sources of this program can be found in the MAP_SPECIF file of the installation library.
+
  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.
−
  Three possible values:
+
  Trois valeurs sont possibles :
−
  - *NONE. By default, no command is run.
+
  - *NONE. Par défaut, aucune commande n'est exécutée.
−
  - *USER. By default, the SNDUSRMSG TOUSR(&USER) command is run.
+
  - *USER. Par défaut, la commande SNDUSRMSG TOUSR(&USER) est exécutée.
−
  - *SYSOPR. By default, the SNDUSRMSG TOUSR(*SYSOPR) command is run.
+
  - *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 :
  
−
===2. Starting e-mail management===
+
Mode utilisé pour envoyer  ____________      (*MAPPING, *IBM)
−
This menu allows you to start the MAPSMTP job of the sub-system. To send e-mails via the MAPSNDMAIL command, this job needs to be started. This menu calls the STRMAPMAIL command.
 
  
−
===3. Stopping e-mail management===
+
Ces deux valeurs possibles sont : '''*MAPPING''' et '''*IBM'''
−
This menu allows you to stop the MAPSMTP job of the sub-system. This menu calls the ENDMAPMAIL command.
 
  
−
===4. Displaying e-mail queue===
+
'''*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.
−
This menu allows you to display previously sent e-mails, which you can filter by user name. This menu calls the MAPDSPMAIL command.<br />
 
−
'''Caution''': This menu stops you from sending new e-mails so do not leave it open.
 
  
−
===5. Sending an e-mail===
+
'''*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.
−
This menu allows you to send an e-mail with (or without) an attachment. This menu calls the MAPSNDDST command.
+
::<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>
  
−
===6. E-mailing a spooled file===
+
===2. Démarrage de la gestion de mail===
−
This menu remaps an IBM i spooled file, converts it to PDF and e-mails it. This menu calls the MAPSNDMAIL command.
+
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.
  
−
===7. Checking e-mail operations===
+
===3. Arrêt du mail===
−
This menu lists the jobs of the sub-system that are linked to e-mailing (MAPSMTP in this case).
+
Ce menu permet d'arrêter le travail MAPSMTP du sous-système MAPSROBOT. Ce menu appelle la commande ENDMAPMAIL.
  
−
===8. Managing spooled files (MAPPING interactive run)===
+
===4. Affichage de la file d'attente des mails===
−
This menu allows you to manage spooled files. This feature is the same as option 1 of the GO MAPPING menu. This menu calls the COGISPLF command.
+
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.
  
−
==Keywords used to map input spooled file data automatically==
+
===5. Envoi d'un mail===
−
One of the requirements to run the MAPSNDMAIL command is to have a Designer template generated in PDF.
+
Ce menu permet l'envoi d'un e-mail avec ou sans pièce-jointe. Ce menu appelle la commande MAPSNDDST.
−
To extract the content of the spooled file and map it directly onto the body of an e-mail or extract the recipient's and sender's address, there are multiple zones in Designer (zone type METADATA):
 
−
===Keywords===
 
−
*mapFrom: Used to retrieve the sender's e-mail address from the spooled file
 
−
*mapSend: Used to retrieve the recipient's e-mail address from the spooled file
 
−
*mapCopy: Used to retrieve the carbon copy e-mail address from the spooled file
 
−
*mapBCopy: Used to retrieve the blind carbon copy e-mail address from the spooled file
 
−
*mapNote: Used to retrieve data from the spooled file and map it onto the body of the e-mail
 
−
*mapSubject: Used to retrieve data from the spooled file and map it into the subject of the e-mail
 
  
−
===Using keywords===
+
===6. Envoi d'un spool par mail===
−
To use the keywords configured in the Designer project (listed below), you need to reference them in the MAPSNDMAIL command.
+
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 :
  
−
To do so, here are the parameters of the MAPSNDMAIL command listed with their corresponding values:
 
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Name of the parameter of the MAPSNDMAIL command
+
! Nom du paramètre de la commande MAPSNDMAIL  
−
! Value to reference Designer meta data
+
! Valeur pour faire référence aux métadonnées de Designer
 
|-
 
|-
 
| Send FROM (FROM)
 
| Send FROM (FROM)
Ligne 125 : Ligne 215 :
 
|-
 
|-
 
| Send CC (CC)
 
| Send CC (CC)
−
| *MACOPY
+
| *MAPCOPY
 
|-
 
|-
−
| Send BCC (CCI)
+
| Send CCI (CCI)
 
| *MAPBCOPY
 
| *MAPBCOPY
 
|-
 
|-
Ligne 137 : Ligne 227 :
 
|}
 
|}
  
−
==Configuration==
+
==Paramétrage==  
  
−
===Configuring the environment variable to define the e-mail sender===
+
===Paramétrage de la variable d'environnement pour définir l'expéditeur des emails===
−
The sender's e-mail address and its password must be configured in the environment variables of the MAPPING Server.
+
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.
−
To do so, follow the steps below:  
+
Pour ce faire :  
  
−
1) Run command:
+
 
 +
1) Taper la commande :
 
  WRKENVVAR
 
  WRKENVVAR
  
−
2) Create the environment variables in *SYS so that the Mapping sub-system which contains the e-mail address and the password for the SMTP server authentication can work.
 
−
<span style="background-color:Black;color:Lime;">MAIL_PASSWORD                MYPASSWORD</span>
 
−
<span style="background-color:Black;color:Lime;">MAIL_LOGIN                  MYEMAILADDRESS</span>
 
  
−
The sender's e-mail address specified in the MAPSNDMAIL command has to be MYEMAILADDRESS.
+
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_LOGIN                  MONADRESSEMAIL</span>
 +
 
 +
 
 +
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 <code>EMAILPROTOCOL</code>.
 +
 
 +
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 .
 +
 
 +
{| class="wikitable"
 +
! Valeur
 +
! Protocol
 +
|-
 +
| 1
 +
| SSL v3
 +
|-
 +
| 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.
 +
===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) <br>
 +
Exemple : %%TXT%%Voici le corps de mon email en texte
 +
 
  
−
Note: To send an e-mail from dynamic e-mail addresses (coming from the spooled file for instance), you can configure the SMTP server to allow e-mails to be sent from any given e-mail address.
+
%%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)
  
−
===Configuring the server to send e-mails===
+
===Contenu HTML===
−
Select option 1 of the GO MAPSND menu to fill in information about the server:
+
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%%
−
* Server IP address
 
−
* Server port
 
−
* Server domain
 
  
−
'''Caution''': You need to have SECOFR permissions or access to the menu will be denied and the messages won't be displayed.
+
%%HTML%% : Permet d'envoyer le body en mode HTML<br>
 +
Exemple : %%HTML%%Voici le corps de mon email en <b>html</b>
  
−
==Examples==
 
  
−
===Sending an email with a PDF file attached===
+
%%FILE_HTML%% : Le contenu de l'email sera alors le contenu d'un fichier envoyé en mode HTML
−
<span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(INVOICE) 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')
+
Exemple : %%FILE_HTML%%/home/monbody.html (Fichier encodé en ANSI)
−
TO('jdieu@mappingsuite.onmicrosoft.com') SUBJECT('My subject') NOTE('This is the body of the e-mail') NAME1('PJ.pdf')</span>
 
  
−
===Sending an email with dynamic text in the e-mail body===
+
 
−
  <span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(INVOICE) SPLNUM(23) JOB(QPADEV0009) JOBNUM(855068) USER(JDIEU) MAPNAM(MAIL_DOC) MAPSEQ(00010) DELSPL(N)  
+
 
 +
==Exemples==
 +
 
 +
===Envoi simple d'un email avec PDF joint===
 +
<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>
 +
 
 +
===Envoi simple d'un email avec un corps d'email texte dynamique===
 +
  <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('My subject') NOTE('This is the body of my e-mail with dynamic data:<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>
  
−
===Sending an e-mail with dynamic HTML code in the e-mail body===
+
===Envoi d'un email avec un corps d'email HTML dynamique===
  
−
The aim of this feature is to use an HTML file as the body for the e-mail.
 
  
−
<u>Example of an HTML file (mail.html) </u>:
+
Le principe de cette fonctionnalité est d'utiliser un fichier HTML pour le corps de l'email.
  
−
''<nowiki><body></nowiki>
+
 
 +
<u>Voici un exemple d'un fichier HTML (mail.html) </u> :
 +
 
 +
 
 +
''<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>
−
  <nowiki>Dear Sir [[NAME]] client number [[CLINUM]],</nowiki>
+
  <nowiki>Cher Monsieur [[NOM]] ayant pour num&eacute;ro de client [[NUMCLI]],</nowiki>
−
  <nowiki>Please find attached our invoice n&ordm; <font color=red> [[INVNUM]] from [[DATE]] </font></nowiki>.
+
  <nowiki>Veuillez trouver ci-joint votre facture n&ordm; <font color=red> [[NUMFAC]] en date du [[DATE]] </font></nowiki>.
−
  <nowiki><b>Regards</b></nowiki>
+
  <nowiki><b>Cordialement</b></nowiki>
 
  </body>''
 
  </body>''
−
<u>Caution</u>: Special characters have to be written with appropriate coding in the HTML file:  
+
<u>Attention</u> : 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
 
https://www.commentcamarche.com/contents/489-caracteres-speciaux-html
  
  
−
To call the HTML file, you need to specify its path and name in the NOTE parameter of the MAPSNDMAIL command:
+
Son appel se fait par l'écriture de son chemin et de son nom dans le paramètre NOTE de la commande MAPSNDMAIL :
  
−
<span style="background-color:Black;color:Lime;">MAPSNDMAIL SPLF(INVOICE) 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('My subject') <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>
  
−
<u>Here is the final result</u>:
+
<u>Voici le résultat obtenu</u> :
  
 
[[FILE:LOGOMAPPING.jpg|50px]]<br />
 
[[FILE:LOGOMAPPING.jpg|50px]]<br />
−
Dear Sir MICALETTI client number 9214,  
+
Cher Monsieur MICALETTI ayant pour numéro de client 9214,  
  
−
Please find attached our invoice nº<span style="color:Red;"> 1 from 11/23/2016.  
+
Veuillez trouver ci-joint votre facture nº<span style="color:Red;"> 1 en date du 23/11/2016 .  
  
−
'''Regards'''
+
'''Cordialement'''
  
−
==Troubleshooting==
+
==Troubleshooting==  
  
−
To solve the emailing issues via the MAPSNDMAIL command, you can refer to the following page :
+
Pour la résolution d'erreurs liées à l'envoi de mail via la commande MAPSNDMAIL, veuillez consulter la page suivante :
  
 
[[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]]
  
−
==Other links==
+
==Voir aussi==
 +
 
  
 
[[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]]
 +
Mot clé : MAPSNDMAIL, Envoi email, envoi PDF par mail, Mail

Version du 13 janvier 2023 à 16:38

Autres langues :
English • ‎français

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

Gestion des menus

Le menu d'envoi d'e-mail s'appelle MAPSND. Pour y accéder, il faut entrer la commande : 

GO MAPSND


MAPSND.jpg

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.

Support : Paramétrage SMTP et envoi d'e-mail via l'API IBM i

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
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.

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 :

LOGOMAPPING.jpg
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

Récupérée de « https://docs.mappingsuite.com/w/index.php?title=OPALE:10.0:Utilisation:Envoyer_un_mail_avec_un_document_PDF_:_MAPSNDMAIL/en&oldid=34929 »
  • Powered by MediaWiki