CA Plex C++ Interfac e Reference V3.0 - CM First Group · PDF fileWorksof t Certify ® CA...

Worksoft Certify®

CA Plex® C++

Interface Reference V3.0.000

Worksoft, Inc. 15851 Dallas Parkway, Suite 855 · Addison, TX

75001 www.worksoft.com · 866-836-1773

CM First Group USA 7000 North Mopac Expy, Plaza 7000 Bldg,

Second Floor · Austin, TX 78731 USA cmfirstgroup.com

1 | P a g e

http://www.worksoft.com/

Contents About ........................................................................................................................................................... 5

Support ........................................................................................................................................................ 5

Installation ................................................................................................................................................... 5

Database Interface Class Language Install ............................................................................................... 5

Plex Interface Install................................................................................................................................. 6

AutomatedQA TestExecute Install ........................................................................................................... 6

Learn ............................................................................................................................................................ 7

Configuration ........................................................................................................................................... 7

Plex Window/Object Learn Steps ............................................................................................................ 7

Handling Application Message Dialogs ...................................................................................................... 11

Classes and Actions .................................................................................................................................... 12

ANYCLASS Actions .................................................................................................................................. 13

Click Text ............................................................................................................................................ 13

Execute Method ................................................................................................................................. 13

Key Press ............................................................................................................................................ 14

Select Popup Menu ............................................................................................................................ 14

Send Click ............................................................................................................................................ 14

Set Property ........................................................................................................................................ 15

Store Property .................................................................................................................................... 15

Type Keys............................................................................................................................................ 15

Verify Property ................................................................................................................................... 16

WIN32_BUTTON Class ........................................................................................................................... 17

PRESS .................................................................................................................................................. 17

WIN32_CHECKBOX Class........................................................................................................................ 18

SET STATE ........................................................................................................................................... 18

STORE STATE ...................................................................................................................................... 18

2 | P a g e

VERIFY VALUE ..................................................................................................................................... 19

WIN32_COMBOBOX Class ..................................................................................................................... 20

SELECT ITEM ....................................................................................................................................... 20

STORE SELECTED ITEM ....................................................................................................................... 20

VERIFY SELECTED ITEM ....................................................................................................................... 21

WIN32_EDIT Class .................................................................................................................................. 22

INPUT VALUE ...................................................................................................................................... 22

STORE VALUE ..................................................................................................................................... 22

VERIFY VALUE ..................................................................................................................................... 23

WIN32_LISTBOX Class ............................................................................................................................ 24

SELECT ITEM ....................................................................................................................................... 24

STORE VALUE ..................................................................................................................................... 24

VERIFY VALUE ..................................................................................................................................... 25

WIN32_LISTVIEW Class ......................................................................................................................... 26

SELECT ITEM ....................................................................................................................................... 26

STORE VALUE ..................................................................................................................................... 27

VERIFY VALUE ..................................................................................................................................... 27

WIN32_TREEVIEW Class ........................................................................................................................ 28

SELECT NODE ..................................................................................................................................... 28

WIN32_RADIOBUTTON Class ................................................................................................................ 29

SELECT ................................................................................................................................................ 29

STORE SELECTED STATE ..................................................................................................................... 29

VERIFY SELECTED STATE ..................................................................................................................... 30

WIN32_STATIC Class .............................................................................................................................. 31

STORE VALUE ..................................................................................................................................... 31

VERIFY VALUE ..................................................................................................................................... 32

WIN32_TOOLBAR Class ......................................................................................................................... 33

PRESS BUTTON ................................................................................................................................... 33

WIN32_UPDOWN Class ......................................................................................................................... 34

3 | P a g e

SET VALUE .......................................................................................................................................... 34

WINDOW Class ...................................................................................................................................... 35

CLOSE ................................................................................................................................................. 35

SELECT MENU..................................................................................................................................... 35

SET WINDOW CAPTION ..................................................................................................................... 35

wsGrid Class ........................................................................................................................................... 36

SELECT ROW BY VALUE(S) .................................................................................................................. 36

SELECT ROW BY NUMBER .................................................................................................................. 37

STORE CELL ......................................................................................................................................... 37

VERIFY CELL ........................................................................................................................................ 37

XTPReport Class ..................................................................................................................................... 38

SELECT ROW BY NUMBER .................................................................................................................. 38

SELECT ROW BY VALUE(S) .................................................................................................................. 38

STORE CELL ......................................................................................................................................... 39

VERIFY CELL ........................................................................................................................................ 39

XTPTaskBar Class .................................................................................................................................... 40

XTPShortcutBar Class ............................................................................................................................. 40

XTPToolBar Class .................................................................................................................................... 41

Usage ......................................................................................................................................................... 42

Building a test scenario .......................................................................................................................... 42

4 | P a g e

About

The Worksoft Certify CA Plex C++ integration product allows CA Plex generated C++ interfaces to tested with Worksoft Certify. Worksoft Certify® is Worksoft’s flagship next-generation functional testing solution that enables QA professionals to build enterprise test plans without writing low level scripting routines. See this link for more information on the Worksoft Certify product.

http://www.worksoft.com/products/worksoft-certify.html

Contact CM First for more information on using Worksoft Certify to test other CA Plex generated applications, such as C#/WPF, Java, 5250, or CM WebClient Mobile or Web.

Support

Questions and support for this interface should be directed to support.cmfirsttech.com.

CM First Group USA

7000 North Mopac Expy, Plaza 7000 Bldg, Second Floor · Austin, TX 78731 USA

cmfirstgroup.com

Installation

Certify must be installed and the interface .zip (i.e. Certify Plex Interface 3.0.000.zip) must be uncompressed to a temp directory.

Database Interface Class Language Install The person designated the Certify DBA will run db scripts from the Plex ICL data directory. The directory resides in the uncompressed .zip directory.

5 | P a g e

http://www.worksoft.com/products/worksoft-certify.html

http://support.cmfirsttech.com/

The DBA can run apply.exe or install the scripts one at a time. If running the scripts one at a time, please follow the order in instructions.xml.

Always backup the Certify database before running the ICL scripts.

Plex Interface Install For each workstation run Certify CA Plex Setup.exe. This file resides in the temp directory.

AutomatedQA TestExecute Install TestExecute 9.x must be installed for each workstation, and there will need to be a TestExecute license for each of the workstations that will need to run consecutively.

6 | P a g e

Learn

The Plex learn creates .map files that describe the windows and objects of the AUT (Application under Test). These .map files are imported into Certify.

Configuration TestExecute and the Certify Plex Interface must be installed.

Plex Window/Object Learn Steps Double click the Certify CA Plex Learn (TestExecute) icon:

Right-Click the TestExecute icon in the system tray and select Run from the menu:

The Select - Process Windows dialog appears with a list of all aut windows that can be learned. Select a window from the list and press Learn:

7 | P a g e

The Select Anchor dialog appears. In most situations you will press the N/A button and not select an anchor. However, if the same aut’s window caption is used for several logical windows or the aut has windows that dynamically instantiate GUI elements, then a unique anchor may be required for Certify’s window recognition routine:

The Objects window appears. This window displays the objects (gui elements) found on the window:

Several operations can be performed from the Objects window:

• Save creates a .map file that contains all the objects for the window. The .map file is imported into Certify.

• Cancel aborts the learn process. • Highlight flashes a red border in the AUT for the selected object. • Rename allows user to change the logical name of the window or object.

Please note! If the root item doesn’t have a distinct name, you will need to name it for the specific tab or screen you are testing. For complex screens, and screens that have controls that do not have a logical name, it is recommended that you give these controls a logical name so that when building your tests, you can differentiate the controls and use them properly.

• Load Map lays a previously saved map over the displayed objects. This serves two purposes:

8 | P a g e

1. Re-loads a saved .map file to continue renaming. 2. Allows for collecting objects into a single .map file (i.e. late binding

or dynamic instantiation of objects).

