Control

There are features that you can use when a scenario requires a branch point or when you need to repeat the same steps.

If UIObject

Determine if the set UIO object exists on the screen and run the child step.

Parent and Child Step Example

If UIObject Attributes

1. UIObject: The screen element that will be used to verify that it exists on the screen is printed.

2. comparator: Lets you select the comparison criteria. - EXISTS: If a screen element exists on the screen, run the child step. - NOT EXISTS: If the screen element does not exist on the screen, run the child step.

If UIObject Attributes Example

If Content

Used when the actual content of the UIOobject is used as a comparison target rather than the UIOobject itself. Text information of UIObject is read into OCR and compared with each other.

The difference is that If UIOject uses the screen element itself as a comparison, while If Content uses the Text information contained in it as a comparison rather than the screen element itself.

If Content Example

If Content Attributes

1. UIObject: A screen element containing the text to be compared is output.

2. comparator: allows you to select a comparison condition.

   • = : If the text and value of the screen element are the same, run the child step.

   • != : If the text and value of the screen element are different, run the child step.

   • > : If the text of the screen element is numeric and greater than value, run the child step.

   • >= : If the text of the screen element is numeric and is greater than or equal to value, run the child step.

   • <: If the text of the screen element is numeric and less than value, run the child step.

   • <= : If the text of the screen element is numeric and less than or equal to value, run the child step.

   • match: Use regular expressions. If the text of the screen element matches the regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.match

   • search: Use regular expressions. If the text of the screen element contains a regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.search

If Content Attributes Example

If Value

Action to use when using a value stored through a Store Value/Content or Random Number/Text action as a comparison destination. Therefore, there is no need to set a separate UIObject.

For more information, see Example 6. Using Conditional Actions.

pageExample5. How to use Conditional Action

If Value Attributes

1. key: Enter the key value of the previously stored value, such as Store Value/Content.

2. comparator: allows you to select a comparison condition.

   • = : If the text and value of the screen element are the same, run the child step.

   • != : If the text and value of the screen element are different, run the child step.

   • > : If the text of the screen element is numeric and greater than value, run the child step.

   • >= : If the text of the screen element is numeric and is greater than or equal to value, run the child step.

   • <: If the text of the screen element is numeric and less than value, run the child step.

   • <= : If the text of the screen element is numeric and less than or equal to value, run the child step.

   • match: Use regular expressions. If the text of the screen element matches the regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.match

   • search: Use regular expressions. If the text of the screen element contains a regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.search

3. value: Enter a string or number to compare.

If Value Attributes Example

If Changed

The If Changed action compares the screen just before the action of the previous step is performed with the change of the current device screen and executes the child step if the conditions are met.

Because you can detect changes in the content of content at a specific location on the screen, you can selectively run child steps by determining whether a toast pop-up or video is played.

For example, if a movie is playing, you can create a scenario that stops playing the movie.

Please refer to the example below.

pageExample6. Stop/Start a video in YouTube

If Changed Attributes

1. UIObject: A space element is output to detect changes in the screen.

2. threshold: You can specify a number to determine how much the screen element has changed. The smaller the number, the more likely it is to change the screen element. - Default value: 10 - Minimum value: 1 - Maximum value: 100 - Unit: %

3. limit: You can set a limit on how long you want to detect changes in the screen. If there is no change in the screen during the setup time, the child steps are not executed and proceed to the next step. - Default value: 5000 - Minimum value: 3000 - Maximum vlaue: 10000 - Unit: ms

Loop UIObject

Action to repeat child steps depending on whether a particular screen element exists on the screen.

The most common use case is when you create a scenario where you need to repeat scrolling until you get the content you want from a listed UI.

Please refer to the example below.

pageExample2. Scroll to find items

Loop UIObject Attributes

1. UIObject: The screen element to be used to determine the existence is output.

2. comparator: Select the criteria for determination. - EXISTS: Repeat the child steps when the screen element is present. - NOT EXISTS: If the screen element does not exist, repeat the child steps.

3. limit: You can set the maximum number of iterations for a child step. - Default value: 5 - Minimum value: 1 - Maximum value: None - Unit: Number of times

Loop UIObject Attributes Example

Loop Ntimes

It is a good action to use when you need to repeat the same step several times.

This action repeats the child steps a set number of times.

Example of a scenario in which you repeat the process of viewing details of recommended apps in the Play Store and moving to the next app with a swipe with Loop Ntimes

Loop Ntimes Attributes

1. limit: You can specify the number of iterations. - Default value: 5 - Minimum value: 1 - Unit: Number of times

Loop Ntimes Attributes Example

Loop Content

Action with one additional condition in addition to the number of iterations. Reads characters at specific locations on the screen to determine if they are repeated against the values specified by the author.

Please check the example below for detailed instructions.

pageExample7. Setting the alarm by scrolling the wheel control

Loop Content Attributes

1. UIObject: The screen element to read the string is output.

2. comparator: Lets you select the comparison criteria.

   • = : If the text and value of the screen element are the same, run the child step.

   • != : If the text and value of the screen element are different, run the child step.

   • > : If the text of the screen element is numeric and greater than value, run the child step.

   • >= : If the text of the screen element is numeric and is greater than or equal to value, run the child step.

   • <: If the text of the screen element is numeric and less than value, run the child step.

   • <= : If the text of the screen element is numeric and less than or equal to value, run the child step.

   • match: Use regular expressions. If the text of the screen element matches the regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.match

   • search: Use regular expressions. If the text of the screen element contains a regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.search

3. value: Enter a string or number to compare.

4. limit: Specifies the number of iterations. - Default value: 5 - Minimum value: 1 - Unit: Number of times

Loop Content Attributes Example

Loop Value

Run the child step by comparing the value you set with the value you saved in Store Value/Content or Random Number/Text. You do not need to specify a separate screen element because it uses a preset value.

Use this action to create a scenario where you can read and save the remaining points on the previous screen and repeat the steps of adding points until the remaining points reach a certain number.

Loop Value Attributes

1. key: Enter the key value of the preset value.

2. comparator: Lets you select the comparison criteria.

   • = : If the text and value of the screen element are the same, run the child step.

   • != : If the text and value of the screen element are different, run the child step.

   • > : If the text of the screen element is numeric and greater than value, run the child step.

   • >= : If the text of the screen element is numeric and is greater than or equal to value, run the child step.

   • <: If the text of the screen element is numeric and less than value, run the child step.

   • <= : If the text of the screen element is numeric and less than or equal to value, run the child step.

   • match: Use regular expressions. If the text of the screen element matches the regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.match

   • search: Use regular expressions. If the text of the screen element contains a regular expression, run the child step.

   Reference: https://docs.python.org/3/library/re.html#re.search

3. value: Enter a string or number to compare.

4. limit: Specifies the number of iterations. - Default value: 5 - Minimum value: 1 - Unit: Number of times

Loop Value Attributes Example

Loop Wait For

Action to wait for the set screen element to be output. When loading times are irregular, the test run time can be greatly reduced.

Example of waiting for the string Search here to appear when running Google Maps on a slow network or low specification device

Loop Wait For Attributes

1. UIObject: A screen element is output that you expect to be output on the screen.

2. limit: If the screen element does not output until the set time is exceeded, stop waiting and run the next step. - Default value: 1000 - Minimum value: 1000 - Maximum value: 60000 - Unit: ms

Loop Wait For Attributes Example