Test Builder

Connect to a Live Device

Connect a to a live device and interact with it like a normal device.

After creating the step, press the “Connect” button

The following pop-up menu should appear. Follow the steps below to connect to a device.

Install App Configuration

Install App is used when an app has been uploaded in “Setup - Application Management”

With the Install App selected,

Click the “Choose application file” dropdown and select an “Uploaded App”
Click the “Select App Activity” dropdown and select the App Activity
Click the “Choose the device pool” dropdown and select a device pool.
Select A Device
Click “Build Live Test”

Launch App

If the app is already installed on the device, “Launch App” can be used instead of “Upload App”

Input the “App Activity”
Input the “App Package”
Click the “Choose the device pool” dropdown and select a device pool.
Select A Device
Click “Build Live Test"

Android Launch App Page

Apple Launch App Page

Inspect Mode

Helps find locator types and values from the connected device to create test steps. Inpspect Mode is only available when connected to a device. Follow these steps to connect to a device.

Navigate to the page, the user wants to inspect.
Click the “Inspect” Toggle button, next to the “Record” button.
Click an element on the phone. A box should appear over that element
1. Example: User clicked on the “Settings” app therefore a white box appeared.
2. User can change the color of the inspect box to be more visible by selecting the color next to the “Inspect” Button
3. Depending on the Action Type, the “Locator Type” and “Locator Value” field will be automatically filled out.
4. User can change the “Locator Type” and will automatically update the “Locator type” and “Locator Value”
When satisfied with the inspect mode’s locators, click the “Inspect” toggle button to toggle it off.

Manual Test Step building

Build out the test steps for the test script manually.

Click on the “Action Type” box in Step Creator to access all the test Action groups
Select a test Action groups then select an Action Type.
Fill out all the required fields.
1. Use “Inspect Mode” when needing to grab any locator information.
2. Optional Step: Toggling on makes the step optional. Therefore, the status of the step will always be pass.
3. Screenshot: If enabled, screenshot of the device is captured after the step is executed and will appear in the test report. It is on by default.
4. Data field requires User input
5. "Verify Element" is used with any Action Type with locator fields
  1. Toggle on the "Inspect Mode." The "Verify Element" button will now be clickable
  2. Click the "Verify Element" buton, a green bounding box will appear around the given element if found. A successfully "Bound has set successfully" message will appear.
6. Can click the “Execute Step” button to test the test step
  1. returns a “Pass” or “Fail” message
Click “Push to Script” button.
Click the “Save Changes” button.

Record Mode

Captures the actions that user performs on the phone and convert them to test steps.

Once we connect to the device user can see the Record icon on left top corner.

Once the users enables the “Record Mode”, all the taps they do on the phone are translated to test steps. An example of the user flow is like this:

User enables “Record Mode”
User taps on an element on the phone
A test step with Tap as the action type is created on the element that the user tapped on.
That step is executed.
If the step passes, it is pushed to Script.

User can record the following Actions:

Long Press: Hold down the mouse for at least 2 seconds on the element that you want to interact with and let it go
Tap: Tap on the Element for which you want to capture.
Swipe Up, Down, Left and Right: Swipe in the direction you want
Custom Swipe: Hold down the mouse for at least 2 seconds and move the mouse in the direction you want to swipe
Wait for Element (Wait Until): A button with an hourglass icon is added to the Scripts section and the user can click on it if they want to add a wait before that step. The Wait Until step will be populated with the locator info of the step that was clicked to add it and the default wait time is 5 seconds.
If you right click on the phone, you get a set of menu options: Set, Send Text, Verify Element Exists, Verify Text, Go Back and Press Home.
1. Set: Right click on the element you want to set the text and select “Set” from the menu options. Wait for the element to be found. Once it is found, start typing on your keyboard the text you want to send and press the “Enter” key on the keyboard to execute that action.
2. Send Text: Right click on the phone and select “Send Text” from the menu options. Start typing on your keyboard the text you want to send and press the “Enter” key on the keyboard to execute that action on the element that is active.
3. Verify Element Exists: Right click on the element you want to interact with and select “Verify Element Exists” from the menu options.
4. Verify Text: Right click on the element you want to interact with and select “Verify Text” from the menu options. Wait for the element to be found. Once it is found, start typing on your keyboard the text you want to verify and press the “Enter” key on the keyboard to execute that action.
5. Go Back: Right click on the phone and select “Go Back” from the menu options.
6. Press Home: Right click on the phone and select “Press Home” from the menu options.
7. Inspect Element: Right click on an element and select “Inspect Element” from the menu options. The found element will now populate the locator value and type on the step builder.

Note:

With Set, Send Text and Verify Text, you can press the “Esc” key to cancel recording that step
Whenever the “Record mode” is disabled and there are unsaved steps, a popup will be displayed asking the user if they want to save their steps.
An option called “Inspect Element” is added to the right click menu in Record Mode which can be used to build a step manually that requires some kind of element locator info. The coordinates on the phone are also displayed in Record Mode now. With these two changes, a user doesn’t have to switch to Inspect Mode when they have to build a step manually.

Live Test Execution

This allows a user to test their steps with the connected device.

Select which steps to Live Execute by clicking the checkbox or clicking the select all button
Press the “Live Test” button below the Step Creator tab
Wait for execution to finish to see which selected steps passed or failed

Edit Test Steps

To edit test steps, click the pencil icon next to the "Live Test" button. Make any necessary changes to the step(s) and click the "Save Changes" button.

Edit Step Page

Delete Test Steps

Select which steps to Live Execute by clicking the checkbox or clicking the select all button
Click the red trash can icon by the "Select All" checkbox

Lock/Unlock Test Script

Prevents other Qyrus users from editing the test script. Only the user who locked the script can edit it.

Click the Lock icon next to the "Live Test" button
- Lock icon will turn red to indicate that the script is locked

To unlock the script, click the red lock icon
A popup prompt will appear, select "Yes" to unlock the script.

Expand/Collapse Test Steps

In the image above the user can click the marked icon to expand and collapse their test steps.

This view demonstrates what the test steps in the script look like once they are expanded. The user can click the icon again in order to collapse the steps into the original view.

Click the arrow next to the "Select All" checkbox to get more options for selecting test steps.

Enter values in the "From" and "To" text fields to select all the steps between that range. The selected steps can be deleted or can be run with Live Test.

Use the "Advance Options" section to move the selected steps to the step number specified in the text field highlighted below by clicking the "Move" button.

Test Step Options

Optional Step

Toggling on makes the step optional. Therefore, the status of the step will always be pass.

Parameterization

Allows the test step to use the paramterized data from the uploaded excel sheet.

Screenshot

Toggling on saves a screenshot of the step on the "Test Report" section. It is on by default.

Expand/Collapse Step

In the image above the user can click the marked icon to expand and collapse their test step.

Insert Step

In the image above the icon the arrow is pointing to allows the user to insert a step following that step in the script.

As an example above the icon was clicked at step 4 which created a new step below it slotted in step 5. The new step starts as a launch step initially but can be changed into any step as seen below.

Wait For Element

In the image above the highlighted icon is the wait for element button. Once selected it will create a wait for element step as shown in the above photo.

As shown in the image above when the step is created it includes the value that was used in the step the button was used on. So the Id value in step 4 is used for the wait for element step that was created.