Dernière mise à jour :2008-10-15

informatique

Cet article démontre comment réaliser une interface web permettant d’inter-agir avec les services de courrier électronique sur un serveur Windows à l’aide du langage de programmation ASP et CDO (Collaboration Data Objects).

Note : Avant d’utiliser le code présenté dans cet article, assurez-vous que le serveur sur lequel est hébergé votre site Web est de type Windows et que CDONTS est disponible et fonctionnel sur ce serveur.

CDO est une technologie qui permet au programmeur de développer facilement des services de messagerie électronique simples. Ils offrent aussi d’utiliser les composants de Exchange Server de Microsoft. CDO est d’ailleurs inclut avec ce dernier. On peut aussi ce procurer CDO directement sur le site de Microsoft.

Dans la plupart des cas, les programmeurs ne désireront pas utiliser les éléments de Exchange Server puisque le besoin le plus courant est l’envois de message et que cette fonction est disponible avec CDONTS qui est plus facile d’utilisation.

Le sujet principal de cet article est justement CDONTS.

Structure de CDONTS

Avant de commencer la présentation d’exemples de code en rapport avec CDONTS, il convient de regarder de quoi celui-ci est composé.

  • Session
    • Folder
      • Messages
        • Message
          • Address Entry
          • Attachments
            • Attachment
          • Recipients
            • Recipient
  • NewMail

Comme on peut le constater, l’objet Session comprend la majorité des objets composant le modèle de CDONTS. Une instance de l’objet Session de CDONTS est créée pour chaque utilisateur qui entre en communication avec le serveur de courrier (mail server). L’instance en question contient certaines informations spécifiques à cet utilisateur.

En plus de l’objet Session et de tout ce qu’il contient, CDONTS offre aussi l’objet NewMail. C’est des propriétés et méthodes de cet objet que nous discuterons dans les prochaines lignes.

L’objet NewMail

Cet objet permet de facilement créer un programme d’envois de courriers électroniques dans une page ASP.

Le listing ci-dessous présente un court programme illustrant comment utiliser l’objet NewMail pour envoyer un message.

Listing 1.0
<html>
<head>
<title>Exemple de script ASP - NewMail CDONTS</title>
</head>
<body>
<%
Dim objNewMail
Set objNewMail = Server.CreateObject("CDONTS.NewMail")
objNewMail.Send "vinz102@caramail.com","sylvain_bilodeau@hotmail.com","Bonjour","A525G, un portail d’information"
Set objNewMail = Nothing
%>
</body>
</html>

Le résultat de cette page ASP affiché dans un navigateur web afficherait une page blanche. Par contre, un courrier électronique aurait été envoyé à l’adresse e-mail sylvain_bilodeau@hotmail.com avec pour sujet du message «Bonjour» et comme texte de message «A525G, un portail d’information». Finalement, il serait indiqué que le message provient de l’adresse e-mail vinz102@caramail.com.

C'est à la ligne 9 que le message est envoyé à l'aide de la méthode Send. Voici la liste des paramètres de celle-ci :

  • From : L'adresse e-mail de l'expéditeur
  • To : L'adresse e-mail du récepteur
  • Subject : Le sujet du message
  • Body : Le corps du message
  • Importance : L'importance du message. Cette propriété accepte une valeur numérique (0 - Faible, 1 - Normal ET 2 - Haute). Par défaut, la propriété Importance est configurée 1 (normal).

L'objet NewMail possède d'autres propriétés dont voici la liste :

  • CC : Adresse e-mail à qui le message sera envoyé en copie
  • BCC : Adresse e-mail à qui le message sera envoyé en copie cachée
  • BodyFormat : Permet d'indiquer si le message sera envoyé en «Plain text» ou en format HTML. Par défaut, cette propriété indique que le message sera envoyé en plain text.
  • ContentBase : Permet de spécifier le début (la base) de tous les URLs contenus dans le corps du message.
  • ContentLocation : Permet de spécifier le chemin d'accès menant aux différents fichiers dont les URLs se trouvent dans le message.
  • MailFormat : Permet d'indiquer l'encodage du message. La valeur par défaut est 1 (format texte) mais vous pouvez aussi indique 0 (format MIME).
  • Value : Permet d'ajouter des valeurs dans l'entête du message. Elle s'utilise selon la syntaxe suivante : objNewMail.Value(header) = strHeaderValue. Dans l'exemple suivant, header représente le nom de la section de l'entête et strHeaderValue représente la valeur qui doit être donnée à la section.
  • Version : Cette propriété est en lecture seule. Elle retourne la version de CDONTS installé sur le serveur Web.

En terminant, voici les méthodes (à l'exception de la méthode NewMail décrite ci-dessus) de l'objet NewMail

  • AttachFile : Cette méthode permet de joindre un fichier au message. Elle contient les trois paramètres suivant : Source, , FileName et EncodingMethod. Le paramètre Source peut être un objet de type IStream ou encore, une chaine de caractère indiquant le chemin d'accès au fichier. Le second paramètre permet de spécifier le nom du fichier. Si celui-ci n'est pas indiqué, le nom de fichier spécifié dans le paramètre Source sera utilisé. Le dernier paramètre permet d'indiquer la méthode d'encodage 0 (UUEncode) et 1 (base 64).
  • AttachURL
  • SetLocaleIDs

Auteur : Sylvain Bilodeau

Date de mise en ligne : 2005-06-14

Aucun commentaire pour l'instant.