Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Integrating Agile Workbench with Jira in Pega Platform from 8.3.x

Updated on January 14, 2022

Capture real-time feedback about an application development project directly in the application with the Agile Workbench tool. By using the Atlassian Jira component that is available from Marketplace, you can continue to use a real-time Agile methodology and integrate Agile Workbench with Jira to take advantage of its project management features, such as project and issue tracking, Scrum and Kanban support, backlog prioritization, and sprint planning.

Note: Integrating Agile Workbench with an extensively customized version of Jira might cause issues. Ensure that your customization of Jira supports official Atlassian Jira APIs. For more information, refer to the list of REST APIs v2 in Atlassian documentation.
Before you begin: Prepare for the integrating Agile Workbench with Jira:
  • Disconnect any existing integration to a project management system. On the Integration & security tab of the Application rule form, in the Agile Workbench integration section, click Configure integration, and then click Disconnect integration.
  • If you use a custom workflow or a custom list of priorities in Jira, ensure that Jira workflow and priorities match the Agile Workbench configuration. For more information, see Mappings of Agile Workbench values to Jira values.
  • Check whether your Jira version is complaint with General Data Protection Regulation (GDPR). For more information, refer to Atlassian documentation.
  1. Download the Jira component from the Marketplace.
  2. In the header of Dev Studio, click the name of the application, and then click Definition.
  3. On the Definition tab, in the Enabled components section, click Manage components.
  4. Click Install new, select the file that you downloaded from the Marketplace, and then click Open.
  5. Enable this component for your application by selecting the Enabled check box, and then click OK.
  6. In the list of enabled components, verify the Jira component and its version, and then save the rule form by clicking Save.
  7. Update the PM_Jira_AuthProfile Authentication Profile instance with credentials that you plan to use to access your Jira system through REST authentication:
    • Provide the user ID as user name and the API token for password. If your Jira server does not support API token, use your Jira password.

      For more information about Jira API token, refer to the Atlassian documentation.

    • To use a method of authentication other than Basic, delete and re-add the PM_Jira_AuthProfile instance by using the same name for the new version.
  8. In the authentication profile, select the Preemptive authentication check box.
  9. In the navigation pane of Dev Studio, click your operator icon, and then click Preferences.
  10. In the Project management section, in the User ID field, enter your Jira details:
    • To integrate with Jira version that is GDPR-complaint, enter your Jira account ID.
    • To integrate with Jira version that is GDPR non-complaint, enter your Jira user ID.
  11. Click Save.
  12. If your Jira version is GDPR non-compliant, perform additional configurations to integrate:
    1. Expand the SysAdmin category, and then click RuleSet.
    2. Click the JiraIntegration ruleset, and then open the IsAccountIDSupportedByJIRA rule.
    3. Click SaveSave as.
      For more information about saving rules, see Copying a rule or data instance.
    4. On the Advanced tab of the new rule, set the When rule name to Never, and then click Save.
    5. Perform check-in.
      For more information about checking in rules, see Checking in a rule.
  13. In the header of Dev Studio, click the name of the application, and then click Definition.
  14. On the Integration & security tab of the Application rule form, in the Agile Workbench integration section, click Configure integration.
  15. Select Jira.
  16. Provide the API URL for Jira, and then click Connect.
  17. Associate your Agile Workbench work items with a project and release by selecting an existing Jira project and release, or by creating a project and release.
  18. Click Begin integration.
    Result: All of the user stories and bugs that were created in Agile Workbench are exported to Jira and associated with the project and release that you specified. A confirmation message explains the results of the integration process.
  19. Click Done.
    • Previous topic Collaborating with development teams
    • Next topic Integrating Agile Workbench with Jira in Pega Platform 8.1.x to 8.2.x

    Have a question? Get answers now.

    Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

    Did you find this content helpful?

    Want to help us improve this content?

    We'd prefer it if you saw us at our best.

    Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

    Close Deprecation Notice
    Contact us