Difference between revisions of "Command List"
From GXtest Wiki
(→Actions) |
(→Actions) |
||
| Line 68: | Line 68: | ||
! 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. |
|- | |- | ||
| − | | Concatenation || Allows concatenation of fixed values, variables and values from | + | | Concatenation || Allows concatenation of fixed values, variables and values from Datapools. |
|- | |- | ||
| − | | DPNext || Move to the next row of a | + | | 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 | + | | DPReset || Returns to the beginning of a Datapool. |
Note: In order to re-use a Datapool, the DPNext command must be executed against it. | Note: In order to re-use a Datapool, the DPNext command must be executed against it. | ||
|- | |- | ||
| − | | DragAndDrop || Drag a control to another one | + | | DragAndDrop || Drag a control to another one. |
|- | |- | ||
| − | | Execute || Execute a process (exe, bat, etc) | + | | Execute || Execute a process (exe, bat, etc). |
|- | |- | ||
| − | | FillInput || Used to insert a value into a field | + | | 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. | | [[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 | + | | 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 | + | | 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 | + | | 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). |
|- | |- | ||
| − | | | + | | 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. |
|- | |- | ||
| − | | SetCheckBoxValue || Sets a value on a CheckBox | + | | 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 Command | 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 || Saves the HTML of the page and captures a screenshot when executed | + | | 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. |
|} | |} | ||
Revision as of 20:04, 29 May 2015
 |
 |
 |
Contents |
Command List
GXtest Commands are grouped in three categories: accions, events or validations.
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. |
| 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 |
| 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 |
| 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. |
* When execute a command on a balloon, GXtest waits until the balloon disappears to continue with the next command to execute.
Considerations
- Bear in mind that all validations which include String comparisons are Case Sensitive, starting in GXtest 3.0 or greater.
