Fill the fields below to generate a controlled random number.
📥 Inputs (Properties)

1) Minimum Value (number – required)

Defines the lowest possible number that can be generated.

Example:

minimum_value = 1

2) Maximum Value (number – required)

Defines the highest possible number that can be generated.

The generated number may have any number of digits, as long as it is between the minimum and maximum values.

Example:

maximum_value = 1000


✔ Possible results: 1, 15, 99, 250, 991, 1000

3) Minus List (text – optional)

A comma-separated list of numbers that must NOT be generated.

Example:

2,3,5,7,9


✔ Spaces are allowed and automatically ignored.

📤 Exposed States

1) Value (number)

The generated random number.

Filled when generation succeeds

Set to -1 when an error occurs

2) Error (text)

Error message describing what went wrong.

Empty when generation succeeds

Filled when an error occurs

📣 Events

1) A random number was successfully generated

Triggered when a valid random number is successfully generated.

2) An error occurred while generating a random number

Triggered when the plugin cannot generate a valid number due to invalid or conflicting rules.

⚠️ Error Handling

The plugin automatically detects situations where:

no valid number exists within the range

minimum value is greater than maximum value

all possible numbers are excluded by the minus list

In these cases:

value is set to -1

error is populated with a descriptive message

an_error_ocurred event is triggered

🚀 Best Practices

Always define both minimum and maximum values

Avoid excluding all possible numbers in the range

Use the success and error events in workflows for clean and safe logic