Examples

ClickTableCell           Quantity             3
ClickTableCell           List Unit Price      5     double=True  # double clicks field

Parameters

column : str

Column header in table.

row : str

Row number in the column.

double : str

False (default): single-click. True: double-clicks the cell.

Related keywords

GetTableCell, TypeTable, VerifyTableCell

Examples

ClickText        Canis

In the above example the ClickText keyword will click the word Canis. If there are multiple instances of the word Canis on the page, first one will be clicked unless 'anchor' is given. You can specific which one should be clicked by either:

• a number or
• a word that is near to the word Canis

For example

ClickText    Canis    3     # clicks the third "Canis" on the page
ClickText    Canis    Dog   # clicks the "Canis" near to the word "Dog"
# handling numeric anchors as text, not index
ClickText    Canis    3     anchor_type=text   # clicks the "Canis" next text "3"

If text can't be found with normal means, you can use computer vision engine instead:

# clicks the text "Canis" using computer vision engine
ClickText    Canis    recognition_mode=vision

If you want to specify how long ClickText tries, you need to add both anchor and timeout.

ClickText    Canis    1     20s   # Tries to click the first "Canis" for 20s

If clickable element is child or parent of locator element use child/parent attribute + elements tagname to pick right element

ClickText   Canis     parent=span # Clicks Canis element's first parent with span -tag
ClickText   Canis     child=a     # First childnode with a -tag

ClickText   Canis     js=true     #Use Javascript click instead of Selenium

To double-click text, use argument doubleclick=True

ClickText   Canis       doubleclick=True

Or use SetConfig

SetConfig   DoubleClick     On
ClickText   Canis

To extend normal text search to shadow DOM, use SetConfig ShadowDOM. Note that certain arguments like partial_match are ignored when searching from shadow DOM.

SetConfig   ShadowDOM     True
ClickText   Canis

Parameters

text : str

Text to be clicked.

anchor : str

Text near the element to be clicked or index. If the page contains many places where the text argument is then anchor is used to get the one that is closest to it. (default 1)

timeout : str | int

How long we wait element to appear and click to succeed

parent : str

tag name for clickable parent.

child : str

tag name for clickable child.

js : boolean

If set to true, uses javascript instead of selenium to click element.

recognition_mode : str

Use either "web" backend (default) or computer vision ("vision"). Computer vision finds texts from the screen regardless how they appear on DOM. This is useful to verify truncated ui texts and especially when elements are under shadow dom.

Accepted kwargs:

css=False/off: Use this to bypass css search when finding elements by visible text

Examples

ClickTree        Western Sales Director   # expands node, does nothing if already expanded
ClickText        CA Sales Rep  # clicks subtree node
ClickTree        Western Sales Director   False   # collapses parent Tree node "User"

Parameters

label : str

Label of the parent tree element to click

expanded : bool

True (default) expands tree node, False will close it.

index : int

If there are multiple duplicate nodes in Tree layout, index can be used to identify which one should be verified. Note: only affects partial match, see below

timeout : str

How long to wait for page header to appear. Default 0 (use the default timeout setting)

kwargs :

Accepted kwargs:

partial_match: True. If element is found by it's attribute set partial_match

to True to allow partial match

Raises

QWebElementNotFoundError

Page did not contain parent Tree node element with given name. Note: If tree node does not have children, use ClickText instead. You can't expand/collapse nodes without children.

Examples

Combobox        Search Accounts...      Test Account
# using label and selecting 3rd duplicated instance
Combobox        *Account Name           Test Account   index=3

Parameters

locator : str

Placeholder for combobox (preferred) or label of the field having combobox. Note that all comboboxes do not open just by clicking the label. If using label, mandatory fields need the "*" character.

value : str

Value to be searched and selected from a combobox.

timeout : str | int

How long we try to find the combobox before failing. Default: DefaultTimeout configuration value.

index : int

If there are duplicated values in the search results, index of the instance which will be selected.

selection_delay : int

The delay in seconds after typing search term and starting to select item from results list. Default: 1 second

all_results : bool

If true, does not select the value from proposed values, but clicks "Show all results for..." item and selects value from the dialog that will open.

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

MultiPickList, GetPickList, GetPickListCount, VerifyPickList

Examples

${value}=          GetFieldValue        Phone           # returns 12345
${value}=          GetFieldValue        Notes           # returns text from Notes field

# returns non-formated text from a tag
${value}=          GetFieldValue        Quote Number    tag=a

Parameters

label : str

Label/heading of the record to verify.

index : int

If there are multiple duplicate labels in record layout, index can be used to identify which one should be verified.

timeout : str | int

Timeout for waiting element to appear before failing. Default value is what is set in "DefaultTimeout".

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

