ShowMessage Step in Step Configuration Wizard
A ShowMessage step allows to capture user inputs while running the test in the TestComposer environment. When the ShowMessage step is executed the message dialog box opens. The message dialog box either, contains a message to which you can response by selecting an option from a list of options provided in the dialog box, or contains a message to which you respond by entering textual information.
Based on your response to the message the next step is carried out.
To add a ShowMessage command step using the GUI scripting support:
While in the Test Steps pane, add a step by choosing the Actions > Add step... command. Select a ShowMessage command, click thebutton to validate the selection, and specify the following parameters:
- Run Type: A ShowMessage step can be executed sequentially (Sequential) or in parallel (Parallel) with other steps.
- Delay: A delay specifying by how much step start is delayed.
- Timeout: A period of time after which the step execution is considered to have timed out.
By default, 1 minute timeout is configured for this step. Setting the timeout to 0, makes execution of the step infinite.
At runtime, if no input is provided within this time, the default response is chosen as input.
- Ignore step: When this option is selected, the step is skipped at execution time. Selecting this option is equivalent to right-clicking a step in the Test Steps table and choosing the Exclude command from the context menu that appears.
- Description: An optional step description can be associated with a step.
Click Next.
Define the Conditional Execution settings as explained below.Conditional Execution settings enable you to define the system conditions a test step execution is monitored for. When such a predefined condition occurs a step error or a step timeout an user-defined procedure is executed and an additional action is performed. For example, on encountering a step error, you could enforce the execution of a cleanup procedure and then terminate the test.
To monitor the step for a predefined Timeout or Error condition, select the corresponding condition, then define the associated procedure local or shared (external) by clicking the
control of the Procedure field and selecting a procedure from the the drop-down pane that appears.
For the selected procedure you can view its defined arguments by clicking the
control of the Input Arguments field, which displays a cascading table-format pane containing the argument list. To specify the actual runtime argument(s) enter the desired values in the Current Value field(s).
Configure an additional action by clicking into additional actions column and selecting either of the following options:
- Continue: After performing the specified procedure, the test execution continues.
- Exit Test: After performing the specified procedure, the test execution is terminated.
Click Next.
Whenever the step execution is monitored for predefined events, an
icon is displayed in the step's corresponding Events selected column entry. For information on turning on the displaying of the Events selected column refer to Customizing the Script Steps Table Layout.
Specify the following parameters:
- Display message: The message that is displayed when the ShowMessage step is executed. The displayed message may contain TestComposer variables and cannot exceed a size of 125 characters.
- Input Type: The type of response that is required for the message. It can be either Multiple choice or Text Input.
Select Multiple choice, if you want the message to show a list of available responses and requires you to select a response from the available ones when the ShowMessage step is executed.
Select Text Input, if you want the message to show a text input box in which you have to type in textual information.
- Response Configuration: This pane allows you to define the acceptable response when the ShowMessage step is executed. The Response Configuration pane is dependent on the selected Input Type.
If you select Multiple choice as the Input Type, enter the options that you want to be displayed in the Message dialog box in the Response Text field. To add multiple options click ,
. You can enter at most 10 responses. Also, indicate the default response by selecting IsDefault against the Response Text. When the ShowMessage step is executed all the options are displayed in the Message dialog box and the default response is selected. If you have not indicated any of the responses as the default response the first response the appears in the list is used as the default response.
If you select Text Input as the Input Type, a text editor opens in the Response Configuration section and you can enter a default response text. You can also choose to leave it blank. When the ShowMessage step is executed the default response appears in the Message dialog box.
While the displayed message may contain TestComposer variables, the actual response texts may not be parameterized.
Click Next.
Verify the step summary information and revert to a previous configuration step if needed. Click Finish.
IxLoad TestComposer │ User Guide |