CA Clarity™ Agile Integration with CA Clarity™ PPM › How to Integrate CA Clarity™ Agile with CA Clarity™ PPM › Configure the Agile Setup Page on CA Clarity™ PPM

Configure the Agile Setup Page on CA Clarity™ PPM

You can set up CA Clarity™ PPM to link to CA Clarity™ Agile, so that they can communicate and transfer data.

Follow these steps:

1. Log in to the CA Clarity™ PPM and access the Administration Tool.
2. Click Administration, and from General Settings, click Agile Setup.

   The Agile Admin Settings page appears.

3. Complete the following fields in the Agile Login Info section:

   User Name

   Defines the user name to login to CA Clarity™ Agile with system administrator privileges.

   Password

   Defines the password to login to CA Clarity™ Agile with system administrator privileges.

   Security Token

   Defines the security token used for server identification in case the login fails or if the CA Clarity™ PPM server is running from an untrusted network. You can retrieve this token from SalesForce.com from the Personal Setup Page. See the SalesForce.com online help for more information.

   Agile Environment URL

   Specifies the URL that CA Clarity™ PPM uses to access the CA Clarity™ Agile production or sandbox environment.

   Production Environment

   https://login.salesforce.com/services/Soap/u/27.0
   

   Test Environment

   https://test.salesforce.com/services/Soap/u/27.0
   

   Agile URL

   Specifies the URL that CA Clarity™ PPM uses to access the requirements list in CA Clarity™ Agile.

   Important! Do not change the default URL.

4. Complete the following fields in the Proxy Server Info section:

   Host Name

   Defines the proxy server host name.

   Port

   Defines the proxy server port.

   User Name

   Defines the proxy server user name.

   Password

   Defines the proxy server password.

5. Save your changes.

Set Up Data Transfers from CA Clarity™ PPM

To set up data transfers, specify the CA Clarity™ Agile product details in a CA Clarity™ PPM project that you have associated. The following tasks show how to set up data transfers:

• Link CA Clarity™ Agile Product and Release with CA Clarity™ PPM by one the following methods:
  • Create a product and release from CA Clarity™ PPM.
  • Link to an existing product and release in CA Clarity™ Agile.
  • Create a release in an existing CA Clarity™ Agile product.
• Map CA Clarity™ Agile task types to CA Clarity™ PPM charge codes.
• Link CA Clarity™ PPM tasks with CA Clarity™ Agile.
• Update Roles in CA Clarity™ Agile from CA Clarity™ PPM

The following rules apply for linking projects between CA Clarity™ PPM and CA Clarity™ Agile:

• If you specify a product ID and a release name but leave the release ID blank, a new release is created for the specified product.
• If you specify both product and release IDs and names, the names are ignored and the IDs are used for linking to an existing product.
• The CA Clarity™ PPM project description is added as the description for the product or release when creating a product or release. A superuser can change this description, and can avoid having it overwritten from CA Clarity™ PPM.
• If you leave all the fields blank, the synchronization job fails and nothing is created or linked in CA Clarity™ Agile.

Best Practice: To link a CA Clarity™ PPM project to CA Clarity™ Agile, verify the following prerequisites:

• The option for automatic creation of effort tasks is turned off.
• No tasks currently exist in the CA Clarity™ PPM project.

Link to an Existing Product and Release

You can link an existing CA Clarity™ Agile product and release to a CA Clarity™ PPM project by specifying the product ID and release ID. You can link to a product release or a master release. Link to a master release to see all the user stories and tasks that are assigned to the master release in CA Clarity™ PPM.

Follow these steps:

1. In CA Clarity™ PPM, open a project that you want to associate with Agile product.

   The project properties appear.

2. Select the Linked to Agile checkbox and click Save.
3. Click Properties, and from General, click Agile.

   The Agile properties page appears.

4. Complete the following fields:
   • If you are linking to a product release define the Agile Product ID and the Agile Release ID
   • If you are linking to an existing master release define the Agile Master Release ID. This value is used to link this project to an existing master release in CA Clarity™ Agile. If the link is established successfully, this field becomes display-only.

     Source: Master Release ID field on the Master Release Detail page in CA Clarity™ Agile.

   Note: Leave the following fields blank: Agile Product Name, Agile Release Name, and Product Prefix.

5. Submit your changes.

   After the Agile Product Sync job runs, the following fields are automatically populated in CA Clarity™ PPM:

   • Agile Product Name
   • Agile Release Name
   • Product Prefix

Create a Release in an Existing Product

Create a release in an existing CA Clarity™ Agile product by specifying the product ID and release name in the CA Clarity™ PPM project. Leave the release ID, product name, and product prefix values undefined.

Follow these steps:

1. In CA Clarity™ PPM, open the project and associate it with CA Clarity™ Agile by selecting the Linked to Agile checkbox and clicking Save.

   The project properties appear.

2. Click Properties, and from General, click Agile.

   The Agile properties page appears.

3. Complete the following fields:
   • Agile Product ID
   • Agile Release Name

   Note: Leave the following fields blank: Agile Release ID, Agile Product Name, and Product Prefix.

4. Submit your changes.

   After the Agile Product Sync job runs, the following fields are automatically populated in CA Clarity™ PPM:

   • Agile Release ID
   • Agile Product Name
   • Product Prefix

Create a Product and Release from CA Clarity™ PPM

You can create a project in CA Clarity™ PPM, and specify the product name and release name in the project. When the synchronization job runs, a release in CA Clarity™ Agile is created.

Follow these steps:

1. Log in to CA Clarity™ PPM.
2. Select Projects from the Portfolio Management menu.

   The projects list page appears.

3. Click New to create a project, complete the required fields, and click Save.

   The properties page appears.

