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.

Create errors

Errors are created by using the Create error capability on the Errors tab of an integration namespace's Overview page.

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 clicking the Edit error details button in the Error Details section on the error's instance page. Alternatively, you can use the Edit capability of each table row on the Errors tab of a integration namespace's Overview page. The fields that can be edited are Error Message and Error Description.

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

Delete errors

You can delete an error by clicking the Delete error button in the upper right corner of the error instance page. Alternatively, you can use the Delete capability of each table row on the Errors tab of a integration namespace's Overview page.

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.