Variables

Variables store data that can be used across commands and datasets. RTILA X has three types of variables.

Variable Types

Type	Scope	Where Defined
Global Variables	All projects for the current profile	Preferences → Global Variables
Project Variables	A single project	Project Settings → Variables tab
Runtime Variables	A single run	Created by set_variable, get_text, etc. during execution

Global Variables

Global variables are available in every project for the current profile.

Managing Global Variables

1. Go to Preferences → Global Variables tab.
2. Click New Variable.
3. Fill in:
   • Name — The variable name (e.g., api_key)
   • Value — The value (supports multiline)
   • Secure — Masks the value in the UI
   • List — Stores multiple values (one per line)
4. Click Save.

Variable Matching

When you define a project variable with the same name as a global variable, RTILA X automatically fills the project variable with the global variable’s value. This is called variable matching.

Example: If you have a global variable api_key = "abc123" and a project variable named api_key, the project variable is auto-filled with "abc123".

Using Variables

In Command Parameters

Use ${variable_name} syntax:

url: https://api.example.com/data?key=${api_key}
selector: css=.product-${product_id}
value: ${user_input}

In Dataset Selectors

selector: variable=my_variable

This extracts the value of a runtime variable as a dataset property.

In Transformations

Variables can be used inside script transformations:

return value + "${suffix}";

JavaScript Expressions

You can use full JavaScript inside ${}:

${price * 1.2}
${name.toUpperCase()}
${url.split('/')[2]}
${item.split(';')[0].trim()}

Variable Insertion via Context Menu

In the Visual Builder, when recording or editing commands:

1. Right-click on any input field.
2. Choose Insert Variable.
3. A submenu shows all available variables.
4. For CSV-style list variables, you can select individual columns.