Sommaire
| Table of Contents |
|---|
1. Introduction
Silog met à la disposition trois applications qui permettent d’utiliser sept neuf fonctions d’envoi de courriels.
...
Une application pour configurer les serveurs d’envoi de courriels. Chaque serveur peut être associé à un utilisateur de Silog : « Configuration des serveurs d’envoi » .
Une application pour créer des modèles de courriels contenant des tags de formules Silog interprétés lors de l’envoi des courriels : « Modèles de mail ».Un modèle peut être associé à un fichier HTML pour la mise en page du corps du message.
Une application qui permet d’historiser les courriels envoyés par L’ERP : « Messages Mail ».
Neuf fonctions d’envoi de courriels qui permettent de piloter par paramétrage l’envoi des courriels en utilisant les serveurs configurés, les modèles créés et si besoin l’application « Messages Mail » pour historiser les envois.
2. Configuration des serveurs d’envoi
Cette application permet de déclarer plusieurs serveurs pour les envois de courriels. Ces serveurs sont utilisés pour envoyer des courriels depuis l’ERP SILOG via les fonctions dédiées. Un serveur peut être associé à un utilisateur Silog ERP.
Pour renseigner correctement ces paramètres, il est fortement conseillé de faire appel à un administrateur qui maitrise bien la configuration des serveurs d’envoi.
2.2. L’application
...
Le mode « Liste » présente la liste des serveurs d’envoi enregistrés.
...
Un code qui permet de l’identifier. Ce code est utilisé par les fonctions d’envoi de courriels et les modèles pour indiquer le serveur de configuration à utiliser.
Le libellé permet de définir le serveur.
Le nom de serveur smtp d’envoi qui peut également être une adresse IP.
Un numéro de port.
Une méthode d’authentification du client SMTP: Standard (SMTP simple par user et mot de passe), Anonyme ou SASL (Exchange).
Le nom de l’identifiant à utiliser.
Le mot de passe.
Le nom de l’émetteur qui sera affiché sur les courriels envoyés (Certains serveurs imposent que cette zone soit renseignée d’une façon particulière).
L’utilisation ou non d’une authentification sécurisée.
Protocoles TLS utilisés : Si plusieurs protocoles sont sélectionnés, on laisse au serveur Smtp le choix de choisir dans la sélection. Si un seul protocole est sélectionné, le choix du protocole est forcé.
Une configuration de serveur d’envoi de courriels peut également être associée à un utilisateur ERP. Ainsi, au cours de la session de cet utilisateur, tous les courriels utiliseront ce serveur. »
...
2.3. Les traitements
...
2.3.1. Activer la configuration actuelle par défaut
Cette option permet de définir, le serveur d’envoi sélectionné comme serveur à utiliser pour les courriels pour lesquels aucun serveur n’a été défini.
Cela a pour effet de côcher la zone « Par défaut » : .
2.3.2. Envoyer un courriel de test
Cette action a pour effet d’afficher la fenêtre « Nouveau message » qui permet de saisir les caractéristiques d’envoi du courriel pour vérifier le bon fonctionnement du serveur sélectionné.
...
S’il n’y a pas d’erreur, la fenêtre se ferme, le message a bien été envoyé
3. Modèles de messages
L’application de définition des modèles de message permet de créer des messages formatés prêt à l’emploi. Ils seront utilisés lors d’évènements dans l’ERP SILOG.
3.1. L’application
L’application de définition des modèles de message permet de créer des messages formatés prêt à l’emploi. Ils seront utilisés lors d’évènements dans l’ERP SILOG.
...
Les zones qui composent un modèle de message peuvent contenir des tags de formule : A, Cc, Cci, Objet et Message. Les tags seront remplacés par leur valeur correspondante au moment où le message est généré pour être envoyé. Les tags sont formatés sous cette forme : [@nom formule ou fonction]. Chaque tag trouvé dans le texte est interprété et remplacé par sa valeur dans le contexte où la fonction a été appelée.
3.2. Exemple de modèle HTML
L’exemple ci-dessous concerne un modèle d’accusé réception d’une commande client.
...
Comme indiqué précédemment, les tags sont formatés sous cette forme :[@nom formule ou fonction]. Chaque tag trouvé dans le texte est interprété et remplacé par sa valeur dans le contexte où la fonction a été appelée.
Le tag [@SILMAILMESSAGE.Message] correspond à la variable qui contient le contenu saisi du corps du message.
4. Messages Mail
Cette application permet de visualiser les courriels envoyés depuis les applications de Silog si ces derniers ont été programmés pour être sauvegardé.
Elle ne permet pas de créer ou modifier un message existant. Elle n’est pas destinée à l’envoi de messages même s’il est possible de le faire dans les traitements de l’application.
4.1. L’application
...
La zone « Statut d’envoi » permet de savoir si le message a bien été envoyé :
1 => Message envoyé
2 => Message non envoyé
...
4.2. Les traitements
...
4.2.1. Nouveau message
Cette action a pour effet d’afficher la fenêtre « Nouveau message » qui permet de saisir les caractéristiques d’envoi d’un courriel et de l’envoyer. Cependant cela n’est pas la vocation de cette application.
...
Le principe de fonctionnement est identique à celui qui est décrit dans le paragraphe : Envoyer un mail de test.
5. Les neuf fonctions de paramétrage.
Les fonctions de paramétrages ont été créées pour permettre l’envoi de messages par programmation en utilisant les informations saisies dans les applications suivantes dédiées de Silog :
...
Le principe de fonctionnement de ces fonctions réside dans l’utilisation de l’application « Message Mail » « Message Mail » pour envoyer des messages qui peuvent être enregistrés dans le système pour en conserver une trace.
Toutes les fonctions d’envoi de messages sont préfixées par « MAIL. ».
L’ensemble de ces fonctions permet de constituer un message basé sur un modèle avant son envoi par appels successifs à des fonctions adaptées pour chacune des propriétés qui constituent le message.
Elles permettent de modifier ou de compléter les paramètres du modèle associé (ajout de destinataires, modification de l'objet...).
La fonction suivante MAIL.SendNewMessage permet d'envoyer un courriel suivant un modèle sans modification des éléments durant son élaboration, la modification reste, toutefois possible manuellement dans la fenêtre « Nouveau message » si son ouverture est activée avant l’envoi.
...
Il est ainsi possible d’ajouter le nom de l’utilisateur ERP en signature du message avec le tag [@g_c_user$] ou le numéro de la commande avec le tag [@COME.NoCommande].
6. Exemple de paramétrage d’envoi par courriel d’un accusé réception de commande et de prise de rendez-vous.
5.1. MAIL.NewMessage
Définition :
La fonction MAIL.NewMessage a pour vocation de créer un nouveau message qui peut être modifié avant d’être envoyé.
Syntaxe :
Mail.NewMessage(p1)
p1 : Le paramètre "Code modèle" permet de spécifier le modèle à utiliser pour créer le message. Il n’est pas obligatoire.
Cette fonction charge l’application "MAILMESSAGE" et commence la création d’un nouveau message à envoyer.
Ce nouveau message est initialisé avec les informations provenant du code modèle passé en paramètre si celui-ci est renseigné.
Si le code modèle est renseigné et si le modèle correspondant contient des tags de formule, ceux-ci seront remplacés par leurs valeurs dans le contexte dans lequel la fonction est appelée.
5.2. MAIL.AddRecipient
Définition :
La fonction MAIL.AddRecepient permet d’ajouter une adresse email en destinataire du courriel en cours de création.
Cette fonction n’est utilisable que si la fonction MAIL.NewMessage a été appelée auparavant.
Syntaxe :
MAIL.AddRecipient(p1,p2,p3)
Cette fonction comporte les paramètres suivants :
p1 : Adresse email (obligatoire) pour indiquer l’adresse du destinataire du courriel.
p2 : Le nom du destinataire (facultatif) .
p3 : Le type du destinatire (facultatif) qui correspond à A (par défaut), Cc ou Cci.
o 0 => A
o 1 => Cc
o 2 => Cci
Lorsque le nom est indiqué, l’adresse du destinataire est composée comme ceci :
nom du destinataire <destinataire@mail.fr>
5.3. MAIL.SetReplyAddress
Définition :
Cette fonction permet de définir l’adresse de réponse si elle est différente de l’adresse de l’expéditeur.
Syntaxe :
MAIL.SetReplyAddress(P1)
Cette fonction comporte les paramètres suivants :
p1 : Adresse email (obligatoire) pour indiquer l’adresse du de réponse du courriel.
5.4. MAIL.SetFrom
Définition :
Cette fonction permet de définir l’adresse de l’expéditeur.
Tous les serveurs de messagerie n’autorisent pas que le nom de l’émetteur soit différent de l’utilisateur connecté pour des raisons de sécurité évidente et éviter l’envoi de mail au nom d’un autre
Certains serveur d’envoi comme office 365 interdisent donc de modifier l’adresse de l’émetteur. Une erreur d’envoi de code 11207, par exemple, apparait alors et le mail n’est pas envoyé. L’utilisation de cette fonction n’est alors pas possible.
Syntaxe :
MAIL.SetFrom(P1)
p1 : Adresse email (obligatoire) pour indiquer l’adresse de l’expéditeur.
5.5. MAIL.SetObject
Définition :
Cette fonction permet de renseigner l’objet du message avec le texte passé en paramètre de la fonction.
Cette fonction n’est utilisable que si la fonction MAIL.NewMessage a été appelée auparavant.
Syntaxe :
MAIL.SetObject(p1)
p1 : Objet du message.
5.6. MAIL.SetMessage
Définition :
Cette fonction permet de renseigner le corps du message avec le texte passé en paramètre.
Cette fonction n’est utilisable que si la fonction MAIL.NewMessage a été appelée auparavant.
Syntaxe :
MAIL.SetMessage(p1)
p1 : Corps du message
5.7. MAIL.AddAttachment
Définition :
La fonction MAIL.AddAttachment permet d’ajouter le fichier passé en paramètre en pièce jointe du message en cours de création.
Cette fonction n’est utilisable que si la fonction MAIL.NewMessage a été appelée auparavant.
La fonction retourne "11001" si le fichier passé en paramètre est introuvable.
Syntaxe :
MAIL.AddAttachment(p1)
p1 : Le nom du fichier passé en paramètre peut être relatif au chemin de Silog ou complet avec le chemin d’accès.
5.8. MAIL.SendMessage
Définition :
Cette fonction déclenche l’envoi du message en cours de création.
Cette fonction n’est utilisable que si la fonction MAIL.NewMessage a été appelée auparavant.
Syntaxe :
MAIL.SendMessage(p1, p2)
La fonction comporte deux paramètres :
p1 : Pour définir si le message doit être affiché avant d’être envoyé pour permettre à l’utilisateur de modifier le message.
o 0 => Non
o 1 => Oui
p2 : Ce paramètre permet de définir si le message doit être enregistré dans le système pour conserver une trace.
o 0 => Non
o 1 => Oui
5.9. MAIL.SendNewMessage
Définition :
Cette fonction permet de déclencher la création d’un nouveau message à partir d’un code modèle et déclenche l’envoi avec affichage ou non du message et enregistrement dans le système.
Syntaxe :
MAIL.SendNewMessage(p1, p2,p3)
La fonction comporte trois paramètres :
p1 : Code modèle à utiliser.
p2 : Pour définir si le message doit être affiché avant d’être envoyé pour permettre à l’utilisateur de modifier le message avant son envoi.
o 0 => Non
o 1 => Oui
p3 :
Ce paramètre permet de définir si le message doit être enregistré dans le système pour conserver une trace de celui-ci.
o 0 => Non
o 1 => Oui
6. Exemple de paramétrage d’envoi par courriel d’un accusé réception de commande et de prise de rendez-vous.
...
6.1. Description de la fonctionnalité paramétrée
L'exemple suivant permet d'envoyer un courriel d'accusé réception d'une commande client avec en pièces jointes le fichier pdf relatif à l'accusé réception ainsi qu'un fichier d'extension ICS relatif à la prise de rendez-vous pour la livraison.
...
Le modèle d'Email utilisé (Application "Modèles de mail") est dans l'exemple : "EnvoiCDE" vu précédemment.
...
Le contenu brut :
...
Dans l'application "Commandes et accusés réceptions" , voici les zones ajoutées pour le rendez-vous associé à la pièce ( des « VarAlphaUtil ») :
...
Le Rendez-vous pour la livraison est en pièce jointe également :
...
6.2. Paramétrage de l’envoi de courriel :
Pour ce paramétrage, le courriel est envoyé via la sélection d’un bouton dans l’entête de la commande.
...