Unqork documentation is available in two workspaces: UnqorkAI for the latest AI-first platform, and legacy Unqork for previous versions. Use the drop-down near the logo to switch.

Calculator Component

Prev Next

The Calculator component computes output values from input fields using configurable formulas. It fires on a manual  or by watching input fields for changes, and can chain into a Post Trigger component on completion.

How to read settings tables

The tables below describe each configurable option as it displays in the UnqorkAI platform. Values are formatted as follows: inline code — a value to type exactly as shown | Bold — a value selected from a drop-down, radio button, tab, or choice chip | ON/OFF — toggle state | ✓ — checkbox checked | ☐ — checkbox unchecked

General Settings

Setting

Field

Type

Default

Description

Property ID

key

Text input

calc

The unique identifier for this component instance.

Canvas Label Text

label

Text input

—

Identifies the component on the Module Builder canvas. Does not display to end-users.

Actions Settings

Triggers

Setting

Field

Type

Default

Description

Trigger Type

triggerType

Radio button

Manual

Sets when the component executes.
• Manual: Waits to be triggered by another component.
• Watch: Executes whenever a defined input field changes.

Inputs

Defines the fields passed into the calculator formulas.

Column

Field

Type

Description

Source

id

Property ID

The module field to use as a formula input.

Alias

alias

Text input

An alias used to reference this field inside formulas (for example, =alias).

Required

required

Toggle

When set to ON, this setting marks the input as required for the calculation to execute.

Outputs

Defines the fields populated with formula results.

Column

Field

Type

Description

Source

id

Property ID

The module field to populate with the formula result.

Formula

formula

Text input

The formula to evaluate (for example, =LEN(participants), =name + " " + surname).

Post Trigger

Setting

Field

Type

Default

Description

Post Trigger

postTrigger

Property ID

—

Triggers another component after all outputs are set.

Unit Testing

The Unit Testing panel verifies formula behavior by running the component against test data. Rows are auto-populated from the configured Inputs and Outputs.

Inputs

Column

Field

Type

Description

Input

inputField

Read-only

The input Property ID from the component configuration.

Label

inputLabel

Read-only

The display label for the input field.

Value

inputValue

Text input

The test value to pass into the formula.

JSON

json

☐/✓

When checked, treats the value as JSON.

Outputs

Column

Field

Type

Description

Output

outputField

Read-only

The output Property ID from the component configuration.

Label

outputLabel

Read-only

The display label for the output field.

Expected

expectedValue

Text input

The value you expect the formula to produce. Displays pass/fail styling against the actual result.

Actual

actualValue

Read-only

The result the formula produces when the test runs.

JSON

json

☐/✓

When checked, treats the value as JSON.

Advanced Settings

Set Execution

Setting

Field

Type

Default

Description

Disable Execution

disabled

Toggle

OFF

Prevents the component from executing when triggered.

Set Debounce

debounceSetting

Number input

0

Sets the delay before executing after being triggered, in milliseconds (ms). Useful when multiple components trigger simultaneously.