Difference between revisions of "Command List"

From GXtest Wiki
Jump to: navigation, search
(Validations)
 
(6 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
[[category:GXtest Guides]]
 
[[category:GXtest Guides]]
 
[[category:GXtest Commands]]
 
[[category:GXtest Commands]]
 
== Command List ==
 
  
 
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 73: Line 72:
 
|-
 
|-
 
| 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.
 
| Concatenation || Allows concatenation of fixed values, variables and values from Datapools.
Line 138: Line 139:
 
|-
 
|-
 
| 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.
 
| Equals|| Compares each other two Data Pool, Variables or values.
Line 150: Line 153:
 
|-
 
|-
 
| VerifyColumnVisible || Verifies if a column is visble in a grid.
 
| 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.
 
| VerifyControlEnable || Verifies that a control is enabled.
Line 181: Line 186:
 
|VerifyResponseTime || Allows you to verify the time taken by the application to respond.
 
|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, buy that may appear in any row.
+
|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.'''
  
=== Considerations ===
+
== 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.
 
* 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

Spanish.gif
English.gif
Japan.gif

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.