DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Mode asynchrone
  • Jauge de progression
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Envoie un email par l'intermédiaire du logiciel Lotus Notes : l'email est placé dans la boîte d'envoi du logiciel de messagerie. L'email est automatiquement envoyé par le spooler de Domino.
Attention : Lotus Notes doit être installé en mode connecté et non en mode local.
Attention : Avant d'envoyer l'email, il est nécessaire de :
Exemple
// Ouverture d'une session Notes
MaSession est un emailSessionNotes
MaSession.OuvreSession()
 
// Construction d'un email
MonMessage est un Email
MonMessage.Expediteur = "service_commande@masociete.fr"
MonMessage.Destinataire.Ajoute("client@societe.com")
MonMessage.Sujet = SAI_SujetEmail
MonMessage.Message = SAI_TexteEmail
 
// Envoi du message
MaSession.EnvoieMessage(MonMessage)
Syntaxe
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)

Envoyer un email par l'intermédiaire de MS Exchange, Lotus Notes ou Outlook Masquer les détails

<Résultat> = EmailEnvoieMessage(<Id session> [, <Email> [, <Afficher> [, <Type>]]])
<Résultat> : Booléen
  • Vrai si le message a été placé dans la boîte d'envoi de MS Exchange, de Lotus Notes ou de Outlook,
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Id session> : Variable de type emailSessionNotes
Identifie la session email en cours. Ce paramètre est un entier renvoyé par la fonction suivante EmailOuvreSessionNotes.
<Email> : Variable de type Email optionnelle
Nom de la variable de type Email correspondant à l'email à envoyer.
Si ce paramètre n'est pas spécifié, les informations contenues dans la structure Email sont utilisées.
<Afficher> : Booléen optionnel
  • Vrai pour afficher le message dans une boîte de dialogue avant de l'envoyer,
  • Faux (par défaut) pour ne pas afficher de boîte de dialogue.
Ce paramètre est pris en compte uniquement si la session email a été ouverte à l'aide de la fonction <Variable EmailSessionNotes>.OuvreSession, en utilisant la syntaxe MS Exchange avec un nom de profile. Dans les autres cas, la boîte de dialogue ne s'affiche pas.
Remarque : Ce paramètre n'est pas disponible pour Lotus Notes.
<Type> : Chaîne de caractères optionnelle
Décrit le type de message à envoyer. Par défaut, <Type> = "IPM" (Inter Personal Message).
Remarques
WEBDEV - Code ServeurAjax

Mode asynchrone

Si l'ouverture de session a été effectuée en mode asynchrone (fonctions <Variable EmailSessionNotes>.OuvreSession et EmailOuvreSessionSMTP), la fonction <Variable emailSessionNotes>.EnvoieMessage crée un identifiant pour chaque email envoyé.
L'identifiant de l'email est stocké dans la variable Email.IdentifiantMail et pourra être utilisé avec la fonction EmailEtat afin de connaître l'état d'envoi actuel de l'email (envoyé, en cours, ...).
Traitement des erreurs en mode asynchrone : La fonction <Variable emailSessionNotes>.EnvoieMessage renvoie Vrai si l'email est placé dans le spooler d'emails, Faux si il n'est pas possible de contacter le spooler. Pour savoir si l'email a été envoyé, il est nécessaire d'utiliser la fonction EmailEtat.
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Jauge de progression

Pour suivre la progression de l'envoi de l'email, utilisez la fonction EmailJauge.
Liste des exemples associés :
Envoi d'un email au format HTML Exemples unitaires (WINDEV) : Envoi d'un email au format HTML
[ + ] Utilisation de la fonction WLangage "EmailImporteHTML".
Cette fonction permet d'importer un fichier HTML directement dans la structure email. Cela permet notamment d'ajouter des images simplement dans des emails.
Envoi d'emails Exemples unitaires (WINDEV) : Envoi d'emails
[ + ] Envoi d'emails avec WINDEV.
WD Mailing par emails Exemples didactiques (WINDEV) : WD Mailing par emails
[ + ] Cet exemple illustre la possibilité d'envoyer un mailing par eMails avec WINDEV.

Cet exemple permet de saisir l'objet du message, son contenu et ses pièces jointes.
L'utilisateur doit ensuite sélectionner les clients auxquels le message doit être envoyé.
La fonction WLangage EMailEnvoieMessage() permet ensuite d'envoyer tout simplement le message saisi à chacun des clients sélectionnés.
Mise en Å“uvre technique :
Un serveur de mail compatible POP3/SMTP doit obligatoirement être accessible depuis le poste sur lequel s'exécute l'application.
WD JavaMail Exemples didactiques (WINDEV) : WD JavaMail
[ + ] Cet exemple est un exemple Java permettant de de lire et envoyer des emails.
WW_CMS Exemples complets (WEBDEV) : WW_CMS
[ + ] Cet exemple est un exemple de CMS (Content Management System).
C'est un site de gestion de contenu, typiquement un site d'affichage d'articles.

Cet exemple est découpé en 2 parties :
- Une partie AWP pour la partie qui doit être référencée
- Une partie WEBDEV Classique pour la partie administration

Note :
Pour que certaines fonctionnalités de l'exemple fonctionnent (l'envoi d'emails par exemple) il est nécessaire de modifier les paramètres afin de les adapter à votre configuration.
Ces paramètres sont stockés sous forme de constantes définies dans le code du projet.
Composante : wd290com.dll
Version minimum requise
  • Version 26
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale