Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Xray provides integration with Confluence, allowing allows you to create Xray issues (e.g., Tests, Pre-Conditions, etc.) from Confluence pages. It also allows you to embed JIRA Jira gadgets in pages, including JIRA standard gadgets (e.g. standard ones like Filter Results ) or Xray-specific gadgets. 

Once you have configured your JIRA Server Jira server with your Confluence Serverserver, you can see JIRA Content in Confluencesee the Jira content in Confluence. If you face any issues you may look at Troubleshooting section below.

Create Xray issues from Confluence

Xray issue types can be created directly from confluenceConfluence.

 


Note

Please note that this This feature has still some limitations regarding custom fields. Xray custom fields are limited by this issue.

Confluence "

...

Jira Issue/Filter" macro

JIRA content in Confluence 


Xray custom fields can also be included in the listing.

...

Jira Gadgets

...

Standard 

Since Xray uses different issue types (e.g., Test, Pre-Condition, Test Set, Test Execution, Test Plan) for the different testing-related entities, you can use standard JIRA Jira gadgets to make some create useful reports using JIRA Jira dashboards. These gadgets can also be included in Confluence pages. The example below illustrates the use of the "Pie Chart" Jira gadget for listing Test issues and generating statistics based on the TestRunStatus custom field.

Image Added

Image Added

Image Added


Xray-specific gadgets

You may can include Xray gadgets (e.g., "Overall Requirement Coverage") in Confluence pages. For this, you just need to insert the proper macro.


Image RemovedImage Added




Troubleshooting

  • Make sure your application links are created correctly in both your Jira and Confluence instances.
  • Make sure your external gadgets are provisioned in the Confluence administration; you can register one by one or you can subscribe to all gadgets from your Jira instance.
  • In Confluence, make sure you have authenticated against Jira; you may have some notification in order to authenticate or you may force it (for example, by listing a set of Jira issues in Confluence using the "Jira issue/filter" macro)
  • Try referencing a gadget directly in the Confluence page by using its XML URL and see if it works. The URLs of all the Jira gadgets URL are in its feed (e.g., http://192.168.56.101/rest/gadgets/1.0/g/feed) . Example below:

    No Format
    {gadget:url=http://192.168.56.101/rest/gadgets/1.0/g/com.xpandit.plugins.xray:overall-requirement-covereage-gadget/gadgets/overall-requirement-coverage/overall-requirement-coverage-gadget.xml|width=600}

References