open-testing-convert-ranorex

name	open-testing-convert-ranorex
description	Convert Ranorex Studio test suites — commercial GUI automation (Ranorex Studio IDE + Runtime). Parses `.rxtst` test suites, `.rxrec` recording modules, `.rxrep` repositories (RanoreXPath), `.rxsln` / `.csproj`, C# `.cs` modules (`*.UserCode.cs`), Ranorex API (`Ranorex.WebDocument`, `Host.Local.OpenBrowser`, `repo.X.Y.PressKeys`, `Report.Info` / `Report.Failure`, `Validate.Exists` / `Validate.AttributeValue`), recording modules, C# code modules, module/global parameters, data-driven (Excel/CSV/SQL/list), parallel exec, technology adapters (Web/WinForms/WPF/Java/Qt/Android/iOS), `[TestModule]` + `ITestModule`, and designer code-behind loop. Targets: Selenium, Playwright, Cypress, Appium, Cucumber, Eggplant, OpenTest.AI, Testers.AI. MANDATORY TRIGGERS: "convert Ranorex", "RanoreXPath", ".rxtst file", "recording module", "Ranorex C#".
license	MIT
metadata	{"family":"open-testing-convert","source":"ranorex","orchestrator":"open-testing-convert","targets":["selenium","playwright","cypress","webdriverio","puppeteer","appium","cucumber","eggplant","testcafe","nightwatch","codeceptjs","taiko","protractor","katalon","playwright-bdd","behave","specflow","behat","karate","robot-framework","gauge","serenity","geb","opentestai","testersai-recorder","testersai-dynamic"]}

Convert — Ranorex

Converts Ranorex Studio test suites to any supported target, and emits Ranorex from any source.

Ranorex is a commercial GUI automation tool with a distinctive architecture:

1. Dual-shape tests. Tests are either recording modules (visual step tables authored in Studio) or code modules (C# classes implementing ITestModule). The former are serialised XML (.rxrec) with auto-generated C# code-behind; the latter are plain C# files. Mature suites typically mix both.
2. Object Repository with RanoreXPath. A central .rxrep file stores every UI element reference as a RanoreXPath — Ranorex's XPath dialect extended with technology adapter hints (/dom, /form, /button, etc.). Repository items are referenced by named path (repo.Home.Login.UsernameField), giving a Page-Object-like indirection.
3. Multi-technology unified API. The same Ranorex API drives Web (Chrome/Edge/Firefox/IE), WinForms, WPF, Java (Swing/SWT), Qt, Android, and iOS. The technology is inferred from the RanoreXPath prefix (/dom for Web, /form for WinForms, /mobile for mobile). Extraction must route per-technology to the right canonical pattern.

When to use

Trigger when:

• .rxtst / .rxrec / .rxrep / .rxsln / .rxcsproj files present.
• C# projects with Ranorex.Core, Ranorex.Core.Testing, Ranorex.WebTestingPlugin, Ranorex.SupportLibrary DLL references.
• [TestModule(...)] or [CodeModule(...)] attributes.
• ITestModule interface imports.
• Host.Local / Host.Current usage.
• repo.<Path>.<Item> pattern in C# code.
• Report.Info(...), Report.Screenshot(...), Validate.Exists(...) method calls.
• Ranorex.WebDocument / Ranorex.Form type instantiation.
• RanoreXPath strings (/dom[@domain='...']//button).

How to use

1. Read the master orchestrator first.
2. Read this skill's reference files: source-profile.md, extraction.md, mappings.md.
3. Read target primer for your target.
4. Emit per target Emission Checklist.

Scope

• Ranorex Studio 10.x and 11.x. Earlier versions (8.x/9.x) have subtly different designer-code-behind conventions; extraction handles both with a version sniff.
• Test Suite (.rxtst) / Test Container hierarchy (smart folders, iterations, data binding).
• Recording Modules (.rxrec) with auto-generated code-behind.
• User Code Modules (C# classes implementing ITestModule).
• Object Repository (.rxrep) — fully expand RanoreXPath expressions.
• RanoreXPath dialect (full grammar, including technology prefixes, attribute predicates, index selectors, parent/ancestor axes).
• Web technology (WebDocument, DomElement, InputTag, LinkTag, ButtonTag).
• WinForms / WPF (Form, Button, Text, CheckBox, ComboBox, TreeView, MenuItem).
• Mobile (MobileApp, MobileForm, MobileButton).
• Java / Qt adapters (rare but in-scope).
• Validation functions (Validate.* family).
• Reporting functions (Report.Info/Warn/Error/Failure/Screenshot).
• Recording module parameters / variables.
• Data-driven connector (Excel / CSV / SQL / simple list).
• Global parameters and run config (RanorexCommandLineArguments.xml / .config).
• Test iterations.

Out of scope

• Ranorex Agent distributed execution config — preserve as metadata; not extraction-semantic.
• Ranorex Studio's built-in video recording plugin — mapped as boolean flag.
• Ranorex Remote orchestration — preserve config.
• Visual Studio integration specifics — .sln / .csproj structure handled generically.
• Custom Ranorex plugins (.dll user libraries without source) — preserved as foreign_call with class/method names, flagged.
• Image-based validation with user-provided reference images — image path preserved; binary not decoded.

Quick reference

Ranorex construct	Canonical	Example target
Host.Local.OpenBrowser("https://...", "Chrome")	{kind: "driver_launch", type: "chrome"} + {kind: "navigate", url}	Playwright chromium.launch() + page.goto()
repo.Home.Login.UsernameField.PressKeys("alice")	{kind: "input", locator: resolved_ranoxpath, value: "alice"}
repo.Home.Login.SubmitBtn.Click()	{kind: "click", locator}
Validate.Exists(repo.Dashboard.Welcome)	{kind: "assert", assertion_kind: "element_exists", locator}
Validate.AttributeValue(repo.X, "innertext", "Y")	{kind: "assert", assertion_kind: "attribute_equals", name:"text", expected: "Y"}
/dom[@domain='example.com']//input[@id='email']	{locator: {strategy: "css", value: "input#email"}, from_ranorex.ranoxpath: "..."}
Report.Info("msg")	{kind: "log", level: "info", message: "msg"}
[TestModule("Login", ModuleType.UserCode, 1)]	module_type: "user_code" on canonical module
Recording module (.rxrec) step table	canonical step list
Data binding → Excel column	data_driven: {source: "xls", columns: [...]}	Scenario Outline

See reference/mappings.md for full cookbook.