Acceptance Criteria Sync

Vandana Kurapati

If you have any documentation related to Acceptance Criteria sync between Jira Align and Jira please share

Peter Jessen

Hi @Vandana Kurapati,

This Help article addresses the Jira integration with Jira Align  - https://agilecrafthelp.zendesk.com/hc/en-us/articles/115000088453-10X-Jira-Integration-Setup

Within the article is this section:

Sync acceptance criteria

For features and stories, you can synchronize a Jira custom field with acceptance criteria with Jira Align's acceptance criteria. In the box, type the Jira custom field ID that is used for acceptance criteria, for example, customfield_12345. After the acceptance criteria are synchronized with Jira custom field, no more acceptance criteria fields can be added in Jira Align. You can add all acceptance criteria in one field in Jira Align.

Some things that may not be clear from the above:

1. This is a limitation of the Atlassian Jira API, not Jira Align's connector, as far as I know. I will defer to Jira Align Support for the technical details as to the why.
2. There is one Jira custom field value that can be entered in Jira Align for Acceptance Criteria.
   • This means that if you want to integrate Acceptance Criteria for stories but not features, it is not possible.
   • The moment you populate the Acceptance Criteria Jira custom field value in Jira Align, you lose native Jira Align multiple acceptance criteria functionality/granularity for both features and stories.
3. What are the options?
   • Don't integrate Acceptance Criteria between Jira and Jira Align to maintain the ability to have multiple, track-able Acceptance Criteria for reporting and health visibility in Jira Align.
     • For features:
       • In Jira you would not enter any acceptance criteria on the features.
       • Only enter acceptance criteria on the features in Jira Align.
     • For stories:
       • In Jira you can enter the story acceptance criteria in the description field or in the single Jira acceptance criteria field.
         • If you enter them in the Jira AC field they will not sync to Jira Align
       • In Jira Align - allow the acceptance criteria to sync via the Jira story description field or enter them as granular acceptance criteria and manually maintain them in Jira's AC field or keep them in sync via the description field.
   • Integrate Acceptance Criteria between Jira and Jira Align and lose the native Jira Align multiple/granular Acceptance Criteria functionality
     • This maintains automatic syncing of the Jira Acceptance Criteria text field to Jira Align, but you lose the robustness of the native Jira Align functionality that provides progress and health at a more granular level than is available in Jira natively.

Regards,
Peter