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 Make sure your application links are created correctly OK, in both your JIRA Jira and Confluence instances.
  • make Make sure your external gadgets are provisioned in the Confluence administration; you can register one by one or , even better, you can subscribe to all gadgets from your JIRA Jira instance.
  • in In Confluence, make sure you have authenticated against JIRAJira; you may have some notification in order to authenticate or you may force it (for example, by listing a set of JIRA Jira issues in Confluence by using the "JIRA Jira issue/filter" macro)
  • you can try Try referencing a gadget directly in the Confluence page by using the XML its XML URL of it and see if that it works. You can know The URLs of all the JIRA 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}

...