Konfiguration des Mail-Empfänger-Adapters 

Verwendung

Sie konfigurieren den Mail-Empfänger-Adapter, um damit XI-Messages in E-Mails umzuwandeln.

Integration

Die Adapterkonfiguration ist Teil der Festlegung eines Kommunikationskanals im Integration Server oder im PCK und wird auf der Registerkarte Parameter vorgenommen. Zusätzlich zur Adapterkonfiguration können auf der Registerkarte Modul im Modul-Prozessor generische Module angegeben werden, die den Adapter mit Zusatzfunktionen ausstatten. 

Voraussetzungen

       1.      Sie haben einen Kommunikationskanal angelegt oder einen bestehenden Kommunikationskanal geöffnet.

       2.      Sie haben auf der Registerkarte Parameter den Adaptertyp Mail ausgewählt.

       3.      Sie haben den Adapter über den Auswahlknopf Empfänger als Empfänger-Adapter definiert.

Aktivitäten

Zur Konfiguration des Adapters machen Sie folgende Angaben:

Transport-Protokoll

●      SMTP

Mit SMTP (Simple Mail Transfer Protocol) können Sie E-Mails an einen E-Mail-Server überstellen.

●      IMAP4

Mit (Internet Message Access Protocol) können Sie E-Mails in einen Order eines E-Mail-Servers einstellen.

Message-Protokoll

●      XIALL

In diesem Modus werden alle Informationen der XI-Message in den Nachrichtentext der E-Mail eingestellt. Der Inhalt der XI-Message entspricht direkt dem Inhalt der RFC822 Mail-Message.

●      XIPAYLOAD

In diesem Modus wird die Payload der XI-Message dazu verwendet, die Mail-Message zu erstellen.

Liegt die Payload im Mail-Package-Format vor, werden auch die Header-Informationen für die E-Mail verwendet. Wenn Mail-Package nicht verwendet wird, werden die Header-Informationen aus der unten beschriebenen Adapterkonfiguration gewonnen.

Adapter-Engine

Wählen sie die Adapter-Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter-Engine aus. Diese Auswahl ist im PCK nicht möglich.

Registerkarte Allgemein

Verbindungsparameter für Mail-Server

Feld	Eingabe
URL	Geben Sie die Adresse des E-Mail-Server an: ●      für SMTP z.B. smtp://mailserver ●      für IMAP z.B. imap://imapserver/XIOutBox
Benutzerauthentifikation konfigurieren	Wählen Sie die Authentifizierungsmethode. ●      Einfach ●      CRAM-MD5 Falls der Server eine Anmeldung erwartet, dann setzen Sie das Kennzeichen. ●      Geben Sie den Benutzernamen an, unter dem die Anmeldung am Server erfolgt. ●      Geben Sie das Kennwort mit Bestätigung an.
Lieferstatusbenachrichtigung	●      Um eine Lieferstatusbenachrichtigung zu erhalten, setzen Sie das Kennzeichen. ●      Geben Sie die E-Mail-Adresse des Empfängers der Benachrichtigung an.

Mail-Attribute für Message-Protokoll XIPAYLOAD

●      Haben Message-Protokoll XIPAYLOAD gewählt und haben Sie als XI-Payload ein Mail-Package-Dokument vorliegen, wählen Sie Mail-Package verwenden.

Liegt die XI-Payload nicht als Mail-Package-Dokument vor, machen Sie Angaben zu Mail-Attributen (Von, An , Betreff).

Zum Format siehe unten unter Beispiel.

●      Angaben zu Mail-Attributen:

○       Geben Sie unter Von die E-Mail-Adresse an, von der die Nachricht kommt.

○       Geben Sie unter An die E-Mail-Adresse an, die die Nachricht erhalten soll. Wenn Sie mehrere Adressen angeben, dann müssen diese durch ein Semikolon getrennt angegeben werden.

○       Wenn Sie unter URL einen IMAP-Server angegeben haben, dann wird die Nachricht im angegebenen Ordner nur abgelegt, nicht aber an den unter An angegebenen Empfänger verschickt.

○       Geben Sie unter Cc die E-Mail-Adressen an, an die die E-Mail ebenfalls gesendet werden soll.

Die Adressen sind für den Empfänger sichtbar.

○       Geben Sie unter Bcc die E-Mail-Adressen an, an die die E-Mail ebenfalls gesendet werden soll.

Die Adressen sind für den Empfänger nicht sichtbar.

○       Geben Sie den Betreff der E-Mail-Nachricht an.

○       Geben Sie an, ob Sie eine Inhaltskodierung des Inhalts der E-Mail vornehmen wollen. Sie haben hierzu folgende Möglichkeiten:

