Sync Clarity Project to existing Initiative in Agile Central


Article ID: 142503


Updated On:


Clarity PPM SaaS Clarity PPM On Premise


How do I sync a Clarity Project to an existing Initiative (or other Portfolio Item type) in Rally? I have an existing initiative/capability/portfolio item I want to sync to my project in Clarity. Currently, when I run the Agile Central/Rally Sync job, it's creating my project as a new initiative in Rally. I'm not able to select which portfolio item or project in Rally I want to connect to from my project in Clarity.


Release : All Supported Releases



  1. Update the Portfolio Item External ID attribute in Clarity with the CA Agile Central portfolio item object ID. 
    • Note in earlier versions of Clarity such as 15.3, 15.4, 15.4.1, the field name is: Initiative external ID
  2. This field can be added to the Agile Summary sub page and/or the project list view in Clarity

To add/edit this field from the Clarity Project List view:


  • For earlier releases such as 15.3 - 15.4.1 you may have to add this field to a project subpage (not the Agile Summary subpage). Then, uncheck the read only option for the attribute on the project object. It's not possible to edit it from the project list view in those releases
  1. In Clarity, go to Home->Projects
  2. Click the Options gear icon on the right hand side, then Configure
  3. Add 'Portfolio Item External ID' to selected Columns
  4. Click Save and Return
  5. Double click on the Portfolio Item External ID for the project you want to sync to an initiative
  6. Add the Portfolio Item External ID that coincides with the Rally portfolio item object ID. 
    1. Retrieve the Agile Central Object ID for the Initiative from AC/Rally.
    2. If you are not planning on moving the iteration, you can use this shortcut and use the ID pulled from the initiative URL
      • Go to the Initiative in Rally
      • Copy the Initiative ID from the URL (last ID in the UR)

If the Portfolio Item External ID field isn't editable:

  1. In Clarity go to Administration->Objects->Project
  2. Click on the Portfolio Item External ID (Initiative external ID in earlier releases) attribute
  3. Uncheck 'Read only'
  4. Click Save
  5. Go to Home->Projects
  6. Click on Options->Configure
  7. From the List Column Section tab drop down, select Fields
  8. Click on the properties icon for Portfolio Item External ID
  9. Check 'Allow editing'
  10. Save changes

Additional Information

See KB Searching for known Clarity Issues using Self Service

If using XOG, see also: Link a PPM Project to an Agile Central Portfolio Item