✍️ Creating, Maintaining and Running Test Scenarios

A test scenario is a visual, step-by-step representation of a user journey or an automated flow. In Testlum IDE, scenarios are built using a no-code interface, making test creation accessible to both QA engineers and non-technical users.

---

🧩 What Is a Test Scenario?

A test scenario (also called a test case) simulates how a user or system interacts with your application. Each scenario is made up of steps that perform actions, validations, or setup/cleanup tasks.

---

🧱 Creating a New Scenario

1. Open your project in Testlum IDE
2. Create a new subfolder inside scenarios folder with representative name of your test scenario. Please avoid using spaces in folder names
3. Right click on created folder or press (Cmd (Alt) + N)
4. Choose the Scenario option

✅ Your new scenario will open in the main editor, ready for step-by-step test building.

---

✏️ Switching between test scenario views

Teslum IDE provides a flexible way of working with test scenarios. You can construct them using XML format or using UI Builder. For switching between these two views, you can choose needed in the bottom of scenario structure

---

🧪 Commands List

In UI Builder tab you can construct tests by drag and dropping process from left panels with All commands to middle area with all tests scenario

In the left panel, you can see All commands in Testlum. You can star them (by clicking on the star near the corresponding command) and later filter commands only by starred. To switch to Starred commands click on the star in the top of the Commands palette.

---

✏️ Adding, Editing and Maintaining Scenarios

• Drag and drop commands from the left panel to needed places to add a new step in your test. Allowed places for dropping commands are highlighted with a green line. Pay attention, that you can drop general commands in any place, but child commands should be dropped only inside the corresponding parent.
• Drag and drop steps inside the test structure to reorder.
• Click on the delete icon to remove a certain step (it appears in the right upper corner of the command node after hovering there).
• Click on any step to open the panel with commands details and change it if needed (Attribute palette will be opened).

✅ All changes are auto-saved and fully synchronized with xml representation. You can work simultaneously in both tabs.

---

🤖 Smart Step Editor & Context-Aware Autocompletion

Testlum IDE isn't just a visual no-code editor - it's also a smart assistant that helps you write high-quality tests faster and more accurately.

🧠 Context-Aware Autocompletion

As you add steps to your test scenario, Testlum IDE provides real-time suggestions based on:

• ✅ Project structure (existing variations, variables, tags, etc.)
• ✅ Unique UI identifiers of available elements collected in file with locators (locator IDs).
• ✅ Condition suggestions for execution step (if condition was specified before).

This ensures consistency across your tests and eliminates guesswork or typos. You can use smart inputs for variations and variables suggestions by typing {{, then suggestions will appear. Suggestions for conditions, tags and locators work without {{.

📄 Automatic File Generation

Some commands - such as complex integrations or page object abstractions - may require supporting files. When you use such a command, the IDE can automatically generate the necessary files or folders for you.

Examples:

• Do you use command that require comparing results from responses? IDE will automatically create and name the needed expected file after adding the corresponding command to the scenario tree. You can find the expected file in the scenario folder. Number in file name corresponds to the number of step in the scenario tree. And will be updated after some changes in the tree (deleting/moving/adding command) accordingly.

• Do you want to send a request from a file? IDE will automatically create and name the needed body file (if you chose “file” body type) after adding the corresponding command to the scenario tree. You can find the body file in the scenario folder.

• After deletion or restructuring we take care about such files deletion and renaming, you need to focus only on test's logic

⚙️ The goal is to reduce boilerplate and keep your project structure consistent and ready-to-run.

▶️ Running Tests in Testlum IDE

Once your test scenarios are ready, running them is as simple as a single click. Just click on Run button in the right upper corner

During a test run, you will see live results of each step

Additionally, to logs about test execution you will see a result for each step right in your testing scenario. Green colored steps passed successfully. Red colored steps failed.

---