The Wildcard(*) Captions dialog appears. It is populated with the window caption. There are two key things you will need to do here. The first is to rename the main text of the window caption to something which will match any testing of that will be done with this window. For example, if the possible window captions for this screen are: “Window One Connection One”, “Window One Connection Two”, and “Window One No Connection”, you will want to put a wildcard at the end of the text that will be present on all screens. You would name it “Window One*”.

The next thing you will want to do is to give it a logical name for the index identifier. This is the last parameter, a “1” by default. Name it something that will identify it as the specific screen or tab that you are mapping.

Wildcards can be at the beginning, end, or both of the window class or window caption.

The Save As dialog appears. This saves the .map file. The user should us a name that describes the learned window:

9 | P a g e

10 | P a g e

Handling Application Message Dialogs Two types of messagebox dialogs are supported by the Plex Interface:

• Windows • Plex

Both are supported with the unknown window. Plex object have a plex prefix and windows objects have a win32 prefix. The Set Caption window action allows for dynamic window recognition. Position a Set Caption step before the messagebox step and the interface will verify the caption from the Set Caption step. If the caption is not the same the step will fail. The unknown.map resides in the interface map directory and must be imported into the Certify Application/Version for the given Aut.

11 | P a g e

Classes and Actions Certify supports a standard set of Plex classes (object controls). When creating processes or working in the Interface Library within Certify, you will see these classes listed by their logical name. Each of these classes contains a set of actions and parameters that you may need to use in your tests against Plex applications. This section provides descriptions for each class, action, and parameter, and a narrative for each.

Standard Plex classes:

• Plex_PushButton • Win32_Button • Win32_Checkbox • Win32_ComboBox • Win32_Edit • Win32_ListBox • Win32_ListView • Win32_TreeView • Win32_RadioButton • Win32_Static • Win32_Tab • Win32_TabStrip • Win32_Toolbar • Win32_Updown • Window • wsGrid

The Plex interface inherits all Win32 classes.

CodeJock controls also supported:

• XTPReport • XTPTaskBar • XTPToolBar • XTPShortcutBar

12 | P a g e

ANYCLASS Actions

AnyClass actions are inherited by all classes. Each class provides a list of the actions that are supported.

Actions: Click Text

Execute Method Key Press Select Popup Menu Send Click Set Property Store Property Type Keys Verify Property

Click Text Single or double click text in a control. This will first try to use the TestComplete Text Recognition for sending the click to set UI elements such as buttons and menu items. If unsuccessful, it will attempt to use optical character recognition (OCR) to find the text within the confines of the specific control. The Text Recognition option is faster and more reliable than the OCR, but requires an extra step to enable. If performance suffers, or the text cannot be found, contact support to ensure that Text Recognition is supported for the control you are attempting to use.

Name

Prompt

Direction

Control Data

Type Value

Text Text Input Editbox Text The text to click. Type

Type Click Input Editbox Listbox Single or double click.

Execute Method Executes a method for given object. The method is based on the specified arguments.

Name

Prompt

Direction

Control Data

Type Value

Method Method Input Editbox Text The method name. Can be manually entered or retrieved from a variable.

Argument1- 8

Optional Argument 1-8

Input Editbox Text The argument(s) to pass to the method. Can be manually entered or retrieved from a variable.

13 | P a g e

Key Press

The action presses a key or key sequence.

Name

Prompt

Direction

Control Data

Type Value

Key Key(s) Input Combina- tion Box

