Working with Data Models


By Alina Panaite

updated 4 months 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?