ZenoTest How to – Installation, Tests & Reports
Step-by-step guides from installation to advanced reporting for desktop UI testing.
📑Table of Contents
⚙️ Installation & Setup
Follow these steps to install ZenoTest and prepare your testing environment:
- Download the latest version from our website.
- Run the installer and follow the on-screen instructions.
- Launch ZenoTest and create your first project.
- Start ZenoTest via Start Menu or desktop shortcut and create a new project.
🧪 Writing Your First Test
Learn how to define your first test case, add steps, and execute it automatically.
- Create a new Test Suite and Test Case inside ZenoTest.
- In the 'Controls' tab, set the AUT (Application Under Test) path and optionally enable 'Start AUT autom.' to launch it automatically during recording.
- Start the Recorder and perform the actions you want to automate—such as clicks, text entries, or selections—in your application.
- Stop the recording. ZenoTest will list all captured UI interactions under the 'Actions' tab.
- Review the recorded actions, deselect any unnecessary ones, and click 'Add to Code' to generate executable script code.
- Add StartAUT(); at the beginning of your script to ensure the AUT launches when the test runs.
- Save your project and run the test using the ▶️ Run Test button.
- Review the execution log and the automatically generated HTML report to verify the test results.
StartAUT();
LeftMouseClick("BUTTON_1");
LeftMouseClick("BUTTON_ADD");
LeftMouseClick("BUTTON_2");
LeftMouseClick("BUTTON_EQUALS");
VerifyEqual(GetText("RESULT"), "3");
CloseAUT();
🎥 Using the Recorder
Record your UI actions and automatically generate reusable test code.
3.1 Starting the Recorder
- Open your project and navigate to the 'Controls' tab.
- Click the 'Record' button to launch your AUT and begin capturing interactions.
3.2 What the Recorder Captures
- Perform the actions you want to automate — ZenoTest records each relevant UI event.
- Mouse clicks (left, right, double-click)
- Mouse wheel movements (scrolling)
- Keyboard input
3.3 Finishing the Recording
- Element selections and focus changes
- When finished, stop the recording.
- Review your captured actions in the 'Actions' tab, where you can edit or convert them into script code.
💻 Generating and Editing Test Code
After recording, edit the generated C-like code to customize or extend your test logic.
4.1 Code Generation
LeftMouseClick("BTN_LOGIN");
SendKeys("TXT_USERNAME", "admin");
SendKeys("TXT_PASSWORD", "1234");
LeftMouseClick("BTN_SUBMIT");
4.2 Manual Editing
- Add custom logic such as conditions, variable assignments, and additional actions.
- Refactor recurring sequences and parameterize your test logic for more flexible and maintainable test cases.
4.3 Global Functions
function Login(string user, string pass)
{
SendKeys("TXT_USERNAME", user);
SendKeys("TXT_PASSWORD", pass);
LeftMouseClick("BTN_SUBMIT");
}
📈 Viewing Reports
View test execution reports, analyze results, and monitor QA progress.
5.1 Report Contents
- Execution time and duration
- Test suite and case name
- Step-by-step results (passed/failed)
- Error messages and stack traces
- Optional screenshots on failure (future)
5.2 Accessing Reports
Reports are stored in the folder specified in the project settings and can be opened directly in ZenoTest or in your web browser.
💡 Command-Line Integration
ZenoTest supports a powerful CLI mode for automation and CI/CD workflows.
7.1 Basic Syntax
zenotest.exe -project "C:\Projects\MyProject.zproj" -suite "RegressionTests" -case "TestCase01" -report "C:\Projects\"
7.2 Parameters
| Argument | Description |
|---|---|
| -run | Runs a specified project |
| -suite | Runs a specific test suite |
| -case | Runs a single test case |
| -report | Custom output path for report |
7.3 CI/CD Integration
call zenotest.exe -run "BuildTests.zproj" -suite "Smoke" -report "C:\Reports\"
Exit codes (0 = success, -1 = failure) allow seamless integration into automated pipelines.
🔄 Updating ZenoTest
ZenoTest automatically checks for updates at startup and notifies you when a new version is available. Manually download the latest installer from the official website. All existing projects, settings, and reports remain preserved after updates.
🧩 Troubleshooting
Common issues and solutions to help you continue testing without interruptions.
6.1 Common Issues
| Problem | Possible Cause | Solution |
|---|---|---|
| Element not found | UI changed (new AutomationID or Name) | Use ZenoTest’s Smart Object Recognition – combine attributes or re-record element |
| Application doesn’t start | Incorrect AUT path in the project settings | Verify AUT path in project settings |
| Missing dependencies | UIAutomation Core or .NET runtime missing | Reinstall prerequisites using installer or Microsoft link |