Interacting with an Entity editor Object
The following image shows of a full-featured Entity editor associated with an Entity and its interactive elements:
Depending on its configuration, the Entity editor may offer the following options:
- The Code field and the Description field allow you to select existing Entity members. Click on the down facing arrows to open the list of members codes or the list of members descriptions
- Filter (): allows to make a selection on a parent Entity in order to reduce the amount of members displayed in the Code and the Description fields
- Reset selection (): clears the current selection
- Insert new member (): allows to create a new Entity member. See How to create a new Entity member for more details
- Edit existing member (): allows to modify the relationships and the description of an existing Entity member. See How to edit an existing Entity member for more details
- Edit member's description (): allows to modify the description of an existing Entity member. See How to edit the description of an existing Entity member for more details
If there are other Objects in the same Screen, the Entity editor acts as a Pager and filters all data displayed on the Screen as a member is selected or created.
Other Objects in the Screen will only show data once a selection on all available Entity editors has been made.
Any custom filter applied using an Entity editor will be lost if you leave the Screen or update it. New Entity members or changes made to existing ones will be retained.
How to create a new Entity member
To create a new Entity member using the Entity editor Object, proceed as follows:
- Click on the Insert new member icon () to open the member creation window shown below
- Enter a Code for the new member (if the option is available) and a Description
- Define the relationships between the new member and its parent Entities from the dropdown menus in the "Relationships" area
- (Optional) If the option is enabled on parent Entities, from the member creation window you can also create new members at higher levels of the hierarchy using the "+" buttons next to each dropdown menu
- Click on SUBMIT to save the new Entity member.
The new member is immediately added to the associated Entity and will appear as selected in the Entity editor Object.
To see the newly created member in other Objects on the Screen, refresh all Screen Objects using the Refresh option in the Top menu of the Capsule workspace.
How to edit an existing Entity member
To edit a new Entity member using the Entity editor Object, proceed as follows:
- Click on the downfacing arrow next to the Code or the Description fields to open the list of members codes or the list of members descriptions
- Select an existing Entity member.
You can also make a selection by clicking on the Code or the Description field and typing the desired member code or description: search results will automatically appear below as you type, as shown in the following image.
- Click on the Edit existing member icon () to open the member editing window shown below
- Edit the description and/or the relationships between the Entity member and its parent Entities as needed.
It is not possible to change the code of an existing Entity member.
- (Optional) If the option is enabled on parent Entities, from the member editing window you can also create new members at higher levels of the hierarchy using the "+" buttons next to each dropdown menu
- Click on SUBMIT to save the modified Entity member.
How to edit the description of an existing Entity member
To edit the description of an existing Entity member using the Entity editor Object, proceed as follows:
- Click on the downfacing arrow next to the Code or the Description fields to open the list of members codes or the list of members descriptions
- Select an existing Entity member.
You can also make a selection by clicking on the Code or the Description field and typing the desired member code or description: search results will automatically appear below as you type, as shown in the following image.
- Click on the Edit member's description icon () to open the description editing window shown below
- Edit the description as needed
- Click on the OK button to save the new description.
Learn more about: