✍️ 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 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 commands

In the left panel, You can see all commands in Testlum. You can star them and later filter commands only by starred

---

✏️ Adding, Editing and Maintaining Scenarios

• Drag and drop steps from the left panel to need places to add a new step in your test
• Drag and drop steps inside the test structure to reorder
• Click on the delete icon to remove a necessary step
• Click on any step to open panel with commands details and change it if needed

✅ 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 on the current page (via the recorder)

This ensures consistency across your tests and eliminates guesswork or typos.

📄 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:

• Using a command that requires comparing results from responses? IDE will automatically create and name needed expected file
• Want to send a request from file? IDE will automatically create and name needed body file
• 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