ZenoTest Documentation – 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.
- Launch your application under test (AUT) directly from ZenoTest using the 'Open AUT' button under the 'Controls' tab.
- Use the Recorder to capture interactions like clicks, text input, and selections.
- Stop recording and ZenoTest will automatically generate executable test code.
- Under the 'Actions' tab, review the recorded actions.
- Deselect unnecessary actions and click 'Add to Code' to generate code lines.
- Insert StartAUT() at the beginning of your code.
- Run the test by pressing ▶️ Run Test.
- Review the HTML report automatically generated after execution.
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, under the 'Controls' tab, click the 'Record' button.
- Interact with your application as usual — ZenoTest captures every relevant UI action.
3.2 Captured Actions
- Mouse clicks (single/double/right)
- Mouse wheel actions (scrolling)
- Keyboard input
- UI element selections
3.3 Finishing Recording
Once done, stop recording and review the captured steps in the Actions section.
💻 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 logic (loops, conditions, variables)
- Reuse functions with Global Scripts and parameterize 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 |