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:

  1. Download the latest version from our website.
  2. Run the installer and follow the on-screen instructions.
  3. Launch ZenoTest and create your first project.
  4. 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.

  1. Launch your application under test (AUT) directly from ZenoTest using the 'Open AUT' button under the 'Controls' tab.
  2. Use the Recorder to capture interactions like clicks, text input, and selections.
  3. Stop recording and ZenoTest will automatically generate executable test code.
  4. Under the 'Actions' tab, review the recorded actions.
  5. Deselect unnecessary actions and click 'Add to Code' to generate code lines.
  6. Insert StartAUT() at the beginning of your code.
  7. Run the test by pressing ▶️ Run Test.
  8. 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
-runRuns a specified project
-suiteRuns a specific test suite
-caseRuns a single test case
-reportCustom 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