Transformatie van een UBL Invoice naar een OAGI Invoice met ChainBuilder ESB IDE

In mijn vorige bloart over de Installatie van de Bostech ChainBuilder ESB heb ik u een algemene introductie gegeven in de ChainBuilder Enterprise Service Bus van Bostech en de Java Business Integration (JBI) specificatie.

Hierna ga ik met behulp van de de Map Editor van ChainBuilder ESB een Message (Transformatie) Map ontwikkelen waarmee een UBL Invoice ingelezen en getransformeerd kan worden naar een OAGI Invoice. Voor de transformatie ga ik uit van de laatste versies (UBL 2.0 en OAGI 9.1) van beide standaarden omdat deze beter aansluiten bij de UN/CEFACT Core Components Specification.

De UBL Standaard kunt u downloaden van de website: www.oasis-open.org via de optie OASIS Standards in de linker kolom.

De OAGI Standaard kunt u downloaden van de website: www.oagi.org via de optie Free Downloads in de linker kolom.

De Map Editor maakt het de gebruiker mogelijk om de relaties tussen gegevenselementen uit twee modellen (input en output) alsook een aantal transformatieregels vast te leggen.

De volgende stappen moeten doorlopen worden:
- Stap 1: Creatie ESB project
- Stap 2: Creatie JBI Service Assembly project voor de UBL to OAGI Invoice
- Stap 3: Kopieer de XSD bestanden van de UBL Invoice en de OAGI Invoice naar de folder src/formats
- Stap 4: Creatie van de Message Map
- Stap 5: Bouwen van een Component Flow Definition

Stap 1: Creatie ESB project
- Klik met uw rechtermuisknop in de Package Explorer en selecteer de menuoptie New > Other.

- Open de node ChainBuilder ESB-IDE en ChainBuilder ESB Project

- Selecteer de optie New ChainBuilder ESB Project en klik op de knop Next

- Geef uw project de naam ESB en klik op de knop Next om verder te gaan

- Klik op de knop Finish

Stap 2: Creatie JBI Service Assembly project voor de UBL to OAGI Invoice
- Klik met uw rechtermuisknop in de Package Explorer en selecteer de menuoptie New > Other.

- Open de node ChainBuilder ESB-IDE en ChainBuilder ESB Project

- Selecteer de optie New JBI Service Assembly Project en klik op de knop Next

- Geef uw project de naam UBLtoOAGIInvoice en klik op de knop Next

- Klik op de knop Next en vink in het dialoogscherm Setup Reference Relationship with Other project uw ESB Project aan

- Klik op de knop Finish

- Beantwoord de vraag voor het openen van de Component Flow Editor Perspective met Yes.

Stap 3: Kopieer de XSD bestanden van de UBL Invoice en OAGI Invoice naar de folder src/formats

- Kopieer het bestand UBL-Invoice-2.o.xsd naar de directory
\cbesb-1.2\ideworkspace\UBLtoOAGIInvoice\src\formats\.

- Kopieer de folders common en maindocs die u kunt terugvinden in de UBL specificatie onder de folder \os-UBL-2.0\xsd\ naar de directory \ideworkspace\UBLtoOAGIInvoice\src\

- Kopieer het bestand Invoice.xsd (OAGI) die u kunt terugvinden in de OAGI specificatie onder de folder \oagis\9_1\Resources\Nouns\ naar de directory \cbesb-1.2\ideworkspace\UBLtoOAGIInvoice\src\formats\.

- Kopieer de folder components die u kunt terugvinden in de OAGI specificatie onder de folder \oagis\9_1\Resources\ naar de directory \ideworkspace\UBLtoOAGIInvoice\src\

Nadat u deze stappen hebt doorlopen ziet de structuur van uw JBI Service Assembly project UBLtoOAGIInvoice er als volgt uit:

Stap 4: Creatie van de Message Map
Met de Map Editor gaat u nu een Message Map aanmaken onder de uw UBLtoOAGIInvoice JBI SA project.

- Klik met uw rechtermuisknop op de folder src/xlate en selecteer de menuoptie New > Map File

- Geef uw Map File de naam UBLtoOAGIInvoiceMap en klik op de knop Next

- In het dialoogscherm Choose Formats klik achtereenvolgens op de knop Browse achter de velden voor de source definition file en de target definition file.

- Selecteer de source definition file (UBL-Invoice-2.o.xsd) en daarna de target definition file (Invoice.xsd).

Zorg ervoor dat u beide definitiebestanden hebt geselecteerd:

- Klik op de knop Next om verder te gaan naar het volgende dialoogscherm waar u de Root nodes van de definities bestanden moet selecteren.

- Selecteer nu de Root nodes: voor beide message definities is dat Invoice.

- Klik op de knop Finish voor het afsluiten van de wizard

De Map Editor Perspective wordt nu geopend met aan de linkerkant het lege tabblad OperationProperties en in het midden het midden de Source en Target structuren.

Aan de rechterkant vindt u de kolom met de verschillende toepasbare operatie types.

Aan de linkerkant ziet u de tab Operation Properties naast de tab Package Explorer.

Nu komt het moeilijkste deel het opstellen van de transformatieregels. Blijf deze bloart volgen, binnenkort ga ik hier verder op in.

Tags: electronic data interchange, eclipse, data mapping tool, UBL

