Inputs

Inputs, also known as input arguments, are the parameters that a function uses to execute its action. The default format for input is YAML, providing a straightforward structure for defining input parameters. If necessary, this format can be switched to HTML.

Function with input in YAML format

Depending on the function, input can be:

• Data (string, number, integer, boolean, array, object)

• Files

• Images

• Filters

• Options

• Functions (for callbacks only)

Certain functions provide the option to include extra inputs, allowing for the incorporation of additional arguments. To add another input box, click the + icon located behind an existing input box.

Input sources

Sources for input arguments are varied:

• Static backend input: Input arguments can be filled statically in the backend.

• Dynamic backend input: They can be filled dynamically with output of another function by linking the output to the input.

• User input in frontend: Alternatively, input arguments can be dynamically filled by capturing user input in the frontend and linking the widget to the input.

Documentation

Hover over the right arrow icon of the input box to see its documentation.

Documentation for input box

Configuration

Input boxes provide a context menu accessible through right-click. In this context menu, you can:

• Switch between YAML and HTML input formats.

• Set the input as secret, which is useful for passwords.

• Clear the content of the input box.

• Delete the input box.

Callbacks

In classical programming, a callback is designed to execute code in response to an event. In Heisenware, callbacks can be employed whenever the integration protocol with an external system or the code integrated through the code adapter supports them.

A function that supports callbacks listens for certain events defined in the function. These functions feature a special, dashed input box that contains an output box. Within this box, you can observe the return value (output) of the function executed in response to an event, to which the original function is subscribed. From there, you can work with the data as with any other output.

A function with a dashed input box listening for incoming MQTT messages in binary format

Names of functions supporting callbacks often begin with on.