Business errors

These errors reflect business errors and not technical errors. That means, that every time a business condition is not met, a business error is thrown to inform the end user about the reason. errors can be specified for the following elements:

Create errors

Errors are created by using the Create capability on the Errors tab of a domain namespace's Overview page or when editing Commands and Services.

Errors are defined using the following master data:

  • Local Identifier: This is the identifier (name) of the error. It is unique within a namespace. Please note, that only the characters A-z (without special characters), digits and the special character "_" are permitted for naming errors! Furthermore, names may not begin with a digit and the first character must be uppercase. The local identifier can not be changed after creation (required)

  • Error Message: This is a short message that will be used to inform the user about the business condition that is not satisfied (required)

  • Error Description: This is used to give a longer description of the error that occurred (optional)

Edit errors

You can edit the master data of an error by using the Info capability on the error's instance page, navigating to the section Master Data and using the Edit Master Data capability.

The following fields can be edited:

  • Error Message

  • Error Description

Note: It's not possible to edit the Local Identifier of an error.

Delete errors

You can delete an error by using the row capability Delete in the table of the Errors tab of the domain namespace's Overview page. Alternatively, you can use the Info capability on an error's instance page, navigate to the Master Data section and use the Delete capability there.

Attention: You will need to confirm the action before the selected error gets permanently deleted. You can only delete an error if it is not in use. You can check the usages of an error by using the Info capability and navigating to the Usages section.