Internal parameters can be helpful if you use the same value in multiple areas in your script or if you need to manipulate a value throughout the execution of the script.
This article explains how to work with ScriptBuilder parameters.
Creating Internal Parameters
Set Parameter
To set a parameter, click the Add button
and select Set parameter.
Define the name of your parameter and its initial value. Then click on Add.
Important!
Parameter names -
Are NOT case-sensitive.
Must begin with a letter.
Can contain letters, digits and underscores only.
Parameter values -
If you need to use ‘\’ (backslash) in a string value, use ‘\\’ instead.
The instruction for creating the parameter and its value will appear in the scriptBuilder.
Important!
For string values, use single quotation marks.
Upon playing the instruction in ScriptBuilder, the below validation will appear.
Set parameter using AI
You can use AI prompts to generate dynamic parameter values such as the below examples. The functionality allows users to leverage AI and easily generate values that can be very specific and that are otherwise cumbersome to define.
A city in the USA
A valid phone number in Germany, including the international code.
The {x} number in US format.
A random Japanese female name that starts with “M” and has more than 5 characters.
I got a number in this format: 123_456_123,56. Can you give it to me in a US format? I need you to give me, as a result, just the number, without any text/explanation.
Good to know!
You can use internal or input parameters in your AI prompts.
ScriptBuilder functions are not supported in AI prompts.
AI Prompt
The AI Prompt instruction is a game-changer for how you create automated instructions. With the AI Prompt, you can generate automation effortlessly using simple, plain English.
Click here to read more about AI Prompt instructions
Validate expression
Use the validate expression instruction to validate whether the given expression is true. The expression can include functions and parameters.
Validate expression using AI
Use AI to ask whether a parameter is valid, such as in the examples below. Validation expressions using AI simplify the task and dismiss the technical/syntax understanding required to create similar validations using other methods.
You can use free text and include strings, parameters, and functions.
The word {X} has exactly 5 characters
{y} is divisible by 5
{delivery_date} is later than today’s date
Check that {p} contains at least 5 digits, and the first character is '#'
Check that {p} is a valid ID number in French
Check that {p} is a city in country {u}
Viewing Internal Parameter
To view defined internal parameters and their values, click the menu button and select Parameters.
Utilizing Internal Parameters
You can utilize internal parameters anywhere in your script. For example, when validating a screen element value in an expression. To add input parameters to your expression, click the parameters button to select from existing pre-defined internal parameters.
Click on equals to change the operator. You can select from Equals, Not equals, Contains, Starts with or Ends with.
