You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

The Record Extended Model (REM) allows you to extend a set of table attributes. 

The table structure of REM repeats the dictionary structure with tables and columns. Instead of columns, Attributes (sys_re_attribute) are used in REM. You can connect REM attributes with a table within the Model (sys_re_model). Besides, you can create attribute collections as universal sets of attributes that can be used in several models at the same time. 

You can access dictionaries related to REM through the Record Extended Model (REM) menu category. 

REM concept


Every table has its own data model specified by the business logic. The data model is represented by the column set. This data model can be extended with a child table containing the same attribute set as the parent one, and individual attributes inaccessible from the parent table. For example, the diagram below shows that all attributes of the User table are inherited by the Employee table:

Attributes extension circuit diagram

When few child tables are available, and the attribute overlap is high, this data model works fine. But when the child table number increases, and the attribute overlap decreases, the management of this data model becomes a challenge. The data model with a large and complicated table inheritance structure has some disadvantages:

  • It is required to allocate more space for record storage.
  • The pace of script execution decreases.
  • It is getting harder to configure the functionality related to the specified dictionary, such as data import, layout setting, etc.

The Request Catalog is an example of such a table: it consists of a parent table for the catalog and a record in the table for each request template with specific attributes.

The Record Extended Model concept addresses the issue described above. The extension concept can be applied to a specific table record, by assigning additional attributes to it.

When a record extension model is applied to a record, it means that an auxiliary record set is created for this record containing information about specific attribute values. Therefore, the record has attributes inherited from a table, and in addition, it has attributes sourced from the extension model.

Configure an extension model


Generally, to configure your extension model, you need to:

  1. Create an extension model.
  2. Create attributes and link them to the model.
  3. (optional) Configure the attribute collection.
  4. (optional) Configure a model client script.

In the diagram below, you can see the difference between models and collections. Models are created with a specific attribute set that can only be used in this model. Collections contain attributes that can be applied to different models. 

It is not recommended to create collections with many attributes. It is better to create one collection with one attribute. 

Create a model


To create a model, complete the steps below:

  1. Navigate to Record Extended Model (REM) → Models.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.
  1. Do not create or add an attribute to a model if an attribute with the same name already exists in this model. 
  2. Do not rename an existing attribute if there is an attribute in the model with the name you want to enter.

Configure an attribute


In SimpleOne, you can create attribute mapping for models and collections. Data mapping is the process of connecting a data field from one table to a data field in another table. It reduces the potential for errors, helps standardize your data, and makes it easier to understand your data because it establishes direct relationships among your data across multiple tables at once.

To create an attribute, complete the steps below:

  1. Navigate to Record Extended Model (REM) → Attributes.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

Configure an attribute collection


Attribute collections are implemented to user Many-to-Many Relationships, so they allow you to reuse the same attributes across models instead of adding them separately to each model where necessary.

The simplified concept of use is:

  1. Create a collection record as described below.
  2. Fill it with previously created attributes or create new ones using the Attributes related list.
  3. Relate this collection with previously created models using the Used in Models related list.

After that, all the attributes contained in this collection are used by all models this collection relates to.

  • If you want to use attribute mapping in a collection, you need to specify a table in the Table field of a collection. Otherwise, leave the Table field empty.
  • Collections with the populated Table field can only be added to models with the same table specified or to models of child tables.

To create a collection, complete the steps below:

  1. Navigate to Record Extended Model (REM) → Collections.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.
  1. Do not rename an existing attribute in the collection if there is an attribute in the model or in the collection linked to the model with the name you want to enter.
  2. The same collection and model cannot be linked to each other more than once.
  3. A model and a collection that have at least one eponymous attribute matching the model attribute cannot be bound between each other.

Configure a model client script


To create a record extended model client script, complete the steps below:

  1. Navigate to Record Extended Model (REM)→ Model Client Scripts.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

Configure model form elements


You can arrange the fields of your model attributes in a particular order and position, as you can do with form layouts. Group attributes by common features and give them a title. In the screenshot below, custom model attributes are divided into two columns:

If you want to define a title for a group of attributes organized in one block, use the Begin element.

The title will appear on the relevant page of the Self-Service Portal.

To change the order of the displayed attributes, perform the following steps:

  1. Navigate to Record Extended Model (REM) → Models.
  2. Open the model you need.
  3. Scroll down to the Related Lists area and open the Model Form Elements tab.
  4. Arrange the attributes by changing the value in the Position field. 

    Use the inline editing: double-click the cell in the Position column, enter the value, and press Enter to save the changes. 

To configure a model layout, perform the following steps: 

  1. Navigate to Record Extended Model (REM) → Models.
  2. Open the model you need.
  3. Scroll down to the Related Lists area and open the Model Form Elements tab.
  4. Click New and fill in the fields.
  5. Click Save or Save and Exit to add the element.

  • No labels