Non-relational data storage

🌐 This document is available in both English and Ukrainian. Use the language toggle in the top right corner to switch between versions.

1. Overview

The Business processes management subsystem uses a distributed in-memory Redis database from the Non-relational databases management subsystem to store intermediate data generated by business processes and data required for building UI forms in user portals.

2. Data structures

2.1. bpm-form-submissions

Provides storage for data entered by users through UI forms, digital signatures, and data obtained as input parameters for business processes from external systems.

The bpm-form-submissions key contains a set of unique keys, which stores data as a hash table with individual keys prefixed with bpm-form-submissions.

Key generation pattern for storing UI form data

bpm-form-submissions:process/{processInstanceId}/task/{taskDefinitionKey}

Key generation pattern for storing data of the initial UI form of a business process

bpm-form-submissions:process-definition/{processDefinitionKey}/start-form/{UUID}

Key generation pattern for storing data with the registry digital seal

bpm-form-submissions:lowcode_{rootProcessInstanceId}_{processInstanceId}_system_signature_ceph_key

Key generation pattern for storing data with the registry digital seal for batch operations

bpm-form-submissions:lowcode_{processInstanceId}_system_signature_ceph_key_{index}"

Table 1. Data storage structure
Key	Data type	Description
`id`	String	Unique ID
`accessToken`	String	JWT user token
`data`	String (JSON)	Data
`signature`	String	Digital signature

2.2. bpm-message-payloads

Provides storage for data provided as input parameters with messages for initiating business processes.

The bpm-message-payloads key contains a set of unique keys, which stores data as a hash table with individual keys prefixed with bpm-message-payloads.

Storage key generation pattern

bpm-message-payloads:process-definition/{processDefinitionKey}/start-message/{UUID}

Table 2. Data storage structure
Key	Data type	Description
`id`	String	Unique ID
`data`	String (JSON)	Input parameter data (message body)

2.3. bpm-form-schemas

Provides storage for UI form structure descriptions in JSON format compatible with Form.io.

The data is stored in the form of a hash table with objects segregation at the level of ID prefixes (<keyspace>:<key>).

Storage key generation pattern

bpm-form-schemas:{formKey}

Table 3. Data storage structure
Key	Data type	Description
`id`	String	Unique ID of the UI form
`formData`	String (JSON)	UI form structure description in JSON format