SendMail
Das SendMail-Beispiel veranschaulicht, wie Sie den SMTP-Adapter (Simple Mail Transfer Protocol) verwenden können, um E-Mail-Nachrichten aus einer Microsoft BizTalk Server-Orchestrierung zu senden. Die zum Senden der E-Mail-Nachrichten verwendeten dynamischen Informationen werden mithilfe der Funktionalität zur Eigenschaftenhöherstufung aus einer XML-Nachricht abgerufen.
In diesem Beispiel wird eine E-Mail-Nachricht mithilfe von Informationen gesendet, die aus Eigenschaften abgerufen werden, die unter Einhaltung der folgenden Schritte aus einer eingehenden XML-Bestellungsnachricht heraufgestuft wurden:
Die BizTalk Server Orchestrierung ruft eine XML-Po-Eingabenachricht ab.
Die BizTalk Server-Orchestrierung fördert die EIGENSCHAFTEN PONumber und Email, um den Zugriff in Zukunft zu erleichtern.
Die BizTalk Server Orchestrierung verwendet die Werte der heraufgestuften Eigenschaften, um die Zieladresse des dynamischen Sendeports festzulegen und den Betreff der E-Mail-Nachricht festzulegen.
Die BizTalk Server Orchestrierung sendet die erstellte E-Mail-Nachricht über den SMTP-Adapter.
<Beispielpfad>\AdaptersUsage\SendMail\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
Datei(en) | BESCHREIBUNG |
---|---|
AssemblyInfo.cs, SendMail.btproj, SendMail.sln | Diese Dateien stellen Projekt-, Projektmappen- und Assemblyinformationsdateien für dieses Beispiel bereit. |
Cleanup.bat | Nimmt die Bereitstellung der Assemblys zurück und entfernt sie aus dem globalen Assemblycache (GAC), entfernt Sende- und Empfangsport und entfernt die virtuellen IIS-Verzeichnisse (Microsoft Internet Information Services, Internetinformationsdienste) nach Bedarf. |
PropertySchema.xsd, PurchaseOrder.xsd | Stellt Schemas für die höherzustufenden Eigenschaften und für die XML-Bestellungsnachricht bereit. |
ReceiveSend.odx | Stellt eine BizTalk Server-Orchestrierung bereit, die die eingehende XML-Po-Nachricht verarbeitet und eine E-Mail-Nachricht basierend auf informationen in der Nachricht sendet. |
SendMailInput.xml | Enthält eine Beispieleingabedatei mit einer Bestellung, die mithilfe von XML angegeben wurde. |
Setup.bat | Erstellt und initialisiert dieses Beispiel. Hinweis: Diese Setupdatei erstellt und bindet Ports usw. mithilfe eines anderen Mechanismus als die meisten Setupdateien für die SDK-Beispiele. Sie erfordert keine begleitende XML-Datei. |
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\AdaptersUsage\SendMail
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Erstellt die folgenden Eingabeordner für dieses Beispiel:
<Beispielpfad>\AdaptersUsage\SendMail\In
Kompiliert das Visual Studio-Projekt für dieses Beispiel.
Startet die BizTalk Server-Orchestrierung.
Hinweis
Sie sollten sicherstellen, dass von BizTalk während des Erstellungs- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie dieses Beispiel ausführen.
Hinweis
Wenn Sie das Projekt in diesem Beispiel öffnen und erstellen möchten, ohne die Datei Setup.bat auszuführen, müssen Sie zunächst ein Schlüsselpaar für starke Namen mit dem entsprechenden .NET Framework-Hilfsprogramm (sn.exe) erstellen. Verwenden Sie dieses Schlüsselpaar zum Signieren der sich ergebenden Assembly.
Hinweis
Führen Sie zum Rückgängigmachen der von Setup.bat vorgenommenen Änderungen Cleanup.bat aus, und löschen Sie alle Empfangs- und Sendeports mit dem Präfix SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. "Cleanup.bat" müssen Sie ausführen, bevor "Setup.bat" ein zweites Mal ausgeführt wird.
Suchen Sie in der BizTalk Server Verwaltungskonsole nach dem Empfangsport mit dem Präfix SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Aktualisieren Sie den Empfangsspeicherort für diesen Empfangsport so, dass er auf ein Verzeichnis in Ihrem Dateisystem verweist, das als Eingabespeicherort verwendet werden soll.
Ändern Sie mit einem Programm wie Editor die Datei SendMailInput.xml, sodass das Email-Element eine legitime E-Mail-Adresse angibt, an der Sie die von diesem Beispiel generierte E-Mail-Nachricht empfangen möchten.
Klicken Sie auf Start, zeigen Sie auf Programme, zeigen Sie auf Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Verwaltung.
Erweitern Sie in der BizTalk Server Verwaltungskonsole die BizTalk-Gruppenstruktur.
Erweitern Sie die Struktur Plattformeinstellungen im linken Bereich.
Erweitern Sie den Ordner Adapters , klicken Sie auf den Knoten SMTP , und doppelklicken Sie dann im rechten Bereich auf die Zeile SMTP-Adapter.
Klicken Sie im Dialogfeld SMTP - Adapterhandlereigenschaften auf Eigenschaften.
Geben Sie im Dialogfeld SMTP-Transporteigenschaften auf der Registerkarte Eigenschaften die entsprechenden Werte für die Eigenschaften SMTP-Servername und From (E-Mail-Adresse) an, und klicken Sie dann auf OK.
Diese Werte werden zum Erstellen der E-Mail-Adresse des Absenders für sämtliche E-Mail-Nachrichten verwendet, die über diesen SMTP-Adapter gesendet werden.
Hinweis
Wenn eine Authentifizierung beim SMTP-Server erforderlich ist, müssen Sie sicherstellen, dass die E-Mail-Adresse des Absenders zum gleichen Konto gehört, das Sie auch für die Authentifizierung verwenden.
Beenden Sie den BizTalk-Dienst (BizTalkServerApplication) und starten Sie ihn dann erneut, damit die Orchestrierung diese Änderungen übernimmt.
Speichern Sie eine Kopie der geänderten Datei SendMailInput.xml im Eingabeordner.
Beachten Sie das Eintreffen einer E-Mail-Nachricht an die von Ihnen im vorherigen Verfahren angegebene E-Mail-Adresse.