Create an entity

Create a new entity

To create an entity:

  1. Right-click the Entities node and select Add Entity…. The Create New Entity wizard opens.

  2. In the Create New Entity wizard, check the Auto Fill option and then enter the following values:

    • Name: Internal name of the object.

    • Label: User-friendly label for this object. Note that as the Auto Fill box is checked, the Label is automatically filled in. Modifying this label is optional.

    • Plural Label: User-friendly label for this entity when referring to several instances. The value for the plural label is automatically generated from the Label value and can be optionally modified.

    • Extends Entity: Select an entity you want to extend in the context of Inheritance. Leave this field to an empty value if this entity does not extend an existing one.

      • If the entity extends an existing one, the remaining options cannot be changed as they are inherited. Click Finish to close the wizard and then press Control+S (or Command+S on macOS) to save the editor.

      • If you do not use inheritance, proceed to the next step.

    • Physical Table Name: This name is used to name the physical table that will be created to store information about this entity. For example, if the physical table is CUSTOMER, then the golden data is stored in a GD_CUSTOMER table.

    • Entity Type: Select the type for this entity. Basic, ID Matched or Fuzzy Matched.

    • Historize Golden Records: Select this option to keep track of the history of the golden data for this entity. See Data historization for more information.

    • Historize Master Records: Select this option to keep track of the history of the master data for this entity. This option is available for ID Matched and Fuzzy Matched entities, if the Historize Golden Records is selected. See Data historization for more information.

  3. Click the Next button.

  4. In the Primary Key Attribute screen, check the Auto Fill option and then enter the following values:

    • Name: Internal name of the primary key attribute.

    • Label: User-friendly label for this primary key attribute.

    • Physical Column Name: This name is used to name the physical column that will be created to store values for this attribute.

    • For fuzzy-matched entities only, select the Golden ID Generation method:

      • Sequence: Use this option to automatically generate the Golden ID as a sequential number. You can specify a startup value for the sequence in the Starts With field.

      • UUID: Use this option to automatically generate the Golden ID as a Universally Unique Identifier.

    • Select the ID Generation method (for all entities):

      • Sequence: Use this option to automatically generate the ID as a sequential number. You can specify a startup value for the sequence in the Starts With field.

      • UUID: Use this option to automatically generate the ID as a Universally Unique Identifier.

      • SemQL: Use this option to automatically generate the ID with a SemQL Expression, using the entities' attributes.

      • Manual: Use this option to manually provide the ID.

    • If the ID Generation method is set to SemQL or Manual, you can then choose the Type and Length for the ID attribute. For fuzzy matched entities the type is automatically set to string.

  5. Click Finish to close the wizard. The Entity editor opens.

  6. In the Description field, optionally enter a description for this entity. This description is indented for model designers.

  7. Define the user-facing Documentation describing this entity. Use plain text or the Markdown syntax for rich text. This text appears in the documentation side nav.

  8. Optionally select an Icon for the entity. This icon is used in the applications to represent records from this entity when no other icon is specified.

  9. Select or unselect the Delete Enabled option to enable or disable Record deletion for this entity.

  10. Press Control+S (or Command+S on macOS) to save the editor.

When an entity is created, it contains no attributes. Simple Attributes and Complex Attributes can be added to the entity now.

You cannot modify the entity type or primary key directly from the entity editor. To change such key properties of the entity after creating it, you must use the Alter Entity option.
Make sure to set the icon and labels for the entity at the early stages, since artifacts based on that entity automatically used them.
For example, the entity icon is automatically used in application components - business views, tabs or transitions - based on that entity, and you do not need to set an icon in these artifacts.

Alter an entity

Altering an entity allows modifying the key properties of an entity, including its type, inheritance and primary key attribute.

To alter an entity:

  1. Select the entity node, right-click and select Alter Entity. The Modify Entity wizard opens.

  2. In the wizard, modify the properties of the entity using the same process used for creating a new entity.

When altering an entity, it is strongly recommended to validate the model to make sure that the other elements of the model do not conflict with the modified entity definition. You must also re-deploy the model edition in order to make the changes active in the deployment data location.