Skip to main content
Skip table of contents

Managing Case Data

To implement cases with X4 BPM, it is required to define a data structure for the business case within the Business Process. In domain model files (.domainmodel) you can define business data structure in a three-staged hierarchy to the process definition, including descriptions.

Structure of Business Case Data

A case's business data is structured in categories, groups, and features:

  • Categories group business data on the highest level containing feature groups. Each category has a name, a position within the tree and an optional description.

  • Groups aggregate business data features of the same category. Each group has a name, a position within the tree and an optional description.

  • Features are specific business data properties, e.g. an order date within a feature group. Each feature has a name, a position within the tree and an optional description, a data type, and an optional default value.

Available data types for features are:

  • String: String

  • Integer: Integers

  • Decimal: Decimals

  • Boolean: Boolean values

  • DateTime: Date and time

Defining Business Case Data

Business case data can be defined both for individual business processes and for the entire project or several business processes.

  1. Right-click the .bpm file in the Repository Navigator view.

  2. Select New > Domain Model in the context menu.

    • If the business case data applies to several Business Processes, the corresponding .domainmodel file is created within the repository folder Activities > DomainModel.
    • If the business case data applies only to one specific Business Process, the corresponding .domainmodel file is created directly below the Business Process. After saving, the .domainmodel file is automatically attached to the Start component.

    The file is now created and opened in X4 Designer.

  3. Define the business data structure and its descriptions.

    • To create a new feature category, click Add or select 

      Add > Category. Then enter a category name (Name) and a corresponding description (Description).

    • To define a feature group, click Add when a category is selected or select

      Add > Group. Then enter a group name (Name) and a corresponding description (Description).

    • To define a feature, click Add when a group is selected or select 

      Add > Feature. Then enter a feature name (Name), a corresponding description (Description), a data type (Type) and a default value for the feature (Default Value). 
      Example:


      • To change the sequence of a selected structure element, click
        or
      • The Delete button allows you to remove a selected entry from the tree.

  4. Click the icon in the toolbar to save.

  5. Drag the .domainmodel file to the desired Business Process.

    .domainmodel files created below the Business Process are automatically attached to the Start component. The business data are therefore available in the process and the related Human Tasks.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.