Create an Entity

   MaestroPreviously known as Transact Maestro.  |    Form Builder Platform Developer |  17.10 This feature was introduced in 17.10.

Maestro allows you to create entities so you can map them to your fields to provide logical groupings regardless of their physical position in the form. There are several ways to create an entity, which are described below.

To create a new entity in the Model pane:

1. Open a form in the Maestro editor.
2. Click the Model pane and expand the Entities root element.
3. Select an existing entity or select the Entities root element if there are no entities available and right-click on it.
4. Select Add Entity from the dropdown menu to add a new entity to the selected element.



5. Enter an entity name or a path in the Name or Path field. You can create a nested entity by adding underscores in the entity name, for example, applicant_name. Maestro recognizes the underscores as entity separators and creates all the required entities for your nested entity.
6. Click Save to update the changes.

To create a new entity in the Properties pane:

1. Open a form in the Maestro editor.
2. Select a field of a component and click the Properties pane.
3. Enter an entity name in the ID property field followed by an underscore. Maestro displays a message informing you that a new entity will be created.

For example, the prefix applicant1 applied to the firstName component, resulting in the component ID applicant1_firstName, identifies that the firstName component belongs to the applicant1 entity.



To create a new entity using the ID field, type the entity name followed by an underscore "_" and the remainder of the component ID. When you enter the underscore, Maestro displays a message informing you that a new entity will be created, as shown below.



After entering the underscore, you can finish entering the component name to complete the component ID.



To use an existing entity in the component ID , start typing in the ID field and any existing entities that match what you have typed will be displayed in a dropdown list. You can select one of the existing entities or keep typing to create a new entity.

Next, learn how to delete an entity.