HPE Agile Manager and PPM

Plug-in Overview

Agenda

• Why ResultsPositive?

• Adapter Overview

• Timesheet Integration Overview

• How Does the Plug-In Work?

• REST API Sequence

• Download and Installation Instructions

• PPM Configuration Instructions

• Importing Agile Manager Effort to PPM Center

ResultsPositive - Make a Difference Today

Our purpose is to make a difference with our customers, business partners, and employees daily by enabling them to reach and exceed their goals and objectives

Founded in 2004, we are a platinum HP partner focused on improving business execution. We offer RapidStart implementation services for HP Quality Center, ALM, Performance Center, UFT, PPM, and Agile Manager. We are recognized by the world’s largest technology company as a leader in delivering better business results for our customers.

Adapter Overview

PPM Center integrates with HP Agile Manager via the Integration Plug-In made available on HPLN:

• Visibility into real-time status and progress of agile development projects from within PPM Center, without having to login to HP Agile Manager for details.

• A consolidated view of your tasks and agile development initiatives

Additional features of the Plug-In, include:

• Allows Project Managers to map a task under a project to a specific released managed in HP AgM

• Each PPM Center task is associated with a single release in HP AgM throughout the task life

• Project Managers and PMO Directors are able to view real-time agile development related charts for a release retrieved from HP Agile Manager.

• Project Managers can also view an overall release hierarchy on a specific work package within PPM Center

Project Managers can Monitor Real-Time Agile Charts within PPM

Timesheet Integration Overview

• Enables end users to import agile effort from AgM into their PPM Center timesheets

• Eliminates need to duplicate effort into multiple systems

• Data feeds from HPE Agile Manager to PPM Center

• One timesheet can be mapped to multiple sprints (releases) in Agile Manager

Via REST APIs, PPM and Agile Manager Communicate in Real-Time to Track Total Effort

How Does It Work?

Get

• End user clicks “Add External Data” on their timesheet from PPM ands selects HP Agile Manager from the “Select an External System” drop-down list.

• PPM calls the HPE Agile Manager REST APIs (see Technical REST API sequence execution)

Compute

• The adapter adds together values from the Invested (h) fields for all returned tasks for each of the releases

• The adapter then imports the total effort of a release as an entry and divides the total effort by the available working days in the current timesheet period.

Import

• The adapter then fills the average value to each of the working days in the timeline

• See Technical REST APIs in the Appendix for more information on the sequence of “Get” calls to AgM

REST API Get Sequence

• Get release list for a specific project from HP Agile Manager

• Get sprint list from available releases, where the sprints shall fall into the user’s current timesheet period

• Get backlog list for qualified sprints

– Sprint start date is the same as or later than the time sheet period start date

– Sprint end date is the same as or earlier than the time sheet period end date

– If the time sheet period contains unqualified sprints, the effort in these unqualified sprints will not be retrieved by the plug-in.

Users will get a warning message when the release contains unqualified sprints.

• Get task list by assign-to value and status value, where assign-to value is the HP Agile Manager user email

address, and the status value is Completed.

• Then the Agile Manager Integration Plug-in for PPM:

– Adds together value for the Invested (h) field for all returned tasks for each of the releases

– Imports the total effort of a release as an entry

– Divides the total effort by available working days in the current timesheet period, and

– Fills the average effort value to each of the working days in the time line

Source: PPM Center v9.31 Release Notes (published by HPE)

REST API Get Sequence

Sequence & Description HP Agile Manager REST API Called

1. Get Domain List https://<AgileManager_Server_URL>/qcbin/rest/domains/

2. Get Project List of One Domain https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/

3. Get release list of one project https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/<project_name>/releases/

4. Get a specific release https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/<project_name>/releases?query={id[<release_id>]}

5. Get sprint list of one release https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/<project_name>/release-cycles?query={parent-id[<release_id>]}

6. Get backlog list of sprints https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/<project_name>/release-backlog-items?query={entity-type[requirement];sprint-id[<sprint_id1> OR <sprint_id2> OR ...]}

7. Get task list of one backlogs by assign-to and status

https://<AgileManager_Server_URL>/qcbin/rest/domains/<domain_name>/projects/<project_name>/project-tasks?query={releasebacklog-item-id[<backlog_id1> OR <backlog_id2> OR…];assigned-to[<agile_user_mail_address>];status[Completed]}

Download & Installation Instructions

Steps Description

Step 1 Obtain the plug-in bundles from the HP Live Network

Step 2 On the PPM Community home page, click Content Catalog

Step 3 Click Agile Manager Integration Plug-in for PPM

Step 4 Click Downloads - Click the HP Agile Manager Connector for PPM v9.31

Step 5 Click ppm-931-AgileManagerConnector.zip to download the file

Step 6 Unzip the file to obtain the ppm-931-Connector-AGM.jar file

Step 7 Stop the PPM Server

Step 8 Unzip the package and copy the two bundles to the <PPM_Home> directory

Step 9 Deploy the bundles by running the following commands from the <PPM_Home>/bin directory: sh . /kDeploy .sh -i Connector –AGM

Step 10 Repeat steps #8 and #9 for each of the server nodes in a cluster

Step 11 Restart the PPM Server

New Entities in PPM v9.31

• New timesheet type of External Data is now visible

in the HPE PPM Time Management Module

• You can enable or disable the external data items, or

make activities specific to external data items only

from HP Agile Manager (example below)

Source: PPM Center v9.31 Release Notes (published by HPE)

PPM Configuration Instructions

Steps Description

Step 1 Logon to PPM Center as the administrator

Step 2 Launch the Administration Console and c heck that the ENABLE_TM_WORK_ITEM_EXTERNAL_DATA server configuration parameter is set to true

Step 3 In the PPM Workbench, enable the External Data option on the Work Items tab of the desired time sheet policy.

Step 4 From the menu bar, select Open > Administration > Open Workbench (or Open Workbench on Desktop)

Step 5 From the shortcut bar, select Time Mgmt > Timesheet Policies

Step 6 Click List

Step 7 From the Results Tab, select and open the desired timesheet policy

Step 8 Click the Work Items tab.

Step 9 Select the checkbox for the External Data option

Step 10 Click OK

Importing Agile Effort to PPM Center

Steps Description

Step 1 Logon to PPM Center

Step 2 From the menu bar, select Create > Timesheet.

Step 3 Select Time Period , Resource, Description, and Included Items from My Items List

Step 4 Click Create (the timesheet is created and the Edit Time Sheet page appears)

Step 5 Click Add Items and then select Add External Data from the available actions (the Import External Data window appears)

Step 6 From the Select Instance drop-down list, select an instance, with the Agile Manager icon in front of the instance name

Step 7 Click Next

Step 8 Enter the Username and Password that you use to logon to HP Agile Manager, click Next

Step 9 Allow PPM Center to retrieve and load effort data from the available releases in HP Agile Manager

Step 10 Click Submit (the AgM efforts are imported and distributed to each of the working days of the timesheet – displayed in the External Data section)

Make a Difference

HP Platinum

Partner

HP Support Partner

of the Year

HP PPM Partner

of the Year

End to End Business

Technology Solutions

Thank you!

www.resultspositive.com

Contact us today for a free 1 hour consultation!