---
version: "7.5"
language: "de"
---
# X4 BPMS
Willkommen im Hilfebereich zur X4 BPMS. Hier finden Sie Informationen zur Bedienung, Installation und Administration der einzelnen Produktbestandteile sowie zur Entwicklung von X4 Web Apps.
**Hinweis:**
Sie nutzen aktuell eine Betaversion der Onlinehilfe. Die Inhalte werden laufend erweitert und optimiert.
---
version: "7.5"
language: "de"
---
# Erste Schritte
Der Bereich Erste Schritte dient Ihnen als Starthilfe, um die ersten Schritte mit der X4 BPMS (Business Process Management Software) so einfach wie möglich zu gestalten.
Hier finden Sie allgemeine Informationen zu den Komponenten der X4 BMPS und erfahren, wie Sie in X4 BPMS projektbasiert arbeiten und Ihre ersten Projekte anlegen. Außerdem lernen Sie, wie Sie Testprojekte importieren oder selbst erstellte Beispielprojekte exportieren.
Für Interessierte gibt es in diesem Bereich jeweils ein Beispielprojekt für die Projekttypen BPM Project, ESB Project und Web App Project. Diesen Beispielanleitungen können Sie Schritt für Schritt folgen, um auszuprobieren, wie X4 BPMS funktioniert und wie Sie unternehmenseigene Projekte umsetzen können.
Ausführliche Informationen zu den Funktionen und Vorteilen der X4 BPMS finden Sie in diesem [Überblick über die X4 BPMS](https://www.softproject.de/de/x4-bpms/).
## X4 BPMS Komponenten
Die Installation der X4 BPMS besteht aus den folgenden Komponenten:
| **Komponente** | **Beschreibung** |
|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| X4 Server | Der X4 Server bildet das Herzstück der X4 BPMS. Als zentraler Baustein in der X4 BPMS Architektur ist der X4 Server zum einen der zentrale Speicher für Projekte und Geschäftsprozesse, zum anderen ist er für die Ausführung und Steuerung aller Prozesse zuständig. |
| X4 Designer | Der X4 Designer als integriertes Entwicklerwerkzeug stellt die grafische Benutzeroberfläche der X4 BPMS dar. Über den X4 Designer lassen sich Geschäftsprozesse angelehnt an BPMN 2.0 (Business Process Model and Notation) und Geschäftsregeln gemäß DMN 1.1 (Decision Model and Notation) modellieren. Mit dem X4 Designer lassen sich Prozesse grafisch per Drag-and-Drop erstellen. Außerdem werden dem Anwender passende Eingabemasken zur Verfügung gestellt, über die einzelne Prozessbausteine konfiguriert werden können. |
**Hinweis:**
Um die X4 BPMS nutzen zu können, muss ein OIDC-konformer Identity Provider installiert und ausgeführt werden.
---
version: "7.5"
language: "de"
---
# Beispiel: BPM Project
Im X4 Designer können Sie einen oder mehrere Geschäftsprozesse (BPM Processes \*.bpm) innerhalb eines BPM Projects grafisch modellieren.
Der Geschäftsprozess kann mit unterschiedlichen Prozessbausteinen dargestellt werden. Diese können per Drag\&Drop in die Zeichnungsfläche gezogen werden und mit Technical Processes verknüpft werden.
Für dieses Beispiel-BPM Project modellieren Sie den Prozess "Import and approve invoices", der Technical Processes mit manuellen Arbeitsschritten Ihrer Mitarbeiter kombiniert und grafisch abbildet. Dabei sollen erhaltene Rechnungen durch Technical Processes automatisch weitergeleitet werden, wenn der Rechnungswert unter 1000 liegt. Wenn der Rechnungswert über 1000 liegt, soll ein Mitarbeiter aus dem Rechnungswesen eine manuelle Rechnungsprüfung durchführen. Erst, wenn eine entsprechende Rechnung manuell angenommen wurde, wird sie weitergeleitet.
**Hinweis:**
Beachten Sie, dass der hier beschriebene Beispielprozess zunächst nur den Prozessablauf modelliert. Im Bereich "Erste Schritte" wird nur beschrieben, wie Sie einen der enthaltenen Technical Processes nachbilden. Die entsprechende Anleitung, wie Sie diesen Technical Process erstellen, finden Sie auf der Seite [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md) und den zugehörigen Unterseiten.
Bevor Sie mit der Prozessmodellierung beginnen können, müssen Sie zunächst ein BPM Project anlegen.
## BPM Project anlegen
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Wählen Sie unter **New** den Projekttyp **BPM Project...** aus.
Das Dialogfenster **Project Creation Wizard** wird geöffnet.
3. Geben Sie im Textfeld **Project name** einen Namen für Ihr Projekt ein.
4. Klicken Sie auf **Finish** .
✅ Ihr neues Projekt wurde angelegt, und Sie sehen die erstellte Projektstruktur in der Sicht **Projects**.
## Benötigte BPM-Prozessbausteine
Sie modellieren Ihre BPM-Prozesse in sogenannten BPM Process-Dateien. Zu diesem Zweck stehen Ihnen in der Sicht **Palette**verschiedene Elemente zur Verfügung.
Weitere Informationen zu allen Elementen in der Sicht **Palette** finden Sie unter [(7.4.4-de) BPMN-Prozessbausteine und ihre Verwendung](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpm/bpmn-prozessbausteine-und-ihre-verwendung.md).
Für den hier beschriebenen Beispielprozess sind die folgenden Elemente relevant:
| **Symbol** | **Name** | **Beschreibung** |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  | `Start` | Definiert gemäß BPMN 2.0 das Start-Ereignis des Business Processes und ermöglicht die Unterscheidung hinsichtlich verschiedener Ereignistypen. |
|  | `Pool/Lane` | Gliedert gemäß BPMN 2.0 einen Business Process in Zuständigkeiten und Beteiligte. `Lanes` werden innerhalb eines oder mehrerer sogenannter `Pools` definiert und repräsentieren somit Zuständigkeiten von Aktivitäten. Mit Pools werden die beteiligten Organisationen, Systeme u. a. dargestellt, wobei ein Pool beliebig viele Lanes enthalten kann. In der Pool/Lane-Darstellung wird der zeitliche Prozessablauf zumeist von links oben nach rechts unten angeordnet. |
|  | `Activity` | Ein `Activity`-Baustein definiert gemäß BPMN 2.0 eine Aktivität innerhalb eines Business Processes. Der Aktivitätstyp sowie dessen Ausführungsverhalten werden durch entsprechende Eigenschaften festgelegt bzw. durch Marker gekennzeichnet. Mit einem `Activity`-Baustein lassen sich je nach Anwendungsfall Technical Processes oder weitere Business Processes als Subprozesse verknüpfen. |
|  | `Intermediate` | Definiert gemäß BPMN 2.0 ein Zwischenereignis innerhalb eines Business Processes und ermöglicht es zudem einen Vorgangs-Statuswert über die Eigenschaft `Case State` zu setzen. |
|  | `Rule` | Mit dem `Rule`-Baustein lassen sich Regeln für Entscheidungen innerhalb eines Business Processes abbilden. Die anzuwendenden Regeln werden dabei innerhalb von Entscheidungstabellen (`.rule`) nach DMN 1.1 definiert. Die Regeln können automatisiert geprüft und die Ergebnisse für die Weiterverarbeitung an den Business Process zurückgegeben werden. |
|  | `Exclusive Gateway (Forking)` | Definiert gemäß BPMN 2.0 ein Gateway für exklusive Verzweigungen. |
|  | `Human Task` | Mit `Human Task`-Bausteinen lassen sich menschliche Aktivitäten abbilden. Bei der Automatisierung des Business Processes werden diese Human Tasks mit ausführbaren HUMANTASK-Dateien verknüpft. Ein Human Task (`.humantask`) ermöglicht die Konfiguration der *Task Management Web App* und damit die Interaktion mit von Menschen ausgeführten Aufgaben, die im Case Management als Vorgang modelliert werden. |
|  | `Stop` | Grundelement zum Festlegen des Prozessendes. |
Auf den folgenden Seiten finden Sie die nächsten Schritte im Beispielprojekt:
* [BPM Process anlegen (.bpm)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/bpm-process-anlegen-bpm.md)
* [Pools und Lanes anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/pools-und-lanes-anlegen.md)
* [Vorgangs-Fachdaten festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-fachdaten-festlegen.md)
* [Vorgangs-Statuswerte festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-statuswerte-festlegen.md)
* [Start-Element festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/start-element-festlegen.md)
* [Erste Activity einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erste-activity-einfugen.md)
* [Erstes Zwischenereignis einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erstes-zwischenereignis-einfugen.md)
* [Entscheidungstabelle anlegen und Regel einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/entscheidungstabelle-anlegen-und-regel-einfugen.md)
* [Exklusive Verzweigung und weitere Aktivitäten einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-und-weitere-aktivitaten-einf.md)
* [Ausführ-Bedingungen festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/ausfuhr-bedingungen-festlegen.md)
* [Human Task anlegen und definieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/human-task-anlegen-und-definieren.md)
* [Exklusive Verzweigung einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-einfugen-und-ausfuhr-bedingu.md)
* [Endpunkte einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/endpunkte-einfugen-und-ausfuhr-bedingung-festlegen.md)
* [Ergebnis: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/ergebnis-bpm-project.md)
---
version: "7.5"
language: "de"
---
# Ausführ-Bedingungen festlegen
In diesem Schritt legen Sie die Ausführ-Bedingungen für die jeweiligen Ausführungszweige der exklusiven Verzweigung fest. Diese Ausführ-Bedingungen bestimmen, wie mit den Daten verfahren wird, wenn einer der in der Regel definierten Case States gesetzt wird: Entweder die Rechnung wird automatisch weitergeleitet oder muss manuell geprüft werden.
**So legen Sie Ausführ-Bedingungen fest**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Exklusive Verzweigung und weitere Aktivitäten einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-und-weitere-aktivitaten-einf.md)
1. Doppelklicken Sie auf das Element  `Exclusive Gateway (Forking)` im Editor.
Der **Condition Editor** wird geöffnet.
Die Verbindung zwischen dem Element  `Exclusive Gateway (Forking)` und der Aktivität  `CreateTransferRequest` ist automatisch im **Condition Editor** ausgewählt und hervorgehoben in Rot.
2. Tragen Sie die folgende Bedingung im Bereich **Edit Condition** ein:
**If result of** `CASE_STATE`**is** `=` `Approved - automatically`
3. Klicken Sie auf die Verbindung zwischen dem Element  `Exclusive Gateway (Forking)` und der Aktivität  `Human Task` im **Condition Editor**.
4. Tragen Sie die folgende Bedingung im Bereich **Edit Condition** ein:
**If result of** `CASE_STATE` **is** `=` `Approved - automatically`
5. Klicken Sie auf **Close**.
6. Klicken Sie auf  **Speichern**.
▶️
**Nächster Schritt:** [(7.4.4-de) Human Task anlegen und definieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/human-task-anlegen-und-definieren.md)
---
version: "7.5"
language: "de"
---
# BPM Process anlegen (.bpm)
In einem BPM Project arbeiten Sie mit sogenannten Geschäftsprozessen (BPM Processes \*.bpm), um Ihre unternehmensspezifischen Prozesse zu visualisieren und modellieren. In diesen BPM-Dateien können Sie einen grafischen Editor verwenden, um die Events, Aktivitäten und Pfade Ihrer Prozesse abzubilden.
Für dieses Beispiel-BPM Project modellieren Sie den Prozess "Import and approve invoices" und müssen im ersten Schritt einen BPM Process anlegen.
**So legen Sie einen BPM Prozess an**
**Voraussetzungen:**
Sie haben ein BPM Project in der Sicht **Projects** angelegt. Weitere Informationen finden Sie unter [(7.4.4-de) Neue Projekte anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/neues-projekt-anlegen.md).
1. Doppelklicken Sie auf das angelegte BPM Project in der Sicht **Projects**.
2. Rechtsklicken Sie auf den Ordner **Processes**.
3. Wählen Sie **New** \> **Business Process...** .
Das Dialogfenster **Process Creation Wizard** wird geöffnet.
4. Geben Sie im Textfeld **File name** den Namen `ImportInvoices`für Ihren Prozess ein.
5. Klicken Sie auf **Finish** .
✅ Der Prozess ist im Ordner **Processes**angelegt.
6. Doppelklicken Sie auf den Prozess, um ihn im Editor zu öffnen.
Der Prozess enthält bereits automatisch einen Start und einem Endpunkt.
7. Löschen Sie zunächst alle Elemente außer dem Element  `Start`, um das hier beschriebene Beispiel umzusetzen.
▶️
**Nächster Schritt:** [(7.4.4-de) Pools und Lanes anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/pools-und-lanes-anlegen.md)
---
version: "7.5"
language: "de"
---
# Endpunkte einfügen und Ausführ-Bedingung festlegen
Im letzten Schritt legen Sie die Endpunkte Ihres Prozesses fest. Für dieses Beispiel verwenden Sie End-Elemente vom Ereignistyp `None End`, also allgemeine End-Ereignisse. Außerdem legen Sie einen der Endpunkte als Endpunkt für die zweite Ausführ-Bedingung der exklusiven Verzweigung fest.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Exklusive Verzweigung einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-einfugen-und-ausfuhr-bedingu.md)
## Endpunkte einfügen
1. Ziehen Sie das Element  `None End` von der Sicht **Palette** neben das Element  `CreateTransferRequest`in die obere Lane des Pools.
2. Legen Sie im Feld **Label** in der Sicht **Properties** einen neuen Namen für den Endpunkt fest, z. B. `Sent to accounting`.
3. Klicken Sie auf die rechte untere  Ecke des Elements  `CreateTransferRequest`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Sent to accounting`.
4. Ziehen Sie das Element  `None End` von der Sicht **Palette** neben das Element  `Exclusive Gateway (Forking)`in die untere Lane des Pools.
5. Legen Sie im Feld **Label** in der Sicht **Properties** einen neuen Namen für den Endpunkt fest, z. B. `Declined - manually`.
6. Klicken Sie auf die rechte untere  Ecke des Elements  `Exclusive Gateway (Forking)`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Declined - manually`.
## Ausführ-Bedingung festlegen
1. Doppelklicken Sie auf das Element  `Exclusive Gateway (Forking)` im Editor.
Der **Condition Editor** wird geöffnet.
Die Verbindung zwischen dem Element  `Exclusive Gateway (Forking)` und dem Element  `Declined - manually` ist automatisch im **Condition Editor** ausgewählt und hervorgehoben in Rot.
2. Tragen Sie die folgende Bedingung im Bereich **Edit Condition** ein:
**If result of** `CASE_STATE`**is** `=` `Declined - manually`
3. Klicken Sie auf **Close**.
4. Klicken Sie auf  **Speichern**.
▶️
**Nächster Schritt:** [(7.4.4-de) Ergebnis: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/ergebnis-bpm-project.md)
---
version: "7.5"
language: "de"
---
# Entscheidungstabelle anlegen und Regel einfügen
In diesem Schritt fügen Sie eine Regel zu Ihrem Prozess hinzu. Die anzuwendenden Regeln legen Sie dabei in einer Entscheidungstabelle fest (`.rule`). Für dieses Beispiel legen Sie eine Entscheidungstabelle an, die Folgendes bestimmt:
* Alle Rechnungen mit einem Rechnungswert unter 1000 werden automatisch bestätigt.
* Alle Rechnungen mit einem Rechnungswert über oder gleich 1000 werden manuell geprüft.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Erstes Zwischenereignis einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erstes-zwischenereignis-einfugen.md)
**Voraussetzungen:**
Sie haben Vorgangs-Fachdaten festgelegt. Weitere Informationen finden Sie unter [(7.4.4-de) Vorgangs-Fachdaten festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-fachdaten-festlegen.md).
## Entscheidungstabelle anlegen
1. Rechtsklicken Sie auf das BPM Project `ImportInvoices.bpm` in der Sicht **Projects** und wählen Sie **New** \> **Rules...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
2. Geben Sie im Textfeld **File name** den Namen `CheckInvoiceAmount.rule` für Ihre Entscheidungstabelle ein.
3. Klicken Sie auf **Finish** .
✅ Die Entscheidungstabelle wird im BPM Project angelegt und öffnet sich automatisch im Editor.
4. Wählen Sie den Wert `Case Feature` als **Input** und wählen Sie `InvoiceAmount` im Feld **/Data/Input1**.
5. Tragen Sie den Wert `< 1000` in die Spalte **Input**der ersten Tabellenzeile ein.
6. Klicken Sie auf die Schaltfläche  **Add After** .
✅ Eine neue Tabellenzeile wird unter der aktuellen Zeile hinzugefügt.
7. Tragen Sie den Wert `>= 1000` in die Spalte **Input** der zweiten Tabellenzeile ein.
8. Wählen Sie den Wert `Case State` als **Output**.
9. Wählen Sie den Wert `Approved - automatically` in der Spalte **Output**der ersten Tabellenzeile.
10. Wählen Sie den Wert `To be checked manually` in der Spalte **Output**der zweiten Tabellenzeile.
11. Klicken Sie auf  **Speichern**.
12. Wechseln Sie zurück zum BPM Project `ImportInvoices`.
## Regel einfügen
1. Ziehen Sie das Element  `Rule` von der Sicht **Palette** neben das Element  `Received` in die obere Lane des Pools.
2. Legen Sie im Feld **Label** in der Sicht **Properties** den Namen `CheckInvoiceAmount` für das Element `Rule`fest.
3. Klicken Sie auf die  Schaltfläche im Feld **Document** in der Sicht **Properties** .
Das Dialogfenster **Choose Rule Input** wird geöffnet.
4. Wählen Sie die zuvor angelegte RULE-Datei `CheckInvoiceAmount.rule`.
5. Klicken Sie auf die rechte untere  Ecke des Elements  `Received`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Rule`.
▶️
**Nächster Schritt:** [(7.4.4-de) Exklusive Verzweigung einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-einfugen-und-ausfuhr-bedingu.md)
---
version: "7.5"
language: "de"
---
# Ergebnis: BPM Project
✅ Sie haben nun erfolgreich den BPM-Prozess "Import an approve invoices" modelliert.
Beachten Sie, dass Sie die Technical Processes der Aktivitäten "ImportInvoices" und "CreateTransferRequest" in separaten Schritten modellieren müssen, damit der Rechnungsimport und die automatische Weiterleitung der Rechnungen auch funktionieren. Sie finden eine Beschreibung, wie Sie den Technical Process "ImportInvoices" anlegen unter [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
Der modellierte BPM Process sollte folgendermaßen aussehen:
Erhaltene Rechnungen werden automatisch weitergeleitet, wenn der Rechnungswert unter 1000 liegt. Wenn der Rechnungswert über 1000 liegt, soll ein Mitarbeiter aus dem Rechnungswesen eine manuelle Rechnungsprüfung durchführen. Erst, wenn eine entsprechende Rechnung manuell angenommen wurde, wird sie weitergeleitet.
---
version: "7.5"
language: "de"
---
# Erste Activity einfügen
Mit `Activity`-Bausteinen legen Sie eine Aktivität innerhalb Ihres Prozesses fest. Der Aktivitätstyp sowie dessen Ausführungsverhalten werden durch entsprechende Eigenschaften festgelegt. Mit einem `Activity`-Baustein lassen sich je nach Anwendungsfall Technical Processes oder weitere Business Processes als Subprozesse verknüpfen.
**So fügen Sie eine Activity ein**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Start-Element festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/start-element-festlegen.md)
1. Ziehen Sie das Element  `Activity` von der Sicht **Palette** neben das Element  `Timer Start` in die obere Lane des Pools.
2. Legen Sie im Feld **Label** in der Sicht **Properties** einen neuen Namen für die `Activity` fest, z. B. `ImportInvoices`.
3. Wählen Sie **Script** als **Activity type** in der Sicht **Properties**, um ein Skript zur Automatisierung des Schrittes zu hinterlegen.
Das entsprechende Skript bzw. den entsprechenden Technical Process können Sie auch zu einem späteren Zeitpunkt mit dem Element verknüpfen. Weitere Informationen, wie man den für dieses Beispiel benötigten Technical Process erstellt, finden Sie auf der Seite [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md) und den entsprechenden Unterseiten.
4. Klicken Sie auf die rechte untere  Ecke des Elements  `Timer Start`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu der Aktivität  `ImportInvoices`.
▶️
**Nächster Schritt:** [(7.4.4-de) Erstes Zwischenereignis einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erstes-zwischenereignis-einfugen.md)
---
version: "7.5"
language: "de"
---
# Erstes Zwischenereignis einfügen
In diesem Schritt fügen Sie ein Zwischenergebnis zum Prozess hinzu und wählen den gewünschten Status des Elements aus den zuvor angelegten Vorgangs-Statuswerten aus.
◀️
**Vorheriger Schritt:** [Erste Activity einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erste-activity-einfugen.md)
**Voraussetzungen:**
Sie haben Vorgangs-Statuswerte festgelegt. Weitere Informationen finden Sie unter [Vorgangs-Statuswerte festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-statuswerte-festlegen.md).
1. Ziehen Sie das Element  `Intermediate` von der Sicht **Palette** neben das Element  `ImportInvoices` in die obere Lane des Pools.
2. Klicken Sie auf die rechte untere  Ecke der Aktivität  `ImportInvoices`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `Intermediate`.
3. Legen Sie im Feld **Label** in der Sicht **Properties** den Namen `Received` für das Element  `Intermediate`fest.
4. Wählen Sie in der Dropdown-Liste **Case State** in der Sicht **Properties** des Elements  `Received`den Status `Received`.
▶️
**Nächster Schritt:** [Entscheidungstabelle anlegen und Regel einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/entscheidungstabelle-anlegen-und-regel-einfugen.md)
---
version: "7.5"
language: "de"
---
# Exklusive Verzweigung einfügen und Ausführ-Bedingung festlegen
In diesem Schritt fügen Sie eine weitere exklusive Verzweigung zu Ihrem Prozess hinzu. Nachdem die Human Task durchgeführt, also eine Rechnung manuell geprüft wurde, kann der Prozess zwei Wege einschlagen: Die Rechnung wird manuell angenommen und anschließend automatisch weitergeleitet oder die Rechnung wird manuell abgelehnt und damit nicht weitergeleitet.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Human Task anlegen und definieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/human-task-anlegen-und-definieren.md)
## Exklusive Verzweigung einfügen
1. Ziehen Sie das Element  `Exclusive Gateway (Forking)` von der Sicht **Palette** neben das Element  `ApproveOrDeclineInvoice.humantask` in die untere Lane des Pools.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `ApproveOrDeclineInvoice.humantask`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Exclusive Gateway (Forking)`.
3. Klicken Sie auf die rechte untere  Ecke des Elements  `Exclusive Gateway (Forking)`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `CreateTransferRequest`.
## Ausführ-Bedingung festlegen
1. Doppelklicken Sie auf das Element  `Exclusive Gateway (Forking)` im Editor.
Der **Condition Editor** wird geöffnet.
Die Verbindung zwischen dem Element  `Exclusive Gateway (Forking)` und der Aktivität  `CreateTransferRequest` ist automatisch im **Condition Editor** ausgewählt und hervorgehoben in Rot.
1. Tragen Sie die folgende Bedingung im Bereich **Edit Condition** ein:
**If result of** `CASE_STATE`**is** `=` `Approved - manually`
2. Klicken Sie auf **Close**.
3. Klicken Sie auf  **Speichern**.
▶️
**Nächster Schritt:** [(7.4.4-de) Endpunkte einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/endpunkte-einfugen-und-ausfuhr-bedingung-festlegen.md)
---
version: "7.5"
language: "de"
---
# Exklusive Verzweigung und weitere Aktivitäten einfügen
In diesem Schritt legen Sie mit einer exklusiven Verzweigung fest, wie mit den Daten verfahren wird, wenn einer der in der Regel definierten Case States gesetzt wird: Entweder die Rechnung wird automatisch weitergeleitet oder muss manuell geprüft werden.
Um die Ausführ-Bedingungen einzufügen, müssen bereits die nächsten Aktivitäten eingefügt werden. Diese Aktivitäten umfassen ein Element `Activity `für die automatische Weiterleitung und eine sogenannte `Human Task` für die manuelle Prüfung.
**Hinweis:**
Für das Aufgabenmanagement bei Human Tasks steht Ihnen standardmäßig die Task Management Web App zur Verfügung. Weitere Informationen finden Sie unter [(7.4.4-de) Task Management](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter/x4-tools/task-management.md).
◀️
**Vorheriger Schritt:** [(7.4.4-de) Entscheidungstabelle anlegen und Regel einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/entscheidungstabelle-anlegen-und-regel-einfugen.md)
## Exklusive Verzweigung einfügen
1. Ziehen Sie das Element  `Exclusive Gateway (Forking)` von der Sicht **Palette** neben das Element  `Rule` in die obere Lane des Pools.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `Rule`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Exclusive Gateway (Forking)`.
## Aktivitäten einfügen
1. Ziehen Sie das Element  `Human Task` von der Sicht **Palette** in die untere Lane des Pools.
Die Einstellungen der Human Task legen Sie zu einem späteren Zeitpunkt fest. Weitere Informationen finden Sie auf der Seite [(7.4.4-de) Human Task anlegen und definieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/human-task-anlegen-und-definieren.md).
2. Legen Sie im Feld **Label** in der Sicht **Properties** einen neuen Namen für die  `Human Task`fest, z. B. `ApproveOrDeclineInvoice`.
3. Ziehen Sie das Element  `Activity `von der Sicht **Palette** neben das Element  `Exclusive Gateway (Forking)` in die obere Lane des Pools.
Das entsprechende Skript bzw. den entsprechenden Technical Process können Sie auch zu einem späteren Zeitpunkt mit dem Element verknüpfen. Hier könnten Sie beispielsweise eine automatische Weiterleitung nach Datentransformation als Technical Process einfügen.
4. Legen Sie im Feld **Label** in der Sicht **Properties** einen neuen Namen für die  `Activity` fest, z. B. `CreateTransferRequest`.
5. Klicken Sie auf die rechte untere  Ecke des Elements  `Exclusive Gateway (Forking)` und ziehen Sie jeweils eine Verbindung zu der Aktivität  `CreateTransferRequest` und der Human Task  `ApproveOrDeclineInvoice`.
▶️
**Nächster Schritt:** [(7.4.4-de) Ausführ-Bedingungen festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/ausfuhr-bedingungen-festlegen.md)
---
version: "7.5"
language: "de"
---
# Human Task anlegen und definieren
Der BPM Process enthält an diesem Punkt eine Aktivität, die als Human Task klassifiziert ist, also eine menschliche, manuelle Aktivität abbildet. In diesem Beispiel ist diese manuelle Aktivität das Bestätigen der Rechnung in der Task Management Web App. Für diesen Prozessschritt müssen Sie nun eine HUMANTASK-Datei anlegen und weitere Einstellungen definieren, zum Beispiel die möglichen Aktionen.
**Hinweis:**
Für das Aufgabenmanagement bei Human Tasks steht Ihnen standardmäßig die Task Management Web App zur Verfügung. Weitere Informationen finden Sie unter [(7.4.4-de) Task Management](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter/x4-tools/task-management.md).
**So legen Sie die Human Task an**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Ausführ-Bedingungen festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/ausfuhr-bedingungen-festlegen.md)
1. Rechtsklicken Sie auf das BPM Project `ImportInvoices.bpm` in der Sicht **Projects** und wählen Sie **New** \> **Rules...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
2. Geben Sie im Textfeld **File name** den Namen `ApproveOrDeclineInvoice.humantask` für Ihre Human Task ein.
3. Klicken Sie auf **Finish** .
✅ Die Human Task wird im BPM Project angelegt und öffnet sich automatisch im Editor.
4. Legen Sie im Feld **Title** einen Titel für die Human Task fest, zum Beispiel `Approve or decline invoice`.
5. Aktivieren Sie das Kontrollkästchen **No deadline** auf der Registerkarte **General**, damit die Freigabe von Rechnungen keiner zeitlichen Beschränkungen unterliegt.
6. Wechseln Sie zur Registerkarte **Business Data** und aktivieren Sie alle Kontrollkästchen der definierten Datenstruktur, damit die Benutzer in der Task Management Web App alle entsprechenden Daten angezeigt bekommen.
7. Wechseln Sie zur Registerkarte **Actions**.
8. Aktivieren Sie das Kontrollkästchen `Approved - manually` und legen Sie einen **Display name** fest, zum Beispiel `Ok`.
9. Aktivieren Sie das Kontrollkästchen `Declined - manually` und legen Sie einen **Display name** fest, zum Beispiel `No`.
✅ Die Status sind als mögliche Aktionen in der Task Management Web App festgelegt.
10. Klicken Sie auf  **Speichern**.
11. Wechseln Sie zurück zum BPM Project `ImportInvoices`.
12. Klicken Sie auf die  Schaltfläche im Feld **Document** in der Sicht **Properties** .
Das Dialogfenster **Choose Human Task Input** wird geöffnet.
13. Wählen Sie die zuvor angelegte HUMANTASK-Datei `ApproveOrDeclineInvoice.humantask`.
14. Klicken Sie **OK**.
▶️
**Nächster Schritt:** [(7.4.4-de) Exklusive Verzweigung einfügen und Ausführ-Bedingung festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/exklusive-verzweigung-einfugen-und-ausfuhr-bedingu.md)
---
version: "7.5"
language: "de"
---
# Pools und Lanes anlegen
Bevor Sie mit dem Modellieren der tatsächlichen Prozessschritte anfangen, empfiehlt es sich, sogenannte Pools und Lanes anzulegen.
Mit Pools und Lanes gliedern Sie gemäß BPMN 2.0 Business Processes in Zuständigkeiten und Beteiligte. Dabei bilden Sie mit einem Pool die beteiligten Organisationen und/oder Systeme ab, Lanes repräsentieren die beteiligten Personen oder Teams. Ein Pool kann beliebig viele Lanes enthalten. In der Pool/Lane-Darstellung wird der zeitliche Prozessablauf zumeist von links oben nach rechts unten angeordnet.
Für das Beispielprojekt legen Sie einen Pool mit zwei Lanes an, die die am Prozess beteiligtem Teams repräsentieren.
**So legen Sie einen Pool und Lanes an**
◀️
**Vorheriger Schritt:** [(7.4.4-de) BPM Process anlegen (.bpm)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/bpm-process-anlegen-bpm.md)
1. Ziehen Sie ein Element  `Pool/Lane` von der Sicht **Palette**in den Editor und ziehen Sie das Element auf die gewünschte Größe.
2. Klicken Sie auf den eingefügten Pool und vergeben Sie den **Pool Name** `Import and approve invoices` in der Sicht **Properties**.
3. Rechtsklicken Sie auf den Pool im Editor und wählen Sie **Add Lane**.
4. Klicken Sie auf die eingefügten Lanes und geben Sie im Feld **Lane Name** in der Sicht **Properties** ein, welches Team für die Arbeitsschritte in der entsprechenden Lane verantwortlich ist. Für unser Beispiel sind das die Teams `X4`und `Accounting`.
▶️
**Nächster Schritt:** [(7.4.4-de) Vorgangs-Fachdaten festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-fachdaten-festlegen.md)
---
version: "7.5"
language: "de"
---
# Start-Element festlegen
Jeder BPM Process wird automatisch mit einem Start-Element im Editor angelegt und muss mindestens ein Start-Element enthalten. Mit diesem Start-Element definieren Sie das Startereignis des Prozesses.
In den Eigenschaften des Start-Elements können Sie zwischen verschiedenen Ereignistypen wählen. Je nach gewähltem Ereignistyp ändern sich das Icon des Start-Elements, die Funktionalität des Elements wird jedoch nicht verändert.
Außerdem können Sie in den Eigenschaften festlegen, welcher Vorgangs-Statuswert durch den Start des Prozesses gesetzt wird, z. B. `New invoice`.
Für das Beispielprojekt legen Sie einen zeitgesteuertes Startereignis an.
**So legen Sie den Timer Start fest**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Vorgangs-Statuswerte festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-statuswerte-festlegen.md)
1. Klicken Sie auf das Element  `Start` und wählen Sie  `Timer Start` in der Dropdown-Liste **Event** in der Sicht **Properties**.
2. Öffnen Sie die  Dropdown-Liste im Feld **Case State** in der Sicht **Properties** und wählen Sie den Vorgangs-Statuswert `New invoice`.
▶️
**Nächster Schritt:** [(7.4.4-de) Erste Activity einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/erste-activity-einfugen.md)
---
version: "7.5"
language: "de"
---
# Vorgangs-Fachdaten festlegen
Vorgangs-Fachdaten bilden die benötigte Datenstruktur der im Business Process verwendeten Fachdaten ab.
Das Anlegen von Vorgangs-Fachdaten ist besonders dann sinnvoll, wenn Sie Technical Processes in Ihren BPM Process integrieren möchten und in diesen Technical Processes mit vorbestimmten Fachdatenstrukturen arbeiten möchten. Für den hier beschriebenen Beispielprozess werden die Vorgangs-Fachdaten benötigt, um eine Entscheidungstabelle und eine zugehörige Regel anzulegen. Weitere Informationen finden Sie unter [Entscheidungstabelle anlegen und Regel einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/entscheidungstabelle-anlegen-und-regel-einfugen.md).
Sie legen diese Datenstruktur mithilfe sogenannter Domain-Model-Dateien (`.domainmodel`) fest. In diesen Domain-Model-Dateien können Sie eine dreistufige Hierarchie mit Fachdatenstrukturen inklusive der zugehörigen Beschreibung definieren und somit der Prozessdefinition hinzufügen.
**Hinweise:**
* Wenn die Vorgangs-Fachdaten für mehrere Business Processes gelten sollen, legen Sie die entsprechende `.domainmodel`-Datei im Repository-Ordner **Activities \> DomainModel** an.
* Wenn die Vorgangs-Fachdaten nur für einen bestimmten Business Process gelten sollen, legen Sie die entsprechende `.domainmodel`-Datei direkt unterhalb des Business Processes an. Nach dem Speichern wird diese direkt an den `Start`-Baustein des Business Processes angehängt.
* Weitere Informationen zu Vorgangs-Fachdaten finden Sie unter [Domain-Model verwalten](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpm/case-management/vorgangs-fachdaten-verwalten.md).
**So legen Sie Vorgangs-Fachdaten fest**
◀️
**Vorheriger Schritt:** [Pools und Lanes anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/pools-und-lanes-anlegen.md)
1. Rechtsklicken Sie auf das BPM Project `ImportInvoices` in der Sicht **Projects** und wählen Sie **New** \> **Domain Model...** , um eine DOMAINMODEL-Datei zu erzeugen und Vorgangs-Fachdaten festzulegen.
✅ Die Datei `Case.domainmodel` wird angelegt und öffnet sich automatisch im Editor.
2. Klicken Sie auf **Add...** , um eine neue Kategorie hinzuzufügen und geben Sie den Namen `InvoiceData `in das Feld **Name**ein.
3. Klicken Sie erneut auf **Add...** , um eine neue Gruppe hinzuzufügen und geben Sie den Namen `InvoiceHeaderData` in das Feld **Name**ein.
4. Wählen Sie die Gruppe `InvoiceHeaderData` im Bereich **Structure** aus, klicken Sie auf **Add...** \> **Feature** und legen Sie die folgenden Features fest:
| **Name** | **Type** |
|-----------------|------------|
| `InvoiceNumber` | `String` |
| `InvoiceAmount` | `Decimal` |
| `InvoiceSender` | `String` |
| `InvoiceDate` | `DateTime` |
5. Klicken Sie auf  **Speichern**.
▶️
**Nächster Schritt:** [Vorgangs-Statuswerte festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-statuswerte-festlegen.md)
---
version: "7.5"
language: "de"
---
# Vorgangs-Statuswerte festlegen
Für den hier beschriebenen Beispielprozess benötigen Sie sogenannte Vorgangs-Statuswerte, d.h., Status, die beim Durchlaufen der unterschiedlichen Prozessschritte automatisch oder durch menschliche Interaktion gesetzt werden und z. B. bestimmen, welche Abzweigung im Prozess durchlaufen werden soll.
Statuswerte und Statusbeschreibungen werden in einer separaten Datei (`.state`) definiert.
**Hinweis:**
Sie können Vorgangs-Statuswerte nur für individuelle Business Processes anlegen. Weitere Informationen zu Vorgangs-Statuswerten finden Sie unter [(7.4.4-de) Vorgangs-Statuswerte verwalten](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpm/case-management/vorgangs-statuswerte-verwalten.md).
**So legen Sie Vorgangs-Statuswerte fest**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Vorgangs-Fachdaten festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/vorgangs-fachdaten-festlegen.md)
1. Klicken Sie auf das BPM Project `ImportInvoices` in der Sicht **Projects** und wählen Sie **New** \> **Case States...** , um eine STATE-Datei zu erzeugen und Vorgangs-Statuswerte festzulegen.
✅ Die Datei `Case.states` wird angelegt und öffnet sich automatisch im Editor.
2. Klicken Sie **Add** , um einen neuen Status hinzuzufügen und fügen Sie die folgenden Status hinzu:
`New invoice`
`Received`
`To be checked manually`
`Approved - automatically`
`Approved - manually`
`Declined - manually`
`Sent to accounting`
4. Klicken Sie auf  **Speichern**.
5. Wechseln Sie zurück zum BPM Project `ImportInvoices`.
▶️
**Nächster Schritt:** [(7.4.4-de) Start-Element festlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project/start-element-festlegen.md)
---
version: "7.5"
language: "de"
---
# Beispiel: ESB Project
Im X4 Designer verwenden Sie sogenannte ESB Projects, um Technical Processes grafisch zu modellieren und auszuführen. ESB Projects enthalten eine vordefinierte Ordnerstruktur, in der beliebig viele Technical Processes (\*.wrf) angelegt werden können.
Ein Technical Process kann mit unterschiedlichen Prozessbausteinen dargestellt werden. Diese können per Drag\&Drop in die Zeichnungsfläche gezogen werden. Dort können sie nach der Parametrierung direkt über das integrierte Debugging-Werkzeug getestet oder per Mausklick zeit- und ereignisgesteuert auf dem X4 Server ausgeführt werden.
Für dieses Beispiel-ESB Project modellieren Sie den Prozess "Import Invoices", um Rechnungsdaten einzulesen und weiterzuverarbeiten. Dabei soll eine Beispiel-Rechnungsdatei von Ihrem lokalen Rechner eingelesen, die Daten transformiert und in einen BPM-Prozess integriert werden.
**Hinweis:**
Den Technical Process, der in diesem Beispiel erstellt wird, können Sie nachträglich in Ihr Beispiel-BPM Project einbinden. Weitere Informationen finden Sie auf den Seiten [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md) und [(7.4.4-de) Activity](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpm/bpmn-prozessbausteine-und-ihre-verwendung/activities/activity.md) .
## Vorzubereitende Datei
Um den in diesem Kapitel beschriebenen Technical Process umzusetzen, müssen Sie folgende Datei vorbereiten und auf Ihrem lokalen Rechner speichern.
**So legen Sie die Datei** `SampleInvoice.xml`**an**
* Legen Sie eine neue XML-Datei mit folgendem Inhalt an. Dazu können Sie einen beliebigen Code-Editor verwenden, z. B. Notepad++.
RNR-2018-001
2018-09-27
1234.56
EUR
Meier GmbH
DE123456789
Bahnhofstraße 12
76275
Ettlingen
DE
SoftProject GmbH
DE987654321
Am Erlengraben 3
76275
Ettlingen
DE
## ESB Project anlegen
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Wählen Sie unter **New** den Projekttyp **ESB Project...** aus.
Das Dialogfenster **Project Creation Wizard** wird geöffnet.
3. Geben Sie im Textfeld **Project name** einen Namen für Ihr Projekt ein.
4. Klicken Sie auf **Finish** .
✅ Ihr neues Projekt wurde angelegt, und Sie sehen die erstellte Projektstruktur in der Sicht **Projects**.
## Benötigte ESB-Prozessbausteine
Sie modellieren Ihre ESB-Prozesse in sogenannten ESB Process-Dateien. Zu diesem Zweck stehen Ihnen in der Sicht **Palette**verschiedene Elemente zur Verfügung.
Weitere Informationen zu den weiteren Elementen in der Sicht **Palette** finden Sie unter [(7.4.4-de) Prozessbausteine und ihre Verwendung](https://docs.softproject.de/de/x4documentation/7.5.3/x4-esb/prozessbausteine-und-ihre-verwendung.md).
Für diesen Beispielprozess sind die folgenden Elemente relevant:
| **Symbol** | **Name** | **Beschreibung** |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  | `Start` | Definiert gemäß BPMN 2.0 das Start-Ereignis des Business Processes und ermöglicht die Unterscheidung hinsichtlich verschiedener Ereignistypen. |
|  | `Textbox` | Fügt einen Textrahmen ein, dessen Inhalt Sie per Doppelklick in einem Dialogfenster bearbeiten und formatieren können. |
|  | `Adapter` | Stellt grundlegende oder zusätzliche Funktionen bereit, etwa Zeichensatz-Konvertierungen oder ermöglicht beispielsweise den Zugriff auf ein SAP-System. Da der X4 Designer hauptsächlich mit XML-Daten arbeitet, werden mit Adaptern meist XML-Dokumente erzeugt oder verändert. Als Output erzeugen Adapter vorwiegend XML-Daten, die in einem nächsten Prozessschritt weiterverarbeitet werden. |
|  | `Variable` | Eine `Variable` speichert temporär Daten, während ein Technical Process (\*`.wrf`) ausgeführt wird. Innerhalb desselben Technical Processes oder eines Subprozesses können Sie die Variable auslesen. Mithilfe des `context:`-Protokolls können Sie auch in XSL-Mappings auf solche Variablen zugreifen. |
|  | `Mapping` | Transformiert ein XML-Dokument in einer Quellstruktur über ein XSLT-Stylesheet in eine Zielstruktur (meist XML) und ermöglicht so, die einzelnen Datenelemente einander zuzuordnen (sog. *Mapping*). XSLT dient der X4 BPMS zudem als Skriptsprache, mit der Prozessbausteine dynamisch parametriert werden können. |
|  | `Stop` | Grundelement zum Festlegen des Prozessendes. |
Auf den folgenden Seiten finden Sie die nächsten Schritte im Beispielprojekt:
* [Technical Process anlegen (.wrf)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/technical-process-anlegen-wrf.md)
* [File System Adapter anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/file-system-adapter-anlegen-einfugen-und-konfiguri.md)
* [Variable einfügen und Beschreibung hinzufügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/variable-einfugen-und-beschreibung-hinzufugen.md)
* [Mapping anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/mapping-anlegen-einfugen-und-konfigurieren.md)
* [(Optional) Case Management Adapter anlegen und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/optional-case-management-adapter-anlegen-und-einfu.md)
* [Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/endpunkt-einfugen.md)
* [(Advanced) Technical Process in Business Process integrieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/advanced-technical-process-in-business-process-int.md)
* [Ergebnis: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/ergebnis-esb-project.md)
---
version: "7.5"
language: "de"
---
# (Advanced) Technical Process in Business Process integrieren
Dieser Schritt ist nur notwendig, wenn Sie den Technical Process in einen BPM Process integrieren möchten. Ansonsten geht es hier weiter mit dem nächsten Schritt: ▶️[(7.4.4-de) Ergebnis: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/ergebnis-esb-project.md).
Sobald Sie den Technical Process `ImportInvoices.wrf` fertig erstellt haben, können Sie diesen Technical Prozess als Aktivität in den Beispielprozess `ImportInvoices.bpm` oder einen beliebigen BPM Process integrieren.
**So integrieren Sie den Technical Process als Aktivität**
**Voraussetzungen:**
* Sie haben den Technical Process erstellt, der als Beispiel beschrieben ist. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
* Sie haben den Business Process angelegt, der als Beispiel beschrieben ist und möchten den Technical Process als Aktivität integrieren. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md).
1. Öffnen Sie den gewünschten BPM-Prozess über die Sicht **Projects**.
2. Klicken Sie auf die Aktivität im Editor, über die Sie den Technical Process integrieren möchten.
3. Klicken Sie auf die  Schaltfläche im Feld **Document** in der Sicht **Properties** .
Das Dialogfenster **Choose Activity Input** wird geöffnet.
4. Wählen Sie den zuvor angelegten Technical Process.
5. Klicken Sie auf **OK** .
✅ Der gewählte Technical Process ist in den BPM Process integriert.
▶️
**Nächster Schritt:** [(7.4.4-de) Ergebnis: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/ergebnis-esb-project.md)
---
version: "7.5"
language: "de"
---
# Endpunkt einfügen
Im letzten Schritt legen Sie den Endpunkt Ihres Prozesses fest.
**So fügen Sie den Endpunkt ein**
◀️
**Vorheriger Schritt:** [(Optional) Case Management Adapter anlegen und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/optional-case-management-adapter-anlegen-und-einfu.md)
1. Ziehen Sie das Element  `Stop` von der Sicht **Palette** neben das Element  `Case_Management`.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `Case_Management`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Stop`.
▶️
**Nächster Schritt:** [(Advanced) Technical Process in Business Process integrieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/advanced-technical-process-in-business-process-int.md) oder [Ergebnis: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/ergebnis-esb-project.md)
---
version: "7.5"
language: "de"
---
# Ergebnis: ESB Project
✅ Sie haben nun erfolgreich den Technical Process "Import invoices" modelliert.
Der Prozess liest eine Beispielrechnung von Ihrem Computer ein und transformiert die eingelesenen Daten in eine gewünschte XML-Struktur zur weiteren Verarbeitung.
Wenn Sie den Technical Process in einen BPM-Prozess integriert und einen Case Management Adapter eingefügt haben, werden die aus den Rechnungsdokumenten ausgelesenen Informationen mithilfe der Operation `SetFeatures` als Features im BPM Process erfasst.
Der modellierte Technical Process sollte folgendermaßen aussehen:
Um zu testen, ob Sie den Technical Process korrekt modelliert haben, können Sie den Prozess debuggen, d.h. auf syntaktische Fehler prüfen. Eine ausführliche Beschreibung, wie Sie dabei vorgehen, finden Sie unter [(7.4.4-de) Technical Process debuggen](https://docs.softproject.de/de/x4documentation/7.5.3/x4-esb/prozesse-debuggen-und-ausfuhren/technical-process-debuggen.md).
---
version: "7.5"
language: "de"
---
# File System Adapter anlegen, einfügen und konfigurieren
Im ersten Schritt fügen Sie einen sogenannten Adapter in Ihren Prozess ein, um eine Beispieldatei zu importieren. Mit Adaptern können Sie Anwendungen und Daten in beliebige Business Processes integrieren. Weitere Informationen zu den X4 BPMS Standard-Adaptern und ihren Funktionen finden Sie unter [(7.4.4-de) X4 BPMS Standard-Adapter](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter.md).
Für dieses Beispiel benötigen Sie den Adapter File System. Dieser Adapter speichert, liest, löscht, kopiert, verschiebt, listet Dateien und Ordner oder fügt Dateien einer Zieldatei an, die sich im Dateisystem des X4 Servers oder auf verbundenen Windows- oder Samba-Netzlaufwerken befinden. Weitere Informationen zum File System Adapter finden Sie auf der Seite [(7.4.4-de) File System](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter/communication/file-system.md).
Nachdem Sie den Adapter angelegt und eingefügt haben, können Sie mit der Konfiguration des Adapters beginnen. 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.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process anlegen (.wrf)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/technical-process-anlegen-wrf.md)
**Voraussetzungen:**
Sie haben die vorzubereitende XML-Beispieldatei angelegt und lokal gespeichert. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
## Adapter anlegen
1. Rechtsklicken Sie auf den Technical Process`ImportInvoices` in der Sicht **Projects** und wählen Sie **New** \> **Adapter...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
2. Geben Sie im Suchfeld den Wert `File System` ein und wählen Sie den File System Adapter.
Bei Bedarf können Sie den Namen des Adapters im Feld **File name** anpassen.
3. Klicken Sie auf **Finish** .
✅ Der Adapter wirdim ESB Project angelegt und öffnet sich automatisch im Editor. Die weitere Konfiguration des eingefügten Adapters erfolgt im nächsten Schritt.
4. Wechseln Sie zurück zum Technical Process `ImportInvoices.wrf`.
## Adapter einfügen
1. Ziehen Sie das Element  `Adapter` von der Sicht **Palette** neben das Element  `Start` in den Editor.
2. Doppelklicken Sie auf das Element  `Adapter`.
Das Dialogfenster **Choose Adapter File** wird geöffnet.
3. Wählen Sie den zuvor im Technical Process angelegten Adapter.
4. Klicken Sie auf **OK**.
5. Klicken Sie auf die rechte untere  Ecke des Elements  `Start`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `File_System_Adapter`.
## Adapter konfigurieren
1. Klicken Sie auf den  `File System Adapter` im Editor.
2. Wählen Sie den Wert `Read File` aus der Dropdown-Liste **Operation** in der Sicht **Properties** .
Der Adapter liest nun Daten aus der im Parameter `path` festgelegten Datei.
3. Doppelklicken Sie auf den  `File System Adapter` im Editor.
Der Adapter wird auf einer neuen Registerkarte geöffnet.
4. Tragen Sie den Pfad zur vorzubereitenden XML-Beispieldatei `sampleInvoice.xml` in das Feld des Parameters `path` ein.
5. Klicken Sie auf  **Speichern**.
6. 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  `File System Adapter` 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 step imports/reads a sample invoice file from the local hard drive. You can set the folder + filename in the adapter."
4. Klicken Sie auf **OK**.
5. Passen Sie bei Bedarf die Größe und Position der Textbox an.
▶️
**Nächster Schritt:** [(7.4.4-de) Variable einfügen und Beschreibung hinzufügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/variable-einfugen-und-beschreibung-hinzufugen.md)
---
version: "7.5"
language: "de"
---
# 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 [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
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.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Variable einfügen und Beschreibung hinzufügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/variable-einfugen-und-beschreibung-hinzufugen.md)
**Voraussetzungen:**
Sie haben die vorzubereitende .xml-Beispieldatei angelegt und lokal gespeichert. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
## 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 Process`ImportInvoices` 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 wirdim 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  `InvoiceNumber`im 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  `InvoiceNumber`im 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  `InvoiceNumber`im 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  `InvoiceNumber`im 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 `DateTime`in 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.
▶️
**Nächster Schritt:** [(7.4.4-de) (Optional) Case Management Adapter anlegen und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/optional-case-management-adapter-anlegen-und-einfu.md)
---
version: "7.5"
language: "de"
---
# (Optional) Case Management Adapter anlegen und einfügen
Dieser Schritt ist nur notwendig, wenn Sie den Technical Process in einen BPM Process integrieren möchten. Ansonsten geht es hier weiter mit dem nächsten Schritt: ▶️[(7.4.4-de) Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/endpunkt-einfugen.md) .
In diesem Schritt fügen Sie einen weiteren Adapter in Ihren Technical Process ein, um die benötigte Struktur der Fachdaten für einen Business Process in eine Domain-Model-Datei (`.domainmodel`) zu überführen.
Für dieses Beispiel benötigen Sie den Adapter Case Management. Diese Adapter bildet die Schnittstelle zur „Case Management"-Funktionalität der Produktkomponente X4 BPM. Weitere Informationen finden Sie auf der Seite [(7.4.4-de) Case Management 1](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpm/case-management.md).
Mit diesem Adapter sollen die aus den Rechnungsdokumenten ausgelesenen Informationen mithilfe der Operation `SetFeatures` als Features in einem BPM Process erfasst werden.
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.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Mapping anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/mapping-anlegen-einfugen-und-konfigurieren.md)
## Adapter anlegen
1. Rechtsklicken Sie auf den Technical Process`ImportInvoices` in der Sicht **Projects** und wählen Sie **New** \> **Adapter...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
2. Geben Sie im Suchfeld den Wert `Case Management` ein und wählen Sie den Case Management Adapter.
Bei Bedarf können Sie den Namen des Adapters im Feld **File name** anpassen.
3. Klicken Sie auf **Finish** .
✅ Der Adapter wirdim ESB Project angelegt und öffnet sich automatisch im Editor. Eine weitere Konfiguration des eingefügten Adapters ist in diesem Fall nicht notwendig.
4. Wechseln Sie zurück zum Technical Process `ImportInvoices.wrf`.
## Adapter einfügen und Operation wählen
1. Ziehen Sie das Element  `Adapter` von der Sicht **Palette** neben das Element  `Stylesheet: ExtractCaseFeatures`in den Editor.
2. Doppelklicken Sie auf das Element  `Adapter`.
Das Dialogfenster **Choose Adapter File** wird geöffnet.
3. Wählen Sie den zuvor im Technical Process angelegten Adapter.
4. Klicken Sie auf **OK**.
5. Wählen Sie als `Operation` in der Sicht **Properties** den Wert `SetFeatures`.
6. Klicken Sie auf die rechte untere  Ecke des Elements  `Stylesheet: ExtractCaseFeatures`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `Case_Management`.
## 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.: "The Case Management adapter "feeds" these Features into the data model = "Case Domainmodel" of a BPM process."
4. Klicken Sie auf **OK**.
5. Passen Sie bei Bedarf die Größe und Position der Textbox an.
▶️
**Nächster Schritt:** [(7.4.4-de) Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/endpunkt-einfugen.md)
---
version: "7.5"
language: "de"
---
# Technical Process anlegen (.wrf)
In einem ESB Project arbeiten Sie mit sogenannten teschnischen Prozessen (Technical Processes \*.wrf), um Ihre technischen Prozesse zu erstellen und grafisch zu modellieren. In diesen WRF-Dateien können Sie einen grafischen Editor verwenden, um die einzelnen Schritte Ihrer Prozesse abzubilden.
Für unser Beispiel-ESB Project modellieren wir den Prozess "Import invoices" und müssen im ersten Schritt einen Technical Process anlegen.
**So legen Sie den Technical Process an**
**Voraussetzungen:**
Sie haben ein ESB Project in der Sicht **Projects** angelegt. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md).
1. Doppelklicken Sie auf das angelegte ESB Project in der Sicht **Projects**.
2. Rechtsklicken Sie auf den Ordner **Processes**.
3. Wählen Sie **New** \> **Technical Process...** .
Das Dialogfenster **Process Creation Wizard** wird geöffnet.
4. Geben Sie im Textfeld **File name** den Namen `ImportInvoices` für Ihren Prozess ein.
5. Klicken Sie auf **Finish** .
✅ Der Prozess ist im Ordner **Processes**angelegt.
6. Doppelklicken Sie auf den Prozess, um ihn im Editor zu öffnen.
Der Prozess enthält bereits automatisch einen Start und einem Endpunkt.
7. Löschen Sie zunächst alle Elemente außer dem Element  `Start`, um das hier beschriebene Beispiel umzusetzen.
▶️
**Nächster Schritt:** [(7.4.4-de) File System Adapter anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/file-system-adapter-anlegen-einfugen-und-konfiguri.md)
---
version: "7.5"
language: "de"
---
# Variable einfügen und Beschreibung hinzufügen
In diesem Schritt fügen Sie eine Variable in den Technical Process ein, um temporär die Daten aus der eingelesenen Datei zu speichern. Diese gespeicherten Daten können Sie im nächsten Prozessschritt weiterverwenden.
◀️
**Vorheriger Schritt:** [(7.4.4-de) File System Adapter anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/file-system-adapter-anlegen-einfugen-und-konfiguri.md)
## Variable einfügen
1. Ziehen Sie das Element  `Variable` von der Sicht **Palette** neben das Element  `File System Adapter` in den Editor.
2. Klicken Sie auf das Element  `Variable`.
3. Tragen Sie einen Namen in das Feld **Name** in der Sicht **Properties** ein, z. B. `INPUT`.
4. Wählen Sie den Wert `Put` aus der Dropdown-Liste **Operation** in der Sicht **Properties**, damit die Daten aus dem vorherigen Prozessschritt in der Variable gespeichert werden.
5. Klicken Sie auf die rechte untere  Ecke des Elements  `File System Adapter`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `Put INPUT`.
## Beschreibung hinzufügen
1. Ziehen Sie das Element  `Textbox` von der Sicht **Palette** unter das Element  `Put INPUT` 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 intermediate step uses a "context variable" to save the invoice in its original format to the memory (for the time the process is running)."
4. Klicken Sie auf **OK**.
5. Passen Sie bei Bedarf die Größe und Position der Textbox an.
▶️
**Nächster Schritt:** [(7.4.4-de) Mapping anlegen, einfügen und konfigurieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project/mapping-anlegen-einfugen-und-konfigurieren.md)
---
version: "7.5"
language: "de"
---
# Beispiel: Web App Project
Im X4 Designer verwenden Sie sogenannte Web App Projects, um modellierte technische Prozesse ohne Programmierkenntnisse über eine Web-Anwendung anzeigen und ausführen können. Web App Projects enthalten neben einer vordefinierten Ordnerstruktur die zentrale Definitionsdatei `.wad` und werden automatisch als Web-Anwendung im X4 Server registriert.
Für dieses Beispiel erstellen Sie eine Web App, die eine Liste von Kundendaten im Browser anzeigt. Dafür erstellen Sie zusätzlich zur Web App einen Technical Process, der Daten von Ihrem Rechner einliest und für die Darstellung in der Web App transformiert. Dabei repräsentiert der Technical Process das "Backend" Ihrer Web App, während die Component der Web App das "Frontend" der Applikation definiert.
## Vorzubereitende Datei
Um die in diesem Kapitel beschriebene Web App umzusetzen, müssen Sie folgende Datei vorbereiten und auf Ihrem lokalen Rechner speichern.
**So legen Sie die Datei** `Customers.csv`**an**
* Legen Sie eine neue CSV-Datei mit folgendem Inhalt an. Dazu können Sie beliebige Software verwenden.
"CustomerID","CompanyName","ContactName","ContactTitle","Address","PostalCode"
"ALFKI","Alfreds Futterkiste","Maria Anders","Sales Representative","Obere Str. 57","12209"
"ANATR","Ana Trujillo Emparedados y helados","Ana Trujillo","Owner","Avda. de la Const. 2222","05021"
"ANTON","Antonio Moreno Taqueria","Antonio Moreno","Owner","Mataderos 2312","05023"
"AROUT","Around the Horn","Thomas Hardy","Sales Representative","120 Hanover Sq.","WA1 1DP"
"BERGS","Berglunds snabbkop","Christina Berglund","Order Administrator","Berguvsvägen 8","S-958 22"
"BLAUS","Blauer See Delikatessen","Hanna Moos","Sales Representative","Forsterstr. 57","68306"
"BLONP","Blondel père et fils","Frédérique Citeaux","Marketing Manager","24, place Kléber","67000"
"BOLID","Bólido Comidas preparadas","Martín Sommer","Owner","C/ Araquil, 67","28023"
"BONAP","Bon app'","Laurence Lebihan","Owner","12, rue des Bouchers","13008"
"BOTTM","Bottom-Dollar Markets","Elizabeth Lincoln","Accounting Manager","23 Tsawassen Blvd.","T2F 8M4"
## Relevante Ordner und Dateien
Wenn Sie ein Web App Project anlegen, ist automatisch eine vordefinierte Projektstruktur vorhanden. In dieser Projektstruktur sind bestimmte Komponenten, Dateien und Ordner ebenfalls automatisch vorhanden.
Ausführliche Informationen zum Aufbau eines Web App Projects finden Sie auf der Seite [(7.4.4-de) Aufbau eines Web App-Projekts](https://docs.softproject.de/de/x4documentation/7.5.3/x4-web-apps-2/aufbau-eines-web-app-projekts.md).
Für das hier beschriebene Beispiel sind die folgenden Ordner und Dateien relevant:
| **Name** | **Typ** | **Beschreibung** |
|-------------------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Components** | Ordner | Dieser Ordner enthält separate Definitionen für die einzelnen Components. Eine neue Web App enthält automatisch den Component `Dashboard.detail`. |
| **Services** | Ordner | In diesem Ordner legen Sie Ihre verwendeten Dateien und Technical Processes ab. Dabei speichern Sie Adapter im **Adapters** Ordner, Prozesse im **Processes**Ordner usw. |
| **\.wad** | WAD-Datei | Datei mit der Definition der Web App. Diese Datei wird beim Anlegen eines Web App Projects automatisch angelegt und kann nicht gelöscht werden. |
Auf den folgenden Seiten finden Sie die nächsten Schritte im Beispielprojekt:
* [List Component anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/list-component-anlegen.md)
* [Technical Process für Web App anlegen (.wrf)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-fur-web-app-anlegen-wrf.md)
* [Technical Process definieren: CSV Converter](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-csv-converter.md)
* [Technical Process definieren: Buffer](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-buffer.md)
* [Technical Process definieren: Mapping](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-mapping.md)
* [Technical Process definieren: Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-endpunkt-einfugen.md)
* [List Component konfigurieren und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/list-component-konfigurieren-und-einfugen.md)
* [Web App im Browser öffnen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/web-app-im-browser-offnen.md)
* [Ergebnis: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/ergebnis-web-app-project.md)
---
version: "7.5"
language: "de"
---
# Ergebnis: Web App Project
✅ Sie haben nun erfolgreich eine Web App zum Anzeigen von Kundendaten erstellt.
Der Technical Process ProcessWebApp steuert das "Backend", liest Daten in das System und transformiert diese für die Darstellung in der Web App. Die List Component zeigt die transformierten Daten dynamisch in der Web App an.
Der modellierte Technical Process sollte folgendermaßen aussehen:
Um zu testen, ob Sie den Technical Process korrekt modelliert haben, können Sie den Prozess debuggen, d.h. auf syntaktische Fehler prüfen. Eine ausführliche Beschreibung, wie Sie dabei vorgehen, finden Sie unter [(7.4.4-de) Technical Process debuggen](https://docs.softproject.de/de/x4documentation/7.5.3/x4-esb/prozesse-debuggen-und-ausfuhren/technical-process-debuggen.md).
---
version: "7.5"
language: "de"
---
# List Component anlegen
Sie können nun mit der Gestaltung der einzelnen Elemente Ihrer Web App beginnen.
Web-Anwendung bestehen aus verschiedenen Components, die die Darstellung der Daten in der Web App definieren und jeweils in einer separaten Datei definiert werden. Diese die Components werden dann in der WAD-Datei des Web App Projects im Bereich `` über das Element `` referenziert.
Jedes neu angelegte Web App Project enthält bereits die Component `Dashboard.detail`.
Für das hier beschriebene Beispielprojekt legen Sie eine List Component an, um Kundendaten in der Web App abzubilden. Eine List Component zeigt dynamisch generierte Listen an. Dazu benötigt die Component einen entsprechenden Hintergrundprozess, der bestimmt, welche Daten angezeigt werden sowie Daten und Informationen darüber, wie die Daten angezeigt werden sollen. Im ersten Schritt legen Sie die Component an.
**So legen Sie die List Component an**
**Voraussetzungen:**
Sie haben ein Web App Project in der Sicht **Projects** angelegt. Weitere Informationen finden Sie auf der Seite [(7.4.4-de) Neue Projekte anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/neues-projekt-anlegen.md).
1. Rechtsklicken Sie auf den Ordner`Components` in Ihrem Web App Project in der Sicht **Projects** und wählen Sie **New** \> **List Component...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
1. Bei Bedarf können Sie den Namen des Stylesheets im Feld **File name** anpassen.
2. Klicken Sie auf **Finish** .
✅ Die List Component wirdim Web App Project angelegt und öffnet sich automatisch im Editor. Die weitere Konfiguration der eingefügten Component erfolgt in einem späteren Schritt.
▶️
**Nächster Schritt:** [(7.4.4-de) Technical Process für Web App anlegen (.wrf)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-fur-web-app-anlegen-wrf.md)
---
version: "7.5"
language: "de"
---
# List Component konfigurieren und einfügen
In diesem Schritt referenzieren Sie den neu angelegten Technical Process in der List Component und konfigurieren die Darstellung der Daten.
Dafür fügen Sie im Bereich `` für jedes zuvor im Mapping angelegte XML-Element eine Property ein. Anschließend definieren Sie die Spalten der anzuzeigenden Liste im Bereich ``.
Danach referenzieren Sie die neu gebaute List Component in der WAD-Datei Ihrer Web App. Diese Datei enthält die Definition Ihrer Web App, wird beim Anlegen eines Web App Projects automatisch angelegt und kann nicht gelöscht werden. Hier fügen Sie neue Module oder Komponenten zu Ihrer Web App hinzu.
Mithilfe der Tastenkombination STRG+LEERTASTE können Sie sich im Editor verfügbare Elemente und Parameter anzeigen lassen.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process definieren: Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-endpunkt-einfugen.md)
## Prozess referenzieren
1. Öffnen Sie die Component `Customer_list.list` im Editor.
2. Ergänzen Sie die zweite Zeile der Component um den Wert `process=".wrf"`:
Sie können den entsprechenden Technical Process auch mittels Drag und Drop zwischen die Anführungszeichen ziehen.
3. Klicken Sie auf  **Speichern**.
## Properties einfügen
1. Fügen Sie im Bereich `` für das Element `Customer` eine Property vom Typ `Complex` ein:
2. Fügen Sie innerhalb der Property `Customer` weitere Properties vom Typ `String` für alle weiteren untergeordneten XML-Elemente ein:
3. Klicken Sie auf  **Speichern**.
## Spalten festlegen
1. Legen Sie im Bereich `` eine Spalte für jede Property der Property `Customer` an:
2. Legen Sie mithilfe des Attributs `displayName` die anzuzeigenden Namen der Spalten fest:
3. Klicken Sie auf  **Speichern**.
## List Component in Web App einfügen
1. Öffnen Sie die WAD-Datei Ihrer Web App.
2. Fügen Sie im Bereich `` eine neue `` mit den folgenden Werten ein:
3. Klicken Sie auf  **Speichern**.
▶️
**Nächster Schritt:** [(7.4.4-de) Web App im Browser öffnen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/web-app-im-browser-offnen.md)
---
version: "7.5"
language: "de"
---
# Technical Process definieren: Buffer
In diesem Schritt legen Sie einen sogenannten Buffer an, eine neue XML-Datei, die das Ergebnis der Konvertierung der CSV-Datei zwischenspeichert.
Buffer können in beliebigen Prozessen verwendet werde, um temporäre Daten für die Weiterverarbeitung zwischenzuspeichern. Für den hier beschriebenen Beispielprozess benötigen Sie den Buffer, um die aus der CSV-Datei erzeugte XML-Struktur so zu transformieren, dass Sie der gewünschten Datenstruktur in der Web App entspricht.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process definieren: CSV Converter](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-csv-converter.md)
## Temporäre XML-Datei anlegen
1. Rechtsklicken Sie auf den Ordner **Services** \> **TemporaryFiles** in der Sicht **Projects**.
2. Klicken Sie auf **New \> XML Document...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
3. Bei Bedarf können Sie den Namen des XML-Dokuments im Feld **File name** anpassen, z. B. `Buffer.xml`.
4. Klicken Sie auf **Finish** .
✅ Das Dokument wird im Ordner **TemporaryFiles**angelegt und öffnet sich automatisch im Editor.
5. Wechseln Sie zurück zum Technical Process `ProcessWebApp.wrf`.
## Buffer einfügen
1. Ziehen Sie das Element  `XML` von der Sicht **Palette** neben das Element  `CSV_Converter` in den Editor.
2. Wählen Sie den Wert `Write` im Feld **Operation** in den **Properties**des Elements, um ein XML-Dokument mit den Daten aus dem vorangegangenen Prozessschritt zu speichern.
3. Klicken Sie auf die  Schaltfläche im Feld **Document** in der Sicht **Properties** .
Das Dialogfenster **Choose XML Input** wird geöffnet.
4. Wählen Sie die zuvor angelegte XML-Datei `Buffer.xml`.
5. Klicken Sie auf **OK**.
6. Klicken Sie auf die rechte untere  Ecke des Elements  `CSV_Converter`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `Buffer`.
## `Buffer.xml` befüllen
Um mit der Datei `Buffer.xml` im Prozess weiterarbeiten zu können, müssen Sie den Prozess einmal Debuggen und so die Daten aus der importierten CSV in die angelegte XML-Datei zu transportieren. Zum Debuggen fügen Sie vorübergehend einen `Stop` in den Prozess ein.
1. Ziehen Sie das Element  `Stop` von der Sicht **Palette** neben das Element  `Buffer` in den Editor.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `Buffer`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `Stop`.
3. Klicken Sie auf das Element  `Start` im Editor.
4. Klicken Sie auf die Schaltfläche  **Start Debugging** in der Symbolleiste.
5. Klicken Sie auf die Schaltfläche  **Step Into** in der Symbolleiste bis Sie alle Schritte des Prozesses durchlaufen haben.
✅ Die Datei `Buffer.xml` ist mit den Daten aus der importierten Datei `customers.csv` befüllt.
6. Entfernen Sie das Element  `Stop` wieder aus dem Prozess, indem Sie mit der Maus auf das Element zeigen und auf die  Schaltfläche klicken.
▶️
**Nächster Schritt:** [(7.4.4-de) Technical Process definieren: Mapping](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-mapping.md)
---
version: "7.5"
language: "de"
---
# Technical Process definieren: CSV Converter
In diesem Schritt legen Sie die ersten Prozessschritte des Technical Processes fest. Dabei soll die für dieses Beispiel vorbereitete CSV-Datei in das System importiert und für die Darstellung in der Web App in ein XML-Format transformiert werden.
Dafür verwenden Sie den Adapter CSV Converter. Dieser Adapter liest ein CSV-Textdokument aus dem vorhergehenden Prozess-Schritt ein und gibt für die angegebenen Datensätze ein XML-Dokument in UTF-8-Zeichenkodierung aus, das anschließend zu weiteren Verarbeitung zwischengespeichert werden kann.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process für Web App anlegen (.wrf)](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-fur-web-app-anlegen-wrf.md)
**Voraussetzungen:**
Sie haben die vorzubereitende CSV-Beispieldatei angelegt und lokal gespeichert. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md).
## Ressource importieren
1. Rechtsklicken Sie auf den Ordner **Services** \> **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 gewünschte Datei auf Ihrem Rechner.
✅ Die importierte Datei wird im Ordner **Resources**angezeigt.
## Beispieldatei in den Prozess einfügen
1. Ziehen Sie die importierte Datei von der Sicht **Projects** neben das Element  `Start` in den Editor.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `Start`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `customers`.
## Adapter anlegen und konfigurieren
1. Rechtsklicken Sie auf den Ordner **Services** \> **Adapters** in der Sicht **Projects** und wählen Sie **New** \> **Adapter...** .
Das Dialogfenster **File Creation Wizard** wird geöffnet.
2. Geben Sie im Suchfeld den Wert `CSV` ein und wählen Sie den CSV Converter.
Bei Bedarf können Sie den Namen des Adapters im Feld **File name** anpassen.
3. Klicken Sie auf **Finish** .
✅ Der Adapter wirdim Ordner **Adapters**angelegt und öffnet sich automatisch im Editor.
4. Für die Zwecke dieses Beispiels müssen Sie nur zwei Werte der Parameter des Adapters anpassen:
1. Aktivieren Sie das Kontrollkästchen des Parameters `columnNamesInFirstRow`, damit die Datenfelder der ersten Zeile in der CSV-Textdatei als Spaltenbezeichnungen interpretiert werden und Datenfeld-Elemente im XML-Dokument entsprechend benannt werden.
2. Da die Werte in der verwendeten Beispieldatei mittels Kommata getrennt sind, tragen Sie den Wert `,` in das Feld `delimiter` ein.
5. Klicken Sie auf  **Speichern**.
6. Wechseln Sie zurück zum Technical Process `ProcessWebApp.wrf`.
## Adapter einfügen
1. Ziehen Sie das Element  `Adapter` von der Sicht **Palette** neben das Element  `Start` in den Editor.
2. Doppelklicken Sie auf das Element  `Adapter`.
Das Dialogfenster **Choose Adapter File** wird geöffnet.
3. Wählen Sie den zuvor im Ordner **Adapters**angelegten Adapter.
4. Klicken Sie auf **OK**.
5. Wählen Sie den Wert `Parse` im Feld **Operation** in den **Properties**des Adapters, damit das Dokument in einem Schritt eingelesen wird.
6. Klicken Sie auf die rechte untere  Ecke des Elements  `customers`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element  `CSV_Converter`.
▶️
**Nächster Schritt:** [(7.4.4-de) Technical Process definieren: Buffer](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-buffer.md)
---
version: "7.5"
language: "de"
---
# Technical Process definieren: Endpunkt einfügen
Im diesem Schritt legen Sie den Endpunkt Ihres Technical Processes fest.
**So legen Sie den Endpunkt fest**
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process definieren: Mapping](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-mapping.md)
1. Ziehen Sie das Element  `Stop` von der Sicht **Palette** neben das Element  `Stylesheet`.
2. Klicken Sie auf die rechte untere  Ecke des Elements  `Stylesheet`, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zu dem Element  `Stop`.
▶️
**Nächster Schritt:** [(7.4.4-de) List Component konfigurieren und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/list-component-konfigurieren-und-einfugen.md)
---
version: "7.5"
language: "de"
---
# 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.
◀️
**Vorheriger Schritt:** [(7.4.4-de) Technical Process definieren: Buffer](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-buffer.md)
**Voraussetzungen:**
Sie haben die vorzubereitende CSV-Beispieldatei angelegt und lokal gespeichert. Weitere Informationen finden Sie unter [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md).
## Mapping anlegen
1. Rechtsklicken Sie auf den Technical Process`ProcessWebApp.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 wirdim 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  `Stylesheet`im 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 `Ok`im 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`.
▶️
**Nächster Schritt:** [(7.4.4-de) Technical Process definieren: Endpunkt einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-endpunkt-einfugen.md)
---
version: "7.5"
language: "de"
---
# Technical Process für Web App anlegen (.wrf)
In diesem Schritt legen Sie fest, welche Daten mit welcher Struktur in der neuen Component Ihrer Web App angezeigt werden. Für dieses Beispiel legen Sie dafür einen Technical Process an, der als "Backend" der Component dient, indem er Daten von Ihrem Rechner einliest und für die Darstellung in der Web App transformiert.
**So legen Sie den Technical Process für die Web App an**
◀️
**Vorheriger Schritt:** [(7.4.4-de) List Component anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/list-component-anlegen.md)
1. Doppelklicken Sie auf das angelegte Web App Project in der Sicht **Projects**.
2. Rechtsklicken Sie auf den Ordner **Services** \> **Processes**.
3. Wählen Sie **New** \> **Technical Process...** .
Das Dialogfenster **Process Creation Wizard** wird geöffnet.
4. Geben Sie im Textfeld **File name** den Namen `ProcessWebApp`für Ihren Prozess ein.
5. Klicken Sie auf **Finish** .
✅ Der Prozess ist im Ordner **Processes**angelegt.
6. Doppelklicken Sie auf den Prozess, um ihn im Editor zu öffnen.
Der Prozess enthält bereits automatisch einen Start und einem Endpunkt.
7. Löschen Sie zunächst alle Elemente außer dem Element  `Start`, um das hier beschriebene Beispiel umzusetzen.
▶️
**Nächster Schritt:** [(7.4.4-de) Technical Process definieren: CSV Converter](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/technical-process-definieren-csv-converter.md)
---
version: "7.5"
language: "de"
---
# Web App im Browser öffnen
Sie können Ihr Web App Project jederzeit in Ihrem Standardbrowser öffnen.
**Hinweis:**
Beachten Sie, dass die Web App nur Components anzeigt, die bereits in die Web App integriert wurden.
**So öffnen Sie Ihre Web App im Browser**
◀️
**Vorheriger Schritt:** [(7.4.4-de) List Component konfigurieren und einfügen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/list-component-konfigurieren-und-einfugen.md)
1. Rechtklicken Sie auf das Web App Project in der Sicht **Projects**.
2. Klicken Sie auf **Open Web App in browser** .
✅ Die Web App wird in Ihrem Standardbrowser geöffnet.
3. Loggen Sie sich mit Ihren Zugangsdaten ein.
✅ Die Web App sollte im linken Bereich unter dem **Dashboard** den neuen Bereich **Customers**mit der konfigurierten Liste anzeigen.
▶️
**Nächster Schritt:** [(7.4.4-de) Ergebnis: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project/ergebnis-web-app-project.md)
---
version: "7.5"
language: "de"
---
# Einrichtung und Lizenzen
Bevor Sie mit der Projektarbeit loslegen können, müssen Sie X4 BPMS installieren und einrichten.
## Installation
Bevor Sie mit X4 BPMS arbeiten können, müssen Sie zunächst die Installationskomponenten unter Beachtung der Systemvoraussetzungen installieren: X4 Server, X4 Designer und einen OIDC-konformen Identity Provider.
Weitere Informationen zu den Systemvoraussetzungen finden Sie auf der Seite [X4 Systemvoraussetzungen 7.5.0](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-systemvoraussetzungen.md).
Weitere Informationen zu den verfügbaren Installationspaketen und zum Installationsprozess finden Sie auf der Seite [X4 Installation](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-installation.md) und den entsprechenden Unterseiten.
**Hinweise:**
* Wenn Sie eine Testlizenz angefordert haben, erhalten Sie mit der Testlizenz ein PDF-Dokument mit einer Installationsanleitung.
* Im [Download-Bereich der SoftProject-Website](https://www.softproject.de/de/x4-bpms/downloads/) finden Sie ein Video-Tutorial, das Sie in wenigen Minuten durch die Installation des All-in-One-Installationspakets führt.
## Weitere Schritte nach der Installation
Nachdem Sie alle Komponenten der X4 BPMS installiert haben, müssen Sie noch einige Schritte durchführen, um den X4 Designer einzurichten.
Sie müssen den X4 Server starten, den X4 Designer mit dem X4 Server verbinden und eine Lizenz installieren.
**Hinweis:**
Auf der SoftProject-Website können Sie eine kostenlose [Testlizenz anfordern](https://www.softproject.de/de/kontakt-demo/). Für ein Livesystem verwenden Sie die Lizenz, die Sie vom SoftProject-Support-Team erhalten haben.
Weitere Informationen zu den einzelnen Schritten finden Sie auf den entsprechenden Unterseiten:
* [X4 Server und Identity Provider starten](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/einrichtung-und-lizenzen/x4-server-und-keycloak-starten.md)
* [X4 Designer mit dem X4 Server verbinden](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/einrichtung-und-lizenzen/verbindung-mit-dem-x4-server-herstellen.md)
* [Lizenz installieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/einrichtung-und-lizenzen/lizenz-installieren.md)
---
version: "7.5"
language: "de"
---
# Lizenz installieren
Wenn Sie den X4 Designer zum ersten Mal starten und mit dem X4 Server verbinden, werden Sie aufgefordert, eine gültige Lizenz zu installieren.
**Hinweis:**
Auf der SoftProject-Website können Sie eine kostenlose [Testlizenz anfordern](https://www.softproject.de/de/kontakt-demo/). Für ein Livesystem verwenden Sie die Lizenz, die Sie vom SoftProject-Support-Team erhalten haben.
**So installieren Sie eine Lizenz**
**Voraussetzungen**
* Der X4 Server wurde gestartet.
* Der Identity Provider wurde gestartet.
* Sie haben eine gültige Lizenz erhalten.
1. Klicken Sie auf das Symbol  in der X4 Designer Symbolleiste.
Wenn Sie noch keine Lizenz installiert haben, öffnet sich ein Dialogfenster.
2. Klicken Sie auf **Install license**.
3. Wählen Sie Ihre X4-Lizenzdatei aus, und klicken Sie auf **Öffnen** .
✅ Ihre X4-Lizenz ist nun installiert. Sie sehen in der Statusleiste am unteren Rand des Bildschirms, wie lange Ihre aktuelle Lizenz gültig ist.
---
version: "7.5"
language: "de"
---
# X4 Designer mit dem X4 Server verbinden
Bevor Sie mit dem X4 Designer arbeiten können, müssen Sie zunächst den X4 Designer starten und die Verbindung mit dem X4 Server herstellen.
**Hinweis:**
Der X4 Designer kann ohne eine Verbindung zum X4 Server nicht in vollem Funktionsumfang genutzt werden, da der X4 Server die für die Nutzung des X4 Designers notwendigen Prozesse im Hintergrund steuert.
## X4 Designer starten
**Voraussetzungen:**
* Der X4 Server wurde gestartet.
* Der Identity Provider wurde gestartet.
1. Öffnen Sie Ihren X4 Installationsordner.
2. Doppelklicken Sie auf die Verknüpfung **X4 Designer** .
✅ Der X4 Designer öffnet sich.
## Mit dem X4 Server verbinden
**Voraussetzungen:**
Der X4 Designer wurde gestartet.
1. Klicken Sie im X4 Designer auf das Symbol  , um den X4 Designer mit dem X4 Server zu verbinden.
Wenn noch keine Verbindung hergestellt ist, ist dieses Symbol das einzige Symbol, das in der Symbolleiste angezeigt wird.
✅ Der X4 Designer ist nun mit dem X4 Server verbunden.
2. Falls Sie noch keine Lizenz installiert haben, werden Sie aufgefordert, eine gültige Lizenz zu installieren.
▶️
**Nächster Schritt:** [Lizenz installieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/einrichtung-und-lizenzen/lizenz-installieren.md)
---
version: "7.5"
language: "de"
---
# X4 Server und Identity Provider starten
Der erste Schritt nach der Installation ist, den X4 Server und den OIDC-konformen Identity Provider zu starten.
**Hinweise:**
* Der X4 Designer kann ohne eine Verbindung zum X4 Server nicht in vollem Funktionsumfang genutzt werden, da der X4 Server die für die Nutzung des X4 Designers notwendigen Prozesse im Hintergrund steuert.
## X4 Server in der Konsole starten
**Voraussetzungen:**
* Alle X4 BPMS-Komponenten sind installiert.
* Der X4 Server wurde nicht als Windows-Dienst installiert. Dazu deaktivieren Sie während der Installation das Kontrollkästchen **Install X4 Server as Service**.
1. Öffnen Sie Ihren X4 Installationsordner.
2. Doppelklicken Sie auf die Verknüpfung **start X4 Server**, um den X4 Server zu starten.
**Hinweis:**
Wenn Sie während der Installation die Kontrollkästchen **Create desktop icon for X4 Server** und **Create desktop icon for X4 Designer** aktiviert haben, können Sie den X4 Server und den X4 Designer auch starten, indem Sie auf die Verknüpfung auf Ihrem Desktop klicken.
4. Warten Sie, bis im Konsolenfenster **start X4 Server** die Meldung `SUCCESSFULLY` angezeigt wird.
✅ Wenn diese Meldung erscheint, wurde der X4 Server erfolgreich gestartet und ist einsatzbereit.
## Identity Provider starten
* Starten Sie den OIDC-konformen Identity Provider, den Sie für X4 BPMS verwenden möchten.
▶️
**Nächster Schritt:** [X4 Designer mit dem X4 Server verbinden](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/einrichtung-und-lizenzen/verbindung-mit-dem-x4-server-herstellen.md)
---
version: "7.5"
language: "de"
---
# Mit dem X4 Designer arbeiten
In X4 BPMS organisieren Sie Ihre Prozesse und Dateien in Projektstrukturen.
Das heißt, Sie legen für unterschiedliche Anwendungsfälle entsprechende Projekte an, in denen Sie mit Dateien wie Prozessen, Adaptern, XML-Dokumenten und Bildern arbeiten. Projekte besitzen eine Dateisystem-Struktur und können beliebige Ordner, Prozesse, Prozessbausteine und andere Dateien enthalten.
In diesem Bereich finden Sie eine erste Einführung in den Aufbau der Oberfläche des X4 Designers sowie grundlegende Beschreibungen der drei gängigsten Projekttypen: BPM Project, ESB Project und Web App Project.
Außerdem lernen Sie, wie Sie neue Projekte aller Typen anlegen, vorhandene Projekte (z. B. Testprojekte, die Sie zu Schulungszwecken erhalten haben) importieren oder selbst angelegte Projekte für den Import in einem anderen System (z. B. Ihrem Livesystem) exportieren.
Alle genannten Informationen finden Sie auf den folgenden Unterseiten:
* [Aufbau des X4 Designers](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/den-x4-designer-kennenlernen.md)
* [Projekttypen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/beispielprojekte-laden.md)
* [Neue Projekte anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/neues-projekt-anlegen.md)
* [Vorhandene Projekte importieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/projekt-importieren.md)
* [Projekte exportieren](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/projekt-exportieren.md)
---
version: "7.5"
language: "de"
---
# Projekttypen
In der X4 BPMS wird zwischen unterschiedlichen Projekttypen unterschieden. Hier stellen wir Ihnen die gängigsten Typen vor.
**Hinweis:**
Bei Bedarf steht Ihnen für jeden der hier erklärten Projekttypen eine Anleitung zur Verfügung, um ein erstes eigenes Testprojekt anzulegen. Die Links zu den entsprechenden Anleitungen finden Sie unter den Beschreibungen des jeweiligen Projekttypen.
## BPM Project
Ein BPM (Business Project Management) Project ist eine Projektart innerhalb der X4 BPMS, mit der Sie Geschäftsprozesse gemäß Notationsstandard BPMN 2.0 visualisieren und modellieren können. BPM Projects enthalten eine vordefinierte Ordnerstruktur, in der beliebig viele Geschäftsprozesse (BPM Processes \*.bpm) angelegt werden können.
Für das Beispiel-BPM Project modellieren Sie den Prozess "Import and approve invoices", der Technical Processes mit manuellen Arbeitsschritten Ihrer Mitarbeiter kombiniert und grafisch abbildet:
[(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md)
### ESB Project
Ein ESB (Enterprise Service Bus) Project ist eine Projektart innerhalb der X4 BPMS, mit der Sie Technical Processes grafisch modellieren und ausführen können. ESB Projects enthalten eine vordefinierte Ordnerstruktur, in der beliebig viele Technical Processes (\*.wrf) angelegt werden können.
Innerhalb von ESB Projects können Sie technische Prozesse erstellen und grafisch modellieren. Alle Prozessbausteine werden dabei einfach per Drag \& Drop in die Zeichnungsfläche übernommen. Dort können sie nach der Parametrierung direkt über das integrierte Debugging-Werkzeug getestet oder per Mausklick zeit- und ereignisgesteuert auf dem X4 Server ausgeführt werden.
Die Einsatzmöglichkeiten von ESB Projects sind sehr vielfältig. Beispiele für die Anwendung sind u.a. elektronischer Datenaustausch zwischen Systemen über die verfügbaren Adapter oder die Transformation von Daten über Mappings.
Für das Beispiel-ESB Project modellieren Sie den Prozess "Import Invoices", um Rechnungsdaten einzulesen und weiterzuverarbeiten:
[(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md)
### Web App Project
Ein Web App Project ist eine Projektart innerhalb der X4 BPMS, mit der Sie modellierte technische Prozesse ohne Programmierkenntnisse über eine Web-Anwendung anzeigen und ausführen können. Ein Web App-Projekt enthält neben einer vordefinierten Ordnerstruktur die zentrale Definitionsdatei `.wad` und wird automatisch als Web-Anwendung im X4 Server registriert.
Mit dem X4 Designer können Sie Web App Projects mit der bereits vor konfigurierten Projektstruktur anlegen. Die vorhandene Business-Logik und statische Ressourcen können dabei einfach in die Web-Anwendungen eingebunden werden.
Die Web-Anwendungen sind responsiv und somit für die Darstellung und Verwendung auf Smartphones, Tablets und klassischen Desktop-PCs optimiert. Über den integrierten Theme-Editor kann die Optik (Farben, Logo, Icons) angepasst werden und mit Hilfe von Sprachdateien können Web-Anwendungen mehrsprachig dargestellt werden. Zusätzlich können rechtliche Informationen, wie ein Impressum oder Information zum Datenschutz, hinterlegt werden.
Für das Beispiel-Web App Project erstellen Sie eine Web App, die eine Liste von Kundendaten im Browser anzeigt:
[(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md)
*** ** * ** ***
**Weitere Informationen:**
* [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md)
* [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md)
* [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md)
---
version: "7.5"
language: "de"
---
# Aufbau des X4 Designers
Wenn Sie den X4 Designer zum ersten Mal öffnen und eine Verbindung zum X4 Server hergestellt haben, sehen Sie folgende Oberfläche:
| 1 | Menüleiste | Über die Menüleiste können Sie verschiedene Funktionen und Editoren des X4 Designers aufrufen. |
| 2 | Symbolleiste | Über die Symbolleiste können Sie verschiedene Funktionen und Anzeigeoptionen aufrufen. Einige Symbole sind nur aktiv, wenn die entsprechende Funktion für das ausgewählte oder geöffnete Element verfügbar ist. Weitere Informationen finden Sie unter [(7.4.4-de) Symbolleiste](https://docs.softproject.de/de/x4documentation/7.4.4/symbolleiste). |
| 3 | Sichten | Sie können die angezeigten Sichten per Drag\&Drop individuell anordnen. |
| 4 | Perspektiven | Über diese Symbole können Sie zwischen den Perspektiven X4 Designer, Debug und BPMN Designer wechseln. |
| 5 | Editoren und Zeichnungsfläche | In diesem Bereich werden Prozesse und Dateien zum Anzeigen und Bearbeiten in Registerkarten geöffnet. |
| 6 | Statusleiste | In der Statusleiste werden der verbundene Server, der Workspace, der angemeldete Benutzer und die Version der X4 BPMS angezeigt. |
|---|-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
---
version: "7.5"
language: "de"
---
# Neue Projekte anlegen
Im X4 Designer organisieren Sie Ihre Prozesse in sogenannten Projekten.
Auf dieser Seite finden Sie eine Anleitung, wie Sie neue, leere Projekte in der Sicht **Projects**anlegen.
Wenn Sie ein neues Projekt anlegen, öffnet sich der **Project Creation Wizard** . Neben der Möglichkeit ein leeres Projekt anzulegen (**Empty**), stehen Ihnen in diesem Wizard auch diverse vorbefüllte Projektvorlagen mit Beispielprozessen zur Verfügung.
Wenn Sie eine dieser Vorlagen auswählen, wird das entsprechende Projekt mit allen vorbefüllten Dateien, Ordnern und Prozessen in Ihren Workspace geladen. Anschließend können Sie die Projekte an Ihre Bedürfnisse und Datenstrukturen anpassen.
Im Bereich "Erste Schritte" finden Sie Beispiele für die drei gängigsten Projekttypen inklusive ausführlicher Anleitungen die Beispiele nachzubilden:
* [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md)
* [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md)
* [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md)
## Leeres Projekt anlegen
**Voraussetzungen:**
Der X4 Designer ist mit dem X4 Server verbunden.
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Wählen Sie unter **New**den gewünschten Projekttyp aus.
Das Dialogfenster **Project Creation Wizard** wird geöffnet.
3. Das Dialogfenster **Project Creation Wizard** wird geöffnet.
4. Geben Sie im Textfeld **Project name** einen Namen für Ihr Projekt ein.
5. Klicken Sie auf **Finish** .
✅ Ihr neues Projekt wurde angelegt, und Sie sehen die erstellte Projektstruktur in der Sicht **Projects**.
## Beispielprojekt aus Vorlage anlegen
Im X4 Designer sind verschiedene Vorlagen für Beispielprojekte vorhanden. Beim Anlegen eines Beispielprojekts können Sie in der Beschreibung der Vorlage nachvollziehen, für welche Zwecke die Vorlage verwendet werden kann.
**Voraussetzungen:**
Der X4 Designer ist mit dem X4 Server verbunden.
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Wählen Sie unter **New**den gewünschten Projekttyp aus.
Das Dialogfenster **Project Creation Wizard** wird geöffnet.
3. Wählen Sie ein gewünschtes Projekt aus den Vorlagen aus.
Im Textfeld auf der rechten Seite erhalten Sie Informationen zum Inhalt der jeweiligen Vorlage.
4. Geben Sie im Textfeld **Project name** einen Namen für Ihr Beispielprojekt ein.
5. Klicken Sie auf **Finish** .
✅ Das ausgewählte Beispielprojekt wurde erstellt.
---
version: "7.5"
language: "de"
---
# Projekte exportieren
Wenn Sie beispielsweise in einem Testsystem bereits Beispielprojekte angelegt haben, können Sie diese Projekte exportieren und in ein Livesystem importieren. So können Sie beispielsweise in einer Testumgebung ausprobieren, welche Prozessabläufe am geeignetsten sind und die finalen Prozesse in ein Produktivsystem überführen.
Weitere Informationen zum Anlegen von Projekten finden Sie auf der Seite [(7.4.4-de) Neue Projekte anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/neues-projekt-anlegen.md).
**Hinweis:**
Im Bereich "Erste Schritte" finden Sie Beispiele für die drei gängigsten Projekttypen inklusive ausführlicher Anleitungen die Beispiele nachzubilden:
* [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md)
* [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md)
* [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md)
**So exportieren Sie ein Projekt**
**Voraussetzungen:**
* Der X4 Designer ist mit dem X4 Server verbunden.
* Die Sicht **Projects**enthält mindestens ein Projekt.
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Klicken Sie auf **Export...**.
3. Wählen Sie den Zielordner aus, in den Sie das Projekt exportieren möchten.
4. Klicken Sie auf **Speichern** .
✅ Das gewünschte Projekt (.zip) wurde exportiert.
*** ** * ** ***
**Weitere Informationen**
* [(7.4.4-de) Neue Projekte anlegen](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/neues-projekt-anlegen.md)
---
version: "7.5"
language: "de"
---
# Vorhandene Projekte importieren
Sie können vorhandene Projekte in den X4 Designer importieren.
Wenn Ihnen beispielweise ein Beispielprojekt als ZIP-Datei zur Verfügung gestellt wurde, können Sie dies zum Ausprobieren der X4 Designer-Funktionen importieren. Auch, wenn Sie in einem Testsystem bereits erste Projekte angelegt haben, können Sie diese exportieren und z. B. in einem Livesystem hochladen.
Weitere Informationen zum Exportieren von vorhandenen Projekten finden Sie auf der Seite [(7.4.4-de) Projekte exportieren 1](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/mit-dem-x4-designer-arbeiten/projekt-exportieren.md).
**Hinweis:**
Im Bereich "Erste Schritte" finden Sie Beispiele für die drei gängigsten Projekttypen inklusive ausführlicher Anleitungen die Beispiele nachzubilden:
* [(7.4.4-de) Beispiel: BPM Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-bpm-project.md)
* [(7.4.4-de) Beispiel: ESB Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-esb-project.md)
* [(7.4.4-de) Beispiel: Web App Project](https://docs.softproject.de/de/x4documentation/7.5.3/erste-schritte-mit-der-x4-bpms/beispiel-web-app-project.md)
**So importieren Sie ein Projekt**
**Voraussetzungen:**
* Der X4 Designer ist mit dem X4 Server verbunden.
* Ihnen liegt ein X4 Designer-Projekt als ZIP-Datei vor, z. B. ein aus einem Testsystem exportiertes Beispielprojekt.
1. Klicken Sie mit der rechten Maustaste in die Sicht **Projects**.
2. Klicken Sie auf **Import...**.
3. Klicken Sie im Dialogfenster **Resource Import Wizard** auf **Browse...** und wählen Sie das zu importierende Projekt (.zip) aus.
4. Ändern Sie den Projektnamen, falls gewünscht, und klicken Sie auf **Finish** .
✅ Das gewünschte Projekt wurde importiert.
---
version: "7.5"
language: "de"
---
# Migrationsleitfaden
Dieser Leitfaden unterstützt Sie bei der Migration von X4 BPMS 7.4. auf Version 7.5.
Sie erfahren:
* welche Änderungen vorgenommen wurden
* welche Funktionen entfernt oder angepasst wurden
* welche Schritte Sie durchführen müssen, damit Ihre Anwendungen weiterhin wie gewohnt funktionieren
*** ** * ** ***
**Weitere Informationen**
* [X4 Web Apps](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-web-apps-1.md)
* [X4 Designer](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-designer-2.md)
* [X4 Server](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-server-1.md)
* [X4 Adapter](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-adapter-2.md)
* [Update Tool](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/update-tool-1.md)
*** ** * ** ***
---
version: "7.5"
language: "de"
---
# Update Tool
Das Update-Tool wurde überarbeitet. In den folgenden Abschnitten finden Sie einen Überblick über die wichtigsten Änderungen. Weitere Informationen finden Sie unter [Update Tool](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/update-tool-1.md).
**Hinweis:**
Sie können das aktuelle Update Tool nach dem offiziellen Release-Datum der X4 BPMS 7.5 über unsere Website anfordern.
## Datenbank aktualisieren
X4 BPMS verwendet eine Datenbank und benötigt eine Datenbankverbindung über JDBC.
## Neue Datenbank einrichten
**Hinweis:**
Die Anleitungen in den folgenden Abschnitten basieren auf der Annahme, dass Sie X4 BPMS und das Datenbankschema zum ersten Mal installieren.
**Aktion erforderlich**
Die Einrichtung einer neuen Datenbank erfolgt in der Regel durch einen Datenbankadministrator.
Für die Verbindung werden folgende Angaben benötigt:
* JDBC-URL (z. B. `jdbc:postgres:...`)
* Datenbankbenutzer
* Passwort
Die JDBC-URL ist datenbankspezifisch und muss auf das korrekte Schema für X4 verweisen.
*** ** * ** ***
### Datenbank vorbereiten
Die im Folgenden angegebenen Anweisungen für [PostgreSQL](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/update-tool-1.md#PostgreSQL), [SQL Server](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/update-tool-1.md#SQL-Server) und [Oracle](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/update-tool-1.md#Oracle) können zum Einrichten der Datenbank verwendet werden.
In den Anweisungen werden folgende Platzhalter verwendet:
* `${schemaName}`: Name des Schemas für die X4-Tabellen (z. B. X4SERVER)
* `${databaseName}`: Name der Datenbank (für SQL Server)
* `${userName}`: Benutzername
* `${userPassword}`: Passwort des Benutzers
**Hinweis:**
Die Anweisungen sollten **einzeln und in der angegebenen Reihenfolge** ausgeführt werden.
### PostgreSQL
SQL
CREATE USER ${userName} WITH PASSWORD '${userPassword}';
CREATE SCHEMA ${schemaName} AUTHORIZATION ${userName};
-- Grant privileges
GRANT CONNECT ON DATABASE ${databaseName} TO ${userName};
GRANT USAGE ON SCHEMA ${schemaName} TO ${userName};
GRANT CREATE ON SCHEMA ${schemaName} TO ${userName};
ALTER USER ${userName} SET search_path TO ${schemaName}, public;
Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden:
jdbc:postgresql://:5432/${databaseName}
In PostgreSQL-Datenbanken sollte `search_path` auf `$user, public` für den X4-Benutzer gesetzt werden.
### SQL Server
SQL
-- Switch to master database to create the server login
USE "master";
CREATE LOGIN ${userName}
WITH PASSWORD = '${userPassword}',
DEFAULT_DATABASE = ${databaseName},
CHECK_EXPIRATION=OFF,
CHECK_POLICY=OFF;
-- Switch to X4 database and create a user mapped to the login
USE ${databaseName};
-- optional: create a schema if it does not exist
CREATE SCHEMA ${schemaName};
CREATE USER ${userName}
FOR LOGIN ${userName}
WITH DEFAULT_SCHEMA = ${schemaName};
ALTER ROLE db_datareader ADD MEMBER ${userName};
ALTER ROLE db_datawriter ADD MEMBER ${userName};
ALTER ROLE db_ddladmin ADD MEMBER ${userName};
Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden (unter Umständen ist ein zusätzlicher Parameter wie `encrypt=false` erforderlich):
jdbc:sqlserver://:1433;databaseName=${databaseName}
### Oracle
SQL
CREATE USER "${userName}" IDENTIFIED BY "${userPassword}";
-- Grant Privileges --
GRANT UNLIMITED TABLESPACE TO ${userName};
GRANT CREATE SESSION TO ${userName};
GRANT CREATE TABLE TO ${userName};
GRANT CREATE SEQUENCE TO ${userName};
GRANT CREATE TRIGGER TO ${userName};
GRANT SELECT ON SYS.DBA_RECYCLEBIN TO ${userName};
Nachdem die Datenbank erfolgreich erstellt wurde, kann mit folgender JDBC-URL eine Verbindung zur Datenbank hergestellt werden (abhängig von Version und Einrichtung der Datenbank):
jdbc:oracle:thin:@:1521:
jdbc:oracle:thin:@//:1521/ --jdbc-user --jdbc-password
*** ** * ** ***
## Vorhandene Datenbank migrieren
Wenn bereits eine ältere Version der X4 BPMS (z. B. 7.4.x) verwendet wird, kann das bestehende Schema aktualisiert werden. Bei der Migration muss unterschieden werden, ob das Schema mit oder ohne Liquibase erstellt wurde.
### Mit Liquibase erstelltes Schema migrieren
Da das verfügbare Schema davon abhängt, wie es installiert wurde, können wir an dieser Stelle kein allgemeingültiges Migrationsskript bereitstellen.
Die grundlegenden Punkte sind jedoch in allen Szenarien identisch:
* Stellen Sie sicher, dass der dedizierte Datenbankbenutzer ähnliche Rechte und Privilegien wie im vorherigen Kapitel beschrieben hat.
* Wenn die Liquibase-Steuertabellen (d.h. `databasechangelog`, `databasechangeloglock`) im Zielschema vorhanden sind, können Sie Folgendes ausführen:
java -jar de.softproject.x4.update-7.5.0.jar --run-database-update --jdbc-url --jdbc-user --jdbc-password
* Wenn sie sich in einem separaten Schema befinden (z. B. `schema_a`), müssen Sie:
* sicherstellen, dass der Datenbankbenutzer in der Lage ist, die Daten dieser Tabellen zu aktualisieren
* den Parameter `--liquibase-schema schema_a` zur Befehlszeile hinzufügen
### Ohne Liquibase erstelltes Schema migrieren
Ein ohne Liquibase erstelltes Schema enthält in der Regel mehr Tabellen als für den Betrieb von X4 erforderlich sind. Alle benötigten Tabellen sind jedoch vorhanden und kompatibel.
Wenn der Datenbankbenutzer alle erforderlichen Rechte und Privilegien besitzt, ist die Migration einfach:
java -jar de.softproject.x4.update-7.5.0.jar --run-database-update --jdbc-url --jdbc-user --jdbc-password
---
version: "7.5"
language: "de"
---
# X4 Adapter
## Adapter
### Keycloak Management
Dieser Adapter wurde intern mit sicheren Bibliotheken überarbeitet und als neuer Adapter mit der Bezeichnung **Keycloak Management 2** in die X4 Adapterdatenbank aufgenommen. Der alte Adapter Keycloak Management steht weiterhin zur Verfügung, damit Sie die Migration auf den neuen Adapter ausführen können.
**Aktion erforderlich**
Sie müssen in Ihren X4 Projekten, die den Keycloak Management Adapter verwenden, eine Migration auf den neuen Adapter vornehmen. Führen Sie dazu die Schritte unter [X4 Adapter \| Migration](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-adapter-2.md#Migration) aus.
### Keycloak Token
Dieser Adapter wurde intern mit sicheren Bibliotheken überarbeitet und als neuer Adapter mit der Bezeichnung **Keycloak Token 2** in die X4 Adapterdatenbank aufgenommen. Der alte Adapter Keycloak Token steht weiterhin zur Verfügung, damit Sie die Migration auf den neuen Adapter ausführen können.
**Aktion erforderlich**
Sie müssen in Ihren X4 Projekten, die den Keycloak Token Adapter verwenden, eine Migration auf den neuen Adapter vornehmen. Führen Sie dazu die Schritte unter [X4 Adapter \| Migration](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-adapter-2.md#Migration) aus.
#### Migration
**Hinweis:**
Die Migration erfolgt für den Keycloak Management Adapter und den Keycloak Token Adapter nach demselben Ablauf. In den folgenden Schritten wird beispielhaft nur der Keycloak Management Adapter genannt und in den Screenshots gezeigt. Übertragen Sie die Schritte entsprechend auf den Keycloak Token Adapter.
**So fügen Sie den neuen Adapter hinzu**
1. Klicken Sie in Ihrem X4 Projekt mit der rechten Maustaste auf den Ordner **Adapters**.
2. Wählen Sie **New** \> **Adapter** aus.
3. Suchen Sie im Dialogfenster **File Creation Wizard** nach dem Adapter Keycloak Management 2.
4. Geben Sie im Feld **File name** einen beliebigen temporären Namen ein.
5. Wählen Sie **Finish** aus.
=\> Der Adapter wird Ihrem X4 Projekt hinzugefügt.
**So migrieren Sie die Adapter-Parameter**
1. Öffnen Sie in Ihrem Projekt beide Keycloak Management Adapter, und zeigen Sie sie nebeneinander an.
2. Übertragen Sie alle Parameter manuell vom alten Adapter auf den neuen Adapter.
**Hinweis:**
Die folgenden Parameter sind in X4 BPMS 7.5 Pflichtparameter:
* `url`
* `realm`
* `clientID`
* `clientSecret`
3. Speichern Sie die Änderungen.
4. Klicken Sie im X4 Projekt mit der rechten Maustaste auf den alten Adapter mit der Bezeichnung **Keycloak Management**.
5. Wählen Sie **Delete** aus.
6. Klicken Sie im X4 Projekt mit der rechten Maustaste auf den neuen Adapter mit dem temporären Namen (**Keycloak Management 2**).
7. Wählen Sie **Rename/Refactor** aus.
=\> Das Dialogfenster **X4 Rename Repository Resource Wizard** wird geöffnet.
8. Benennen Sie den Adapter in den alten Adapternamen um, in diesem Fall **Keycloak_Management.fa**.
**Hinweis:**
* Verwenden Sie exakt den Namen des vorher verwendeten Adapters.
* Achten Sie darauf, dass das Kontrollkästchen **Update References** deaktiviert ist.
9. Wählen Sie **Finish** aus.
=\> Die Migration ist abgeschlossen.
### Google Maps
Der bisherige Google Maps Adapter ist veraltet und basiert intern auf dem HTTP-Adapter.
Für neue Implementierungen wird die Verwendung des Google Maps SDK for Java empfohlen.
Im Zuge der Weiterentwicklung wurde der Adapter überarbeitet und als **Version 2.0.0** bereitgestellt.
**Hinweis:**
Die Dokumentation für den neuen Google Maps Adapter befindet sich aktuell noch in Arbeit und wird zu einem späteren Zeitpunkt in der Onlinehilfe ergänzt.
#### Änderungen an den Adapter-Parametern
Einige Parameter wurden bereinigt oder angepasst.
Die wichtigsten aktuellen Parameter sind:
* `apiKey` (erforderlich) -- API-Schlüssel zur Authentifizierung gegenüber Google Maps
* `privateKey` (optional, nur für `CreateGoogleURL`) -- Signierung von URLs
* `outputFormat` (xml oder json) -- Ausgabeformat der API-Antwort
* `timeout` *(Integer)* -- maximale Zeit für den Verbindungsaufbau in Millisekunden
#### Änderungen an der Authentifizierung
Die Authentifizierung erfolgt jetzt über:
* API Key
* OAuth 2.0 (falls unterstützt)
Der API-Schlüssel wird im Parameter `apiKey` hinterlegt.
#### Verfügbare Adapter-Operationen
Der Adapter stellt folgende Operationen bereit:
* `Geocode` -- Wandelt Adressen in geografische Koordinaten (Längengrad/Breitengrad) um.
* `ReverseGeocode` -- Wandelt Koordinaten in eine lesbare Adresse um.
* `GetRoutes` -- Ersetzt die bisherige Operation `GetDirections`.
Berechnet Routen zwischen zwei oder mehreren Standorten unter Berücksichtigung von Verkehr, Fahrmodus usw.
* `CreateGoogleURL` -- Erstellt URLs für Google APIs, z. B. für statische Kartenbilder.
Optional kann eine Signatur über den Parameter `privateKey` erzeugt werden.
### IBM Websphere MQ Integration
X4 BPMS stellt einen Adapter für die Kommunikation mit IBM Websphere MQ bereit. Aus Lizenzgründen werden die benötigten IBM-JAR-Dateien nicht mitgeliefert.
**Aktion erforderlich**
Sie müssen die JAR-Dateien als Erweiterungsmodul in X4 BPMS einbinden. Führen Sie dazu die folgenden Schritte aus.
1. Laden Sie das Artefakt `com.ibm.mq.allclient` und alle erforderlichen Abhängigkeiten von einem Maven-Repository Ihrer Wahl herunter:
XML
com.ibm.mq
com.ibm.mq.allclient
9.4.4.1
compile
**Hinweis:**
Die Version ist möglicherweise eine andere und muss mit Ihrem MQ-Server kompatibel sein. Weitere Informationen finden Sie in der MQ-Server-Dokumentation.
2. Erstellen Sie die Datei `module.xml` wie folgt:
XML
3. Legen Sie im WildFly-Ordner `modules` den Ordner `com/ibm/mq/allclient/main` an.
4. Kopieren Sie alle heruntergeladenen JAR-Dateien und die erstellte Datei `module.xml` in dieses Verzeichnis.
5. Öffnen Sie die Datei `module.xml` im Ordner `de/softproject/x4/adapter/ibmMQ/main`.
6. Fügen Sie im Abschnitt `` folgende Zeile hinzu:
7. Starten Sie den X4 Server (neu).
=\> Der Adapter sollte nun mit Ihrem MQ-Server kommunizieren können.
### PDF to PDF/A Converter
Der PDF to PDF/A Converter ist nicht im Standardlieferumfang der X4 BPMS enthalten, sondern muss manuell als externer Adapter installiert werden.
**Hinweis:**
Sie können den Adapter nach dem offiziellen Release-Datum der X4 BPMS 7.5 über unsere Website anfordern.
**Aktion erforderlich**
Die Anleitung zum Installieren des Adapters finden Sie unter [PDF to PDF/A Converter \| Installation der Drittbibliotheken](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter/pdf-processing/pdf-to-pdf-a-converter/installation-der-drittbibliotheken-1.md).
### PDF Compression
Der PDF Compression Adapter ist nicht im Standardlieferumfang der X4 BPMS enthalten, sondern muss manuell als externer Adapter installiert werden.
**Hinweis:**
Sie können den Adapter nach dem offiziellen Release-Datum der X4 BPMS 7.5 über unsere Website anfordern.
**Aktion erforderlich**
Die Anleitung zum Installieren des Adapters finden Sie unter [PDF Compression \| Installation der Drittbibliotheken](https://docs.softproject.de/de/x4documentation/7.5.3/x4-bpms-adapter/x4-bpms-standard-adapter/pdf-processing/pdf-adapter-pdf-compression-und-pdf-to-pdf-a-conve/installation-der-drittbibliotheken.md).
---
version: "7.5"
language: "de"
---
# X4 Designer
## Integration von OIDC
Ab Version 7.5 unterstützt der X4 Designer OpenID Connect (OIDC) als Authentifizierungsmethode. Damit ist eine Authentifizierung über einen beliebigen OIDC-konformen Identity Provider möglich. Eine Keycloak-Instanz ist nicht mehr erforderlich.
Im X4 Designer stehen im Dialogfeld **X4 Preferences** unter **Connection Properties** in der Dropdown-Liste **Authentication** jetzt drei Optionen zur Verfügung:
* Basic
* OIDC
* No Auth
Basic
OIDC
No Auth
### Basic
Die Authentifizierungsoption **Basic** funktioniert wie in den vorherigen Versionen:
1. Wählen Sie in der Dropdown-Liste **Authentication** die Option **Basic** aus.
2. Geben Sie Benutzernamen und Passwort ein.
#### OIDC
Für die Verwendung von OIDC müssen Sie die URL Ihres Identity Providers sowie einen Client angeben.
**Beispiel:**
OIDC URL: https://x4-dev-keycloak.azurewebsites.net/realms/OIDC-Test
Client: X4Designer
**Aktion erforderlich**
Damit die Verbindung zum Server mit OIDC funktioniert, sind zusätzliche Anpassungen am Server erforderlich. Die Anleitung finden Sie unter [X4 Server \| Neuerungen bei Verwendung von Keycloak mit OIDC](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-server-1.md).
#### No Auth
Verwenden Sie den No-Auth-Modus nur in Entwicklungs- oder Testumgebungen. In produktiven Umgebungen sollte immer ein Identity Provider verwendet werden.
**Aktion erforderlich**
Um die Authentifizierung **No Auth** zu verwenden, muss diese zunächst auf dem Server aktiviert werden. Die Anleitung finden Sie unter [X4 Server \| OpenID Connect](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-server-1.md).
#### Keycloak mit OIDC verwenden
**Aktion erforderlich**
Wenn Sie eine lokale X4-Keycloak-Instanz verwenden möchten, können Sie diese weiterhin konfigurieren und mit OIDC für die Verbindung nutzen. Die Anleitung finden Sie unter [X4 Server \| Bestehende Keycloak Installation mit OIDC verwenden](https://docs.softproject.de/de/x4documentation/7.5.3/migrationsleitfaden-7-5-0/x4-server-1.md).
*** ** * ** ***
## Änderungen im `.wsinc`-Editor
Im `.wsinc`-Editor wurden in Version 7.5 Änderungen im Bereich **Access Restriction** vorgenommen.
Die folgenden Felder sind veraltet (**deprecated**):
* Realm
* Client ID
* Client Secret
Stattdessen steht das neue Feld **Auth Config Name** zur Verfügung. Dieses Feld wird verwendet, um eine Authentifizierungskonfiguration zu referenzieren, die in der Datei `authentication_config.xml `definiert ist.
[Next Page](https://docs.softproject.de/llms-full.txt/1)