Managing Entities
Create an Entity
You can access an overview page of the existing entities by choosing Entities in the Integration namespace’s navigation area. You create a new entity using the Create capability
In integration namespaces entities do not differ greatly from the entities of the domain namespace. One of the main differences is that Root Entities and external Entities are not allowed in the integration namespaces.
Moreover, the entities that are modeled in the integration namespace are used to map the external object that is returned by the external operation to the current solution. Then this entity can be attached as a known entity to an external entity in the domain namespace, thus, mapping the external object to the domain logic.
Define entity master data
Entities are defined using the following master data:
| Property | Description |
| Local identifier |
This is the local identifier (name) of the entity. 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 entities! Furthermore, local identifiers may not begin with a digit and the first character must be uppercase. The local identifier cannot be changed after creation. This field is mandatory. |
| Abstract | This is a checkbox field. When checked, it indicates that the entity will be abstract. If the field is checked, no instances of this entity can be created by the Solution Envoy environment. The default value is unchecked. This field is only available for Entities and Root entities. |
| Label |
This is used to label the entity.
This field is mandatory. |
| Short label |
This is used to give an even shorter label.
This field is optional. |
| Notes |
This is a long description of the entity and its lifecycle.
This field is optional. |
| Parents | This specifies one or more entities from which the new entity is meant to inherit properties and commands. Entities can only add other entities as parents and root entities other root entities. This field is only available for Entities and Root entities. |
You can also use the Open after creation checkbox to open the entity for further editing after saving.
Edit an Entity
You edit the master data using the Information capability on the entity instance page. When editing all types of entities, you can overwrite the values for label, short label and notes. It is not possible to overwrite the type and the local identifier
The overwritten values are lost as soon as the editing action has been completed.
Delete an entity
You can delete the entity by using the inline Delete capability. Alternativerly, you can use the Information capability to access the details view and there you can use the Delete capability.
You will need to confirm the action before the selected response is permanetely deleted.