Konfiguration des
Mail-Sender-Adapters
Verwendung
Sie konfigurieren den Mail-Sender-Adapter, um damit E-Mails in XI-Messages 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 Sender als Sender-Adapter definiert.
Aktivitäten
Zur Konfiguration des Adapters machen Sie folgende Angaben:
Transport-Protokoll
● Mit IMAP4 (Internet Message Access Protocol) können Sie E-Mails aus einen Order eines E-Mail-Servers abholen.
● Über POP3 (Post Office Protocol Version 3) werden E-Mails von einem E-Mail-Server abgeholt.
Message-Protokoll
● XIALL
In diesem Modus stimmt der Inhalt der RFC822 E-Mail mit dem Inhalt der XI-Message überein. Die XI-Message ist eine Multipart-MIME-Message, deren erster Teil der SOAP-Umschlag ist. Siehe auch: Messages , dort unter XI-Message-Protokoll.
● XIPAYLOAD
In diesem Modus wird der Inhalt der E-Mail in die Payload der XI-Message eingestellt. Wird das Kennzeichen Mail-Package verwenden nicht gesetzt, dann gehen die Informationen über Sender (Von) , Empfänger (An) und den Betreff der E-Mail verloren
Adapter-Engine
Wählen sie die Adapter-Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter-Engine aus. Im PCK ist diese Auswahl nicht möglich.
Registerkarte Allgemein
Verbindungsparameter für Mail-Server
Feld |
Eingabe |
URL |
Geben Sie die Adresse des Mail-Server an, z.B. imap://imapserver/XIInBox |
Benutzerauthentifizierung konfigurieren |
Wenn eine Authentifizierung des Benutzers verlangt wird, dann setzen Sie das Kennzeichen und wählen Sie aus: ● Einfach ● CRAM-MD5 Machen Sie folgende Angaben: ● Geben Sie den Benutzer an, mit dem Sie Zugriff auf den Server erhalten können. ● Geben Sie das Kennwort mit Bestätigung an. |
Poll-Intervall (Min.) |
Zeitintervall, nach dessen Ablauf E-Mails auf dem Server abgerufen werden. |
Gelesene Messages löschen |
Wenn Sie IMAP4 als Transport-Protokoll gewählt haben, dann können Sie hier angeben, ob Sie die Messages nach dem Lesen auf dem E-Mail-Server löschen möchten. Sie können dann einen Ordner für gelöschte Messages auf dem Server angeben. |
Hol-Bericht erzeugen |
Wenn Sie für jeden Poll-Vorgang des Adapters einen Bericht erzeugen wollen, dann setzen Sie das Kennzeichen. Es wird eine XI-Message mit folgenden Informationen erzeugt: ● Interface-Namensraum: http://sap.com/xi/XI/Mail/30 ● Interface-Name: FetchReport |
Mail-Attribute für Message-Protokoll XIPAYLOAD
Falls Sie unter Message-Protokoll XIPAYLOAD ausgewählt haben, dann machen Sie unter Mail-Attribute zusätzlich die folgenden Angaben:
● Wenn Sie die komplette E-Mail-Nachricht mit den Header-Informationen (Von, An, Betreff) in die Payload einstellen möchten, dann setzen Sie das Kennzeichen Mail-Package verwenden. Beispiel siehe unten. Die Header-Informationen werden in ein XML Mail-Package-Format übernommen.
● Geben Sie an, ob Sie eine Inhaltskodierung des E-Mail-Inhalts vornehmen wollen. Sie haben dazu folgende Möglichkeiten:
○ Keine
○ base64
● Wenn E-Mail-Attachments in XI-Attachments weitergeleitet werden sollen, dann setzen Sie das Kennzeichen Anlagen behalten.
Mit dem Modul PayloadSwapBean haben Sie die Möglichkeit, die Anwendungs-Payload durch eines der Attachments zu ersetzen.
Sicherheitsparameter für Message-Protokoll XIPAYLOAD
● Wenn Sie in der zugehörigen Sendervereinbarung im Integration Server oder im PCK verschlüsselte und digital signierte E-Mails entschlüsseln und validieren wollen, dann setzen Sie das Kennzeichen S/MIME. Siehe auch :Sicherheitseinstellungen für Mail-Sender-Adapter
Hierzu muss das Kennzeichen Anlagen behalten gesetzt sein.
Geben Sie außerdem im Erweiterten Modus in der Tabelle folgende Parameter und Werte ein:
XI.ReceiverParty
XI.ReceiverService
Die hier angegebenen Werte müssen mit den Werten für Empfänger-Partner und Empfänger-Service in der zugehörigen Sendervereinbarung übereinstimmen.
● Geben Sie die Aufbewahrungszeit an. Diese Angabe wird zurzeit nicht genutzt, soll aber später für die Sicherheitsarchivierung genutzt werden.
Weitere Parameter für Message-Protokoll XIPAYLOAD
● XI-Parameter
Geben Sie den Interface-Namensraum und den Interface-Namen an.
● Verarbeitungsparameter
Wählen Sie den Quality-of-Service.
Für Exactly Once in Order geben Sie den Queue-Namen an.
Siehe: Quality-of-Service
Registerkarte Erweitert
Adapterspezifische Message-Attribute
Um Adapterattribute im Message-Header der XI-Message abzulegen, setzen Sie das Kennzeichen Adapterspezifische Message-Attribute setzen.
Folgende Attribute werden, falls der Sender sie zur Verfügung stellen kann, in den XI-Message-Header übernommen, wenn Sie das Kennzeichen Variable Transportanbindung setzen:
Bedeutung |
Technischer Name |
Benutzer des Mail-Kontos |
SUser |
Mail-Header-Feld Von |
SHeaderFROM |
Mail-Header-Feld An |
SHeaderTO |
Mail-Header-Feld Cc |
SHeaderCC |
Mail-Header-Feld Betreff |
SHeaderSUBJECT |
Mail-Header-Feld Referenz auf Mail, auf die diese Mail antwortet |
SHeaderIN-REPLY-TO |
Mail-Header-Feld |
SHeader-REPLY-TO |
Mail-Header-Feld Mail-Client-Programm |
SHeaderX-MAILER |
Mail-Header-Feld Empfangsbestätigung senden |
SHeaderDISPOSITION-NOTIFICATION-TO |
Mail-Header-Feld Priorität |
SHeaderPRIORITY |
Mail-Header-Feld Dringlichkeit der Nachricht |
SHeaderIMPORTANCE |
Um weitere Header-Felder zu übernehmen, setzen sie das jeweilige Kennzeichen. Sie können dann folgende Attribute und deren Werte in den XI-Message-Header ablegen:
Bedeutung |
Technischer Name |
Variabler Header |
XHeaderName1 |
Variabler Header |
XHeaderName2 |
Variabler Header |
XHeaderName3 |
Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/Mail.
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, setzen Sie das Kennzeichen Erweiterter Modus.
● Geben Sie die zusätzlichen Parameternamen und -werte in der Tabelle an:
○ Für die Sicherheitseinstellungen geben Sie hier Werte für den Empfänger-Partner und Empfänger-Service an.
○ Setzen Sie in der Tabelle den Parameter IMail.AssumeXMLContent = true. Dadurch wird der Text der Message als XML interpretiert und unverändert in das Mail-Package übernommen. Wird der Parameter nicht gesetzt, dann wird die Information aus dem Content-Type des MIME-Headers übernommen. Falls dort der Typ application/xml oder text/xml ist, dann wird der Text der Message als XML übernommen, sonst als Text.
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>