MAIL - Interface de messagerie, envoi de mails - www.4GL.fr
|
<< Click to Display Table of Contents >> Navigation: »No topics above this level« MAIL - Interface de messagerie, envoi de mails - www.4GL.fr |
vpxPrint permet d'envoyer des courriers automatiquement ou à la demande depuis la fenêtre de prévisualisation.
Balises d'envoi de mail :
<MAILTO= [TO:mailaddress1[,mailaddress2...] ] [ CC:adresse_mail1[,adresse_mail2...] ] [ BCC:mailaddress1[,mailaddress2...] ] > |
Destinataires.
Chaque groupe d'adresses est une liste délimitée par une virgule. Chaque groupe est séparé du précédent par un espace.
Exemple : <MAILTO=TO:info@4gl.fr,bill@bill.com CC:xxx@y.com >
N'ajoutez pas d'espace entre les adresses des séquences TO: CC: et BCC: Si un espace est inséré, les adresses qui suivent sont considérées comme TO: |
|
<MAILSUBJECT=sujet> |
Objet du message. |
|
<MAILBODY=Message> |
Note : oLe fichier produit par vpxPrint est toujours envoyé en pièce jointe sauf si <MAILNOFILE>. Le "Mail Body" est utilisé pour spécifier le texte du mail. oLe caractère TAB -chr(9)- génère un saut de ligne, c'est "<BR>" en HTML.
Si le message commence par <HTML>, il est évalué comme un texte HTML. Pour éviter toute confusion, les caractères "<" et ">" doivent être échappés par "\<" et "\>", respectivement. Voir ci-dessous la fonction escapeHTML().
La fonction escapeHTML() insère facilement les caractères d'échappement (\) avant tous les caractères < et >. Cette fonction préserve tous les "\<" et "\>" déjà présents dans la chaîne d'entrée.
Syntaxe : <MAILBODY=xxxxxxxxx>
Exemple : "<MAILBODY=" + escapeHTML("<html>Exemple d'un corps <strong>HTML</strong>") + ">" |
|
<SENDMAIL= [ PDF | xPrint ] [ ,DIALOG | NO-DIALOG ] > |
Exemples : <SENDMAIL=PDF,NO-DIALOG> <SENDMAIL=xPrint,NO-DIALOG>
Note : Le dialogue ou l'absence de dialogue permet d'indiquer à l'interface de messagerie d'activer ou de désactiver la boîte de dialogue avant l'envoi. |
|
<OUTLOOK> |
Cette balise n'a plus d'importance. Depuis la version 9.18, la valeur par défaut est Outlook. Cette balise est conservée pour des raisons de compatibilité. Si vous ne souhaitez pas utiliser Outlook, insérez une balise </OUTLOOK>.
Ancienne discussion : Indique à vpxPrint d'utiliser Outlook dans la mesure du possible (Outlook doit être installé). Si Outlook n'est pas présent, vpxPrint passe à l'interface MAPI. |
|
</OUTLOOK> |
|
vpxPrint n'essaiera pas de se connecter à Outlook. |
<MAILATTACH=file1[,file2....]> |
Spécifie des fichiers à joindre au message. |
|
<MAILRECEIPT= TRUE | FALSE> |
Si true, demande un accusé de réception lorsque le message est lu. OUTLOOK uniquement. |
|
|
Cette balise supprime l'intégration du rapport dans le courrier. vpxPrint peut être utilisé comme un programme de courrier standard : spécifiez les destinataires, le(s) fichier(s) à joindre, l'objet et le corps ou le corps html. Avec <MAILRECEIPT>, il s'agit d'une solution complète pour envoyer des mails. |
|
<MAILSelfClient= TRUE | FALSE>
Défaut = false |
vpxPrint permet d'envoyer des courriers en utilisant l'interface self incluse. Cette option est destinée à s'interfacer avec les serveurs Exchange lorsqu'aucun client de messagerie n'est installé.
Cette option n'est valable que lorsque la session CDO/MAPI est active. Dans tous les autres cas, cette option n'a aucun effet. |
|
|
Indique à vpxPrint d'ignorer l'interface de messagerie standard. Lorsque l'utilisateur clique sur le bouton "mail", vpxPrint se ferme et ajoute 1 000 000 à la valeur de retour. Utilisez printFileStat() pour vérifier cette valeur. Vous pouvez ensuite utiliser votre propre interface de messagerie. |
|
<MAILFrom=myaccount@gmail.com> *Outlook uniquement |
Définit les informations relatives à l'expéditeur |
|
<MailOnBehalf> |
<MAILOnBehalf=myadress@gmail.com> *Outlook uniquement |
Définit les informations "de la part de..." |
<MAILSilent> |
*Outlook uniquement |
N'affiche pas les messages d'erreur à l'écran. Attention : le message peut ne pas être envoyé, sans information visuelle. Vous devez vérifier le résultat de l'interface Mail pour obtenir le code retour, voir ci-dessous. |
<MAILSAVE=file> |
Enregistre un copie d'un message envoyé dans le fichier précisé. (Outlook seulement) Formats supportés : .msg, .eml, txt, rtf, oft, doc, html
MailConverter.exe doit être déployé pour les messages .eml |
Règles générales :
•La balise <SENDMAIL> ouvre le logiciel de messagerie.
•Sans aucun paramètre dans le sendmail :
1.Le fichier de rapport original est envoyé tel quel, en mode .txt ou .xpr (sauf si <SENDMAIL=PDF> est spécifié).
2.S'il y a un <PDF-OUTPUT=xxxx>, le rapport est automatiquement envoyé au format .pdf.
3.NO-DIALOG indique qu'Outlook ne demandeRA pas de confirmation avant d'envoyer le mail.
•si <SENDMAIL=PDF> est spécifié et qu'il n'existe pas de balise <PDF-OUTPUT>, un fichier PDF temporaire est créé dans le répertoire temporaire de Windows et supprimé à la fin de la session.
•Aucun envoi n'a lieu si <sendmail> n'est pas spécifié. Tous les paramètres <MAIL> sont inclus dans le message lors d'un clic sur le bouton d'envoi.
•On peut supprimer l'envoi du fichier courant avec une balise <MAILNOFILE>.

