Share this page

# Configure the integration of PPM tasks with OpenText Application Quality Management releases

This topic describes how to configure the integration of PPM tasks with OpenText Application Quality Management releases.

In this topic:

## Install the PPM plug-in for OpenText Application Quality Management integration

To integrate PPM tasks with OpenText Application Quality Management releases, administrators must first install the OpenText Application Quality Management Integration Plug-in for PPM. This is a one-time action.

To install the integration plug-in:

1. Obtain the plug-in bundles from the Marketplace.

   1. Go to the ALM Integration Plug-in for PPM.

   2. Click Download in the ALM Integration Plug-in for PPM <ppm_version> section.

      The `ppm-<ppm_version>-ALMPlugin_VPQ.zip` package is downloaded.

   This package contains the following two bundles:

   Bundle name | Description
   --- | ---
   `ppm-<ppm_version>-PluginQuality.jar` | Contains the plug-in basic structure for integrating PPM with OpenText Application Quality Management release management tools.
   `ppm-<ppm_version>-PluginQualityVPQ.jar` | Contains the plug-in files specifically for integrating PPM tasks with the OpenText Application Quality Management Releases module.

2. Stop the PPM server.

3. Unzip the package and copy the two bundles to the `<PPM_Home>` directory.

4. Deploy the bundles by running the following commands from the `<PPM_Home>/bin` directory:

   - sh ./kDeploy.sh -i PluginQuality
   - sh ./kDeploy.sh -i PluginQualityVPQ

5. Repeat step 3 and step 4 for each of the server nodes in your cluster.

6. Restart the PPM server.

   Note: We recommend you restart the PPM server to make sure that the integration bundles are properly deployed before you continue to deploy bundles for another integration solution.

Entities installed by the plug-in

The following entities are installed:

Entity | Description
--- | ---
Quality tab added to the Task Details page | The Quality tab on the Task Details page allows project managers to link the task to a specific OpenText Application Quality Management release. After a mapping relationship is established, the tab displays the following quality graphs and scorecard report retrieved from OpenText Application Quality Management for the linked release: Priority Defects Trend: Displays trend of defects of higher severity in the last 10 days. The higher severity defects include defects of priority S1 and S2. Open Defects Trend: Displays open defects trend in the last 10 days. The open defects include open defects number and total defects number. Requirements Trend: Displays requirement status trend in the last 10 days. The requirement status includes requirement coverage. Scorecard Report: Displays scorecard report for the linked OpenText Application Quality Management release. Note: The scorecard report is displayed only when the OpenText Application Quality Management scorecard information is configured in the project request field of the Project Planning and Tracking (PPT) module in OpenText Application Quality Management.
Quality tab added to the Project Overview page | The Quality tab on the Project Overview page offers a centralized view of the following quality graphs for each of the OpenText Application Quality Management releases linked to tasks of the current project: Priority Defects Trend: Displays trend of defects of higher severity in the last 10 days. The higher severity defects include defects of priority S1 and S2. Open Defects Trend: Displays open defects trend in the last 10 days. The open defects include open defects number and total defects number. Requirements Trend: Displays requirement status trend in the last 10 days. The requirement status includes requirement coverage. Clicking a specific release in the navigation tree brings you to the Task Details page of the linked task.
Project Quality Sync Service | The Project Quality Sync Service synchronizes quality KPI data from OpenText Application Quality Management releases to the mapped OpenText PPM tasks. The default synchronization interval is 24 hours. You can set the synchronization interval on the Schedule Services page. The Project Quality Sync Service gets all valid OpenText Application Quality Management server configurations and loops through all configurations to retrieve KPI information from OpenText Application Quality Management and stores the data in OpenText PPM database. When the service runs, it checks whether all the PPM task - ALM release mappings have been synchronized in the current day. If yes, it does not sync data for the existing mappings. If new mappings are detected, it syncs data for the new mappings only. That is to say, even if the service is set to run more than once in a day, it syncs data for each existing mapping only once a day. Synchronization rules Synchronization rules are as follows: When a project or task is deleted, the mapping and records are removed from the database. This means that users will lose all the data related to the corresponding mapping. When a task is canceled or completed, synchronization stops. When a project is canceled or closed, synchronization stops. If an OpenText Application Quality Management release is deleted on OpenText Application Quality Management end or cannot be found when the service tries to synchronize data, the status is logged in the PPM_INT_QUALITY_TASK_MAPPING table. If the end date of an OpenText Application Quality Management release is ahead of the user's current date, for example, OpenText Application Quality Management release R1 is scheduled to end on 11/11/2012 and today is 05/01/2013, then the service stops synchronization next time. For details about KPI data to be retrieved from OpenText Application Quality Management, see KPI data retrieved from OpenText Application Quality Management.

