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 Module 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.
Verbindungsparameter für Mail-Server
Feld |
Eingabe |
URL |
Geben Sie die Adresse des Mail-Server an, z.B. imap://imapserver/XIInBox |
Benutzerauthentifikation konfigurieren |
Wenn eine Authentifizierung des Benutzers verlangt wird, dann setzen Sie das Kennzeichen und 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. |
Poll-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
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.
Sicherheitseinstellungen 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.
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
Geben Sie unter Quality-of-Service an, wie die Message
durch die Integration Engine/durch das PCK verarbeitet werden soll:
¡ Best Effort
¡ Exactly Once
¡ Exactly Once In Order
Asynchrone Verarbeitung über Queues, d.h. eine garantierte einmalige Ausführung unter Beibehaltung der Reihenfolge aufeinander folgender Messages
Geben Sie den Queue-Namen an.
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.
Tabelle
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:
<ml:Mail xmlns:ml=’http://sap.com/xi/XI/Mail/30’>
<Subject>Important</Subject>
<From>namea@company.com</From>
<To>nameb@company.com</To>
<X_Mailer>Outlook Express </X_Mailer>
<Content>
Das ist der Inhalt.
</Content>
</ml:Mail>