Creating an environment

Edit online

You can create an environment to define custom variables that override the variables defined in the test when you run a test or suite. You can also configure profile overrides so that cloud-native devices can replace the default browsers or device profiles when you run a test or suite.

Before you begin

You must have completed the following tasks:

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 Hub. See Creating a project.

Added the remote Git repository that contains the test resources to the project. See Adding repositories to a server project.

About this task

You can use environments such as Dev, QA, or Staging to manage a set of variables and profiles with different values. When you run a test, the environment variables dynamically replace the matching variable values, and profile overrides replace the browser or device profiles defined in the test.

Procedure

Log in to Test Hub.
The Projects page of the initial team space is displayed.
Click My projects > project_name to open the project that contains the test assets.
The Overview page of the project is displayed.
Navigate to Author > Test Editor.
The Test Editor page and test navigator panel are displayed.
Perform any of the following actions:
- Click the Action Menu icon and select Environment.
- Right-click the application folder in the test navigator panel and select New > Environment.
The Edit branch dialog is displayed.

If the Edit branch dialog is not displayed, then go to step 6.
Select your action to either select an existing Edit branch or create an Edit branch:
- Perform the following steps to select an existing Edit branch:
  1. Select Use an existing edit branch.
  2. Select an Edit branch from the Select branch list if Edit branches already exist for your repository.
    
    Note: A warning message is displayed if the Edit branch, which you selected, is behind the source branch. To update the selected edit branch and maintain synchronization with the source branch, you can select the Update branch option when switching checkbox.
  3. Click Ok.
- Perform the following steps to create the Edit branch:
  1. Select Create new edit branch.
  2. Enter a name for the Edit branch in the Branch Name field.
  3. Click Save.
Perform the following steps to configure the environment details in the Create Environment dialog.
1. Select a target application from the Application drop-down list.
2. Enter a unique name for your environment in the Name field.
Click Done.
The new environment is created, and it opens in the Test Editor for further configuration.
Perform the following steps to add specific variables in the Variables section:
1. Click + Create Variable.
2. Enter the name of the variable in the Name column.
  For example, App_URL, username, or password.
3. Enter the corresponding value for the variable in the Value column.
4. Repeat these substeps to add all necessary variables for this environment.
Perform the following steps to define overrides for the default profiles in the Profiles section:
1. Click + Add Override.
2. Select the name of the default browser or device profile from the Profile drop-down list.
  For example, select Phone (Small) or Chrome.
3. Select a device from the list of devices for the configured device cloud from the Override drop-down list.
4. Repeat these substeps to add all necessary overrides for this environment.
Click the Save icon to save the details.

Results

You have created an environment.

What to do next

You can perform the following tasks:

Run a server test asset. See Running server test assets or Running server test assets on an agent.
Run a server test suite asset. See Running server suite assets.