SendMail
L’exemple SendMail montre comment utiliser l’adaptateur SMTP (Simple Mail Transfer Protocol) pour envoyer des messages électroniques à partir d’une orchestration Microsoft BizTalk Server. Les informations dynamiques utilisées pour envoyer les messages électroniques sont extraites d'un message XML à l'aide de la fonctionnalité de promotion de propriétés.
Fonctions de l'exemple
Cet exemple envoie un message électronique à l'aide d'informations obtenues à partir des propriétés promues à partir d'un message de bon de commande (PO) XML entrant, en procédant comme suit :
L’orchestration BizTalk Server récupère un message de bon de commande XML d’entrée.
L’orchestration BizTalk Server promeut les propriétés PONumber et Email pour faciliter l’accès à l’avenir.
L’orchestration BizTalk Server utilise les valeurs des propriétés promues pour définir l’adresse de destination du port d’envoi dynamique et pour définir l’objet du message électronique.
L’orchestration BizTalk Server envoie le message électronique construit via l’adaptateur SMTP.
Accès à l'exemple
<Chemin d’accès> des exemples\AdaptersUsage\SendMail\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| AssemblyInfo.cs, SendMail.btproj, SendMail.sln | Fournit des fichiers d'informations de projet, de solution et d'assembly pour cet exemple. |
| Cleanup.bat | Annule le déploiement des assemblys et les supprime du GAC, supprime les ports d'envoi et de réception, ainsi que les répertoires virtuels Microsoft Internet Information Services. |
| PropertySchema.xsd, PurchaseOrder.xsd | Fournit des schémas respectivement pour les propriétés que vous voulez promouvoir et pour le message de PO XML. |
| ReceiveSend.odx | Fournit une orchestration BizTalk Server qui traite le message DE bon de commande XML entrant et envoie un message électronique en fonction des informations contenues dans le message. |
| SendMailInput.xml | Contient un exemple de fichier d'entrée avec un bon de commande spécifié à l'aide de XML. |
| Setup.bat | Crée et initialise l'exemple. Note: Ce fichier d’installation crée et lie des ports, et ainsi de suite, à l’aide d’un mécanisme différent de la plupart des fichiers d’installation pour les exemples sdk. Il ne nécessite pas de fichier .xml compagnon. |
Pour créer et initialiser l'exemple
Dans une fenêtre de commande, accédez au dossier suivant :
<Chemin d’accès> des exemples\AdaptersUsage\SendMail
Exécutez le fichier Setup.bat, qui effectue les actions suivantes :
Crée le dossier d'entrée suivant pour cet exemple :
<Chemin d’accès> des exemples\AdaptersUsage\SendMail\In
Compile le projet Visual Studio pour cet exemple.
Démarre l’orchestration BizTalk Server.
Notes
Avant de tenter d'exécuter cet exemple, vous devez confirmer que BizTalk n'a signalé aucune erreur durant le processus de création et d'initialisation.
Notes
Si vous choisissez d'ouvrir et de créer le projet dans cet exemple sans exécuter le fichier Setup.bat, vous devez d'abord créer une paire de clés de nom fort en utilisant l'utilitaire .NET Framework Strong Name Utility (sn.exe). Utilisez cette paire de clés pour signer l'assembly obtenu.
Notes
Pour annuler les modifications apportées par Setup.bat, exécutez Cleanup.bat et supprimez tous les ports de réception et d’envoi préfixés par SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Vous devez exécuter Cleanup.bat avant d'exécuter Cleanup.bat une seconde fois.
Dans la console Administration BizTalk Server, recherchez le port de réception préfixé par SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Mettez à jour l’emplacement de réception de ce port de réception pour qu’il pointe vers un répertoire sur votre système de fichiers à utiliser comme emplacement d’entrée.
À l’aide d’un programme tel que le Bloc-notes, modifiez le fichier SendMailInput.xml afin que l’élément Email spécifie une adresse de messagerie légitime à laquelle vous souhaitez recevoir le message électronique généré par cet exemple.
Cliquez sur Démarrer, pointez sur Programmes, pointez sur Microsoft BizTalk Server 20xx, puis cliquez sur BizTalk Server Administration.
Dans la console Administration BizTalk Server, développez l’arborescence BizTalk Group.
Développez l’arborescence Paramètres de plateforme dans le volet gauche.
Développez le dossier Adaptateurs , cliquez sur le nœud SMTP , puis double-cliquez sur la ligne de l’adaptateur SMTP dans le volet droit.
Dans la boîte de dialogue Propriétés du gestionnaire d’adaptateur SMTP , cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du transport SMTP , sous l’onglet Propriétés , indiquez les valeurs appropriées pour le nom du serveur SMTP et les propriétés De (adresse de messagerie), puis cliquez sur OK.
Ces valeurs seront utilisées pour créer l'adresse électronique De pour tous les messages électroniques envoyés via cet adaptateur SMTP.
Notes
Si vous devez vous authentifier auprès de votre serveur SMTP, vous devez veiller à ce que l'adresse électronique De appartienne au même compte que celui que vous utilisez pour l'authentification.
Arrêtez, puis redémarrez le service BizTalk (BizTalkServerApplication) de façon à ce que l'orchestration adopte ces modifications.
Pour exécuter l'exemple
Placez une copie du fichier modifié SendMailInput.xml dans le dossier d'entrée.
Observez l'arrivée d'un message électronique à l'adresse spécifiée au cours de la procédure précédente.