Text Select from a list of keys to press. The key to press must be in TestComplete format. For example “[Home]” will press the “Home” key. The key options are: (ENTER), (BACKSPACE), (SPACEBAR), (TAB), (UP), (DOWN), (LEFT), (RIGHT), (F1), (F2, (F3), (F4), (F5), (F6), (F7), (F8), (F9), (F10), (F11), (F12).

Number Number of Times

Input Editbox Text The number of times you want to press the key combinations.

Mask Shift, Ctrl, Alt

Input ListBox Text Allows you to press the Shift, Ctrl, or Alt key while selecting another key. You can also specify other keys by choosing a variable holding the value.

Select Popup Menu

Performs a mouse click on an object and selects a menu item.

Name

Prompt

Direction

Control Data

Type Value

Menu Menu Input Editbox Text The menu to select in TestComplete format. TestComplete uses the “|” symbol to separate submenus (i.e. File|Open).

Click TypeClick Input ListBox Text The type click “Right” or “Left” can be stored in a variable or selected from the argument’s combo box.

Send Click

Performs a mouse click to the control. The type of click performed must be specified. The click is sent to the control, but not to a specific location on the control.

Name

Prompt

Direction

Control Data

Type Value

ClickType Click Type Input ListBox Text Select the click type. The options include LeftClick, DoubleClick, or RightClick.

14 | P a g e

Name

Prompt

Direction

Control Data

Type Value

Key Key(s) Input Editbox Text Input a value or select a variable that contains the value.

Set Property

The action sets the property of an object to a specified value. If you are unsure about the properties of an object, use TestComplete to learn the object. From there you can see what the properties of the object are.

Name

Prompt

Direction

Control Data

Type Value

Property Property Input EditBox Text The property name. Can be manually entered or retrieved from a variable.

Value Value Input Editbox Text The value to set the property to. Can be manually entered or retrieved from a variable.

Store Property

The action stores a property value in a variable for a given object. If you are unsure about the properties of an object, use TestComplete to learn the object. From there you can see what the properties of the object are.

Name

Prompt

Direction

Control Data

Type Value

Property Property Input EditBox Text The property name can be manually entered or stored in a variable.

Variable Variable Output Variable Only

Text The variable to store the value in.

Type Keys

The action types the keys that are specified.

Narrative: [Object] [Class] key(s) - Type <*Key>

15 | P a g e

VB Classes and Actions

Verify Property

The action verifies any property value for a given class.

Name

Prompt

Direction

Control Data

Type Value

Property Property Input EditBox Text The property name. Input a value or select a variable that contains the value.

Value Value Input Editbox Text The expected property value. Can be manually entered or stored in a variable.

Wait Wait Until Input Editbox Text Type the time, in milliseconds, to wait before the verify times out.

Condition Criteria Input Variable Condi- tion List

Text Select one of the following criteria: Is Equal To (the default), Is Not Equal To, Is Less Than, Is Less Than Or Equal To, Is Greater Than, Is Greater Than or Equal To, Starts With, Contains, Does Not Con- tain, Is Empty, or Is Not Empty.

16 | P a g e

WIN32_BUTTON Class

The Win32_Button class is comprised of actions that interact with Win32 push button controls. A button is a control the user can click to provide input to an application. A standard push button is typically used to start an operation. It receives the keyboard focus when the user clicks it.

Logical Name: Win32_Button Physical Name: Win32_Button

Actions: PRESS

Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)

See the "ANYCLASS Actions" for descriptions of all actions not described here.

PRESS

The action performs single-click on a button belonging to this type of class.

17 | P a g e

WIN32_CHECKBOX Class

The Win32_Checkbox class has actions that interact with Win32 check box controls. With the check box control, any number of check boxes may be selected.

Logical Name: Win32_Checkbox Physical Name: Win32_Checkbox

Actions: SET STATE

STORE STATE VERIFY STATE Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)

SET STATE

The action sets the checkbox state to either checked or unchecked.

Name

Prompt

Direction

Control Data

Type Value

State State Input ListBox Text State of the checkbox. Options include Checked or Unchecked. Can be picked from the list or stored in a variable. Case does not matter.

STORE STATE

The action stores the object’s state – cbChecked, cbUnchecked or cbGrayed.

Name

Prompt

Direction

Control Data

Type Value


Text Select the variable you wish to store the text value of the object in.

18 | P a g e

VERIFY VALUE

The action verifies the state of the checkbox.

Name

Prompt

Direction

Control Data

Type Value

Value Value Input Combo Text cbChecked, cbUnchecked or cbGrayed

19 | P a g e


WIN32_COMBOBOX Class

The Win32_ComboBox class has actions that interact with Win32 combo box controls. A ComboBox displays an editing field combined with a ListBox, allowing the user to select from the list or to enter new text. The default behavior of ComboBox displays an edit field with a hidden drop-down list.

