Skip to main content

Check if element is visible using Vision RPA

Written by Wrk Product
Updated over a week ago

Check if an element is visible using the element description, a reference image, or text.This Wrk Action uses AI-generated content. Like all AI content, use with caution; information may be outdated, incomplete, or inaccurate.

Application

  • Vision RPA

Inputs (what you have)

Name

Description

Data Type

Required?

Example

Session ID

The unique identifier of the session. Can be retrieved from 'Connect and log in to a VM' or 'Open a browser session' Wrk Action

Text (Short)

Yes

fb9bc380-146c-420e-9130-50ce93614e05

Maximum wait duration

The number of seconds to wait for

Number

Yes

Selection type

The method used to identify the element you want to check for

Predefined Choice List

Yes

Element reference image

Element description

Shown when Selection type is Element description. Description of the element to be found within the visible screen. See the documentation for config guidelines

Text (Long)

Yes

Log in button.

Element reference image

Shown when Selection type is Element reference image. Reference image to find within the visible screen. Capture reference image using the Wrk RPA Session Controller

File

Yes

Show advanced settings

Shown when Selection type is Element reference image. Show advanced settings for the element reference image

True/False

No

Convert to grayscale?

Shown when Selection type is Element reference image and Show advanced settings is Yes. Set to true to identify the element using grayscale

True/False

No

Level of image blur

Shown when Selection type is Element reference image and Show advanced settings is Yes. Image blur is used to smooth out noise and highlight overall shapes instead of fine details. Adjusting the blur can help the bot correctly recognize the object without being thrown off by unnecessary texture or losing too much detail

Predefined Choice List

No

Low

Minimum match percentage

Shown when Selection type is Element reference image and Show advanced settings is Yes. The minimum match percentage an image must meet to be considered the correct element. The highest match greater than or equal to this percentage will always be chosen. Range: 0-100. Default: 80

Number with decimals

No

80

Minimum scale percentage

Shown when Selection type is Element reference image and Show advanced settings is Yes. This Wrk Action will scale the provided reference image from the minimum scale to the maximum scale stepping by the amount provided. This feature allows you to provide a reference image that was taken at a different resolution or size than then the resolution in the browser session. Changing this will impact match percentage and speed. Default: 100

Number

No

80

Maximum scale percentage

Shown when Selection type is Element reference image and Show advanced settings is Yes. This Wrk Action will scale the provided reference image from the minimum scale to the maximum scale stepping by the amount provided. This feature allows you to provide a reference image that was taken at a different resolution or size than then the resolution in the browser session. Changing this will impact match percentage and speed. Default: 100

Number

No

120

Match percentage steps

Shown when Selection type is Element reference image and Show advanced settings is Yes. This Wrk Action will scale the provided reference image from the minimum scale to the maximum scale stepping by the amount provided. This feature allows you to provide a reference image that was taken at a different resolution or size than then the resolution in the browser session. Changing this will impact match percentage and speed. Default: 5

Number

No

5

Element text

Shown when Selection type is Element text. The text or regex of the element to be found within the visible screen. Example: Search value

Text (Long)

Yes

Search value

Match index

Shown when Selection type is Element text. The numbered order from left to right then top to bottom of the elements that match the provided text. Example: 1

Number

No

1

Enable regex?

Shown when Selection type is Element text. Set to true to enable regex for the element text filter

True/False

No

true

Search section

The section of the visible screen to search for the element in.

Predefined Choice List

No

Outputs (what you get)

Name

Description

Data Type

Required?

Example

Search image

Screenshot of the visible screen with the searched section highlighted in a green box and the found element in a red box

File

No

Found element coordinates

Coordinates of the found element within the visible screen

Text (Short)

No

[0, 0, 0, 0]

Match percentage

If reference image provided, the percentage match of the selected element in comparison to the provided reference image

Number with decimals

No

95.1

Text captured

If Selection type is element text, the complete output of all text found on the screen ordered from top left to bottom right

Text (Long)

No

Outcomes

Name

Description

Yes

This status is selected if the job returned an outcome of Yes.

No

This status is selected if the job returned an outcome of No.

Requirements

  • N/A

Did this answer your question?