How do you integrate Ranorex tests into a Jenkins CI/CD pipeline?

Ranorex doesn't need a special Jenkins plugin to run - a Test Suite builds into a standard executable, which means it can be invoked from any pipeline step that can run a Windows command.

flowchart LR
    A[Jenkins job triggered] --> B[Checkout code + Ranorex test suite]
    B --> C[Run test suite exe via batch/PowerShell step]
    C --> D[Ranorex writes HTML + XML report]
    D --> E[Archive report as build artifact]
    E --> F{Exit code}
    F -->|0| G[Mark build stable]
    F -->|non-zero| H[Mark build failed]

1. Build or reference the compiled test suite executable (or run it via rxtst.exe/the Ranorex Runtime).
2. Add a Jenkins build step (Windows batch or PowerShell) that runs the executable with report-output parameters pointing at a known path.
3. Archive the generated .html/.rxlog report as a build artifact so failures can be reviewed from the Jenkins UI.
4. Have the step surface the suite's exit code to Jenkins, so a non-zero code marks the build as failed.

For teams that also want the result inside Jenkins's native test trend graphs, the report can additionally be converted to JUnit-style XML and published with the standard JUnit plugin, alongside the full Ranorex HTML report for detailed debugging.