Share this page

# Integration with OpenText Application Quality Management

This section describes how to manage your Vuser scripts by integrating with OpenText Application Quality Management.

In this topic:

## Manage scripts

OpenText Application Quality Management provides efficient functionality for storing and retrieving Vuser scripts, scenarios, and analysis results. You can store scripts in an OpenText Application Quality Management project and organize the scripts into unique groups.

In order for VuGen to access a project, you must connect VuGen to the web server on which the project is located. You can connect to either a local or remote web server.

For more information, see the OpenText Application Quality Management Help Center.

## Connect to a project

To store and retrieve scripts, you need to connect to an OpenText Application Quality Management project. You can connect or disconnect from a project at any time during the testing process.

You can connect to one version of OpenText Application Quality Management from VuGen and a different version from your browser.

To connect to a project:

1. Determine the type of authentication required for the OpenText Application Quality Management server: User name/password or CAC (Common Access Card). To use CAC mode, make sure to enable CAC authentication in VuGen's General options. For details, see General tab.

2. In VuGen, select Integrations > ALM > Connect to ALM. The ALM Connection dialog box opens.

3. In the Step 1: Connect to server section, enter a Server URL (not relevant for CAC authentication).

   - If the provided URL is for a server that supports SSO, you will be redirected to the SSO authorization page from the server.

   - If the provided URL is for a server that does not use SSO, enter your user name and password and click Connect.

   VuGen connects to the OpenText Application Quality Management server.

4. In the Step 2: Login to project section, expand the dropdown and enter the domain and project details.

5. Click Login.

6. Click Close to exit the Connection dialog box.

Note:

- If you authenticated through CAC mode and disconnected from the OpenText Application Quality Management server, you need to restart VuGen before reconnecting in CAC mode.

- If you have a slow connection, this may be because the VuGen machine does not have access to the WAN, and so cannot verify the digital signature of the relevant files.

Resolution: Download and import the certificates from the GlobalSign Root Certificates site using certmgr MMC until the issue is resolved (you might not need to import all the certificates).

## Version control

VuGen supports version control features in Vuser scripts saved in OpenText Application Quality Management projects that use version control.

The version control features change the process of opening and saving a script. Scripts with version control are either in a state of checked-in or checked-out. When you are working with a script in a checked-out state, any changes you make are not saved on the OpenText Application Quality Management server until you check in the script. If you save the script from within VuGen, a temporary file is saved on your machine that protects your changes in case your computer crashes.

If you are working with a script in a checked-in state, the script is read-only and you cannot make any changes until you check out the script.

If a particular script is being saved to OpenText Application Quality Management for the first time, and the project uses version control, the script automatically starts in a checked-out state.

## Work with scripts in projects

The following steps describe how to work with Vuser scripts that are saved in an OpenText Application Quality Management project.

Note: When downloading a VuGen script, the file name displayed in the Save As dialog box might be truncated. Due to a Microsoft IE limitation, this problem occurs if the original script name contains more than 160 letters, or if script name contains non-English letters.

To avoid this, download the script using the connection to OpenText Application Quality Management, as described below.

To work with scripts:

1. Open a connection to the server and project that contains the script. For details, see Connect to a project.

2. Select File > Open > Script/Solution. In the Open VuGen Script or Solution dialog box, select the script to open and then click Open.

3. Select File > Save Script. If the script is in a project that uses version control and is not checked out, the script is saved as a temporary file on your local machine.

## Work with version-controlled scripts in projects

The following steps describe how to work with scripts saved in OpenText Application Quality Management projects for which version control is enabled.

To work with version-control scripts:

1. Open a connection to the OpenText Application Quality Management server and project that contains the script. For details, see Connect to a project.

2. Select File > Open > Script/Solution. In the Open VuGen Script or Solution dialog box, select the script to open and then click Open.

3. If the project has version control, each script is always defined as being either checked-in or checked-out. For more details, see Version control . To check in and check out scripts, select Integrations > ALM > Check In/Check Out.

   Note: If the project has version control, the file is locked when it is checked out.

   If the project is not version controlled, the file is not locked when checked out of the project.

4. Cancel a check out. (Optional)

   If you checked out a script and do not want to save the changes, you can return the status of the script to checked-in without saving by selecting Integrations > ALM > Undo Check Out.

5. Save the script.

   Select File > Save Script. If the script is in a project that uses version control and is not checked out, the script is saved as a temporary file on your local machine.

## Save VuGen Vuser scripts to projects

The following steps describe how to save a Vuser script to an OpenText Application Quality Management project.

To save a script:

1. Create or open the script in VuGen.

2. Open a connection to the server and project in which you want to store the script. For details, see Connect to a project.

3. Save the script to OpenText Application Quality Management:

   1. Select File > Save Script as. The Save Script As dialog box opens.
   2. Click ALM Test Plan, and then specify the name and location for the script.

   3. Click Save. After a short time, the Working Mode dialog box opens.

   4. Select one of the following options:

      Runtime Mode. Copies only the files needed to replay the script. This option does not copy recording snapshot files and other unnecessary files. This results in a shorter transfer time.

      All Files Mode. Copies all of the files associated with this script. This results in a longer transfer time.

## Compare previous versions of a script

If your Vuser script is saved in a project that uses version control, you can compare previous versions of the script. The following steps describe how to do this.

To compare a script with previous versions:

1. Open a connection to the OpenText Application Quality Management server and project that contains the script that you want to view or modify. For details, see Connect to a project.

2. Select File > Open > Script/Solution. In the Open VuGen Script or Solution dialog box, select the script to open and then click Open.

3. Compare previous versions of the script:

   1. Select Integrations > ALM > Version History. The Version History dialog box opens.
   2. Select two previous versions of the script and then click Compare Versions. The comparison tool opens and displays the two versions of the script.

## ALM Connection dialog box [VuGen]

This dialog box enables you to connect to an OpenText Application Quality Management project from within VuGen.

Item | Description
--- | ---
To access | Integrations > ALM > ALM Connection
Important information | Before you connect to results stored on OpenText Application Quality Management through this dialog box, it is recommended that you first connect to the server through your browser. This automatically downloads the OpenText Application Quality Management client files to your computer. You can configure more advanced settings, such as a proxy setting, by using the Webgate Customization tool (webgatecustomization.exe) and then sign in using the dialog box. The Webgate Customization tool can be found on your OpenText Application Quality Management server at the following address: `http://<Server>/qcbin/Apps/`.

User interface elements are described below:

UI Element | Description
--- | ---
Step 1: Connect to Server | Server URL. The URL of the server on which OpenText Application Quality Management is installed. User name. Your project user name (not relevant for CAC authentication). Password. Your project password (not relevant for CAC authentication). Connect button. Connects to the server specified in the Server URL box. Disconnect link. Disconnects from the current server.
Step 2: Login to Project | Domain. The domain that contains the OpenText Application Quality Management project. Only those domains containing projects to which you have permission to connect to are displayed. Project. Enter the project name or select a project from the list. The list includes only those projects to which you have permission to connect. Login button. Logs into the project. Logout link. Logs out of the current project.
Restore connection on startup | Automatically reconnect to the OpenText Application Quality Management server, using the same credentials, when restarting VuGen.

## See also

- Integrations

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: