Use the integration of PPM tasks with ALM releases

This topic introduces how to use the integration of PPM tasks with ALM releases.

Overview of using integration of PPM tasks with ALM releases

Project managers can use the integration after PPM administrators have completed the configuration tasks described in Configure the integration of PPM tasks with ALM releases.

After a project manager initiates a project in PPM, and adds tasks and assigns them to sub-project managers, with the ALM release information available, you can do the following:

  • Sub-project manager can link your task to a corresponding ALM release on the Task Details page for your task. See Link a PPM task to an ALM release.

    Note: If a task is already mapped to an ALM release, or has progress information synchronized from Agile Manager, you cannot map it to another ALM release.

After the one-one mapping relationship between a PPM task and an ALM release is established:

  • Sub-project manager can view and monitor the quality related KPI data retrieved from ALM for your task on the Quality tab of the Task Details page. See View quality data from the Task Details page.
  • Project manager can view and monitor the project quality related KPI data retrieved from ALM for all releases that are linked to your project tasks on the Quality tab of the Project Overview page, and drill down to details for each task. See View quality data from the Project Overview Page.

Back to top

Link a PPM task to an ALM release

You can link a PPM task to an ALM release from the Quality tab of the Task Details page.

To link a PPM task to an ALM release:

  1. Log on to PPM.

  2. From the menu bar, select Search > Projects.

  3. Locate and open the target project.

  4. On the Project Summary tab of the Project Overview page, click Edit Work Plan in the Work Plan portlet.

  5. Open the task that you want to link to an ALM release.

  6. In the Quality tab, click Start Mapping.

  7. In Step 1: General, from the Server drop-down list, select the ALM server that you want to link to, and click Next.

  8. In Step 2: Authentication, provide your user name and password to log on to the target server, and click Next.

    If you use API key authentication, provide your client ID and API key secret.

    If you use SSO authentication, click the Authenticate access to ALM link to log in to ALM, and click Next.

    Note: This step is skipped if your administrator enables using the same credentials that are provided on the View Project Quality configuration page to log in to ALM. For details, see Use the same credential for task mapping.

  9. In Step 3: Project Server, select a value from the drop-down list for each of the Domain, Project, and Release fields, and click Confirm.

  10. In Step 4: Confirmation, verify the information and click Done.

    The mapping is established and starts retrieving data from the linked ALM release.

    When the synchronization completes, the following graphs display on the Quality tab:

    • Priority Defects Trend
    • Open Defects Trend

    • Requirements Trend

    Note: The Scorecard Report is not yet available. Follow the instructions described in Configure Scorecard Report to configure the Scorecard Report.

Back to top

Configure Scorecard Report

This section provides details about how to configure the Scorecard Report.

To configure the Scorecard Report:

  1. Get the Scorecard URL for the Scorecard Report:

    1. Log in to the target ALM server and click Dashboard > Analysis View.

    2. Right-click the target scorecard analysis item and select Share Analysis Item.

    3. Select Copy Analysis Item Public URL from the pop-up dialog and click OK.

    Note: Make sure that the scorecard analysis item you configured is related to the ALM release you linked, otherwise it may mess up the display of quality related data on the Quality tab.

  2. For PPM to load Scorecard Report information properly, add the scorecard URL and port number to the CONTENT_SECURITY_POLICY parameter. For details, see Server parameters.

  3. Click Edit Link on the Quality tab of the Task Details page.

  4. Paste the URL to the field and click Save.

    The Quality tab page refreshes to retrieve scorecard information.

  5. Scroll down to view the scorecard report.

    An example of the scorecard report:

Back to top

View and monitor project quality KPIs and Scorecard Report

When a PPM task is mapped with an ALM release, you can view and monitor project quality KPIs and Scorecard Report from the Task Details and Project Overview pages.

Overview

Once the one-one mapping relationship between a PPM task and an ALM release is established, the Quality tab of the Task Details page displays the following quality information retrieved from ALM:

  • Priority Defects Trend

  • Open Defects Trend
  • Requirements Trend
  • Scorecard Report (if you provided scorecard URL)

View quality data from the Task Details page

To view quality data from the Task Details page:

  1. Log on to PPM.
  2. From the menu bar, select Search > Projects.
  3. Provide search criteria in search fields and click Search.

  4. Locate your project and open it.

  5. On the Project Summary tab page, click Edit Work Plan in the Work Plan portlet.

  6. Open the target task.

  7. Go to the Quality tab.

    The Quality tab displays quality KPI data graphs as well as scorecard report.

    Note: If the Scorecard Report is not available, you need to configure the Scorecard Report link first. For instructions, see Configure Scorecard Report .

View quality data from the Project Overview Page

To view quality data from the Project Overview page:

  1. Log on to PPM.
  2. From the menu bar, select Search > Projects.
  3. Provide search criteria in search fields and click Search.

  4. Open the target project.

    The Project Overview page displays.

  5. Go to the Quality tab.

    • If no tasks are linked to any ALM releases, a promotion picture is displayed.

    • If sub-project managers have linked their tasks to ALM releases, the Quality tab displays quality KPI data aggregated for the master project by default.

  6. Click or to cycle the display of the quality graphs.

  7. To browse quality KPI data for a linked ALM release, click the release in the left navigation tree.

  8. To view scorecard report for the release, click the Go to <Release_Name> link at the top right corner.

    The Task Details page for the task lined to the release displays.

  9. Go to the Quality tab and scroll down to view the scorecard report.

Back to top

Remove a mapping

You can remove a mapping from the Task Details page.

To remove a mapping from the Quality tab of the Task Details page:

  1. Log on to PPM.

  2. From the menu bar, select Search > Projects.

  3. Open the target project.

  4. Go to the Task Details page for the target task that you want to remove the mapping, and go to the Quality tab.

  5. Click .

    A prompt dialog pops up.

  6. Click OK.

    The mapping is removed and the Quality tab page returns to its original state.

    You can click Start Mapping to link the task to another ALM release as needed.

Back to top

See also: