Working with Data Models


By Alina Panaite

updated 27 days ago

Use the Data Model Designer to create your custom data type. It helps you define the relationships between the data elements (attributes) you have, to give it a structure. Data models are a key concept in PROCESIO as they can be used to configure the data type of process variables.

Data model structure

A Data Model is an organized view of attributes and their relationships with other data models. 

Each data model has one or more attributes. Each attribute has a data type, either primitive or data model, which would effectively create a relationship between 2 data models.

Relationships consist of dependencies or associations between two data models. Thus a data model can have another data model as an attribute, describing the relationship between the two. 

Creating a data model

Here are the steps to create a data model and add attributes to it:

Step 1:  Go to the Designer panel and select “Data Model Designer” to access the Data Models page. 

Step 2:  Once on the Data Models page, select “Create data model”.

Data Model Specs


Display Name



Must be unique

Step 3: A modal screen will pop up where you must set a name for your Data model.

If you want to create several data models at this point, check the “Add another” option and hit “Create”. A similar form will be displayed to set a name for the following data model.  

Step 5: Press “Create” when done.

Step 6: The data model is now created and you can add attributes by pressing "Add attribute".

Step 7: Define the Display Name, Type, and Properties. 

Note: the Type of an attribute can be a primitive (integer, string, boolean etc.) or another Data Model created upfront. This is how you can create Relationships between two or more data models. 

Attribute Specs


Display Name




Primitive: string, integer, float, double, date, datetime, boolean

Relationship: an existing Data Model

Can be defined as Single value or List

Single value (default) - the attribute can reference only a value

List - the attribute can reference a list of values

JSON Property

Used for binding a JSON attribute from the response of a Call API action to the data model attribute


Must be unique

If you want to create several attributes at this point, check the “Add another” option and hit “Create”. A similar form will be displayed to set a name for the following attribute.  

Step 8: Press "Create" button to complete the attribute definition. It will be listed within the data model you created.

Using a data model in a process

When you create a process you can add variables that have a custom data type that you defined in the Data Model Designer. For example, you have defined the data model Country like in the image below:

In the process designer, you can create the country_var that has the data type “Country”:

We can use the “country_var” variable in any action configuration, by selecting an attribute of the “Country” data model:

When mapped to the property of an action, the format is <variable_name>.<data_model_attribute_name>, like in the image below:

Related links

Working with Data Types

Working with process variables

Did this answer your question?