Create nested object

A nested object is intended to be used inside a complex attribute. It is a set of nested attributes that is added to a complex attribute. The complex attribute, in turn, is displayed in the record card as a catalog of nested attributes.

To create nested object:

  • Make sure that draft mode is enabled and draft is selected.
  • Make sure that the “Entities/lookup entities” tab is active in the “Data Model” section. The tab is located at the top of the “Data Model” list.
  • Click the “Create nested object” at the bottom of the “Data model” list.
  • The action will create a nested object. It will open on the right side of the screen (in the general area of the section). The nested object contains the “Properties” and “Attributes” tabs.
  • Fill in the required fields in the “Properties” tab:
    • “Name”: the system name of the nested object. The name can only contain Latin characters. Cannot be edited after saving the entity/lookup entity.
    • “Display name”: name of the nested object that will be displayed to all users. The display name can consist of both Latin and Cyrillic letters, as well as spaces. It is recommended to use a human-identifiable name. Can be edited after saving the entity/lookup entity.
    • “Description”: any additional information about the entity/lookup entity that is displayed only for administrators.
    • “Additional parameters”. A list of parameters (the “name” – “value” pair) that contain additional text information. Parameters can be referenced by custom extensions, and parameters can also contain non-standard information from external systems.
  • Create at least 1 attribute in the "Attributes" tab. The added attributes will represent the contents of the nested object.
  • Save the changes. Click “Save” in the upper-right corner of the screen. If filling errors are detected during saving, a corresponding message will be displayed on the screen.
  • Publish the data model when all necessary changes are made.

Create nested object

Figure 1. Create nested object

Features of nested objects

  • Single nested object can be used in multiple complex attributes of one or more entities at once. Example: The nested “Contacts” object will contain the following attributes: phone number, email, address, etc.
  • If a nested object has been edited, the changes will be applied to every complex attribute where the object is used.
  • Nested object can contain complex attributes that refer to other nested objects. A nested object cannot refer to itself.