Logical Name: Win32_ComboBox Physical Name: Win32_ComboBox

Actions: SELECT ITEM

STORE SELECTED ITEM VERIFY SELECTED ITEM Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


SELECT ITEM

Select an item from the Windows 32 ComboBox control.

Name

Prompt

Direction

Control Data

Type Value

Item Item Input EditBox Text The name of the item to select. A variable containing the name of the item can be selected.

STORE SELECTED ITEM

The action stores the object’s selected value.

Name

Prompt

Direction

Control Data

Type Value



20 | P a g e

VERIFY SELECTED ITEM

Verifies that the value of the selected items meets a specified criteria.

Name

Prompt

Direction

Control Data

Type Value

Value Value Input EditBox Text The expected value of the object. Can be manually entered or stored in a variable.


Text Select the criteria. Criteria include: Is Equal To (the default), Is Not Equal To, Is Less Than, Is Less Than Or Equal To, Is Greater Than, Is Greater Than or Equal To, Starts With, Contains, Does Not Con- tain, Is Empty, or Is Not Empty.

Wait Wait Until Input Edit Text The maximum number of seconds to wait for the expected value

21 | P a g e

WIN32_EDIT Class

The Win32_Edit class has actions that interact with Win32 edit controls. An edit control is a rectangular control window typically used in a dialog box to permit the user to enter and edit text by typing on the keyboard.

Logical Name: Win32_Edit Physical Name: Win32_Edit

Actions: INPUT

STORE VERIFY Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


INPUT VALUE

The action inputs a typed value or a value contained within a variable into this type of control.

Name

Prompt

Direction

Control Data

Type Value

Value Value Input EditBox Text The value of the object. Can be manually entered or stored in a variable.

Key Key Input ListBox Text Specify the key to be pressed. Options are None, Tab, or Enter. Can be manually entered or stored in a variable.

STORE VALUE

The action stores the object’s displayed text to a variable.

Name

Prompt

Direction

Control Data

Type Value



22 | P a g e

VERIFY VALUE

The action verifies that the value of the control meets a specified criteria.

Name

Prompt

Direction

Control Data

Type Value





23 | P a g e


WIN32_LISTBOX Class

The Win32_ListBox class has actions that interact with Win32 list box controls. A ListBox allows the user to select from a list of values.

Logical Name: Win32_ListBox Physical Name: Win32_ListBox

Actions: SELECT ITEM STORE SELECTED ITEM VERIFY SELECTED ITEM



SELECT ITEM

Select an item from the Windows 32 ListBox control.

Name

Prompt

Direction

Control Data

Type Value

Item Item Input EditBox Text The name of the item to select. A variable containing the name of the item can be selected.

STORE VALUE


Name

Prompt

Direction

Control Data

Type Value



24 | P a g e

VERIFY VALUE

Verifies that the value of the control meets a specified criteria.

Name

Prompt

Direction

Control Data

Type Value





25 | P a g e


WIN32_LISTVIEW Class

The Win32_ListView class has actions that interact with Win32 ListView controls. The Windows Forms ListView control displays a list of items with icons.

Logical Name: Win32_ListView Physical Name: Win32_ListView

Actions: SELECT ITEM

STORE SELECTED ITEM VERIFY SELECTED ITEM Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


SELECT ITEM

Performs a selection by single or double clicking or checking or unchecking an item on a Win32 ListView item.

Name

Prompt

Direction

Control Data

Type Value

Row Row Number or Text

Input EditBox Text The row number or text visible on the row that you want to select. The first row is 1, not 0. Can be manually entered or stored in a variable.

ClickType Click Type Input ListBox Text Specify the type of click for this item. Click Types are Double, Single, Check, and Uncheck. Can be picked from a list or called from a variable. Case does not matter.

26 | P a g e

STORE VALUE


Name

Prompt

Direction

Control Data

Type Value



VERIFY VALUE


Name

Prompt

Direction

Control Data

Type Value





27 | P a g e