VerifyField

Examples

${mfa_code}=    GetOTP          my_user@testsf.com    ${MY_SECRET}
TypeText        Code            ${mfa_code}

Parameters

usenname : str

Salesforce username of the user logging in.

secret : str

Secret given by Salesforce when connecting an OTP authentication app to an account.

url : str

Salesforce instance url. Default: "https://login.salesforce.com"

Raises

ValueError

An error occurred while generating OTP. Please make sure correct details (user, secret) are used.

Related keywords

MultiPickList

Setup

1.Enable OTP authentication app in your SF user settings:

2. Get the security code. You can hover on top of the QR code or right-click and open the image in another tab (code will be in url):

3. FInalize the setup with you mobile authentication app and provide first code from the app.

4. Provide the security token in variable ${secret}. This should be given as encrypted variable in Copado Robotic Testing.

Examples

${options}=         GetPicklist        Salutation
# Returns  ['--None--', 'Mr.', 'Ms.', 'Mrs.', 'Dr.', 'Prof.']
${selected}=        GetPicklist        Salutation   selected=True
# Returns  'Mr.' if that one was selected.

Parameters

label : str

Label of the pick list where value should be selected.

index : int

If multiple picklists are present with same label, index can be used to identify which one should be selected. Default: 1

selected : bool

Return all options (False) or just currently selected option (True). Default: False

timeout : str | int

How long we try to find the picklist before failing. Default: DefaultTimeout configuration value.

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

PickList, MultiPickList, GetPickListCount, VerifyPickList

Examples

${count}=   GetPickListCount        Salutation   # returns 5

Parameters

label : str

Label of the pick list where value should be selected.

timeout : str | int

How long we try to find the picklist before failing. Default: DefaultTimeout configuration value.

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

PickList, MultiPickList, GetPickList, VerifyPickList

Examples

${value}=    GetTableCell          Quantity             3
${value}=    GetTableCell          List Unit Price      5

Parameters

column : str

Column header in table.

row : str

Row number in the column.

Related keywords

ClickTableCell, TypeTable, VerifyTableCell

Examples

GlobalSearch       ${login_url}   John Doe             # returns top results for "John Doe"
GlobalSearch       ${login_url}   John Doe     Contact # returns results for a Contact named "John Doe"

Parameters

instance_url: str

Salesforce instance base url.

search_term : str

The search term that will be searched for. Mandatory.

record_type : str

Type of the record(s) that will be searched. Optional, if omitted, TOP_RESULTS will be returned.

timeout : str

How long to wait for the search results page to appear. Default 0 (use the default timeout setting).

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

LaunchApp

Examples

LaunchApp          Sales    # Launch normal app
LaunchApp          Sales    Opportunities   # Launch app + check text after launch
LaunchAPp          Gmail    connected_app=True  # Launch connected app, skips checks
LaunchApp          E-Bikes  index=2   # Launch second instance if there are duplicates

Parameters

app_name : str

Exact name of the application to launch.

tab : str

Tab text which will be verified to exist after succesfully opening an application (optional).

connected_app: bool

Connected apps behave differently than "native" apps. After launching applauncher is left open and app opens in a new tab. If True is given here, we will skip check that applauncher is closed and verification of tab name. (optional) Default: False

index : int

If there are exact duplicate app names, index of item that should be selected (optional) Default: 1

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

Login

Examples

MultiPicklist    Hide Tabs     Auto Resolved Conflicts
# Move from "selected" back to "available"
MultiPicklist    Hide Tabs     Auto Resolved Conflicts   action=Move selection to Available

Parameters

label : str

Label of the pick list where value should be selected.

value : str

Value to be selected from a pick list.

action : str

Action of the button to click after selection. It's usually the text next to the button, or the text that appears when mouse pointer is hovered over the button. Default: "Move selection to Chosen" (select). Change to "Move selection to Available" to unselect.

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

PickList, GetPickList, GetPickListCount, VerifyPickList

Examples

PickList        Salutation      Mr.

# Finding with exact label when label includes special characters
# ("*" needs to be escaped with "\")
PickList        \*Status        Open     partial_match=False

Parameters

label : str

Label of the pick list where value should be selected.

value : str

Value to be selected from a pick list.

index : int

If multiple picklists are present with same label, index can be used to identify which one should be selected. Default: 1

timeout : str | int

How long we try to find the picklist before failing. Default: DefaultTimeout configuration value.

kwargs :

Accepted kwargs:

partial_match: False. If partial matches are accepted set

partial_match to True.

Default: as set in config PartialMatch. Check with 'GetConfig PartialMatch'

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