▪Les caractères TAB chr(9) sont utilisés pour ajouter des sauts de ligne dans le corps du message, utiliser "<BR>" pour HTML.
Notes techniques :
oPour utiliser l'interface de messagerie, Outlook, CDO/MAPI ou une interface MAPI correcte doivent être installés sur le système.
ovpxPrint se connecte automatuqment à l'interface de messagerie installé. L'ordre de priorité est le suivant :
1.Essai de connexion Outlook OLE (sauf si </OUTLOOK>)
2.Essai de connexion CDO/MAPI ('MAPI.SESSION'), vpMail.dll doit être déployé si <MAILSelfClient=true> et qu'un dialogue est nécessaire.
(plus d'informations sur vpMail.dll)
3.Essai d'envoi via l'interface MAPI de base.
Le statut du courrier peut être vérifié à l'aide du point d'entrée getMailResult de xprint.dll :
DEF VAR i AS INT.
RUN getMailResult(OUTPUT i).
La valeur de retour est la somme des conditions suivantes :
▪00000001 Le courrier a été envoyé
▪00000010 Erreur de courrier
▪00000100 Le courrier est sauvegardé // S'applique à Outlook, pas de support pour MAPI
▪00001000 Erreur de pièce jointe
▪00010000 Outlook
▪00100000 CDO
▪01000000 MAPI
PROGRESS peuvent vérifier le code de retour avec mailStatus() défini dans xprint.i :
D'autres environnements fournissent des valeurs de retour sous forme de chaîne comme "00010001", voir les paramètres spécifiques.
Syntaxe :
<logique> = mailStatus( <Condition_à_vérifier> ).
où <Condition_à_vérifier> est l'un des éléments suivants :
omailSent 1
omailError 2
omailSave 3
omailAttachError 4
omailOutlook 5
omailCDO 6
omailMAPI 7
Toutes ces valeurs sont définies dans .
Exemple :
| RUN printFile( "c:/temp/myReport.xpr"). | /* inutile d'appeler printFileStat() */ |
IF mailStatus( MailSent ) THEN
MESSAGE "Le courrier est envoyé" VIEW-AS ALERT-BOX.
-- OU --
/* RUN getMailResult(OUTPUT J). */ /* NOT NEEDED */
DEF VAR a AS CHAR NO-UNDO.
IF MailStatus(MailSent) THEN
A = 'Sent '.
IF MailStatus(MailSave) THEN
A = A + 'Save '.
IF MailStatus(MailError) THEN
A = A + 'ERROR '.
IF MailStatus(MailAttachError) THEN
A = A + 'AttachERROR '.
IF MailStatus(MailOutlook) THEN
A = A + 'Outlook '.
IF MailStatus(MailCDO) THEN
A = A + 'CDO '.
IF MailStatus(MailMAPI) THEN
A = A + 'MAPI '.
MESSAGE "Done." SKIP(1)
| /* 'Mail Return code:' J SKIP(2) */ | /* NOT NEEDED */ |
'Mail status:' A
VIEW-AS ALERT-BOX.