Last update: 26-11-2011

Continue!

HR-XML schema's doorgronden met hyperModel en Eclipse WTP

De HR-XML Consortium heeft een bibliotheek samengesteld bestaande uit +100 XML Schema's. Deze XML Schema's ondersteunen de voornaamste Human Resource Management processen en transacties.

De volledige bibliotheek kunt u downloaden van de website: www.HR-XML.org via het menu DOWNLOADS. Selecteer de laatst beschikbare stabiele versie die beschikbaar wordt gesteld op de Download-webpagina (momenteel versie 2.5). Als u een eerdere versie wilt downloaden klik op de link comprehensive index. Voor de versie 2.3 klik met uw rechtermuisknop op het jaar 2004 August en download het bestand ALLHRXML200408.zip. Pak daarna het zip-bestand uit naar een folder van uw keuze.

De download bevat eveneens de HR-XML Staffing Industry Data Exchange Standards (SIDES) XML Schema Definities. Wanneer u de HR-XML SIDES standaard gaat gebruiken voor het uitwisselen van informatie dan dient u zich te conformeren aan de gebruiksconventies teneinde de interoperabiliteit van de standaard te waarborgen. De structuur en de relevante velden van de HR-XML berichten zijn vastgelegd in XML Schema's die u kunt terugvinden in het zip-bestand.

Het XML Schema voor de TimeCard (uren- of werkbriefje) ga ik meer in detail bestuderen met hyperModel. Verder zal ik met behulp van de Eclipse webtools (Eclipse WTP Project) een XML-bestand aanmaken uitgaande van de XML Schema Definitie van de TimeCardAddionalData XML Schema.

Installeer eerst hyperModel volgens de instructies in mijn bloart Installeer hyperModel, het analyse- en ontwikkelgereedschap voor UML en XML.

Of ga naar de website van hyperModel en download het zip-bestand met de volledige Eclipse-omgeving en hyperModel plugin's.

Importeren van de HR-XML XML Schema's in hyperModel
Volg de onderstaande instructies:

- Start Eclipse hyperModel op.

- Open het perspectief hyperModel via het menu Window > Open Perspective > Other > hyperModel<?p>

- Maak eerst een nieuw project aan.
Klik daarvoor met uw rechtermuisknop in de Project Explorer en selecteer de menuoptie New > Project.
Open de node General en selecteer de optie Project.

Klik op de knop Next en geef uw project de naam HR-XML

Klik op de knop Finish om het project aan te maken.

- Importeer de XML Schema's
Ga naar het menu File en selecteer de menuoptie Import XML Schema's

In het dialoogscherm Import XML Schemas klik op de knop Add Folder en ga naar de folder waarin u het zip-bestand hebt uitgepakt.

Selecteer de folder SIDES (\HR-XML-2004-08\HR-XML-2_3\SIDES\) en klik op de knop OK. De folder wordt toegevoegd aan de lijst met XML Schema Files.

In het veld Root package selecteer de waarde SIDES.

Klik op de knop Next en geef daarna uw UML Model de naam SIDES.uml

Klik op de knop Finish om de XML Schema's te importeren.

In de Project Explorer ziet u volgende boomstructuur verschijnen.

Ga naar het menu File en selecteer de menuoptie Save All voor het opslaan van het aangemaakte UML Model.

Genereer het Class Diagram voor het TimeCard bericht
De TimeCard is het bericht waarmee de door een medewerker gemaakte uren worden gerapporteerd aan de uitlener maar eveneens kunnen de gemaakte uitgaven en/of onkosten in het bericht worden opgenomen.

In UML Table Editor open de node SIDES en ga naar de node TimeCardAdditionalData.

Klik met uw rechtermuisknop op de node TimeCardAdditionalData en selecteer de menuoptie Open With > Class Dynagram voor het genereren van een UML Class Dynagram van de TimeCard.

Klik met uw rechtermuisknop op de node TimeCard en selecteer de menuoptie Add Diagram > Class Diagram voor het genereren van een UML Class Diagram van de TimeCard.

Selecteer de folder waarin het diagrambestand moet worden aangemaakt en geef het bestand de naam SIDES.TimeCard.umlclass_diagram.

Klik op de knop Finish voor het aanmaken van de Class Diagram.

Genereer een XML bestand gebaseerd op de XML Schema Definitie van de TimeCard.
- Maak het project XML-Files aan onder de Package Explorer

- Klik met uw rechtermuisknop op het project en selecteer de menuoptie New > Other

- Open de node XML, selecteer de optie XML en klik op de knop Next

- Vink de optie Create XML file from an XML schema file aan en klik op de knop Next

- Geef uw XML-bestand een naam (hr-xmlTimeCardFile.xml), selecteer de parent folder en klik op de knop Next

- Vink de optie Select file from workbench aan en selecteer het XML Schema uit de bestanden aanwezig in de workbench. (XML -Standards\HR-XML-2004-08\HR-XML-2_3\SIDES\TimeCardAdditionalData.xsd)

- Klik op de knop Next en

- Vink in het dialoogscherm Select Root Element alle opties aan en klik op de knop Finish

Het XML-bestand hr-xmlTimeCardFile.xml wordt aangemaakt en geopend.

Tags van Technorati: eclipse

Last update: 26-11-2011

Continue!