MS-Office documenten integratie via SAP PI

Transcriptie

1 MS-Office documenten integratie via SAP PI Met behulp van het SAP Process Integration systeem (SAP PI) kun je op vele manieren je integratie regelen tussen je SAP systemen en/of andere systemen. Ook met MS-Office documenten is deze integratie vorm te geven. MS-Office documenten kunnen al in de adapter worden ontleed naar verschillende XML-documenten. Helaas zijn dit dan allemaal losse attachments in de payload voor SAP PI. Onderstaand volgt de beschrijving van een manier om deze attachments tot één payload te maken voor verder verwerking in SAP PI. In een vorige Tips & Tricks is al aandacht besteed aan MS-Office documenten. Deze keer gaan wij hierop verder, maar dan via SAP PI. Zoals bekend zijn XLSx, DOCx en/of PPTx allemaal XML documenten verpakt in één ZIP-bestand. Via de standaard SAP PI file adapter kan een MS-Office document worden uitgepakt. Bij het uitpakken van, bijvoorbeeld een Excel bestand, zijn de XML s bestanden als attachtment bij de payload van het bericht gestopt. Deze Tips & Tricks gaat alleen over het converteren van alle XML berichten naar één XML bericht voor de payload. Hierdoor heb je alle gegevens beschikbaar voor een volgende mapping naar IDoc of een andere formaat bericht. Daarom is deze ABAP class mapping gemaakt, zodat elke XML document aanwezig in het MS-Office document in één XML wordt samengevoegd. SAP PI file adapter In de file adapter kan d.m.v. het tabje MODULE een extra functie worden uitgevoerd voor het unzippen van je MS-Office bestand.

2 Onderstaand een voorbeeld zoals de payload wordt weergegeven in de monitoring van SAP PI, hierbij zie je duidelijk de groot aantal XML en andere soorten attachtments. Na de mapping zijn de attachments nog steeds aanwezig, maar de main payload bevat nu één groot XML bericht. ABAP-class mapping Bij het maken van deze ABAP-class mapping is het wel belangrijk om de interface IF_MAPPING toe te voegen. Dit zorgt ervoor dat de methode IF_MAPPING-EXECUTE standaard zichtbaar is. Hierin kunnen wij vervolgens gaan programmeren. Indien je verschillende versies van SAP-PI omgevingen beschikbaar hebt, dan valt gelijk een belangrijk verschil op tussen een SAP PI 7.0 en 7.4. In de laatste SAP-PI versie is standaard al meer informatie tot je beschikbaar, zoals alle attachtments. In dit voorbeeld gaan wij uit van de iets oudere SAP-PI 7.0 versie, zodat je ook ziet hoe je attachtments op een andere manier kunt ophalen in je programmatuur.

3 De eerste methode komt van de interface IF_MAPPING, alle andere methodes worden in deze ABAP-class gemaakt. Methode IF_MAPPING-EXECUTE Hierbij de globale stappen welke wij gaan doen in deze hoofd methode. 1) De message ID opvragen, 2) De hele message/bericht ophalen o.b.v. van message ID, Indien het niet lukt om het bericht op te vragen dan gaan wij gelijk uit de hoofd methode. Voor de netheid wordt wel het oorspronkelijke source bericht teruggeven aan het result. 3) Alle attachtments ophalen van het bericht, 4) Het samenvoegen van alle attachtments (XML berichten) tot één XML, 5) Als laatste het converteren van string naar Xstring, zodat het result klaar is voor bijvoorbeeld een volgende mapping. Dit laatste zit niet in deze Tips & Tricks. 6) Indien result leeg is, dan alsnog oorspronkelijke source bericht mee teruggeven.

4 1) Message ID Via de import referentie parameter PARAM kan makkelijk de message ID opgevraagd worden via de beschikbaar methode van referentie object. 2) Message bericht In de ABAP-class kan je een nieuwe methode maken. In ons voorbeeld is dit READ_PERSIST_MESSAGE. Via de message ID wordt het hele bericht opgehaald. 3) Ophalen van attachtments Dit is niet zo moeilijk aangezien het lokale data object LR_MESSAGE van het type interface IF_XMS_MESSAGE is. Deze interface heeft een standaard methode beschikbaar voor het ophalen van de attachments. 4) Samenvoegen van attachtments Dit is weer een eigen gemaakte methode in de ABAP-class. Aangezien binnenkomende parameter IR_PAYLOADS in deze methode niet van het type interne tabel is, gaan wij deze eerst als zodanig maken d.m.v. een field-symbol <payloads>. Hierdoor kan over de attachtments geloopt worden. Per payload wordt gecontroleerd of dit wel een XML bericht is, zo niet dat gelijk naar de volgende attachment. Het soort XML wordt bepaald, in ons voorbeeld gaan wij alleen maar de Binary XML behandelen. Het ophalen van de Xstring is mogelijk door een standaard methode aan te roepen van dit referentie object. Gelijk gaan wij deze Xstring converteren naar normale string zodat de content aangepast kan worden.

5 Voor het maken van de nieuwe XML bericht is een apart methode gemaakt in onze ABAP-class mapping, namelijk CREATE_XML_DOCUMENT. Elk attachtment wordt hieraan toegevoegd. Aan het einde moet ook de einde van de root node gemaakt worden.

6 5) Methode CONVERT_STRING_TO_XSTRING Deze methode in de ABAP-class kan het string object terug geconverteerd worden naar een Xstring versie. Methode CONVERT_XSTRING_TO_STRING Via deze gemaakt methode in onze ABAP-class krijgen wij een string terug van een Xstring. Methode CREATE_XML_DOCUMENT Als eerste wordt de echte XML content bepaald. De standaard proloog van een XML wordt verwijderd, aangezien dit maar één keer mag voorkomen in onze nieuw te maken XML. Op basis van de type van het XML bericht wordt de naam bepaald voor deze XML node. Indien de nieuwe XML nog leeg is wordt een proloog toegevoegd, hierna de nieuwe root node plus XML node en XML content. Alles keurig beginnen en eindigen met de juiste begin en sluit tekens. Elke attachtment wordt zodoende samengevoegd tot één XML bericht.

7 Methode GET_XML_CONTENT Van de XML halen wij de proloog er af. De rest van de XML is de echte XML content wat wij willen hebben. Methode DETERMINE_FILE_FROM_TYPE Het type bestaat bijvoorbeeld uit application/xml;name="[content_types].xml" of application/xml;name="xl/worksheets/sheet1.xml". Voor ons is alleen Content_Types of sheet1 van belang. Met onderstaande logica wordt er voorgezorgd dat wij alleen de naam overhouden welke wordt gebruikt voor de naam van de sub node.

8 Methode GET_XML_PROLOG De originele proloog wordt door gegeven zodat het kan worden toegevoegd. Tot slotte Deze oplossing oogt complex en lastig, maar het zorgt er voor dat alles in één XML bericht beschikbaar. Wat zeer handig is voor maatwerkoplossingen op integratie gebied. Een eventuele volgende mapping heeft nu alle informatie beschikbaar van het oorspronkelijke excel document. In bijvoorbeeld een (ABAP) XSLT mapping of zelfs een message mapping kan je dit XML document weer converteren naar een IDoc, proxy, etc. voor verder verwerking in SAP. Deze tip is aangeleverd door Siebren Kramer. Wilt u meer informatie, dan kan dat via siebren.kramer@nl4b.com