■       Keine

■       Base64 (Vorgabewert)

■       Quoted-Printable

○       Haben Sie Transport-Protokoll XIPAYLOAD gewählt und Sie möchten XI-Attachments in E-Mail-Attachments weiterleiten, dann wählen Sie Anlagen behalten.

Mit dem Modul PayloadSwapBean haben Sie die Möglichkeit, die Anwendungs-Payload mit einem der Attachments zu vertauschen.

Siehe: PayloadSwapBean

Sicherheitsparameter für Message-Protokoll XIPAYLOAD

●      Wollen Sie in der zugehörigen Empfängervereinbarung im Integration Server oder im PCK E-Mails verschlüsseln und digital signieren, wählen Sie S/MIME.

Siehe: Sicherheitseinstellungen für den Mail-Empfänger-Adapter

Das Kennzeichen Anlagen behalten muss hierzu gesetzt sein.

●      Geben Sie die Aufbewahrungszeit an. Diese Angabe wird zurzeit nicht genutzt, soll aber später für die Sicherheitsarchivierung genutzt werden.

Registerkarte Erweitert

Adapterspezifische Message-Attribute

Um Adapterattribute im Message-Header der XI-Message zu verarbeiten, wählen Sie  Adapterspezifische Message-Attribute verwenden und außerdem das Kennzeichen Variable Transportanbindung. Folgende Attribute im Message-Header stehen dann zur Verarbeitung zur Verfügung:

Bedeutung	Technischer Name
Benutzer	TServerLocation
Authentifizierungsschlüssel	TAuthKey
Mail-Header-Feld Von	THeaderFROM
Mail-Header-Feld An	THeaderTO
Mail-Header-Feld Cc	THeaderCC
Mail-Header-Feld Bcc	THeaderBCC
Mail-Header-Feld Betreff	THeaderSUBJECT
Mail-Header-Feld Referenz auf die Mail, auf die geantwortet wird	THeaderIN-REPLY-TO
Mail-Header-Feld Anwort an	THeaderREPLY-TO
Mail-Header-Feld Mail Client-Programm	THeaderX-MAILER
Mail-Header-Feld Empfangsbestätigung senden	THeaderDISPOSITION-NOTIFICATION-TO
Mail-Header-Feld Priorität	THeaderPRIORITY
Mail-Header-Feld Dringlichkeit der Nachricht	THeaderIMPORTANCE

Um Felder zu setzen, die in der Tabelle nicht enthalten sind, wählen Sie Variabler Header. Mit diesen Felder können Sie weitere Header-Informationen weiterleiten.

Die technischen Namen der Felder sind XHeaderName1, XHeaderName2, XHeaderName3. Unter diesen hier eingegebenen Bezeichnungen werden die Parameter in den Mail-Header übernommen.

Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/Mail.

Authentifizierungsschlüssel

Wird für das Empfängersystem eine Authentifizierung verlangt, dann können Sie hier für den jeweiligen Schlüsselwert ein Kennwort mit Bestätigung hinterlegen. Auf diese Weise ist es nicht nötig, Kennwörter in den erweiterten Message-Header zu schreiben.

Wollen Sie den jeweiligen Authentifizierungsschlüssel eingeben oder anzeigen, wählen Sie Berechtigungsschlüssel anzeigen. Sie können zum Wert des Authentifizierungsschlüssels (TAuthKey) ein Kennwort mit Bestätigung eingeben.

Adapterstatus

Setzen Sie den Adapter Aktiv, um ihn für den Message-Austausch einzusetzen.

Erweiterter Modus

Um zusätzliche Parameter für die Adapterkonfiguration anzugeben, wählen Sie Erweiterter Modus.

●      Geben Sie die zusätzlichen Parameternamen und -werte in der Tabelle an.

●      Um zu verhindern, dass der Content-Disposition-Header automatisch erzeugt wird, geben Sie den Parameternamen OMail.AddContentDisposition ein und geben Sie unter Wert falseein.

Ist der Content-Disposition-Header beispielsweise in einem Modul erzeugt worden, hat dieser Parameter keine Wirkung.

Setzen Sie den Parameter nicht, wird der Header vom Adapter erzeugt.

Beispiel

XI-Payload mit Mail-Package:

<?xml version="1.0" encoding="UTF-8"?>

 

<ns:Mail xmlns:ns="http://sap.com/xi/XI/Mail/30">

  <Subject>Subject</Subject>

  <From>namea@company.com</From>

  <To>nameb@company.com</To>

  <Reply_To />

  <Content_Type>text/plain</Content_Type>

  <Content>

Das ist der Inhalt.

  </Content>

</ns:Mail>