Skip to main content

Ranorex

Build from source

The source code can be found on GitHub: Ranorex Logger.

(Preferred option is NuGet install!)

  • Clone this repository
  • Open in a .Net IDE
  • Reference Ranorex.Core.dll and Ranorex.Libs.Util.dll from your Ranorex Installation(s)'
  • Reference the Orangebeard.Client DLL
  • Build the Ranorex Logger DLL

Installation

  • Install from NuGet
  • If you built it yourself: Add your dll as a reference in your Ranorex Solution
  • Reference it in Program.cs using RanorexOrangebeardListener;
  • Attach the logger to your Ranorex report (environment vars can of course be set up elsewhere):
    Environment.SetEnvironmentVariable("orangebeard.endpoint", "https://your-instance.orangebeard.app");
Environment.SetEnvironmentVariable("orangebeard.accessToken", "api-token-for-orangebeard");
Environment.SetEnvironmentVariable("orangebeard.project", "projectname");
Environment.SetEnvironmentVariable("orangebeard.testrun", "Test Run name");
Environment.SetEnvironmentVariable("orangebeard.description", @"test run description"); //OPTIONAL
Environment.SetEnvironmentVariable("orangebeard.attributes", @"key:value;single tag"); //OPTIONAL
Environment.SetEnvironmentVariable("orangebeard.ref.url", @"https://my-ci-server.net/PRJ/1234"); //OPTIONAL
Environment.SetEnvironmentVariable("orangebeard.fileupload.patterns", @".*\.txt;.*\.bat"); //OPTIONAL

Environment.SetEnvironmentVariable("orangebeard.ranorex.systemattributes", "memory; number of displays"); //OPTIONAL

OrangebeardLogger orangebeard = new OrangebeardLogger();
Report.AttachLogger(orangebeard);

If the orangebeard.ranorex.systemattributes parameter is not present, no Ranorex system information will be sent to Orangebeard. If set, the content should be a semicolon-separated list of attributes to include. Attribute keys are matched case-insensitive.

Valid attributes are:

  • Ranorex version
  • OS version
  • OS default locale
  • .NET Runtime version
  • Number of logical CPUs
  • Number of displays
  • Screen dimension
  • Memory

Now run your test as you normally do and see the results fly in to Orangebeard!