Technical Process definieren: Mapping

In diesem Schritt legen Sie die letzten Prozessschritte des Technical Processes fest. Dabei soll die aus der CSV-Datei erzeugte XML-Datei mithilfe eines XSL-Mappings weiter transformiert werden, um der gewünschten Datenstruktur in der Web App zu entsprechen.

Dafür verwenden Sie ein sogenanntes Mapping bzw. XSL Stylesheet.

Hinweis:

Für komplexere Mappings ist ggf. Wissen rund um die Elemente von XSLT 2.0 erforderlich. Die komplexeren Funktionen, die für dieses Beispiel-Mapping benötigt werden, sind in der Schrittanleitung enthalten.

Mapping anlegen

1. Rechtsklicken Sie auf den Technical ProcessProcessWebApp.wrf 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 Web App Project angelegt und öffnet sich automatisch im Editor.

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

Mapping einfügen

1. Ziehen Sie das Element Mapping von der Sicht Palette neben das Element Buffer 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.

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 Buffer, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element Stylesheet.

   

Mapping konfigurieren

1. Doppelklicken Sie auf das Element Stylesheetim Technical Process ProcessWebApp.wrf.
   Die verknüpfte Datei stylesheet.xsl öffnet sich im Editor.

2. Ziehen Sie die temporär gespeicherte Datei Buffer.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. Ok.

5. Rechtsklicken Sie auf das Element Okim rechten Bereich und wählen Sie XSL Element.

6. Wählen Sie As Child in der Location Dropdown-Liste und wählen Sie for-each in der XSL Element Dropdown-Liste.

7. Klicken Sie auf Next.

8. Tragen Sie den Wert Csv/Row im Feld select ein, um die neue Datenstruktur für jede Reihe der CSV-Datei festzulegen.

9. Klicken Sie Finish.
   ✅ Eine gelbe Verbindungslinie zeigt das Mapping grafisch an.

10. Rechtsklicken Sie auf das Element Ok 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: Customer.

12. Rechtsklicken Sie auf das Element Customer im rechten Bereich und wählen Sie Element.

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

14. Rechtsklicken Sie auf das Element Vorname im rechten Bereich und wählen Sie XSL Element.

15. Wählen Sie As Child in der Location Dropdown-Liste und wählen Sie value-of in der XSL Element Dropdown-Liste.

16. Klicken Sie auf Next.

17. Tragen Sie den Wert substring-before(//ContactName, ' ')im Feld select ein, um den Vornamen als den ersten Teilstring aus dem Feld ContactName festzulegen.

18. Klicken Sie Finish.
    ✅ Eine grüne Verbindungslinie zeigt das Mapping grafisch an.

19. Rechtsklicken Sie auf das Element Customer im rechten Bereich und wählen Sie Element.

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

21. Rechtsklicken Sie auf das Element Nachname im rechten Bereich und wählen Sie XSL Element.

22. Wählen Sie As Child in der Location Dropdown-Liste und wählen Sie value-of in der XSL Element Dropdown-Liste.

23. Klicken Sie auf Next.

24. Tragen Sie den Wert substring-after(//ContactName, ' ') im Feld select ein, um den Nachnamen als den zweiten Teilstring aus dem Feld ContactName festzulegen.

25. Klicken Sie Finish.
    ✅ Eine grüne Verbindungslinie zeigt das Mapping grafisch an.

26. Rechtsklicken Sie auf das Element Customer im rechten Bereich und wählen Sie Element.

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

28. Rechtsklicken Sie auf das Element Firma im rechten Bereich und wählen Sie XSL Element.

29. Wählen Sie As Child in der Location Dropdown-Liste und wählen Sie value-of in der XSL Element Dropdown-Liste.

30. Klicken Sie auf Next.

31. Tragen Sie den Wert //CompanyName im Feld select ein.

32. Klicken Sie Finish.
    ✅ Eine grüne Verbindungslinie zeigt das Mapping grafisch an.

33. Rechtsklicken Sie auf das Element Customer im rechten Bereich und wählen Sie Element.

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

35. Rechtsklicken Sie auf das Element Adresse im rechten Bereich und wählen Sie XSL Element.

36. Wählen Sie As Child in der Location Dropdown-Liste und wählen Sie value-of in der XSL Element Dropdown-Liste.

37. Klicken Sie auf Next.

38. Tragen Sie den Wert concat (//PostalCode, ' ' , //Address) im Feld select ein, um die Felder PostalCode und Address zu einem String zu verketten.

39. Klicken Sie Finish.
    ✅ Zwei grüne Verbindungslinien zeigen das Mapping grafisch an.

    

40. Klicken Sie auf Speichern.

41. Wechseln Sie zurück zum Technical Process ProcessWebApp.wrf.