MultiPickList, GetPickList, GetPickListCount, VerifyPickList

Examples

# Default action, page down in a list
ScrollList

# Scrolls list up by one page
ScrollList  direction=page_up

# Scroll list right
ScrollList  uiScroller      right

# Scroll to the bottom of a list using different locator and tag
ScrollList  scrollable2     bottom      tag=custom_tag

# Scroll to the top of a list
ScrollList  direction=top

# Scroll (page) down 3 times in a list
Repeat Keyword     3 times    ScrollList    direction=down

Parameters

scrollable: str

Attribute value or xpath to identify scrollable element. Default: as set in setting SFScrollable

direction : str

Direction to scroll to (down, up, left, right, top, bottom, page_down, page_up).

• Down/up/left/right map to respective ARROW keys.
• Top/Bottom map to HOME & END keys.
• Page_up/Page_down map to PAGE_UP and PAGE_DOWN keys.

Default value: page_down

tag : str

Tag of the scrollable element. Needed if attribute value is used instead of xpath. Default value: div

timeout : str

How long to wait for the search results page to appear. Default 0 (use the default timeout setting).

Raises

QWebValueError

Direction is not given in correct format.

QWebElementNotFoundError

Page did not contain given scrollable element

Examples

TypeTable          Quantity             3     2.00
TypeTable          List Unit Price      5     9322

Parameters

column : str

Column header in table.

row : str

Row number in the column.

text : str

Text to be written into the field

Related keywords

ClickTableCell, GetTableCell, VerifyTableCell

Examples

ClickText          New

UseModal           On   # limits all text based element searches to dialog, if open
... do something in modal dialog
UseModal           Off

# Filter by non-default modal dialog
UseModal           On   //div[@class='slds-modal__container']

Parameters

status : str

Status of limitation (on/off). Default on

modal_xpath : str

Xpath to the root element of the modal dialog. Default: //div[contains(@class, 'modal-container')]

Examples

VerifyField        Phone             12345
VerifyField        Phone             123                 partial_match=True
VerifyField        Account Name      Customer X
VerifyField        Notes             This is the begi    partial_match=True

# verifies that field "Type" is empty
VerifyField        Type              ${EMPTY}

# Verifies text in non-formatted a tag
VerifyField        Lead Owner        John Doe            tag=a

Parameters

label : str

Label/heading of the record to verify.

value : str

Value which is expected to be in the field.

index : int

If there are multiple duplicate labels in record layout, index can be used to identify which one should be verified.

partial_match : bool

If full match is expected or if partial match is accepted. Default: False (full match)

timeout : str | int

Timeout for waiting element to appear before failing. Default value is what is set in "DefaultTimeout".

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

GetFieldValue

Examples

VerifyPageHeader    Opportunities

Parameters

tab_name : str

Name of the tab which should be opened.

timeout : str

How long to wait for page header to appear. Default 0 (use the default timeout setting)

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

LaunchApp, VerifyField

Examples

# Verify specific option value exists
VerifyPicklist        Salutation    Dr.
# Verify multiple option values exist
VerifyPicklist        Salutation    Mr.   Ms.    Dr.
# Verify specific value exists and is selected
VerifyPicklist        Salutation    Dr.   selected=True

Parameters

label : str

Label of the pick list where value should be selected.

args: str

Option values which should exist on a picklist

index : int

If multiple picklists are present with same label, index can be used to identify which one should be selected. Default: 1

selected : bool

Verifies that given option exists only (False) or that it also is the currently selected option (True). Default: False

timeout : str | int

How long we try to find the picklist before failing. Default: DefaultTimeout configuration value.

Raises

QWebElementNotFoundError

Page did not contain element

Related keywords

PickList, MultiPickList, GetPickList, GetPickListCount

Examples

VerifyTableCell          Quantity             3     2.00
VerifyTableCell          List Unit Price      5     7 632     partial_match=True

Parameters

column : str

Column header in table.

row : str

Row number in the column.

expected : str

Expected value in column to verify against.

partial_match : str

False (default): expect full match. True: allow partial matches

Related keywords

ClickTableCell, TypeTable, GetTableCell

Examples

VerifyText          Canis
VerifyText          Canis       20  # Waits max 20 seconds for text to appear
VerifyText          Canis       recognition_mode=vision  # Use Computer Vision engine

Parameters

text : str

Text to be verified.

timeout : str | int

How long we try to find text before failing. Default 10 (seconds)

anchor : str | int

Another text close to text we are trying to find or index.

recognition_mode : str

Use either "web" backend (default) or computer vision ("vision"). Computer vision finds texts from the screen regardless how they appear on DOM. This is useful to verify truncated ui texts and especially when elements are under shadow dom.