Ranorex Spy is the component of Ranorex Studio that makes it possible to explore and analyze the UI of desktop, mobile, and web applications for the purpose of identifying UI elements. Spy captures all running applications (according to your >⇢ whitelist) and displays them and their subelements in a tree view. It therefore recognizes UI elements, identifies them, assigns a RanoreXPath to them, and ultimately makes them available as repository items to Ranorex Studio.

Spy is available as a standalone version and from within Ranorex Studio.

On this page, you’ll find out how to start Spy and use its basic functions.

In this chapter

• Related chapters
• Start Ranorex Spy
• Ranorex Spy layout

Ranorex Spy is an advanced topic that is closely connected to the concepts of RanoreXPath and UI elements. Together, they explain how UI element identification in Ranorex Studio works. We therefore recommend you also study these chapters.

Further reading

---

RanoreXPath is explained in

Ranorex Studio advanced > ⇢ RanoreXPath.

Further reading

---

Further reading
UI elements are explained in

Ranorex Studio advanced > ⇢ UI elements.

Spy is available integrated into Ranorex Studio and as a standalone tool.

Integrated Spy

1. In the Ranorex Studio toolbar, click the Spy icon.

2. Click View > View Spy.

3. In a repository, click EDIT IN SPY next to a selected repository item.

Standalone version

4. Open Ranorex Spy from the Start Menu.

In the image below, you can see the layout of the standalone Spy with the BROWSER & RESULTS tab  active. The areas framed in green change when selecting PATH EDITOR instead. These areas are explained separately as part of the pages ⇢ Browser & results and ⇢ Path editor.

The areas in red are fixed and explained further below.

1. Element browser / repository selector (standalone only)
   Switches between the element browser and the repository. Loading repository files (.rxrep) is only possible in the standalone Spy.

2. Track button and RanoreXPath field
   The track button lets you track, identify, and add new UI elements. The RanoreXPath field displays the RanoreXpath of an element and also lets you edit it.

3. Switch between browser & results screen and the path editor
   These are explained separately on the pages⇢ Browser & results and ⇢ Path editor.

4. UI-element tree view
   This hierarchical tree structure represents all running applications (depending on whitelist settings) and their UI structure.

5. UI-element details
   Selecting a UI element in the tree displays detailed information about it in this section.

6. Image navigation area
   Displays a selected UI element as it would appear in the application and can be used to navigate through the UI.

Element browser/repository selector

Only available in the standalone version of Spy. Lets you switch between the element browser and the repository view.

In the repository view, you can load and manage repository files (.rxrep). This is particularly useful when you want to add repository items to a repository on a computer where Ranorex Studio isn’t available.

The repository view is the same as in Ranorex Studio and has all the same functions.

Reference

---

Managing repositories is explained in

Ranorex Studio fundamentals > ⇢ Repository.

Track function

Ranorex Spy has a track function that lets you identify UI elements and add them to the element tree, from where you can then add them to your repository.

1. TRACK button and RanoreXPath field:

• The track button starts the tracking process.
• The RanoreXPath field displays the RanoreXPath of the tracked UI element

2. Root UI element

• You can only track UI elements that are contained in the root element.
• In the example, the RxMainFrame (The Ranorex Studio Demo Application) is the root element and the button RxButtonExit is the tracked UI element. This means that tracking a button in the Windows Calculator would not work because it’s a separate application. If the root was the entire endpoint, it would work.

RanoreXPath field

1. RanoreXPath field in edit mode

• Normally, the RanoreXPath field is white and displays the RanoreXPath of the element currently selected in the tree.
• When you click in the field and press Enter, it changes to edit mode. This is indicated by a red X, yellow background, and a message below the field.
• You can now change the RanoreXPath and press Enter again and the element tree will display all elements that match this path.

2. Exit edit mode

• Clicking the red _X exits edit mode.

Working environment selector

The working environment selector lets you switch between the browser & results screen and the path editor.