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 linkerkolom.
De OAGI Standaard kunt u downloaden van de website: www.oagi.org via de optie Free Downloads in de linkerkolom.
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.
