Setting everything up

There are a few things that you have to install and double-check before you will be able to run a Robot test using the RanorexLibrary.

• Check if you have valid Ranorex licenses.
• Check Ranorex' system requirements and make sure you have them in place.
• Install Ranorex. Although not strictly necessary in all circumstances, it makes license handling much easier, plus it brings all the .dll files that you will need.
• Install IronPython.
  • In IronPython 2.7.8, the elementtree is bugged, therefore you have to install the elementtree preview 1.2.7 release also from here.
• Set the PATH variable (although not strictly necessary, it makes working much easier).
  • Set path to IronPython installation, by default here: C:\ProgramFiles\IronPython2.7
  • Set path to Robot scripts, by default here: C:\ProgramFiles\IronPython2.7\Scripts
• Install the Robot Framework
  • ipy -X:Frames -m ensurepip
  • ipy -X:Frames -m pip install robotframework
• Download RanorexLibrary files
  • Download the files of the RanorexLibrary and place them to a folder.
  • Add the path to the RanorexLibrary to your IRONPYTHONPATH in your system environment variables.

Now you should have everything in place to run a Robot test. Running a Robot file looks like this: ipy32 -m robot myTest.robot

Importing the RanorexLibrary into a Robot Test

In order to import the RanorexLibrary into a Robot test, you have to add it as a library in the Settings-section, and you can also give the location of the Ranorex .dll files so the RanorexLibrary knows where to look for them if they are not installed in the default location (starting from Ranorex 9.0).

*** Settings ***
Library    RanorexLibrary    C:\\Program Files (x86)\\Ranorex 8.3\\Bin

*** Settings ***
Library    RanorexLibrary

And from here on you can use the keywords from the RanorexLibrary in your Robot test.