Versions Compared

Old Version 6

changes.mady.by.user Adrien Ragot

Saved on

compared with

New Version Current

changes.mady.by.user Mileva Briand

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
toc
Excerpt
hiddentrue
nameRequirement Yogi
has a JIRA module for JIRA-Confluence integration.
  • Search and link to requirements from JIRA,
  • Confluence displays the link in the Requirement Yogi inline dialog,
  • The text is updated in JIRA whenever users click "synchronize" for an issue.

Example:

Image Removed

Inserting a requirement:

Image Removed

Information page in Confluence

If you move a requirement to another space in Confluence, the link from JIRA is not updated. Don't worry, users will be redirected to the new space as long as no requirement is created with the same name in both spaces.

It is therefore useful to synchronize requirements between Confluence and JIRA. A synchronization can either be triggered from a JIRA issue (see screenshot above) or from Confluence. We've included this feature in the Tools menu, on the top-right of the page:

Image Removed Image Removed

Installation

To install this module, please:

  • Check both JIRA and Confluence have the same version of Requirement Yogi,
  • Create an Application Link using OAuth between JIRA and Confluence (see Atlassian's documentation),
  • Create an Entity Link between the JIRA project and the Confluence space (see Atlassian's documentation).

When search for a requirement from JIRA, Requirement Yogi will only search Confluence instances which are linked with the current JIRA project.

Synchronization FAQ

In the following answers, RIL is a Remote Issue Link. It's the lines that are visible in JIRA under the "Description" panel.

 

Is there any harm when the sync fails or when a RIL is invalid?

No:

  • The master data for links is what is visible in JIRA. Requirement Yogi has no control over what JIRA displays.
  • Invalid data in JIRA cannot delete data in Confluence.
  • The worst that can happen is that Confluence is not aware of a link.
    • This could be recovered by going to the JIRA issue and synchronizing it. Synchronization always affects all RILs on a JIRA issue.
    • If the synchronization fails, then deleting-and-recreating the link will always update the situation. This is what the synchronization does automatically.
  • RILs will be deleted in the following situations:
    • When the requirement in Confluence was deleted (removed from its original page) and the JIRA issue is synchronized. That means the link persists on the JIRA issue until a user clicks "Synchronize" in JIRA.
    • When it is immediately recreated to update its globalID. This is required because the globalID is immutable and unique across a JIRA instance.

Is there any harm when the JIRA connector of Requirement Yogi is uninstalled or when the HTTP link to Confluence is suspended?

Yes, there is little harm:

  • RILs can't be displayed properly,
  • Neither synchronous nor asynchronous synchronizations can happen between JIRA and Confluence, causing:
    • Issues link to stale requirements (which were either moved or deleted in Confluence),
    • Confluence requirements display stale links to JIRA (e.g. keep displaying a link although it was deleted in JIRA, or no link although a new one was created in JIRA).

The whole purpose of the "synchronize" buttons is to recover those situations. After reinstalling and synchronizing:

  • Titles will be updated both ways (Confluence requirement description in JIRA / JIRA issue title in Confluence),
  • Links to requirements which were deleted in Confluence will be deleted from JIRA,
  • Links which were created or deleted in JIRA will be updated in Confluence.

 

Image Removed
for Jira

You can have an efficient requirements management in Jira, thanks to our integration plug-in. Learn how to use it now.

To use all Jira connected features, make sure you download the Requirement Yogi for Jira app first.

Image AddedImage Added

How to set up the integration?

  • Set up the Application Links between Jira and Confluence,

  • Set up Entity Links between a Jira project and a Confluence space (or several),

  • Status
    colourYellow
    titleImportant
     Go to the administration and set the credentials in both products (since 2.2 for Confluence and 2.5 for Jira).

  • Go to the Requirement Yogi for Jira configuration page for more explanations

What does the integration look like in Jira?

A Requirements panel on Jira issues:

Image Added

A custom field, if you choose to configure it instead of the panel:

Image Added

The dialog to add links on an issue:

Image Added

What does the integration look like in Confluence?

The glorious Jira bulk issue creation:

Image Added

And of course, Jira issues appear in the popup as dependencies, and in the traceability matrix.

Image Added

More about the Custom Field

Using the custom field is optional. All requirements can be displayed in the "requirements" panel, but some customers prefer using the custom field, which makes it possible to:

  • Make requirements visible in the REST API,

  • Make requirements visible in the XML API,

  • Make the field visible and mandatory on the Create Issue screen.

If interested, see more details on Release notes 2.2.5 for Jira

JQL function

The JQL function to search for issues with Requirement Yogi links is described on this page: JQL Syntax.

Related content

Child pages (Children Display)
page$1804534616