## Add an OpenText Application Quality Management integration configuration

Administrators need to add integration configurations with OpenText Application Quality Management server on the View Project Quality configuration page before project managers can link their project tasks to releases managed in the OpenText Application Quality Management Release module.

To add an OpenText Application Quality Management integration configuration:

1. Log on to OpenText PPM.

2. Click the Administration button in the masthead.

3. From the Administration menu, click Integrations > View Project Quality with ALM Integration.

4. In the Server Configuration Details area, click Add Integration Configuration to display the Server Configuration Details section.

5. Complete the fields described in the following table.

   Field (*Required) | Description
   --- | ---
   *QC/ALM Server Name | Specify a unique name for the target ALM server. Note: The server name shall not contain pound sign (#) or space.
   *QC/ALM Version | Select ALM server version from the drop-down list of supported versions. Valid values include: ALM 11.00 ALM 11.20 (The complete version number is ALM 11.00 SP2) ALM 11.50 ALM 12.00 ALM 12.60 Select this version if your ALM is enabled with API key authentication. ALM 15.5.1 Select this version if your ALM is enabled with API key or SSO authentication. ALM 15.5.1 is also compatible with ALM versions 16.00 and 17.00. If you wish to use ALM 16.00 or 17.00, select 15.5.1 from the list.
   *QC/ALM Server URL | URL of the ALM server you want to integrate with. For example, `http://ALM11.company.net:8080/qcbin/`
   *QC/ALM Username | ALM account username that you use to log on to the ALM server. If the ALM server supports API key or SSO authentication, provide the client ID instead of username.
   *QC/ALM Password | Password of your OpenText Application Quality Management account. If the ALM server supports API key or SSO authentication, provide the API key secret instead of password.
   Use the same credential for task mapping | Select this option if you want the OpenText Application Quality Management credentials provided above to be used to retrieve the releases that can be mapped to PPM work plan tasks. Note: If you use SSO authentication to log in to OpenText Application Quality Management, select this check box to avoid authentication error when linking a PPM task to an OpenText Application Quality Management release.
   Description | Provide a description for the OpenText Application Quality Management server.

6. Click Save.

   The OpenText Application Quality Management server you just configured is added to the Integration Configurations summary list.

## Enable the Project Quality Sync service

For the integration of PPM tasks with OpenText Application Quality Management releases to work, you need to enable the Project Quality Sync Service.

To enable the Project Quality Sync Service:

1. From the Administration menu, select Sys Admin > Schedule Services.

2. Click the table row that displays the Project Quality Sync Service.

   The editable fields for that service are enabled.

3. To enable the service, from the Status list, select Enabled.
4. Leave the type of expression in the Schedule Type list to Simple.
5. In the Schedule column, leave the default value (`24` hours).

6. Click Save.

Your changes take effect immediately after you save them. You do not need to restart the PPM server.

## Configure PPM server for MLU support

If both your PPM server and OpenText Application Quality Management server use a language other than English, you need to perform some extra configuration tasks to enable proper display of project quality related information in OpenText PPM.

To configure the PPM server for MLU support:

1. Make sure that the `IntegrationResources_<Language_Code>.properties` file is located in the `<PPM_Home>\WEB-INF\resources\web\` directory.

   The `IntegrationResources_<Language_Code>.properties` file is a localized version of the `IntegrationResources.properties` file, for example, `IntegrationResources_fr.properties`. It is located in the `<PPM_Home>\WEB-INF\resources\web\` directory if you have applied the OpenText PPM language pack for the desired language.

   For a list of supported languages and the corresponding language codes, see the System Requirements and Compatibility Matrix

2. Modify the `<PPM_Home>\conf\hpALMKPI.conf` file. The `hpALMKPI.conf` file is added into the `<PPM_Home>\conf\` directory automatically after you deploy the
   `ppm-<ppm_version>-PluginQualityVPQ.jar` bundle.

   To modify the `hpALMKPI.conf` file:

   1. Stop the PPM server.
   2. Open the `<PPM_Home>\conf\hpALMKPI.conf` file in a text editor.

   3. Copy and paste the following content to the end of the file:

          #Test
          test.passed=Passed

          #Requirement
          requirement.notCovered=Not Covered
          requirement.na=N/A
          requirement.passed=Passed
          requirement.reviewed=Reviewed

          #Defect
          defect.priority=4-Very High,5-Urgent
          defect.new=New
          defect.open=Open
          defect.closed=Closed

   4. Modify the content you just pasted by doing the following:

      1. Add the OpenText Application Quality Management server name you specified in Add an OpenText Application Quality Management integration configuration as prefix to each parameter, and

      2. Change each parameter value to the target language, as follows:

             #Test
             QC/ALM Server Name>.test.passed=<Translation of �Passed�>

             #Requirement
             <QC/ALM Server Name>.requirement.notCovered=<Translation of �Not Covered�>
             <QC/ALM Server Name>.requirement.na=N/A
             <QC/ALM Server Name>.requirement.passed=<Translation of �Passed�>
             <QC/ALM Server Name>.requirement.reviewed=<Translation of �Reviewed�>

             #Defect
             <QC/ALM Server Name>.defect.priority=<Translation of �4-Very High,5-Urgent�>
             <QC/ALM Server Name>.defect.new=<Translation of �New�>
             <QC/ALM Server Name>.defect.open=<Translation of �Open�>
             <QC/ALM Server Name>.defect.closed=<Translation of �Closed�>

         Example: If you want to configure Simplified Chinese language support, and the ALM server name you specified in Add an OpenText Application Quality Management integration configuration is `ALMServer4PPM`, modify the newly pasted section to the following:

   5. Save the file in Unicode format.

      Caution: Make sure you save the file in Unicode format. Otherwise you may encounter errors.

   6. Restart the PPM server.

## KPI data retrieved from OpenText Application Quality Management

All KPI data retrieved from OpenText Application Quality Management are stored in the PPM_INT_QUALITY_STATISTICS table.

The following table describes the types of KPI data that are retrieved from OpenText Application Quality Management as well as the REST APIs that are used to retrieve KPI data.

KPI Data | Description | REST APIs used to retrieve KPI data
--- | --- | ---
Requirements
# of Total Requirements | Total number of requirements within a specific release | http://<URL>:<Port>/qcbin/rest/domains/ <Domain>/projects/<Project>/requirements?fields=status, req-reviewed& query={type- # of Covered id[<>1];release.id[<Release_ID>]}
# of Covered Requirements | Number of the requirements within a specific release, excluding status "Not Covered" or "N/A"
# of Reviewed Requirements | Number of requirements with status �Reviewed� within a specific release
# of Passed Requirements | Number of requirements with status of Passed |
Defects
# of Total Defects | Total number of defects of release level | http://<URL>:<Port>/qcbin/rest/domains/<Domain>/projects/<Project>/defects/groups/severity, status?query={target-rel [<Release_ID>]}
# of Priority Defects | Number of defects with priority level at �4-Very High� or �5-Urgent�
# of Closed Defects | Number of defects with status of Closed

## Next steps

- Use the integration of OpenText PPM tasks with OpenText Application Quality Management releases

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: