Dokumentation zum Projekt Mail-Adapter in SAP PI Sinkwitz, Sven Theel, Thomas

Transkript

1 Dokumentation zum Projekt Mail-Adapter in SAP PI Sinkwitz, Sven Theel, Thomas

2 Inhalt 1. Einleitung Vorgehen Datentyp für die Mail einrichten Message Typen für die Mail einrichten Service Interface ablegen Message-Mapping für die Mail anlegen Funktion zur Verarbeitung des Mailinhaltes Mapping der Attribute Operations-Mapping Kommunikationskanal für den Mailempfang Verbinden der Komponenten mit dem Konfigurationsassistenten Fazit Dokumentation zum Projekt Mail Adapter in SAP Seite 1

3 1. Einleitung Mit dieser Dokumentation kann ein Mail-Sender in SAP PI so konfiguriert werden, dass dieser s von einem POP3-Mail Konto abrufen kann, den Inhalt der Nachricht parsen und die beinhaltete Bestellnummer und Kundennummer in ein XML Dokument auf einem FTP-Server ablegen kann. Der angelegte Mail-Sender in SAP PI ist nur ein Prototyp. Die muss in einem bestimmten Format vorliegen, damit die Mail richtig ausgelesen werden kann. Die Dokumentation setzt das in der Vorlesung gemachte Tutorial voraus, da einige Schritte nicht detailliert beschrieben werden. Dokumentation zum Projekt Mail Adapter in SAP Seite 2

4 2. Vorgehen Starten Sie den Enterprise Service Builder. 1. Datentyp für die Mail einrichten Als erstes wird ein Datentyp für die eingehende Mail angelegt (Neu Interface-Objekte Datentyp). Er hat den Namen MailDatentyp. In der Typdefinition gibt es nur eine Zeile mit dem Namen MailDatentyp, der Kategorie Einfacher Typ und dem Typ xsd:string. Dieses Feld beinhaltet den Text der empfangenen Mails. Nachdem alles eingestellt wird wir der neue Datentyp gespeichert. Dokumentation zum Projekt Mail Adapter in SAP Seite 3

5 2. Message Typen für die Mail einrichten Als nächstes wird der Message-Typ für die Mail angelegt (Neu Interface-Objekte Message-Typ). Er trägt den Namen MailMessage. Als verwendeter Datentyp wird der eben erstelle MailDatentyp verwendet. Das ist die einzige Einstellung die vorgenommen werden muss. Anschließend wird der neue Message-Typ gespeichert. Dokumentation zum Projekt Mail Adapter in SAP Seite 4

6 3. Service Interface ablegen Es muss nun ein Service-Interface angelegt werden (Neu Interface-Objekte Service-Interface). Er hat den Namen MailService. Als Message-Typ wird die eben erstellte MailMessage hinzugefügt. Stimmen die Einstellungen mit dem Screenshot überein, wird das neue Service-Interface abgespeichert. 4. Message-Mapping für die Mail anlegen Damit der Inhalt der Mail verarbeitet und umgewandelt werden kann, wird ein Message-Mapping für die Mail angelegt (Neu Mapping-Objekte Message-Mapping). Es hat den Namen MailToBestellung. Das Ziel dieses Mapping ist, dass aus der MailMessage die Bestell- und Kundennummer gelesen und eine neue Message vom Typ zielbestellung angelegt wird. Dafür wird als Ausgangsmessage der Message-Typ MailMessage und als Zielmessage der Message- Typ zielbestellung ausgewählt. Dokumentation zum Projekt Mail Adapter in SAP Seite 5

7 5. Funktion zur Verarbeitung des Mailinhaltes Damit der Inhalt der Mail verarbeitet wird, legen wir eine Funktion pars an. Dafür links unten auf den Button Neue Funktion anlegen drücken. Dokumentation zum Projekt Mail Adapter in SAP Seite 6

8 Als Name und Titel wird pars eingegeben und als Ausführungsart Alle Werte eines Kontexts ausgewählt. Außerdem benötigt die Funktion noch zwei Argumente: MailText Der Inhalt der Mail, der verarbeitet wird. feld Gibt an, welcher Wert (Kundennummern, Bestellnummer, usw.) von der Funktion geliefert werden soll. Anschließend wird auf den Button Funktion anlegen gedrückt, worauf ein neues Fenster geöffnet wird. In diesem Fenster wird folgender Quellcode für die Funktion eingegeben. if (feld[0].equals("id")) { result.addvalue(mailtext[0].substring(15, 19)); } else if (feld[0].equals("custid")) { result.addvalue(mailtext[0].substring(33,39)); } Anschließend schließen Sie das Fenster, womit das Erstellen der Funktion abgeschlossen ist. 6. Mapping der Attribute Damit die aus der Funktion pars ermittelten Werte auch in die richtigen Attribute überführt werden, wird an dieser Stelle das Mapping vorgenommen. Als erstes werden alle Felder bis auf id und valuta deaktiviert, da nur diese beiden Felder gefüllt werden. Feld id: Feld valuta: Das Feld id wird mit der Bestellnummer gefüllt und das Feld valuta mit der Kundennummer. Das ließe sich noch weiter fortführen, soll aber an dieser Stelle reichen. Das Mapping wird nun gespeichert. Dokumentation zum Projekt Mail Adapter in SAP Seite 7

9 7. Operations-Mapping Damit die eben erstellte Funktionalität im Projekt für die Bestellung genutzt werden kann, wird eine Operations-Mapping angelegt. Dieses verbindet das Verarbeiten der Mail mit dem Ablegen der Bestellung auf dem FTP-Server(Neu Mapping-Objekte Operations-Mapping). Das neue Mapping bekommt den Namen MailToBestellung. Als Ausgangs-Operation wird MailService und als Ziel-Operation interface_zielbestellung ausgewählt. Das Message-Mapping ist MailToBestellung. Durch das Klicken auf den Button Leseoperationen erscheinen links als Ausgangs-Message MailMessage und rechts als Ziel-Message zielbestellung. Ist alles korrekt, wird das neue Operations-Mapping abgespeichert. Um weiter zu arbeiten, werden alle Änderungen aktiviert. 8. Kommunikationskanal für den Mailempfang Um den Kommunikationskanal für den Mailempfang zu erstellen, wird der Integration Builder gestartet. Als erster wird eine Business Komponente benötigt (Neu Business-Komponente). Dokumentation zum Projekt Mail Adapter in SAP Seite 8

10 In der Karteikarte Sender wird den Outbound-Interfaces der MailService hinzugefügt. Um einen neuen Kommunikationskanal anzulegen, wird unten links auf den Button Objekt anlegen geklickt. Der Name des Kommunikationskanals ist MailKanal. Folgende Einstellungen müssen vorgenommen werden: Adaptertyp Mail Damit wird der Kommunikationskanal auf Mail gestellt. Sender Das bedeutet bei SAP, dass der Kommunikationskanal s empfangen soll. Bei der Einstellung Empfänger wäre er in der Lage s zu verschicken. Dokumentation zum Projekt Mail Adapter in SAP Seite 9

11 Transportprotokoll POP3 An dieser Stelle wird festgelegt mit welchem Protokoll die s abgerufen werden sollen. Messageprotokoll XIPAYLOAD In diesem Modus wird der Inhalt der in die Payload der XI-Message eingestellt. Wählt man XIALL, stimmt der Inhalt der mit dem Inhalt der XI-Message überein. Adapter-Engine Zentrale Adapter Engine Verbindungsparameter für den Mailserver An dieser Stelle wird konfiguriert, von welchem Server die Mails abgerufen werden sollen. Wichtig ist, dass bei der URL das Protokoll (z.b. pop://) mit angegeben werden muss. Zum Testen kann man den HTW-Mail Server nehmen: pop://mail.rz.htw-berlin.de/inbox Mail-Attribute Hier kann eingestellt werden, ob der Header und die Anhänge der Mail ebenfalls weiterverarbeitet werden sollen. Für dieses Beispiel ist dies nicht erforderlich. Die übrigen Einstellungen können beibehalten werden. Genauere Information findet man unter htm. Nach der Konfiguration wird der Kommunikationskanal gespeichert. Dokumentation zum Projekt Mail Adapter in SAP Seite 10

12 9. Verbinden der Komponenten mit dem Konfigurationsassistenten Über Werkzeuge Konfigurationsassistent wird der Assistent gestartet. Mit dessen Hilfe werden der Mailempfang, die Verarbeitung des Mailinhaltes und die Erzeugung der Bestellung auf dem FTP- Server miteinander verbunden. Schritt 1: Interne Kommunikation wird ausgewählt. Schritt 2: Es wird die erstellte Businesskomponente TR_MAIL, das Interface MailService und der Adaptertyp Mail ausgewählt. Dokumentation zum Projekt Mail Adapter in SAP Seite 11

13 Dokumentation zum Projekt Mail Adapter in SAP Seite 12

14 Schritt 3: An dieser Stelle werden die Einstellungen für das Projekt Bestellungen vorgenommen. Es wird das Interface verwendet, dass wir im Operations-Mapping für MailToBestellung verwendet haben. Dokumentation zum Projekt Mail Adapter in SAP Seite 13

15 Schritt 4: Klicken sie solange auf weiter, bis Sie das Szenario auswählen können. Anschließend werden alle benötigten Objekte generiert. Nachdem die Änderungen aktiviert wurden, läuft der Mailadapter und verarbeitet alle eingehenden Mails. Dokumentation zum Projekt Mail Adapter in SAP Seite 14

16 3. Fazit Der angelegte Mail-Sender sollte nun die von dem angelegten Konto abrufen. Der Inhalt der wird ausgelesen und in ein XML-Dokument umgewandelt und auf dem FTP-Server hinterlegt. Da dieser Mail-Sender prototypisch ist, können noch weitere Schritte verbessert werden. Der Inhalt muss in einem bestimmten Format vorliegen. Die muss einerseits als XML Dokument verschickt werden und andererseits muss die Bestellnummer und Kundennummer in richtiger Reihenfolge geschrieben werden. Diese Eigenschaft könnte mit einem besseren MailParser umgangen werden. Die funktionierende , die zu dieser Dokumentation verwendet wurde, sollte folgender Maßen aussehen: <?xml version="1.0" encoding="utf-8"?> <ns0:mailmessage xmlns:ns0=" Bestellnummer: 1001Kundennummer: </ns0:mailmessage> Wurde die erkannt, wird ein XML-Dokument auf dem FTP-Server abgelegt. Als Alternativ- Szenario könnte die ausgelesene Bestellnummer und Kundennummer direkt in SAP integriert werden. Diese Dokumentation bietet einen Einstieg in die Thematik des SAP PI Mail-Senders und lässt weitere Forschungsarbeit zur vollständigen Integration in das SAP-System offen. Dokumentation zum Projekt Mail Adapter in SAP Seite 15