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

1. 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.

2. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport neben Typ auf Konfigurieren.

3. 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: 1024
   Subject	Gibt den Subject-Header (Betreffzeile) für die Nachricht an. Mindestlänge: 0 Maximale Länge: 256
   Benachrichtigung	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.

4. 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 Kb
   Zeichensatz 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)

5. 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.

6. 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: 256
   Authentifizierungstyp	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: 256
   Kennwort	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: 256

7. Klicken Sie erneut aufOK, um die Einstellungen zu speichern.

Weitere Informationen

Konfigurieren des SMTP-Adapters