WIN32_TREEVIEW Class

The Win32_TreeView class has actions that interact with Win32 TreeView controls. The Windows Forms TreeView control displays a list of items, in expandable trees with optional icons.

Logical Name: SysTreeView32 Physical Name: SysTreeView32

Actions: SELECT NODE



SELECT NODE

Performs a selection by single or double clicking an item on a Win32 TreeView control.

Name

Prompt

Direction

Control Data

Type Value

Text The text path of the selected node

Input EditBox Text The text path of the node to be selected separated by a | character. For example, in order to select a node of Two nested under a node of One, input “One|Two”.

ClickType Click Type Input ListBox Text Specify the type of click for this item. Click Types are Double, or Single

28 | P a g e

WIN32_RADIOBUTTON Class

The Win32_RadioButton class is comprised of actions that interact with Win32 radio button controls.

Logical Name: Win32_RadioButton Physical Name: Win32_RadioButton

Actions: SELECT

STORE SELECTED STATE VERIFY SELECTED STATE Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


SELECT

The action selects a Windows 32 Radio button.

STORE SELECTED STATE

The action stores the object’s state.

Name

Prompt

Direction

Control Data

Type Value



29 | P a g e

VERIFY SELECTED STATE

The action Verifies the state of the control.

Name

Prompt

Direction

Control Data

Type Value

Value Value Input Listbox Text Selected or Not Selected


30 | P a g e


WIN32_STATIC Class

The Win32_Static class is comprised of actions that interact with Win32 labels. A static control is a control that enables an application to provide the user with informational text and graphics that typically require no response. Static text controls provide a convenient way to display text on dialog boxes and other windows. Static text controls often serve as labels for other controls.

Logical Name: Win32_Static Physical Name: Win32_Static

Actions: STORE VALUE

VERIFY VALUE Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


STORE VALUE

The action stores the name of the label to a variable.

Name

Prompt

Direction

Control Data

Type Value


Text Select the variable you wish to store the name of the label in.

31 | P a g e

VERIFY VALUE


Name

Prompt

Direction

Control Data

Type Value

Value Value Input EditBox Text The expected value of the control. Can be manually entered or stored in a variable.



32 | P a g e


WIN32_TOOLBAR Class

The Win32_Toolbar class is comprised of actions that interact with Win32 toolbar controls. The Windows Forms ToolBar control is used on forms as a control bar that displays a row of drop-down menus and bit mapped buttons that activate commands. Thus, clicking a toolbar button can be an equivalent to choosing a menu command.

Logical Name: Win32_Toolbar Physical Name: Win32_ToolbarWindow32

Actions: PRESS BUTTON



PRESS BUTTON

The action presses the specified button on the toolbar.

Name

Prompt

Direction

Control Data

Type Value

Value Button text or index

Input EditBox Text Specify the caption on the button or the position of where the button is located in number format (e.g., 1, 2, 3, 4). Can be manually entered or stored in a variable.The caption is case-sensitive.

Click Type Click Input Listbox Text Left or Right

33 | P a g e


WIN32_UPDOWN Class

The Win32_UpDown class is comprised of actions that interact with Win32 updown controls. This class creates an UpDown control, which increments or decrements numbers, or scrolls through a range of values or a list of items.

Logical Name: Win32_UpDown Physical Name: Win32_msctls_updown32

Actions: SET VALUE



SET VALUE

The action sets the value of the control.

Name

Prompt

Direction

Control Data

Type Value

Value Value Input EditBox Text The text or index value of the button to press. Can be manually entered or stored in a variable.

34 | P a g e

WINDOW Class

The Window class is comprised of a group of actions that interact with Plex windows forms.

Logical Name: Window Physical Name: Window

Actions: CLOSE

SELECT MENU Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)

CLOSE The action closes a window.

SELECT MENU

The action performs single-click on a window menu.

Name

Prompt

Direction

Control Data

Type Value

Menu Menu Input Editbox Text The menu to select in TestComplete format. TestComplete uses the “|” symbol to separate submenus (i.e., File|Open).

SET WINDOW CAPTION

