X4 Produktdokumentation

(Optional) Creating and Inserting a Case Management Adapter

This step is only necessary if you want to integrate the Technical Process into a BPM process. Otherwise, continue with the next step here: ▶️Inserting an End Point .

In this step, you insert another adapter into your Technical Process to transfer the required business data structure for a Business Process into a domain-model file (.domainmodel).

For this example, you need the Case Management adapter. This adapter represents the interface to the "Case Management" functions of the X4 BPM product component. For more information, see Case Management.

With this adapter, the information read from the invoice documents is supposed to be recorded as features in a BPM process using the SetFeatures operation.

We also recommend that you include descriptions of your Technical Process that explain each process step. This way, the individual process steps remain transparent and can also be quickly followed up by new colleagues.

◀️

Creating the adapter

  1. Right-click on the Technical Process in the Projects view and select New > Adapter….
    The File Creation Wizard dialog opens.

  2. Enter the value Case Management in the search field and select the Case Management adapter.
    If necessary, you can customize the name of the adapter in the File name field.

    image-20241017-091952.png
  3. Click Finish.
    ✅ The adapter is created in the ESB Project and opens automatically in the editor. For this example, you do not need to configure the inserted adapter further.

  4. Return to the Technical Process ImportInvoices.wrf.

Inserting the adapter and selecting the operation

  1. Drag the image-20241016-105227.png element from the Palette view next to the image-20241017-063201.png Stylesheet: ExtractCaseFeatures element in the editor.

  2. Double-click the image-20241016-105227.png element.
    The Choose Adapter File dialog opens.

  3. Select the adapter previously created in the Technical Process.

  4. Click OK.

  5. Select the value SetFeatures as the Operation in the Properties view.

  6. Click the lower-right image-20241017-092018.png corner of the image-20241017-063201.png Stylesheet: ExtractCaseFeatures element, hold down the mouse button, and drag a connection to the image-20241017-092335.png Case_Management element.

    image-20241111-125802.png

Adding a description

  1. Drag the image-20241017-063603.png Textbox element from the Palette view next to the image-20241017-063201.png Stylesheet: ExtractCaseFeatures element in the editor.

  2. Double-click the image-20241017-063603.png Textbox element.
    The Text Editor opens.

  3. Enter the desired description text, e.g.: “The Case Management adapter "feeds" these Features into the data model = "Case Domainmodel" of a BPM process.”

  4. Click OK.

  5. If necessary, adjust the size and position of the text box.

    image-20241111-134227.png
▶️