Downloading and Installing the PPM Plug-in for ALM Integration

To integrate PPM tasks with ALM releases, administrators must download and install the free ALM Integration Plug-in for PPM. This is a one-time action.

Installation Instructions

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

    1. Go to the ALM Integration Plug-in for PPM
    2. Click Download in the ALM Integration Plug-in for PPM 9.50 section.

      The ppm-950-ALMPlugin.zip package is downloaded.

    3. This package contains the following two bundles:

      Bundle name Description
      ppm-950-PluginQuality.jar Contains the plug-in basic structure for integrating PPM with ALM release management tools.
      ppm-950-PluginQualityVPQ.jar Contains the plug-in files specifically for integrating PPM tasks with the ALM Releases module.
  2. Stop 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 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 PPM Plug-in for ALM Release Integration

The following entities are installed:

  • 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 ALM release.

    After the mapping relationship is established, the tab displays the following quality graphs and scorecard report retrieved from ALM 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 ALM release.

      Note: The scorecard report is displayed only when the ALM scorecard information is configured in the project request field of the Project Planning and Tracking (PPT) module in ALM.

  • 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 ALM 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 users to the Task Details page of the linked task.

  • Project Quality Sync Service

    The Project Quality Sync Service synchronizes quality KPI data from ALM releases to the mapped 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 ALM server configurations and loops through all configurations to retrieve KPI information from ALM and stores the data in 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's 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 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 ALM release is deleted on ALM 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 ALM release is ahead of the user's current date, for example, ALM 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 ALM, see KPI Data Retrieved from ALM.