Ranorex Studio Overview: Desktop Automation and Enterprise Testing Platform

// Ranorex object repository structure
public partial class LoginRepository
{
    public static LoginRepositoryFolders Folders
    {
        get { return _instance.FoldersImpl; }
    }

    public partial class LoginRepositoryFolders
    {
        [RepositoryItem("Username")]
        public Text UsernameField
        {
            get { return _usernameFieldInfo.CreateAdapter<Text>(true); }
        }

        [RepositoryItem("Password")]
        public Text PasswordField
        {
            get { return _passwordFieldInfo.CreateAdapter<Text>(true); }
        }

        [RepositoryItem("LoginButton")]
        public Button LoginBtn
        {
            get { return _loginBtnInfo.CreateAdapter<Button>(true); }
        }
    }
}

// WPF application automation
[TestModule]
public class DesktopAutomationModule : ITestModule
{
    public void Run()
    {
        // Launch desktop application
        Host.Local.RunApplication(@"C:\Apps\MyApp.exe");

        // Interact with WPF controls
        var mainWindow = "/form[@title='Main Window']";
        var textBox = mainWindow + "/text[@automationid='txtInput']" (as discussed in [TestComplete Commercial Tool: ROI Analysis and Enterprise Test Automation](/blog/testcomplete-commercial));
        var button = mainWindow + "/button[@text='Submit']";

        // Type into text field
        Keyboard.Press(textBox);
        Keyboard.Press("Test Data");

        // Click button
        Mouse.Click(button);

        // Validate result
        var result = mainWindow + "/text[@automationid='lblResult']" (as discussed in [BDD: From Requirements to Automation](/blog/bdd-requirements-to-automation));
        Validate.AttributeEqual(result, "Text", "Success");
    }
}

// Excel-based data-driven test
[TestModule]
public class DataDrivenLogin : ITestModule
{
    [DataSource("Users.xlsx", "Sheet1")]
    public void ExecuteLogin()
    {
        var username = TestSuite.CurrentTestContainer.DataContext.Current["Username"];
        var password = TestSuite.CurrentTestContainer.DataContext.Current["Password"];
        var expected = TestSuite.CurrentTestContainer.DataContext.Current["ExpectedResult"];

        // Perform login
        LoginRepository.Folders.UsernameField.TextValue = username.ToString();
        LoginRepository.Folders.PasswordField.TextValue = password.ToString();
        LoginRepository.Folders.LoginBtn.Click();

        // Validate
        Validate.AreEqual(GetActualResult(), expected.ToString());
    }
}

<!-- Azure DevOps pipeline -->
<Project DefaultTargets="Run">
  <Target Name="Run">
    <Exec Command="RanorexRuntime.exe /rf:TestSuite.rxsol /zr:true" />
  </Target>
</Project>

# GitLab CI/CD
ranorex_tests:
  stage: test
  script:
    - RanorexRuntime.exe /rf:TestSuite.rxsol /reportlevel:Info
  artifacts:
    reports:
      junit: RanorexReport.xml

// Separate repositories by feature
public class LoginRepository { }
public class DashboardRepository { }
public class CheckoutRepository { }

// Reusable modules
[TestModule]
public class NavigationModule { }

[TestModule]
public class ValidationModule { }

try
{
    LoginRepository.Folders.LoginBtn.Click();
}
catch (ElementNotFoundException ex)
{
    Report.Error("Login button not found: " + ex.Message);
    Ranorex.Report.Screenshot();
}