Configuring a run of an SAP GUI test

When you want to run an SAP GUI test, then you must configure a run of SAP GUI test or the Compound Test that contains SAP GUI tests on Test .

You must have completed the following tasks:

Read and completed the tasks mentioned in Test run considerations for running tests on remote performance agents, if you want to use a remote agent as the location to run the test.
Created a Compound Test that contains SAP GUI tests in IBM® DevOps Test UI (Test UI) and added the test asset to the project repository on Test. Refer to Task flow for running SAP tests on DevOps Test Hub.
Completed the Xray integration, if you want to export the test results to a Jira issue in your Xray project in Jira. See Integration with Xray test management for Jira.
Ensured that you are assigned a role as a Member or Project Creator in the team space. See Managing members and their roles in a team space.
Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
Created a project in your team space in Test. See Creating a project.
Added the remote Git repository that contains the test resources to the project. See Adding repositories to a server project.

You can run the SAP GUI test or Compound test that contains the SAP GUI test in Test, only by using the remote performance agent installed with the SAP runtime environment. If you have not installed any remote performance agent with the SAP run time environment, you do not see any agents in the Override column and the Execute button is disabled so that you cannot run the test.

Log in to Test.
The Projects page of the initial team space is displayed.
Open the project that contains the test assets, and then click Execution.
The test assets in the selected branch of the repository are displayed on the Execution page.
Perform any of the following steps based on the test you want to run:
- Click the TESTS tab to run the SAP GUI test.
- Click the SUITES tab to run the compound test that contains the SAP GUI test.
Identify the test that you want to run and click the Execute icon in the row of the identified test asset.

The Execute test asset dialog is displayed.
Note: If you do not want to continue with the current settings, click Reset to reset the settings.
Select the version of the test resources that you want to run.
Optional: Click Schedule to select a time for scheduling the test run.
Optional: Click the Add a label icon , type a label to identify the test on the Results page, and then press the Enter key.
Perform the following steps to select the performance agent and run the SAP GUI tests:
1. Click the LOCATION tab, if it is not already open.
  
  The performance agents installed with SAP GUI runtime are listed under the Host column.
  Note: You must have added performance agents to your project from the Agents and Intercepts page for the performance agents to be displayed under the Override column.
2. Select the performance agent where you want to run the test asset in the Override column.
Optional: Click Advanced to make the following advanced configurations:
1. Enter any JVM arguments that must be passed to the test run at run time in the JVM Arguments field, if applicable for the test.
  
  For example, you can set a maximum Java heap size.
2. Enter program arguments that must be passed to the test run at run time in the Program Arguments, if applicable for the test.
  
  If you want the test log for the test, you must enter -history testlog in the Program Arguments field.
3. Enter the environment variables that must be passed to the test run at run time in the Environment Variables field, if applicable for the test.
  
  For example, enter the environment variables when the third-party libraries that are used in the test run refer to the environment variables for configuration.
Note: You must separate the arguments or variables with a white space when you enter them in the same line or start each argument or variable on a new line.

The default value for each of the fields for the advanced settings is null or an empty field.

If you want to run the test immediately or at the scheduled time, click Execute, or continue with the next step.
Optional: Follow the instructions if you are running a test asset that contains datasets:
1. Click the DATA SOURCES tab, if it is not already open.
2. Consider the following information about datasets before you select a dataset:
  
  The default value for the datasets in the DATA SOURCES tab is null if the test asset did not have an associated dataset. If the asset had an associated dataset, the default value is the associated dataset.
  
  You can utilize the dataset stored as an Excel or CSV file to override the original dataset associated with the Suite, test, or schedule. For example, when you have associated a dataset in .xlsx, .xls, or .csv format with the test or schedule in desktop clients and if you have another set of data stored in an Excel or CSV file, then you can select that dataset from the Override list.
  Remember: You must have uploaded the dataset as an Excel or CSV file into the Git repository, and ensured that both the original dataset (from the test asset) and new datasets (added to the project) have the same column names.
3. Select the dataset that you want to use in the test run from any of the following options:
  - Select the dataset that is displayed as the default dataset when the test asset contains a single dataset.
    Note: If there is only one dataset in the test asset, then that dataset is displayed as the default dataset.
  - Select the dataset from the list.
    Note: If there are multiple datasets in the test asset, the datasets are listed in their increasing alphabetical order.
  - Select the dataset from the Override list to override the dataset that was associated with the test in the desktop client.
    Important: If the test contains an encrypted dataset, the Project Owner must classify it in the DATA SECURITY tab on the Project page before you can select it. You must have added datasets to your project from the Dataset page for the datasets to be displayed in the Override list.
If you want to run the test immediately or at the scheduled time, click Execute, or continue with the next step.
Optional: Follow the instructions in this step if the test requires a variable that must be passed to the test at the test run time.

You must configure the supported browser by using a variable if the test has a browser configured, which is different from the one that is supported by Test.
1. Click the VARIABLES tab, if it is not already open.
2. Choose one of the following methods to add the variables:
  - To add new variables manually, click the Add Variable icon , enter the name, and value of the variable.
    
    Enter RTW_WebUI_Browser_Selection as the name.
  - To add new variables from your local computer or from the Git repository that is associated with your project, click the Upload icon and choose either Upload from local system or Browse from server to select the variable file.
    Note: You must have created a file with the variables before you can select the file.
The default value for the variables is either null or an empty field.

If you want to run the test immediately or at the scheduled time, click Execute, or continue with the next step.

Optional: Follow the instructions if you want to export the test results to a Jira issue in your Xray project in Jira:

Click the RESULTS tab.

Perform the actions listed in the following table to select an option to export the test results:


Export options	Results in...	Actions
Jira Xray	The test results of the test that you configure for a run are exported to the selected issue after the test run is completed. The results are exported to the selected issue that exists in your Xray project in Jira.	Perform the following steps: Select the Jira Xray option. The Select issue field is displayed. Click the field to view the list of issues in the Xray project in Jira. Alternatively, you can enter the issue key in the Jira Xray project. Select the issue to which you want to export the test results. Continue with the next step.
New Jira item	The test results of the test that you configure for a run are exported to a new Jira issue. The issue is created in your project in Jira after the test run is completed.	Perform the following steps: Select the New Jira item option. Continue with the next step.
None	The test results are not exported. Note: This export option is the default option.	Perform the following steps when: You do not want to export the test results. You selected a Jira issue in a previous run of the same test, and you do not want to export the results of the current run. Select the None option. Continue with the next step.

Click Execute.

You have started or scheduled a test run of an SAP GUI test or Compound test that contains SAP GUI test.

You can perform any of the following tasks:

Stop the test run at any point after the test run is initiated from the Execution page. See Stopping test runs.
Cancel a scheduled test run from the Execution page. See Canceling scheduled test runs.
View all the states of the test asset by clicking the Show in the Progress page icon for the test asset for which you started or scheduled the run. See Viewing the state of test assets.
View the progress of the test from the Progress page. See Viewing the progress of running test assets.
View the results, reports, and logs of the test from the Results page after the test completes the run. See Test results.