Synchronization Workitems JIRA - techtalk/SpecLog-Resources GitHub Wiki

This section covers setting up work item synchronisation with Altassian JIRA. More information on synchronising work items in general is available here.

SpecLog's JIRA integration allows any SpecLog card type to be mapped to exactly one issue type in JIRA. This means, no matter what number and hierarchy of requirement types you setup in SpecLog, it will be synced as issues of a single type in JIRA (e.g. Story, but you can configure any other type in JIRA as well).

The relationships between requirements in SpecLog (parents, refinements) are synchronized as a link between issues in JIRA. You can use any existing link type (e.g. "Relates") or you can specify a new link type (e.g. "Refinement", as suggested in the setup instructions below).

Our recommendation is to model everything down to the user story in SpecLog and link it to a "Story" in JIRA. Tasks and other flow related items should be created in JIRA as tasks that are linked to the story. Items related to product design, such as user stories, deliverables, impacts and goals should be modelled in SpecLog. Stories are the boundary object that link product design with task and flow coordination of the team.

Supported JIRA Versions

The following versions are currently supported by the SpecLog's work item synchronization:

  • Atlassian JIRA V5.2 or later (cloud hosted or on-premise)

The plugin uses version 2 of JIRA's REST API for synchronization. Later versions may also be supported.

JIRA Synchronization Plugin Versions

Warning: SpecLog provides two different plugins for synchronising issues with JIRA. Migrating from SpecLog.JiraPlugin.V1 to SpecLog.JiraPlugin.V2 is currently unsupported. If you have a project using the SpecLog.JiraPlugin.V1, do not change the JIRA plugin to SpecLog.JiraPlugin.V2. Support for migrating between plugin versions is planned in a future release.

The following versions of the JIRA synchronisation plugin are available:

  • "SpecLog.JiraPlugin.V2": This plugin is recommended for synchronisation with JIRA. Synchronisation is bi-directional (including creating SpecLog requirements from new Jira issues) and collates multiple SpecLog updates into a single JIRA issue update. Details on configuring the plugin can be found here.
  • "SpecLog.JiraPlugin.V1": This plugin is provided for backwards compatibility with previous SpecLog releases. It provides uni-directional synchronization (SpecLog to JIRA) for requirements, and back synchronization of estimates (JIRA to SpecLog). Furthermore, individual SpecLog updates are synchronised as JIRA issue updates whenever they occur. Details on configuring the plugin can be found here.
⚠️ **GitHub.com Fallback** ⚠️