PaceWords™

In Qentinel Pace, test cases are written using simple keywords, "PaceWords". PaceWords are keywords which are built-in to Qentinel Pace. They enable you to write test cases with high readability, usability, maintainability and robustness.

PaceWords replicate one user action, like

  • ClickText, clicking a text (button, link etc.) on a screen

  • TypeText, writing to an input field

  • VerifyText, verifying that some text appears on a screen

PaceWords are platform agnostic keywords, which mean you can use mostly the same PaceWords to write test cases testing mobiles, browsers or native operating system applications. The easiest way to get familiar with writing tests using PaceWords is to examine an example test case.

An example test case

Test the global home page
[Documentation]     Accepts the cookie policy, changes the
...        location to 'Global' and verifies home page text.
    [Tags]              Home
    Appstate            home
    ClickText           Accept
    ClickText           Change location
    ClickText           Global
    VerifyText          Robotic software testing. Qentinel Pace

Please note that PaceWords are continuously developed and maintained and hence refer to the latest version of PaceWords documentation.

Timeouts

Most Pacewords have an inbuilt timeout. They try to do their action (for example click a button) and re-try if button is not yet visible. PaceWords keep trying until they can perform the action correctly or until timeout is reached. If timeout is reached, the test case will fail.

The default timeout is 10 seconds. You can change the timeout in two ways:

  • For a specific Paceword call with argument

  • Globally for the whole test suite using SetConfig

Example
# the following two lines set the timeout to 2 seconds for this PaceWord call only
ClickText       Sign in   timeout=2
ClickText       Sign in   2

# the following line changes the timeout for every PaceWord until the end of test run
SetConfig       DefaultTimeout     60       # sets default timeout to 60 seconds, affecting all keywords

Anchors

Qentinel Pace interacts with elements mostly using the UI texts. Sometimes webpage or application contains multiple, duplicated UI texts. While Qentinel Pace tries it’s best to click only elements that are actually clickable, you may face situations where there are duplicated elements. By default Qentinel Pace clicks the first found element and it can be the "wrong" one. This is where concept of anchors steps in.

In nutshell, anchors are little hints to underlying test execution framework on which of the duplicate elements to select. They work with basically all interaction Pacewords which uses UI text as a locator (for example ClickText, TypeText etc.)

Anchor types

Anchors can be either text or numbers.

Textual anchors bind text to be found to another text close by. So using for example the following script:

ClickText    Login      anchor=Cancel

…​Qentinel Pace tries to find and click text Login which is closest to text Cancel.

Numeric anchors are positional; Qentinel Pace finds nth instance of the element on screen. For example, using the following script:

ClickText    Login      anchor=3

…​Qentinel Pace would click third instance of element containing text Login.