The Calculator component computes output values from input fields using configurable formulas. It fires on a manual trigger 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 Unqork IDE. 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. |
Changelog
| Date | Change |
|---|---|
| — | Initial publication. |