Rainforest Test Language - Targets Overview
RTL (Rainforest Test Language) is built on Actions and Targets. Think of them as verbs and nouns. Click (Action / Verb) on the Red button (Target / Noun)
This article will will discuss Targets (nouns) within RTL. The use of Target and noun is used interchangeably in this article and within the application
Targets or UI Elements are the various visual elements that are present on the page. Buttons, Text Fields, etc. These elements are what any of the actions will be "done to" - such as clicking on the SUBMIT button.
This article will provide information on how to
- Creating a New Target
- Use a current Target
- Target Types and their uses
Creating a new Target
There are two main steps in creating a Target
- Specify Target Type and Parameters (button, link,text field)
- Screen capture element so RTL knows what to look for
Specifying Target Type and Parameters
- Select Targets from the right hand side (under Preview button)
Targets will now be bold and have a line under it.
Elements Type pulldown will appear along with Filter Elements and + Create New Element
- Select + Create New Element
All the various Element types will appear
NOTE: Use Filter Nouns box to filter the type of noun required.
Example: start typing "modal" for modal to be selected
- Select the noun you want (Button, Label etc)
- Provide the Label for the selected Noun
NOTE: Make Label descriptive and accurate.
If it is for a Submit button, make label "Submit". This is important in both the management of elements but also helps during automation to actually find the element on the page as OCR.
- Select Save
Screen Capturing the element
Once the target type and parameters have been set, you need to do a screen capture of the element so RTL knows what to look for. This is a 100% pixel match. So if the UI element changes - you will need to update this element so it can be found.
- Ensure that the Target is included as one of the steps in the test
- Select Preview (top right)
- Select Preview parameters in popup window.
Selection of the browser is very important. As you will be capturing how the specific browser displays the element. Under most circumstances this is the same across all browsers but sometimes it is not
- Follow the instructions in Preview mode.
The list of UI elements you need to screen capture will appear at the top left
- Once on a screen where you can capture one or several elements, Click on the name (blue text) of the element you want to select
- Click and drag to take a screenshot of the UI element on the page (pointer will now allow it as you selected it in prior step)
You may redraw if needed (select red X to start over)
NOTE: the white X in the middle is where the automation will click.
Ensure that the selected item has a unique element to it
- Select SAVE
- Finish balance of test
- The element is now in the test
Selecting an available Target
A target may be added to a step one of two ways
- Select the Target from the right hand column and drag and drop it to the appropriate step.
A blue box will appear around "Select Element" for the test.
Drop it and it will be added to the step
- Click on "Select Element" from the step.
The wording will change, however just Click the element you want to add from the right hand list and it will be added
To make finding elements easier:
- Use Element Type pulldown to limit the elements shown (such as Button, Dropdown etc)
- Use Filter Elements box on search on element label
- These can be used in conjunction with each other as well such as BUTTONS labeled SUBMIT
Following are the specific Target Types that RTL supports and their general usage. Please note that various types work very similarly but are broken out to make management of them easier for you. If you accidentally make something a button, but it should be an icon - there is no negative consequence, the various types are provided for easy management and recalling.
An element that is meant to be clicked to induce an action.
Examples: Submit button, Enroll button, Cancel button
An area where text can be entered
Examples: Search field, First Name, Email address
The actual options when the dropdown is selected
Examples: List of states, List of Months, List of Years
An element that can be clicked to induce an action
Similar to a button - but it visually may not look as obvious
Examples: More Information, Contact Us, View
A visual element that may or may not be clicked to induce an action or is presented as a result of other actions
Similar to a button - but may or may not have an action that occurs when selected.
Examples: Company logo, avator, magnifying glass
A square box that can be checked or unchecked to denote that the corresponding item is accepted or not.
Examples: Acceptance, selection of specific item
An element, usually at the top of the page that has higher importance.
Examples: For pages that have articles, the article title or perhaps the whole banner that shows at the top of a site.
A popup or other area, similar to a modal
Example: A popup window
A modal window that appears.
Example: Confirmation of an action that displays over the main screen "Are you sure you want to delete this item [Yes] [No]".
Specific text that is displayed to the user.
Any text or passage displayed to the user
Anything that doesn't necessarily fall into any of the other Target Categories
Examples: picture or graphic