Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

This article shows you how to click on any text or link press and hold down a button, that has a text label, on the screen in Aria Digital Workplace Automation.

Purpose

Clicks text or a hyperlink in the current Application or website that has a text value.

Usage

Click a link with the text “Help”:

Syntax

Code Block
languagenone
ClickPress and Hold(n) "Save" label

Click a link with only a partial match of the text:

Code Block
Click "**Terms and conditions" label
Info

** will wildcard match the first instance of the text New User found within text and links in the UI. When you use this wildcard put as much as possible in order to ensure it finding the correct text/link. You can use the wildcard and placement values such as -third (see below) to both find

Click a link called “Help” nearest to the text on screen of “New Item”:

Code Block
Click "Help" label -nearestlabel("New Item")

Click the fifth “Add” link on the screen

Code Block
Click "Add" label -fifth

Inputs/Switches

...

Input/Switch

...

Values

...

Details

...

Name

...

Click "Cancel" label

Click "**I accept" label

...

The text inside the link exactly as shown or the first instance partially matching by using the wildcard prefix of **.

...

Placement

...

Click "Add" label -second

...

If there are multiple links with the same text you can specify which to click. You can use first, second, third, fourth or fifth.

...

Neareast Label

...

Click "Save" label -nearestlabel("New Item")

...

If you have multiple links with the same text you can help Aria find it by indicating some other text that is unique to that particular part of the screen.

Key Considerations

...

button label here" button
Include Page
Snippet - Aria Command Notes
Snippet - Aria Command Notes

Example 1

The example syntax below will command Aria to locate the button labeled “XXXXXXX” and press and hold it for 5 seconds.

Code Block
Press and Hold(5) "XXXXXXXX" button

...

Example 2

The example syntax below will command Aria to use wildcard match to find a button with the first instance of “XXXXX” contained within a label, and press and hold it for 5 seconds.

Code Block
Press and Hold(5) "*XXXXXXXX*" button

Include Page
Snippet - Aria Command Parameters2
Snippet - Aria Command Parameters2
Include Page
Snippet - Aria Command Footer
Snippet - Aria Command Footer
Include Page
Snippet - Footer - Tech
Snippet - Footer - Tech

...

Related Commands

Filter by label (Content by label)
showLabelsfalse
sorttitle
showSpacefalse
reversetrue
cqllabel in ( "kb-command-reference" , "kb-how-to-article" , "aria" , "kb-user-guide" , "product" ) and label = "aria"