The action sets the caption for unknown windows.

Name

Prompt

Direction

Control Data

Type Value

Caption Caption Input Editbox Text The window caption to verify on the next unknown window step.

35 | P a g e

wsGrid Class

The wsGrid class has actions that interact with Plex grid control.

Logical Name: Win32_Edit Physical Name: Win32_Edit

Actions: SELECT ROW BY VALUE(S)

SELECT ROW BY NUMBER STORE CELL VERIFY CELL Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


SELECT ROW BY VALUE(S) Finds and selects a row in the grid by searching for a row with expected value(s). After finding the row that meets the search criteria a single or double click can be performed.

Name

Prompt

Direction

Control Data

Type Value

Click_Cell_Index Click Cell Index Input EditBox Text The column to click on. Any Column Number (1-based).

Click_Cell_Type Click Cell Type Input Combo Text Type of click. Can be Single or Double.

Main Value Main Value Input EditBox Text Searches for this value. If found searches for Sub-Values on the same row.

MainCriteria Criteria for Main Value

Input ListBox Text Can be Is Equal To, Contains, Starts With.

SubValue1-3

Sub-Value #1-3 Input EditBox Text Searches for these values on the rows where it finds the Main Value. If all Sub-Values are found the step passes.

Criteria1-3 Sub-Value #1 Criteria – #3 Criteria

Input Listbox Text Can be Is Equal To, Contains, Starts With.

36 | P a g e

SELECT ROW BY NUMBER

Uses row number to select the row. A single or double click can be performed.

Name

Prompt

Direction

Control Data

Type Value

Row Row # Input EditBox Text The row number to click.

Type Type Click Input Combo Text Type of click. Can be Single or Double.

STORE CELL

Will store the value of a cell in a Certify variable. The step uses the row that is selected.

Name

Prompt

Direction

Control Data

Type Value

Variable Variable Output Variable Text The variable to store the cell value.

ColumnIndex Column Index Input Editbox Text The column index

VERIFY CELL

Compares the actual cell value to a expected value. The step uses the row that is selected.

Name

Prompt

Direction

Control Data

Type Value


ColumnIndex Column Index Input Editbox Text The column index.

Value Value Verify Editbox Text The expected value.

Condition Criteria Input Condition list

Text Select from condition list.

37 | P a g e

VB Classes and Actions XTPReport Class

The XTPReport class is a grid control that has more complexity and more features than the standard Plex Grid, such as allowing the user to drag columns to rearrange them.

Logical Name: XTPReport Physical Name: XTPReport

Actions: SELECT ROW BY NUMBER

SELECT ROW BY VALUE(S) STORE CELL VERIFY CELL Execute Method (Any Class) Key Press (Any Class) Select Popup Menu (Any Class) Send Click (Any Class) Set Property (Any Class) Store Property (Any Class) Type Keys (Any Class) Verify Property (Any Class)


SELECT ROW BY NUMBER

Specify which row to click on based on ordinal number.

Name

Prompt

Direction

Control Data

Type Value

Row# Value Input EditBox Text Specify the caption row number to select

Click Type Click Input Listbox Text Single or Double

SELECT ROW BY VALUE(S) Finds and selects a row in the grid by searching for a row with expected value(s). After finding the row that meets the search criteria a single or double click can be performed.

Name

Prompt

Direction

Control Data

Type Value

Click_Cell_Index Click Cell Index Input EditBox Text The column to click on. Any Column Number (1-based).

38 | P a g e

Click_Cell_Type Click Cell Type Input Combo Text Type of click. Can be Single or Double.

Main Value Main Value Input EditBox Text Searches for this value. If found searches for Sub-Values on the same row.

MainCriteria Criteria for Main Value

Input ListBox Text Can be Is Equal To, Contains, Starts With.

SubValue1-3

Sub-Value #1-3 Input EditBox Text Searches for these values on the rows where it finds the Main Value. If all Sub-Values are found the step passes.

Criteria1-3 Sub-Value #1 Criteria – #3 Criteria

Input Listbox Text Can be Is Equal To, Contains, Starts With.