4. Select the Linked to Agile check box, and click Save.

   The Agile and Agile Task Type Mapping options become available in the Properties menu.

5. Click Properties, and from General, click Agile.

   The Agile properties page appears.

6. Complete the following fields:

   Agile Product Name

   Defines the name of the new CA Clarity™ Agile product you want to create.

   Agile Release Name

   Defines the name of the new CA Clarity™ Agile release you want to create.

   Product Prefix

   Defines a unique prefix to add to the product name for the user stories and tasks. You cannot change the prefix after the product is created.

   Limits: 6 characters

   Note: Leave the following fields blank: Agile Product ID and Agile Release ID.

7. Submit your changes.

   After the Agile Product Sync job runs, the following fields are automatically populated in CA Clarity™ PPM. The new product and release is created in CA Clarity™ Agile:

   Agile Product ID

   Displays the Agile product ID. This value is automatically populated from CA Clarity™ Agile.

   Source: The Product ID field on the Product Detail page on CA Clarity™ Agile.

   Agile Release ID

   Displays the Agile release ID. This value is automatically populated from CA Clarity™ Agile.

   Source: The Release ID field on the Release Detail page on CA Clarity™ Agile.

Map CA Clarity™ Agile Task Types to CA Clarity™ PPM Charge Codes

If you have assigned charge codes to your project tasks in CA Clarity™ PPM, you can map these charge codes to the CA Clarity™ Agile task types. Mapping the task types to charge codes allows you to assign appropriate charge codes to actuals on linked tasks. A project manager can map task types to charge codes and run the Populate Agile Task Types process, if they have the following global and instance access rights:

• Task Type and Charge Code Mapping - Create
• Task Type and Charge Code Mapping - Edit All
• Process - Start

Best practices:

• If you accidentally delete charge code mappings, run the Populate Agile Task Types process manually to retrieve the deleted mappings.

  See the CA Clarity™ PPM Administration Guide for more information.

• You can map a task type to only one charge code. If no task type is defined for a task in CA Clarity™ Agile, you can assign the Default charge code to it in CA Clarity™ PPM.

If you have a new task type in CA Clarity™ Agile, create a new charge code in CA Clarity™ PPM and map the new task type to the charge code.

Follow these steps:

1. In CA Clarity™ PPM, click Administration, and from Project Management, click Charge Codes.
2. Click New and complete the required fields.
3. Save your changes.

   New Charge code is created.

After you have created a charge code, you can map it to the CA Clarity™ Agile task type.

Follow these steps:

1. In CA Clarity™ PPM, open the linked project.

   The project properties appear.

2. Click Agile Task Type Mapping from Properties.

   The Agile Task Type Mapping page for the project appears.

3. Click New.

   The Create Agile Task Type and Charge Code Mapping page appears.

4. Complete the following fields and submit:

   Task Type

   Defines the CA Clarity™ Agile task type for a task.

   Charge Code

   Defines the CA Clarity™ PPM charge code for the same task.

5. Save your changes.

The CA Clarity™ PPM charge code is successfully mapped to the CA Clarity™ Agile task type.

Link CA Clarity™ PPM Tasks with CA Clarity™ Agile

You can link multiple tasks to a single requirement, and you can link multiple requirements to a single task.

Follow these steps:

1. In CA Clarity™ PPM, open the linked project.

   The project properties appear.

2. Click the Tasks tab and click Gantt.
3. Locate the task and click the icon in the Mapped Requirements column.

   The Mapped Task: Properties page appears with the Agile Requirement and Task Mapping List option selected in the menu.

4. Click New.

   The Create Agile Requirement and Task Mapping page appears.

5. Click the Browse icon and select a CA Clarity™ Agile requirement to map to the task.
6. Click Save and Return.

   The Mapped Task: Properties page appears with the requirement listed.

   Note: After the requirement is added to the task, populate the requirement list with the CA Clarity™ Agile requirement information. If the list is empty, refresh the page.

7. Choose one of the following options:
   • Click New to map another requirement to the task.
   • Click Return to return to the Work Breakdown Structure.

   CA Clarity™ Agile is updated with the information about linked tasks and requirements the next time the Agile Requirement and Task Mapping Sync job runs.

   Note: The sync job does not synchronize the requirement version number and the version status from CA Clarity™ Agile to CA Clarity™ PPM.

Update Roles in CA Clarity™ Agile from CA Clarity™ PPM

You can download roles and role hierarchies from CA Clarity™ PPM to CA Clarity™ Agile. When you download roles, all roles in CA Clarity™ PPM are available in CA Clarity™ Agile.

To update roles in CA Clarity™ Agile from CA Clarity™ PPM roles, run the Agile Role Sync job.

Review the Project Integration Status

Review the integration status from the Agile properties page after linking a CA Clarity™ PPM project to CA Clarity™ Agile.

Follow these steps:

1. In CA Clarity™ PPM, open the project, and from the Properties, click Agile.

   The Agile properties page for the project appears.

2. Review the information in the following fields:

   Sync Status

   Displays the status of the Agile Product Sync job as successful, pending, or failed.

   Sync Detail Information

   Displays the details of the job status such as date and time when it was last run. If the job failed, displays details of the errors encountered.

A successful integration means that data is transferring between CA Clarity™ Agile and CA Clarity™ PPM. If the integration is not successful, it can mean one of the following issues:

• The Salesforce.com or CA Clarity™ Agile credentials are incorrect on the admin setup page.
• The Salesforce.com network is down.
• The CA Clarity™ Agile product or release IDs are entered incorrectly.
• The CA Clarity™ Agile product that you are trying to create exists.
• The CA Clarity™ Agile release is already linked to another CA Clarity™ PPM project.

If any information is entered incorrectly, try integrating again by reentering the correct values and running the Agile Product Sync job.