Mapping anlegen, einfügen und konfigurieren

In diesem Schritt legen Sie ein sogenanntes Mapping bzw. XSL Stylesheet an und fügen es in Ihren Technical Process ein, um die mithilfe der Variable zwischengespeicherten Daten weiter zu verarbeiten. Das angelegte Mapping soll das originale Rechnungsformat in das benötigte XML-Format umwandeln.

Nachdem Sie das Mapping in Form eines XSL Stylesheets angelegt und eingefügt haben, können Sie mit der Konfiguration des Mappings beginnen. Dabei sollen nur die Informationen aus den Rechnungsdokumenten ausgelesen werden, die für die Prüfung und Weiterleitung erforderlich sind: die Rechnungsnummer, die Rechnungssumme, den Rechnungssender und das Datum der Rechnung.

Dazu müssen Sie zunächst die Beispieldatei SampleInvoice.xml, die Sie in Vorbereitung des Beispielprozesses bereits angelegt haben, als Ressource in das System importieren. Weitere Informationen zum Anlegen der Beispieldatei finden Sie unter Beispiel: ESB Project.

Außerdem empfehlen wir, dass Sie ihren Technical Process mit Beschreibungen versehen, die die einzelnen Prozessschritte erläutern. So bleiben die einzelnen Prozessschritte transparent und können auch von beispielweise neue Kollegen schnell nachvollzogen werden.

Beispieldatei als Ressource importieren

1. Rechtsklicken Sie auf den Ordner Resources in der Projektstruktur.

2. Klicken Sie auf Import….
   Das Dialogfenster Resource Import Wizard wird geöffnet.

3. Klicken Sie auf Browse… und wählen Sie die Datei SampleInvoice.xml auf Ihrem Rechner.
   ✅ Die importierte Datei wird im Ordner Resources in der Sicht Projects angezeigt.

Mapping anlegen

1. Rechtsklicken Sie auf den Technical ProcessImportInvoices in der Sicht Projects und wählen Sie New > XSL Stylesheet….
   Das Dialogfenster File Creation Wizard wird geöffnet.

2. Bei Bedarf können Sie den Namen des Stylesheets im Feld File name anpassen.

3. Klicken Sie auf Finish.
   ✅ Das Stylesheet wird im ESB Project angelegt und öffnet sich automatisch im Editor. Die weitere Konfiguration des eingefügten Stylesheets erfolgt im nächsten Schritt.

4. Wechseln Sie zurück zum Technical Process ImportInvoices.wrf.

Mapping einfügen

1. Ziehen Sie das Element Mapping von der Sicht Palette neben das Element Put INPUT in den Editor.

2. Klicken Sie auf das Element.

3. Tragen Sie einen Namen in das Feld Label in der Sicht Properties ein, z. B. Stylesheet: ExtractCaseFeatures.

4. Klicken Sie auf die Schaltfläche im Feld Document in der Sicht Properties.
   Das Dialogfenster Choose Transform Input wird geöffnet.

5. Wählen Sie die zuvor angelegte .xsl-Datei stylesheet.xsl.

6. Klicken Sie auf OK.

7. Deaktivieren Sie die Checkbox Empty Input in der Sicht Properties.

Wenn diese Option aktiv ist, werden im Mapping nicht die Daten aus dem vorherigen Prozessschritt verwendet.

8. Aktivieren Sie die Checkbox Remove X4 Processing Instructions in der Sicht Properties.

Wenn diese Option aktiv ist, werden alle X4 Processing Instructions aus dem Ergebnis gelöscht.

9. Klicken Sie auf die rechte untere Ecke des Elements Put INPUT, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element Stylesheet: ExtractCaseFeatures.

   

Mapping konfigurieren

1. Doppelklicken Sie auf das Element Stylesheet: ExtractCaseFeatures im Technical Process ImportInvoices.wrf.
   Die verknüpfte Datei stylesheet.xsl öffnet sich im Editor.

2. Ziehen Sie die importierte Datei samleInvoice.xml von der Sicht Projects in den linken Bereich der Datei stylesheet.xsl.
   ✅ Die XML-Struktur der Datei wird im linken Bereich der Datei stylesheet.xsl angezeigt.

3. Rechtsklicken Sie auf den Eintrag template match="/" im rechten Bereich der Datei stylesheet.xsl und wählen Sie Element.

4. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie einen Namen für das Element fest, z. B. Features.

5. Rechtsklicken Sie auf das Element Features im rechten Bereich und wählen Sie Element.

6. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Elements fest: InvoiceNumber.

7. Rechtsklicken Sie auf das Element InvoiceNumberim rechten Bereich und wählen Sie Attribute.

8. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Attributs fest: type.

9. Tragen Sie den Wert String in das Feld Value ein.

10. Rechtsklicken Sie auf das Element Features im rechten Bereich und wählen Sie Element.

11. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Elements fest: InvoiceAmount.

12. Rechtsklicken Sie auf das Element InvoiceNumberim rechten Bereich und wählen Sie Attribute.

13. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Attributs fest: type.

14. Tragen Sie den Wert Decimal in das Feld Value ein.

15. Rechtsklicken Sie auf das Element Features im rechten Bereich und wählen Sie Element.

16. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Elements fest: InvoiceSender.

17. Rechtsklicken Sie auf das Element InvoiceNumberim rechten Bereich und wählen Sie Attribute.

18. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Attributs fest: type.

19. Tragen Sie den Wert String in das Feld Value ein.

20. Rechtsklicken Sie auf das Element Features im rechten Bereich und wählen Sie Element.

21. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Elements fest: InvoiceDate.

22. Rechtsklicken Sie auf das Element InvoiceNumberim rechten Bereich und wählen Sie Attribute.

23. Wählen Sie As Child in der Location Dropdown-Liste und legen Sie den Namen des Attributs fest: type.

24. Tragen Sie den Wert DateTimein das Feld Value ein.

    

25. Klicken Sie auf ein Element in der XML-Struktur im linken Bereich, halten Sie die Maustaste gedrückt und ziehen Sie das Element auf das Element auf der Rechten Seite, zu dem Sie das Element mappen möchten, z. B. InvoiceNumber (links) wird auf InvoiceNumber (rechts) gedroppt.
    ✅ Eine grüne Verbindungslinie zeigt das Mapping grafisch an.

26. Wiederholen Sie den Schritt bis alle notwendigen Felder auf der linken Seite zu Ihrem Gegenstück im rechten Bereich gemappt sind. Für dieses Beispiel sind das die die Felder InvoiceNumber, InvoiceDate, InvoiceTotal und Name.

    

27. Klicken Sie auf Speichern.

28. Wechseln Sie zurück zum Technical Process ImportInvoices.wrf.

Beschreibung hinzufügen

1. Ziehen Sie das Element Textbox von der Sicht Palette unter das Element Stylesheet: ExtractCaseFeatures in den Editor.

2. Doppelklicken Sie auf das Element Textbox.
   Der Text Editor wird geöffnet.

3. Geben Sie den gewünschten Beschreibungstext ein, z. B.: “This Stylesheet (= "mapping") transforms the original invoice format into the format needed by the adapter in the following step, and therefore creates an XML with 4 "Feature" elements.”

4. Klicken Sie auf OK.

5. Passen Sie bei Bedarf die Größe und Position der Textbox an.