Konfigurieren eines SMTP-Sendeports
Sie können einen SMTP-Sendeport entweder programmgesteuert oder über die BizTalk Server-Verwaltungskonsole konfigurieren.
So konfigurieren Sie einen SMTP-Sendeport programmgesteuert
Der SMTP-Adapter speichert seine Konfigurationsinformationen in der BizTalk-Verwaltungsdatenbank (die auch als Konfigurationsdatenbank bezeichnet wird). Konfigurationsinformationen werden in einem benutzerdefinierten XML-Eigenschaftenbehälter gespeichert. Während der Initialisierung des SMTP-Adapters und zur Laufzeit übergibt der Server die Konfiguration folgendermaßen an den Adapter:
Für den SMTP-Sendehandler werden Konfigurationsinformationen an den Adapter übergeben, indem die Load-Methode der IPersistPropertyBag-Schnittstelle aufgerufen wird .
Für die SMTP-Sendeadapter werden Konfigurationsinformationen als Satz von Eigenschaften für einen Nachrichtenkontext an den Adapter übergeben. Im SMTP-Namespace werden diese Eigenschaften gruppiert.
Das BizTalk-Explorer-Objektmodell macht die ITransportInfo-Adapterkonfigurationsschnittstelle für Sendeports verfügbar, welche die TransportTypeData-Eigenschaft mit Lese-/Schreibzugriff enthält. Diese Eigenschaft akzeptiert die Eigenschaftensammlung für die Konfiguration des SMTP-Sendeports in Form einer aus einem Name/Wert-Paar bestehenden XML-Zeichenfolge. Beachten Sie, dass diese Eigenschaft zuerst für die Address-Eigenschaft der ITransportInfo-Schnittstelle festgelegt werden muss, um diese Eigenschaft im BizTalk Explorer-Objektmodell festzulegen.
Das Festlegen der TransportTypeData-Eigenschaft der ITransportInfo-Schnittstelle ist nicht erforderlich. Wenn sie nicht festgelegt ist, verwendet der SMTP-Sendeport die Standardwerte für den SMTP-Sendehandler. Die für den SMTP-Sendeport spezifischen Eigenschaften werden im Eigenschaftsschema bts_smtp_properties.xsd des SMTP-Sendeadapters definiert.
Wenn Sie keine Eigenschaften definieren, die die Konfigurationseigenschaften des Sendehandlers duplizieren, werden die Konfigurationseigenschaften des Handlers verwendet. Wenn Sie die erforderlichen Eigenschaften nicht angeben, werden Standardwerte verwendet. Wenn Sie keine Standardwerte definieren, protokolliert der HTTP-Sendehandler einen Fehler im Ereignisprotokoll und verschiebt die Nachricht in den Sicherungsadapter.
Sie können diese Eigenschaften programmgesteuert für einen Nachrichtenkontext festlegen. Die Eigenschaften können in einem BizTalk-Orchestrierungszeitplan oder in einer benutzerdefinierten Pipelinekomponente festgelegt werden. Für die Verwendung dieser Eigenschaften gelten die folgenden Regeln:
Wenn die Eigenschaft in einer Orchestrierung oder in einer benutzerdefinierten Pipelinekomponente festgelegt wird, gilt Folgendes:
Wenn die Nachricht an einen statischen Sendeport gesendet wird, wird der Eigenschaftenwert durch den für diesen Sendeport konfigurierten Wert überschrieben.
Wenn die Nachricht an einen dynamischen Sendeport gesendet wird, wird der Eigenschaftenwert nicht überschrieben.
Wenn die Eigenschaft in einer benutzerdefinierten Pipelinekomponente in einer Sendepipeline festgelegt wird, gilt Folgendes:
- Der Eigenschaftenwert wird unabhängig davon nicht überschrieben, ob die Nachricht an einen statischen oder einen dynamischen Sendeport gesendet wird.
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie im Objektmodell von BizTalk-Explorer für den SMTP-Sendespeicherort festlegen können.
Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
---|---|---|---|---|
SMTPHost | xs:string | Der SMTP-Server, der zum Senden von Nachrichten verwendet wird. | Maximale Länge: 256 | Standardwert: Leer. Der Standardwert zeigt an, dass der SMTP-Sendeport die Konfigurationswerte für den Handler verwendet. |
From | xs:string | Die E-Mail-Adresse, die der SMTP-Sendeport im SMTP-Von-Header platziert. | Maximale Länge: 256 | Standardwert: Leer. Der Standardwert zeigt an, dass der SMTP-Sendeport die Konfigurationswerte für den Handler verwendet. |
CC | xs:string | Die E-Mail-Adresse, an die eine Kopie der Nachricht gesendet wird. | Maximale Länge: 1024 | Standardwert: Leer Sie können mehrere E-Mail-Adressen angeben. |
Subject | xs:string | Der Betreffheader für die Nachricht. | Mindestlänge: 0 Maximale Länge: 256 |
Standardwert: %MessageID%. |
SMTPAuthenticate | xs:int | Der zu verwendende Authentifizierungstyp. | Keine | Gültige Werte: - 0 : Keine Authentifizierung - 1. Standardauthentifizierung - 2: Prozesskonto (NTLM) Der Standardwert zeigt an, dass der SMTP-Sendeport die Konfigurationswerte für den Handler verwendet. Wenn der Standardwert verwendet werden soll, lassen Sie diese Eigenschaft im Eigenschaftenbehälter aus, wenn Sie die TransportTypeData-Eigenschaft festlegen. |
UserName | xs:string | Der Benutzername, der für die Authentifizierung mit dem SMTP-Server verwendet werden soll. | Mindestlänge: 0 Maximale Länge: 256 |
Standardwert: Leer Erfordert einen Wert, wenn SMTPAuthenticate gleich 1 (Standardauthentifizierung) ist. |
Kennwort | xs:string | Das Benutzerkennwort, das für die Authentifizierung mit dem SMTP-Server verwendet werden soll. | Mindestlänge: 0 Maximale Länge: 256 |
Standardwert: Leer Erfordert einen Wert, wenn SMTPAuthenticate gleich 1 (Standardauthentifizierung) ist. |
ReadReceipt | xs:boolean | Fordert eine Lesebestätigung für die Nachricht von diesem Sendeport an. | Keine | Standardwert: False |
DeliveryReceipt | xs:boolean | Fordert eine Übermittlungsbestätigung für die Nachricht von diesem Sendeport an. | Keine | Standardwert: False |
EmailBodyText | xs:string | Geben Sie den Text für den Textteil der zu sendenden E-Mail an. | Maximale Länge: 64 kb | Standardwert: Leer |
EmailBodyTextCharset | xs:string | Geben Sie den Zeichensatz an, der zum Codieren des Texts der gesendeten E-Mail verwendet werden soll, wenn die Option EmailBodyText verwendet wird. Der SMTP-Adapter konvertiert den EmailBodyText in den durch EmailBodyTextCharset angegebenen Zeichensatz. | Keine | Standardwert: Keine. Sie müssen den Wert explizit festlegen, z. B. auf UTF-8. Wenn Sie keinen Wert festlegen, wird ggf. der am Ende dieses Themas beschriebene Wert angezeigt. |
EmailBodyFile | xs:string | Gibt an, dass der Inhalt einer Datei als Textteil der zu sendenden E-Mail-Nachricht verwendet werden soll. Gibt außerdem den vollständigen Pfad der Datei an. Auf diesen Pfad muss der Host des SMTP-Adapters zur Laufzeit zugreifen können. | Maximale Pfadlänge: 256 Zeichen | Standardwert: Leer |
EmailBodyFileCharset | xs:string | Geben Sie den Zeichensatz an, der zum Codieren des Textkörpers der gesendeten E-Mail verwendet werden soll, wenn die EmailBodyFile-Eigenschaft festgelegt ist. Der SMTP-Adapter wendet keine Konvertierung auf die Datei an. Die Datei muss bereits in diesem Zeichensatz codiert sein. Wenn die Datei eine Markierung für die Bytereihenfolge hat, wird diese vom SMTP-Adapter entfernt. | Keine | Standardwert: UTF-8 (65001) |
Attachments | xs:string | Gibt an, dass mindestens eine Datei an die E-Mail-Nachricht angefügt wird, und gibt den vollständigen Pfad der Dateien an. Auf diesen angegebenen Pfad muss der Host des SMTP-Adapters zur Laufzeit zugreifen können. | Maximale Pfadlänge: 256 Zeichen | Standardwert: Leer |
MessagePartsAttachments | xs:int | Geben Sie an, wie BizTalk-Nachrichtenteile an die E-Mail-Nachricht angefügt werden. | Keine | Gültige Werte: - 0 : Es werden keine BizTalk-Nachrichtenteile als Anlagen verwendet. - 1: Der BizTalk-Nachrichtentextteil wird als E-Mail-Anlage gesendet. In diesem Fall sollten die Eigenschaften EmailBodyFile oder EmailBodyText angegeben werden. Wenn keine dieser Eigenschaften angegeben wird, wird der Nachrichtenteil der BizTalk-Nachricht als E-Mail-Nachrichtentext und nicht als Anlage gesendet. - 2 : Alle Teile werden als Anlagen gesendet. Wenn jedoch EmailBodyText oder EmailBodyFile nicht angegeben werden, wird der BizTalk-Nachrichtentextteil als E-Mail-Text gesendet, und andere Teile werden als Anlagen gesendet. Standardwert: 0 |
ReplyBy | xs:dateTime | Füllt das Feld Reply-By-Header in der ausgehenden Nachricht mit dem angegebenen Wert auf. | Diese Eigenschaft kann nicht für die Eigenschaftenseite des Sendeports festgelegt werden. Diese Eigenschaft kann aus einer Pipeline oder einer Orchestrierung festgelegt werden. | Standardwert: Leer |
Der folgende Code zeigt das Format der XML-Zeichenfolge, die zum Festlegen dieser Eigenschaften verwendet wird:
<CustomProps>
<DeliveryReceipt vt="11">-1</DeliveryReceipt
<SMTPHost vt="8">sfdsadf</SMTPHost>
<Subject vt="8">Some subject</Subject>
<From vt="8">username@domain.com</From>
<SMTPAuthenticate vt="19">2</SMTPAuthenticate>
<ReadReceipt vt="11">-1</ReadReceipt>
</CustomProps>
Konfigurieren eines SMTP-Sendeports über die BizTalk Server-Verwaltungskonsole
Sie können in der BizTalk Server-Verwaltungskonsole Adaptervariablen für den SMTP-Sendeport festlegen. Wenn keine Eigenschaften für den Sendeport festgelegt sind, werden die in der BizTalk Server-Verwaltungskonsole festgelegten Standardwerte für den Sendehandler verwendet.
Gehen Sie wie folgt vor, um den SMTP-Sendeport mit der BizTalk Server-Verwaltungskonsole zu konfigurieren.
So konfigurieren Sie Variablen für einen SMTP-Sendeport
Erstellen Sie in der BizTalk Server-Verwaltungskonsole einen neuen Sendeport, oder doppelklicken Sie auf einen vorhandenen Sendeport, um diesen zu ändern. Weitere Informationen finden Sie unter Erstellen eines Sendeports. Konfigurieren Sie alle Sendeportoptionen, und geben Sie SMTP für die Option Typ im Abschnitt Transport der Registerkarte Allgemein an.
Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport neben Typ auf Konfigurieren.
Führen Sie im Dialogfeld SMTP-Transporteigenschaften auf der Registerkarte Allgemein die folgenden Schritte aus:
Option Aufgabe An Erforderlich. Geben Sie die E-Mail-Adresse an, an die Nachrichten gesendet werden sollen.
Sie können mehrere Adressen angeben.
Maximale Länge: 256
Weitere Informationen zu dieser Eigenschaft finden Sie unter Einschränkungen für die SMTP To-Eigenschaft.CC Geben Sie die E-Mail-Adresse an, an die die Carbon-Kopie der Nachricht gesendet werden soll.
Sie können mehrere Adressen angeben.
Maximale Länge: 1024Subject Gibt den Subject-Header (Betreffzeile) für die Nachricht an.
Mindestlänge: 0
Maximale Länge: 256Benachrichtigung Geben Sie den Typ der Benachrichtigungsbestätigung an. Sie können einen oder beide Bestätigungstypen auswählen. Typen der Benachrichtigungsbestätigung:
- Beleg lesen. Eine Bestätigungs-E-Mail wird gesendet, nachdem die Nachricht gelesen wurde.
- Lieferschein. Eine Bestätigungs-E-Mail wird gesendet, nachdem die Nachricht zugestellt wurde.Führen Sie im Dialogfeld SMTP-Transporteigenschaften auf der Registerkarte Verfassen die folgenden Schritte aus:
Option Aufgabe Textteil einer BizTalk-Nachricht Geben Sie an, dass der Textteil einer BizTalk-Nachricht als Textteil der zu sendenden E-Mail verwendet werden soll. Text Geben Sie den Text für den Textteil der zu sendenden E-Mail an. Nachdem die Option Text aktiviert ist, können Sie den Text für den E-Mail-Text in das Textfeld eingeben.
Maximale Länge: 64 KbZeichensatz des Texts – Geben Sie den Zeichensatz an, der zum Codieren des Textkörpers der gesendeten E-Mail verwendet werden soll. Diese Option ist nur verfügbar, wenn die Option Text ausgewählt ist.
- Standardwert: UTF-8 (65001)File Geben Sie an, dass der Inhalt einer Datei als Textteil der zu sendenden E-Mail verwendet werden soll. Geben Sie außerdem den Dateipfad an. Nachdem Sie die Option Datei ausgewählt haben, können Sie auf die Schaltfläche Auslassungspunkte (...) klicken, um zur Datei zu navigieren.
Maximale Pfadlänge: 256 Zeichen Hinweis: Es wird empfohlen, einen Pfad für eine Dateifreigabe anzugeben, auf den von allen BizTalk-Servern in der BizTalk Server Gruppe zugegriffen werden kann, die in der Produktion verwendet werden soll.Zeichensatz der Datei Geben Sie den Zeichensatz an, mit dem die zu sendende Datei codiert wird. Hinweis: Der SMTP-Adapter wendet die angegebene Codierung nicht auf die Datei an. Mit dieser Option wird nur angegeben, wie die gesendete Datei bereits codiert ist.
Diese Option ist nur verfügbar, wenn die Option Datei ausgewählt ist.
Standardwert: UTF-8 (65001)Gehen Sie im Dialogfeld SMTP-Transporteigenschaften auf der Registerkarte Anlagen wie folgt vor:
Option Aufgabe Verbleibende BizTalk-Nachrichtenteile Geben Sie an, wie BizTalk-Nachrichtenteile an die E-Mail-Nachricht angefügt werden.
Optionen:
- Keine Teile anfügen
- Nur Textkörper anfügen
- Alle Teile anfügen
Standardwert: Fügen Sie keine Teile an.Add (Hinzufügen) Geben Sie Dateien an, die an die E-Mail-Nachricht angefügt werden sollen. Nachdem Sie auf Hinzufügen geklickt haben, können Sie eine Datei auswählen und der Liste der dateien hinzufügen, die angefügt werden sollen.
Maximale Pfadlänge: 256 Zeichen Hinweis: Es wird empfohlen, einen Pfad für eine Dateifreigabe anzugeben, auf den von allen BizTalk-Servern in der BizTalk Server Gruppe zugegriffen werden kann, die in der Produktion verwendet werden soll.Entfernen Entfernt die ausgewählte Datei aus der Liste der Dateien, die an die E-Mail-Nachricht angefügt werden sollen. Führen Sie im Dialogfeld SMTP-Transporteigenschaften auf der Registerkarte Handlerüberschreibung die folgenden Schritte aus:
Option Aufgabe SMTP-Servername Geben Sie den Namen des SMTP-Servers für den Versand von Nachrichten an.
Maximale Länge: 256 Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf 256 Zeichen nicht überschreiten.Von (E-Mail-Adresse) Geben Sie die E-Mail-Adresse an, die im SMTP From-Header platziert werden soll.
Maximale Länge: 256Authentifizierungstyp Geben Sie den Typ der Authentifizierung am SMTP-Server an.
Optionen:
- (Standard)
- Keine Authentifizierung
- Standardauthentifizierung
- Prozesskonto (NTLM)
Der Standardwert gibt an, dass der SMTP-Sendeport die im Sendehandler angegebenen Konfigurationswerte verwendet.Benutzername Geben Sie den Benutzernamen für die Authentifizierung am SMTP-Server an.
Diese Eigenschaft erfordert einen Wert, wenn der AuthentifizierungstypDie Standardauthentifizierung ist.
Mindestlänge: 0
Maximale Länge: 256Kennwort Geben Sie das Kennwort für die Authentifizierung am SMTP-Server an.
Diese Eigenschaft erfordert einen Wert, wenn der AuthentifizierungstypDie Standardauthentifizierung ist.
Mindestlänge: 0
Maximale Länge: 256Klicken Sie erneut aufOK, um die Einstellungen zu speichern.