Difference between revisions of "Command List"
From GXtest Wiki
(→Actions) |
|||
(19 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{Idiomas | + | {{Idiomas|Lista de Comandos|Command List|コマンドリスト}} |
− | |Lista de Comandos | + | |
− | |Command List | + | |
− | }} | + | |
[[category:GXtest Guides]] | [[category:GXtest Guides]] | ||
[[category:GXtest Commands]] | [[category:GXtest Commands]] | ||
− | |||
− | |||
GXtest Commands are grouped in three categories: accions, events or validations. | GXtest Commands are grouped in three categories: accions, events or validations. | ||
+ | == Web Commands List == | ||
=== Events === | === Events === | ||
Line 21: | Line 17: | ||
| Click || Clicks on a GeneXus control | | Click || Clicks on a GeneXus control | ||
|- | |- | ||
+ | | [[ClickBy Command|ClickBy]]|| Clicks over an HTML control, identified by its name, id, class or xpath. | ||
+ | |- | ||
| ClickLinkByCaption || Clicks on a link. The difference between this event and the previous is that sometimes because of how an application is constructed the same control has more than one name. In these cases ClickLinkByCaption is used to specify the name of the link to be controlled | | ClickLinkByCaption || Clicks on a link. The difference between this event and the previous is that sometimes because of how an application is constructed the same control has more than one name. In these cases ClickLinkByCaption is used to specify the name of the link to be controlled | ||
|- | |- | ||
Line 43: | Line 41: | ||
| Close || Closes a window | | Close || Closes a window | ||
|- | |- | ||
− | | DummyEvent || Does nothing. Used to go | + | | DummyEvent || Does nothing. Used to go from one page to another without performing an event |
|- | |- | ||
| FacebookLogin || Does the login when the authentication of the application is done with Facebook credentials | | FacebookLogin || Does the login when the authentication of the application is done with Facebook credentials | ||
Line 69: | Line 67: | ||
! style="background:#efefef;" colspan="2" | Actions | ! style="background:#efefef;" colspan="2" | Actions | ||
|- | |- | ||
− | | Check || Allows you to tick or check a CheckBox | + | | Check || Allows you to tick or check a CheckBox. |
|- | |- | ||
− | | CheckTable || Same as Check but used for controls that are located in tables | + | | CheckTable || Same as Check but used for controls that are located in tables. |
|- | |- | ||
− | | Choose || Allows you to select an option from a RadioButton | + | | Choose || Allows you to select an option from a RadioButton. |
|- | |- | ||
− | | | + | | ChooseTable || Same as Choose but used for controls that are located in tables. |
|- | |- | ||
− | | | + | | Concatenation || Allows concatenation of fixed values, variables and values from Datapools. |
|- | |- | ||
− | | | + | | DPNext || Move to the next row of a Datapool. You should always use DPNext before you begin to use a Datapool, indicating the name of Datapool. |
|- | |- | ||
− | | | + | | DPReset || Returns to the beginning of a Datapool. |
+ | Note: In order to re-use a Datapool, the DPNext command must be executed against it. | ||
|- | |- | ||
− | | | + | | DragAndDrop || Drag a control to another one. |
|- | |- | ||
− | | | + | | Execute || Execute a process (exe, bat, etc). |
|- | |- | ||
− | | | + | | FillInput || Used to insert a value into a field. |
|- | |- | ||
− | | | + | | [[FillInputBy Command|FillInputBy]] || Is used to insert a value on an HTML editable field, which is identified by id, name, class or xpath. |
|- | |- | ||
− | | | + | | FillInputTable || Used to insert a value into a field within a table. |
|- | |- | ||
− | | | + | | GetValue || Allows you to obtain a value returned from an application and store it in a variable to later be used in another command. |
|- | |- | ||
− | | | + | | GetValueTable || Same as GetValue but used for values that are located in tables. |
|- | |- | ||
− | | | + | | [[LoadCSV Command|LoadCSV]] || LoadCSV command is used to dinamycally load data from a CSV file to a datapool, during the execution of a testcase, so we can use the data contained inside the file as inputs of the testcase. |
|- | |- | ||
− | | | + | | Pause || Sleep the execution for some time. You should indicate the length of the pause in miliseconds. |
|- | |- | ||
− | | | + | | PressKey || Simulates a keystroke made by a user. For more information on how to specify different keys see the following [http://msdn.microsoft.com/en-us/library/8c6yea83(VS.85).aspx reference]. |
|- | |- | ||
− | | | + | | Random || Generates random sequences of numbers and characters of a given length. |
|- | |- | ||
− | | | + | | SelectCombo || Allows you to select a value from a list of values (combobox). |
|- | |- | ||
− | | SetCheckBoxValue || Sets a value on a CheckBox | + | | SelectComboInTable || Allows you to select a value from a list of values (combobox) that are found within a table. |
+ | |- | ||
+ | | SelectRow || Allows you to select a row in a table. | ||
+ | |- | ||
+ | | SeleniumCommand || Allows you to execute an arbitrary Selenium command. | ||
+ | |- | ||
+ | | SetCheckBoxValue || Sets a value on a CheckBox. | ||
|- | |- | ||
| SetGridContext || Allows you to execute actions over controls in grids within grids. You can find more information in [[Inputs in Grids within Grids]]. | | SetGridContext || Allows you to execute actions over controls in grids within grids. You can find more information in [[Inputs in Grids within Grids]]. | ||
|- | |- | ||
− | | [[SQLExecute Command| SQLExecute]] || Executes an arbitrary SQL sentence over a selected database | + | | [[SQLExecute Command| SQLExecute]] || Executes an arbitrary SQL sentence over a selected database. |
|- | |- | ||
− | | StoreValue || Save a value or variable inside one DataPool in execution time | + | | [[StoreValue Command | StoreValue]] || Save a value or variable inside one DataPool in execution time. |
|- | |- | ||
− | | Summarize || Summarize a group of values | + | | Summarize || Summarize a group of values. |
|- | |- | ||
− | | TakeScreenshot || | + | | TakeScreenshot || Saves the HTML of the page and captures a screenshot when executed. |
|- | |- | ||
− | | UnCheck || Allows you to uncheck a CheckBox | + | | UnCheck || Allows you to uncheck a CheckBox. |
|- | |- | ||
− | | UnCheckTable ||Same as UnCheck but used for controls that are located in tables | + | | UnCheckTable ||Same as UnCheck but used for controls that are located in tables. |
|} | |} | ||
Line 129: | Line 134: | ||
! style="background:#efefef;" colspan="2" | Validations | ! style="background:#efefef;" colspan="2" | Validations | ||
|- | |- | ||
− | | AppearBalloon* || Checks if a balloon appears on a control | + | | AppearBalloon* || Checks if a balloon appears on a control. |
|- | |- | ||
− | | AppearBalloonTable* || Similar to AppearBalloon but used for controls within grids | + | | AppearBalloonTable* || Similar to AppearBalloon but used for controls within grids. |
|- | |- | ||
− | | AppearText || Checks if a specific text is or is not on the screen. It can also be used for validations performed by Ajax. If it indicates a GeneXus object associated with the node where the command is being run, it will search the text in the frame that contains this object. If it is not indicated then it will look in the main frame | + | | AppearText || Checks if a specific text is or is not on the screen. It can also be used for validations performed by Ajax. If it indicates a GeneXus object associated with the node where the command is being run, it will search the text in the frame that contains this object. If it is not indicated then it will look in the main frame. |
|- | |- | ||
− | | | + | | DatapoolCompare || Compares row by row the data between two datapools. Returns OK if both datapools contains the same rows with the same values. |
|- | |- | ||
− | | | + | | Equals|| Compares each other two Data Pool, Variables or values. |
|- | |- | ||
− | | | + | | IsItemInList || Verifies if an especific item exists in a list of items. |
|- | |- | ||
− | | | + | | SeleniumCommand || Allows you to execute an arbitrary Selenium command. |
|- | |- | ||
− | | | + | | TableOrderedBy || Checks to see if a table is sorted by a given column. |
|- | |- | ||
− | | | + | | TableRowsNumber || Checks the number of rows of a given table. |
|- | |- | ||
− | | | + | | VerifyColumnVisible || Verifies if a column is visble in a grid. |
|- | |- | ||
− | | | + | | VerifyControlCheck || Verifies that a checkbox control is checked. |
|- | |- | ||
− | | | + | | VerifyControlEnable || Verifies that a control is enabled. |
|- | |- | ||
− | | | + | | VerifyControlEnableTable || Same as VerifyControlEnable but used for controls that are found in a table. |
|- | |- | ||
− | | | + | | VerifyControlFocus || Verifies if the current application focus is in the right control. |
|- | |- | ||
− | | | + | | VerifyControlFocusTable || Same as VerifyControlFocus but used for controls that are found in a table. |
|- | |- | ||
− | | | + | | VerifyControlText || Compares a value displayed by a control with another value. |
|- | |- | ||
− | | | + | | VerifyControlTextTable || Same as VerifyControlText but used for controls that are found in a table. |
|- | |- | ||
− | | | + | | VerifyControlValidation* || Compares a value displayed in a balloon in a control. |
|- | |- | ||
− | | | + | | VerifyControlValidationTable* || Similar to VerifyControlValidation but used for controls within grids. |
|- | |- | ||
− | | | + | | VerifyControlVisible || Verifies that a control is visible. |
|- | |- | ||
− | | VerifyItemsInListTable || Same as VerifyItemsInList but used for controls within grids | + | | VerifyControlVisibleTable || Same as VerifyControlVisible but used for controls that are found in a table. |
+ | |- | ||
+ | | VerifyItemsInList || Checks the elements in a list. | ||
+ | |- | ||
+ | | VerifyItemsInListTable || Same as VerifyItemsInList but used for controls within grids. | ||
|- | |- | ||
| VerifyItemsInSuggestion || Checks the list of elements in a input suggestion list. | | VerifyItemsInSuggestion || Checks the list of elements in a input suggestion list. | ||
|- | |- | ||
− | | VerifyItemsInSuggestionTable || Same as VerifyItemsInSuggestion but used for controls within grids | + | | VerifyItemsInSuggestionTable || Same as VerifyItemsInSuggestion but used for controls within grids. |
|- | |- | ||
− | |VerifyResponseTime|| | + | |VerifyResponseTime || Allows you to verify the time taken by the application to respond. |
+ | |- | ||
+ | |VerifyTextInTable || Verifies that a value exists inside a specific column of a grid, but that may appear in any row. | ||
|} | |} | ||
'''* When execute a command on a balloon, GXtest waits until the balloon disappears to continue with the next command to execute.''' | '''* When execute a command on a balloon, GXtest waits until the balloon disappears to continue with the next command to execute.''' | ||
+ | |||
+ | == Mobile Commands List == | ||
+ | |||
+ | === Events === | ||
+ | {| border="1" cellpadding="5" cellspacing="0" align="center" width="100%" | ||
+ | |- | ||
+ | ! style="background:#efefef;" | Event || Description || Android || iOS | ||
+ | |- | ||
+ | | Back || It is analogous to press the Back button on the device. || Yes || No | ||
+ | |- | ||
+ | | Go || Open the application that is located in the path of the device. || Yes || Yes | ||
+ | |- | ||
+ | | Tap|| Gives a Tap on the selected control. || Yes || Yes | ||
+ | |- | ||
+ | | Tap Table|| Gives a tap over the selected table/control. || Yes || Yes | ||
+ | |- | ||
+ | | Tap Text|| Gives a tap over the selected text. || Yes || Yes | ||
+ | |} | ||
+ | |||
+ | === Actions === | ||
+ | {| border="1" cellpadding="5" cellspacing="0" align="center" width="100%" | ||
+ | |- | ||
+ | ! style="background:#efefef;" | Action || Description || Android || iOS | ||
+ | |- | ||
+ | | Concatenation || Concatenate allows fixed, variable and Datapool values. || Yes || Yes | ||
+ | |- | ||
+ | | DPNext || Continues to the next line in Datapool. Always should do a DPNext before continuing to use the Datapool, indicating the name. || Yes || Yes | ||
+ | |- | ||
+ | | DPReset || Makes it start again from the beginning of Datapool, only you must indicate the name of Datapool. Note: To reuse the Datapool, you must run a DPNext back on that Datapool. || Yes || Yes | ||
+ | |- | ||
+ | | Enter || Taps Enter. || Yes || No | ||
+ | |- | ||
+ | | Execute || Executes a process (exe, bat, etc.) || Yes || Yes | ||
+ | |- | ||
+ | | FillInput || Used to enter a value in a field. || Yes || Yes | ||
+ | |- | ||
+ | | GetValue || Gets a value given by the application and stores it in a variable to later be used in another command. || Yes || Yes | ||
+ | |- | ||
+ | | Menu || Taps Menu. || Yes || No | ||
+ | |- | ||
+ | | Pause || Puts the execution to sleep for a certain time. Must indicate the duration of the pause in milliseconds. || Yes || Yes | ||
+ | |- | ||
+ | | Random || Generates random sequences of numbers and characters, of selected range. || Yes || Yes | ||
+ | |- | ||
+ | | [[Comando SQLExecute|SQLExecute]] || Allows you to run arbitrary SQL databases on different sentences. || Yes || Yes | ||
+ | |- | ||
+ | | [[Comando StoreValue|StoreValue]]|| Saves a given value in the DataPool or variable during execution. || Yes || Yes | ||
+ | |- | ||
+ | | Summarize || Summarizes a group of values. || Yes || Yes | ||
+ | |- | ||
+ | | Swipe || Makes a move (swipe) on the screen in the direction indicated. || Yes || Yes | ||
+ | |- | ||
+ | | TakeScreenshot || Saves a screen capture in the moment that the command is executed. || Yes || Yes | ||
+ | |} | ||
+ | |||
+ | === Validations === | ||
+ | {| border="1" cellpadding="5" cellspacing="0" align="center" width="100%" | ||
+ | |- | ||
+ | ! style="background:#efefef;" | Validation || Description || Android || iOS | ||
+ | |- | ||
+ | | AppearText || Validates whether a given text is or is not on the screen. || Yes || Yes | ||
+ | |- | ||
+ | | DatapoolCompare|| Compares the values line by line in two datapools. Returns OK if the datapools have the same lines with the same content. || Yes || Yes | ||
+ | |- | ||
+ | | Equals|| Compares the value of a value (DataPool, Value or Variable) to another value. || Yes || Yes | ||
+ | |- | ||
+ | | VerifyControlCheck || Verifies that a type of checkbox control is checked. || Yes || No | ||
+ | |- | ||
+ | | VerifyControlText || Compares a reference value with the value shown by a control. || Yes || Yes | ||
+ | |} | ||
+ | == Considerations == | ||
+ | * Bear in mind that all validations which include String comparisons are [http://es.wikipedia.org/wiki/Case_sensitive Case Sensitive], starting in GXtest 3.0 or greater. |
Latest revision as of 13:55, 14 September 2016
GXtest Commands are grouped in three categories: accions, events or validations.
Contents |
Web Commands List
Events
Events | |
---|---|
Back | The same as clicking the Back button in a browser |
Click | Clicks on a GeneXus control |
ClickBy | Clicks over an HTML control, identified by its name, id, class or xpath. |
ClickLinkByCaption | Clicks on a link. The difference between this event and the previous is that sometimes because of how an application is constructed the same control has more than one name. In these cases ClickLinkByCaption is used to specify the name of the link to be controlled |
ClickMenu | Allows you to click in a menu item |
ClickPortalMenu | Allows you to open a specific menu of an application developed with GXPortal |
ClickPrompt | Allows you to open a prompt to select values from a list |
ClickPromptInTable | The same as the above except for fields that are located in a table |
ClickTable | Allows you to click on a control that is located in a table |
ClickTableHeader | Allows you to click in a grid column header. |
ClickTableLinkByCaption | Allows you to click on a link that is located in a table, specifying the link caption |
ClickToolbarButton | Allows you to click on a toolbar button in an application made with GeneXus X and that uses a User Control with ExtJS |
ClickTree | Allows you to open a menu developed with ExtJS TreeMenu (in an application made with GeneXus X and that uses a User Control with ExtJS) |
Close | Closes a window |
DummyEvent | Does nothing. Used to go from one page to another without performing an event |
FacebookLogin | Does the login when the authentication of the application is done with Facebook credentials |
Go | The same as typing a web address (URL) into a browser |
GoAndLogin | The same as the Go command except that it allows you to enter a username and password for applications that require it |
GoogleLogin | Does the login when the authentication of the application is done with Google credentials |
GoToObject | The same as Go, but specifying a GeneXus object name instead of the full application URL. |
LoginPortal | Allows you to login to an application that uses GXPortal for security |
PressKey | Idem to the action, but for those keys that produces a transition to other page (like an enter) |
SeleniumCommand | Allows you to define Selenium commands to execute in GXtest. |
TwitterLogin | Does the login when the authentication of the application is done with Twitter credentials |
Actions
Actions | |
---|---|
Check | Allows you to tick or check a CheckBox. |
CheckTable | Same as Check but used for controls that are located in tables. |
Choose | Allows you to select an option from a RadioButton. |
ChooseTable | Same as Choose but used for controls that are located in tables. |
Concatenation | Allows concatenation of fixed values, variables and values from Datapools. |
DPNext | Move to the next row of a Datapool. You should always use DPNext before you begin to use a Datapool, indicating the name of Datapool. |
DPReset | Returns to the beginning of a Datapool.
Note: In order to re-use a Datapool, the DPNext command must be executed against it. |
DragAndDrop | Drag a control to another one. |
Execute | Execute a process (exe, bat, etc). |
FillInput | Used to insert a value into a field. |
FillInputBy | Is used to insert a value on an HTML editable field, which is identified by id, name, class or xpath. |
FillInputTable | Used to insert a value into a field within a table. |
GetValue | Allows you to obtain a value returned from an application and store it in a variable to later be used in another command. |
GetValueTable | Same as GetValue but used for values that are located in tables. |
LoadCSV | LoadCSV command is used to dinamycally load data from a CSV file to a datapool, during the execution of a testcase, so we can use the data contained inside the file as inputs of the testcase. |
Pause | Sleep the execution for some time. You should indicate the length of the pause in miliseconds. |
PressKey | Simulates a keystroke made by a user. For more information on how to specify different keys see the following reference. |
Random | Generates random sequences of numbers and characters of a given length. |
SelectCombo | Allows you to select a value from a list of values (combobox). |
SelectComboInTable | Allows you to select a value from a list of values (combobox) that are found within a table. |
SelectRow | Allows you to select a row in a table. |
SeleniumCommand | Allows you to execute an arbitrary Selenium command. |
SetCheckBoxValue | Sets a value on a CheckBox. |
SetGridContext | Allows you to execute actions over controls in grids within grids. You can find more information in Inputs in Grids within Grids. |
SQLExecute | Executes an arbitrary SQL sentence over a selected database. |
StoreValue | Save a value or variable inside one DataPool in execution time. |
Summarize | Summarize a group of values. |
TakeScreenshot | Saves the HTML of the page and captures a screenshot when executed. |
UnCheck | Allows you to uncheck a CheckBox. |
UnCheckTable | Same as UnCheck but used for controls that are located in tables. |
Validations
Validations | |
---|---|
AppearBalloon* | Checks if a balloon appears on a control. |
AppearBalloonTable* | Similar to AppearBalloon but used for controls within grids. |
AppearText | Checks if a specific text is or is not on the screen. It can also be used for validations performed by Ajax. If it indicates a GeneXus object associated with the node where the command is being run, it will search the text in the frame that contains this object. If it is not indicated then it will look in the main frame. |
DatapoolCompare | Compares row by row the data between two datapools. Returns OK if both datapools contains the same rows with the same values. |
Equals | Compares each other two Data Pool, Variables or values. |
IsItemInList | Verifies if an especific item exists in a list of items. |
SeleniumCommand | Allows you to execute an arbitrary Selenium command. |
TableOrderedBy | Checks to see if a table is sorted by a given column. |
TableRowsNumber | Checks the number of rows of a given table. |
VerifyColumnVisible | Verifies if a column is visble in a grid. |
VerifyControlCheck | Verifies that a checkbox control is checked. |
VerifyControlEnable | Verifies that a control is enabled. |
VerifyControlEnableTable | Same as VerifyControlEnable but used for controls that are found in a table. |
VerifyControlFocus | Verifies if the current application focus is in the right control. |
VerifyControlFocusTable | Same as VerifyControlFocus but used for controls that are found in a table. |
VerifyControlText | Compares a value displayed by a control with another value. |
VerifyControlTextTable | Same as VerifyControlText but used for controls that are found in a table. |
VerifyControlValidation* | Compares a value displayed in a balloon in a control. |
VerifyControlValidationTable* | Similar to VerifyControlValidation but used for controls within grids. |
VerifyControlVisible | Verifies that a control is visible. |
VerifyControlVisibleTable | Same as VerifyControlVisible but used for controls that are found in a table. |
VerifyItemsInList | Checks the elements in a list. |
VerifyItemsInListTable | Same as VerifyItemsInList but used for controls within grids. |
VerifyItemsInSuggestion | Checks the list of elements in a input suggestion list. |
VerifyItemsInSuggestionTable | Same as VerifyItemsInSuggestion but used for controls within grids. |
VerifyResponseTime | Allows you to verify the time taken by the application to respond. |
VerifyTextInTable | Verifies that a value exists inside a specific column of a grid, but that may appear in any row. |
* When execute a command on a balloon, GXtest waits until the balloon disappears to continue with the next command to execute.
Mobile Commands List
Events
Event | Description | Android | iOS |
---|---|---|---|
Back | It is analogous to press the Back button on the device. | Yes | No |
Go | Open the application that is located in the path of the device. | Yes | Yes |
Tap | Gives a Tap on the selected control. | Yes | Yes |
Tap Table | Gives a tap over the selected table/control. | Yes | Yes |
Tap Text | Gives a tap over the selected text. | Yes | Yes |
Actions
Action | Description | Android | iOS |
---|---|---|---|
Concatenation | Concatenate allows fixed, variable and Datapool values. | Yes | Yes |
DPNext | Continues to the next line in Datapool. Always should do a DPNext before continuing to use the Datapool, indicating the name. | Yes | Yes |
DPReset | Makes it start again from the beginning of Datapool, only you must indicate the name of Datapool. Note: To reuse the Datapool, you must run a DPNext back on that Datapool. | Yes | Yes |
Enter | Taps Enter. | Yes | No |
Execute | Executes a process (exe, bat, etc.) | Yes | Yes |
FillInput | Used to enter a value in a field. | Yes | Yes |
GetValue | Gets a value given by the application and stores it in a variable to later be used in another command. | Yes | Yes |
Menu | Taps Menu. | Yes | No |
Pause | Puts the execution to sleep for a certain time. Must indicate the duration of the pause in milliseconds. | Yes | Yes |
Random | Generates random sequences of numbers and characters, of selected range. | Yes | Yes |
SQLExecute | Allows you to run arbitrary SQL databases on different sentences. | Yes | Yes |
StoreValue | Saves a given value in the DataPool or variable during execution. | Yes | Yes |
Summarize | Summarizes a group of values. | Yes | Yes |
Swipe | Makes a move (swipe) on the screen in the direction indicated. | Yes | Yes |
TakeScreenshot | Saves a screen capture in the moment that the command is executed. | Yes | Yes |
Validations
Validation | Description | Android | iOS |
---|---|---|---|
AppearText | Validates whether a given text is or is not on the screen. | Yes | Yes |
DatapoolCompare | Compares the values line by line in two datapools. Returns OK if the datapools have the same lines with the same content. | Yes | Yes |
Equals | Compares the value of a value (DataPool, Value or Variable) to another value. | Yes | Yes |
VerifyControlCheck | Verifies that a type of checkbox control is checked. | Yes | No |
VerifyControlText | Compares a reference value with the value shown by a control. | Yes | Yes |
Considerations
- Bear in mind that all validations which include String comparisons are Case Sensitive, starting in GXtest 3.0 or greater.