STORE CELL

Will store the value of a cell in a Certify variable. The step uses the row that is selected.

Name

Prompt

Direction

Control Data

Type Value


ColumnIndex Column Index Input Editbox Text The column index

VERIFY CELL

Compares the actual cell value to a expected value. The step uses the row that is selected.

Name

Prompt

Direction

Control Data

Type Value


ColumnIndex Column Index Input Editbox Text The column index.

Value Value Verify Editbox Text The expected value.

Condition Criteria Input Condition list

Text Select from condition list.

39 | P a g e

XTPTaskBar Class

The XTPTaskBar class is a very flexible control that can take several forms, including a menu. The most thoroughly tested format of this is the menu format. Click Text is the recommended way to click on the desired item.

Logical Name: XTPTaskBar Physical Name: XTPTaskBar

Actions: Click Text (Any Class)



XTPShortcutBar Class

The XTPShortcutBar class is a control that gives broader categories for menu selection to display an expanded menu when clicked on. An example of the way this looks is the Microsoft Outlook sidebar and accordion menu. Click Text is the recommended way to click on the desired item.

Logical Name: XTPShortcutBar Physical Name: XTPShortcutBar




40 | P a g e

XTPToolBar Class

The XTPToolBar class is a control that groups buttons into customizable groups. At this time, Click Text is the only supported way to click on the desired item.

Logical Name: XTPToolBar Physical Name: XTPToolBar


41 | P a g e

Usage

Building a test scenario When you have saved the .map file from the Learn process, you can start building a test scenario. Launch Certify, and log in. The first thing you will need to do is create an application. This will only need to be done the first time that you get started. Subsequent tests for the same AUT can use the same application. In Certify, click on Applications, and then click on the New Application button. Give it a name appropriate for the UAT, and give the version of the UAT. You will want to select Plex as the Interface. Next you will create a project. This will need to happen once when you first get started, but will not need to happen again until a new testing project begins. Click on the Project menu item on the left hand side of the certify interface. Click on the New Project button and enter a name appropriate to the testing project that you are starting. Then select the Application that you created in the previous step.

42 | P a g e

Next we are going to open the project you just created. You should now see your project in the list of projects in the treeview and/or the listing in the middle of the interface. Right click on the project, and select

“Open Project”. Now that we have the project open we can start adding to it. Click on the menu item called ‘Maps’. You should see the project and application in the

43 | P a g e

treeview area. Right click on the application and version that you are testing and select ‘Import Maps’. In the window that comes up, select Plex as the interface. Then, change the Import Directory to the location that you saved your map to. Once you have, you should see your map. Check the box next to your map, and click OK. Please take a moment to ensure that the root object in the tree is the name that map is for, and the objects listed are the ones contained on the screen. Then click OK, and it will import the map. Once the map has been imported, you are ready to build the steps of the specific scenario that you would like to test. Click on Processes, and then click on the New Process button. On the Process Detail screen, give the scenario a logical name, and click on the Steps tab. Here you will build the steps that you need to test the scenario. Keep in mind that you will need to break each action down logically and in order. Right-click in the grid area, and select New. A new row will appear with a series of drop-down boxes. These contain the details of the steps. To get started select the Application, and then choose the window that you will start the test with.

44 | P a g e

Choose the Object that you will be interacting with, (i.e. XTPShortcutBar). The default action will be selected. Choose a different action if you want to do something different with this control. Once you have chosen the action, you can fill the details of the action in the Parameters area. See the references to the actions in the previous section to get help with the details of what to fill out in the parameters area. Repeat this process with each step of the test that you want to run. Once finished, save the process and close this window. In the Processes area of Certify, you can select this process to run.

Please note: You cannot run the Learn process at the same time as the test. Be sure to close the Learn process completely before run

45 | P a g e

CA Plex C++ Interfac e Reference V3.0 - CM First Group · PDF fileWorksof t Certify ® CA...

Documents

Transcript of CA Plex C++ Interfac e Reference V3.0 - CM First Group · PDF fileWorksof t Certify ® CA...