Freigeben über

Konfigurieren eines SMTP-Sendeports

  • Artikel

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