Skip to main content
Skip table of contents

Create Object

The Create node is used to create a new record of a selected entity in the database.

image-20251023-145458.png

It defines how values are assigned to entity fields during record creation, using:

  • static values

  • values referenced from the DataStore

  • dynamically computed values defined using the Expression Language

The Create node prepares data for persistence, but the actual database write is finalized later during Flow execution.

image-20251023-145356.png

Execution Behavior

During execution, the Create node:

  • evaluates its configuration

  • resolves all field values

  • creates an in-memory representation of the new entity record

  • stores the created object in the DataStore

The Create node does not immediately persist data to the database.
Persistence is completed later as part of Flow finalization.

Entity Selection

The first configuration step of the Create node is selecting the target entity.

The selected entity determines:

  • which fields must or can be provided

  • field data types

  • validation rules

  • the structure of the created object

Once the entity is selected, all its available fields are exposed for configuration.

Field Value Definition

For each entity field, the value can be defined individually.

The Create node supports multiple ways of defining field values:

Static Values

A fixed value can be entered directly.

Examples:

  • numeric literals

  • strings

  • predefined constants

This approach is suitable for:

  • default values

  • flags

  • static classifications

DataStore References

Field values can reference values already available in the DataStore.

Examples:

  • input variables from the Start node

  • values loaded by a Load node

  • results of previous Create or Update nodes

This allows direct data propagation through the Flow.

Expression Language Values

Field values can also be defined using Expression Language.

This enables:

  • transforming input values

  • combining multiple values

  • performing calculations

  • applying formatting or normalization

  • conditional value selection

Expressions are evaluated at runtime against the current DataStore state.

For syntax rules, functions, and type compatibility, see Expression Language (Low-Code Syntax).

Expression Evaluation Context

Expressions used in the Create node:

  • are evaluated before persistence

  • operate only on in-memory DataStore values

  • do not perform side effects

  • must resolve to a value compatible with the target field type

If the resolved value does not match the field’s data type, conversion is attempted where possible.

Created Object in DataStore

After execution, the created object is stored in the DataStore and can be accessed by subsequent nodes.

Typical use cases include:

  • passing the created object to an Update node

  • referencing generated identifiers

  • returning values to the client via the End node

  • using created values in If node conditions

Interaction with Expression Language

The Create node is one of the primary integration points for Expression Language within a Flow.

Expressions are commonly used to:

  • map input values to entity fields

  • compute derived attributes

  • normalize external data

  • apply conditional logic during record creation

Despite this flexibility, expressions should remain focused on value computation, not business process logic.

Typical Usage

The Create node is typically used to:

  • create new domain records based on user input

  • persist results of a process

  • materialize calculated data

  • initialize related entities before further processing

In many Flows, Create nodes represent the transition from process logic to persistent state.

Notes and Limitations

  • The Create node always creates a new record

  • It does not update existing records

  • Complex business rules should be modeled using Flow structure and If nodes

  • Deeply nested expressions may reduce readability and should be avoided

  • Validation errors may prevent successful persistence during Flow finalization

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.