Calculator Component

Canvas Label Text                                                                        

A component’s Label Text indicates the purpose of the corresponding field or component.  For non-input components, the Label Text isn't end-user facing, and only appears in the Module Builder.

User-friendly labels make your module more accessible. Keep labels short and descriptive (a word or two) using title case. For longer entries, use sentence case.

For the Calculator component, it's best practice to use the same value for Canvas Label Text as your Property ID:calcXxx.

Trigger Type                                                                    

This setting provides the following options:

• Manual: The component fires when triggered by another component. For example, when using a Button or Initializer component to trigger a Plug-In component.

  By default, this Trigger Type is selected.

• Watch: The component fires when there's any action taken on the input  listed in the Inputs table. Actions include entering a new value, editing, or overwriting a saved value. If there are multiple inputs, use the Required setting to specify what inputs must be present before firing.

Property ID                                                                    

The Source column is where you enter inputs for your logic component to reference. Examples of supported inputs include:

• The Property ID of another component in the module. Examples include a component that acts as a trigger, an input for a Micro Decision, or a referenced formula.

  When using a Watch Trigger Type, enter all inputs the component must watch for in the Property ID column.

  You can use dot notation to reference values nested under a Property ID in the submission data.

• Values that are not the Property ID of a component in the module, but are still present in the submission object. For example, the currentUser object contains information about the end-user.

• Native values generated by the Unqork Designer Platform. For example, buttonClick. This Unqork value is created following button-click events.

Alias                                                                    

To simplify the configuration, give each component an alias. An easy approach is to assign each component a different letter of the alphabet. For example, A, B, C.

Required                                                                    

This setting sets the input as mandatory. That way, your calculation cannot take place without this input.

Close/ Open Unit Testing

Collapses or opens the Unit Testing panel.

Refresh Fields

Updates all Input fields to reflect changes on the canvas.

Run All Tests

Runs all added tests with the Input values entered.

Additional Unit Testing settings.

Duplicate

Makes a copy of an existing test.

Delete Test

Removes an existing test.

Run Test

Runs the test with the Input values entered.

Input Table

Use this table to enter the information you want to test. If you have multiple inputs and want to skip testing certain inputs, leave the Value column blank.

Input

Automatically populates all components listed in the Calculator component’s Inputs table.

Label

Automatically populates the label of the connected Input component.

Value

Enter example data in this column that you want to test.

If you enter a JSON value with a syntax error (such as a missing bracket), the cell turns yellow, indicating an error scenario.

JSON

Select this checkbox when you enter a Value that's written in JSON. This can be an object, array, number, or Boolean (true/false) value.

Output Table

This table displays the results of your test.

Output

Automatically populates all components listed in the Calculator component's Outputs table.

Label

Automatically populates with the label of your connected Output component.

Expected

Enter the outcome you expect from the test you run. You can use this to compare the expected result with the actual result.

This column is optional. If you leave it blank, the cell turns red when the unit test runs.

Actual

The result from the test you ran.

JSON

Select this checkbox when your result must display in JSON. This can be an array, string, or object.

Set Execution

Select if and what is executed when this component triggers.

Disable Execution

If Disable Execution is set to (ON), the logic tied to this component does not execute. Use this to keep the component's settings, but disable the operations it performs.

By default, this setting is set to (OFF).

Set Debounce

The number of milliseconds that pass before the form loads this component. For larger modules, increasing the debounce value prevents the Decisions component from triggering before all components load in.