Configuring and troubleshooting the JIRA Traceability Widget
After installing the DTP Enterprise Pack and installing the JIRA Traceability Widget, it might be confusing on where you put the data for your JIRA server and the authentication needed to access it. Also, it might seem confusing to get the data to appear in the widget the way you want it too. These steps are to help configure and troubleshoot if you are using the widget.
Configuration:
After the JIRA Traceability Widget has been installed into DTP Enterprise Pack, import the JIRA Traceability Workflow into your Enterprise Pack.
Once the Flow is placed in the Slice, go to the "Set JIRA URL" node and open it. Enter your JIRA Server's information into the text box.
After the JIRA Server information is placed, go to the "Get JIRA Projects" node. Click on the "pencil" icon on the right-side where it says configuration and this is where you will enter your User Information to allow DTP to access your JIRA server's api to fetch the data.
Once the above is apply, the Widgets in DTP Dashboard are ready to be used for Dashboard.
Troubleshooting:
If you don't see the JIRA category in the available Widgets, then this could be caused by:
- The Flow was not placed in a slice. Check the service to make sure the Flow was imported in DTP Enterprise Pack.
- You have accessed DTP on it's secure address but SSL is not enabled for DTP Enterprise Pack. Refer to the DTP Enterprise Pack documentation about configuring for SSL. You could also use the non-https address for DTP and this will allow access to the widgets.
- This could also be caused by the DTP Enterprise Pack not running. Make sure the DTP Enterprise Pack is turned on.
If you have published information but the Pie graph is grey or if "No Data" appears in the widget:
- The widget might not be configured to the correct project. Open the widget and make sure that all the JIRA projects are available. If they are not available go back and check the JIRA URL and the credentials used to access JIRA.
- The widget's JIRA query might be incorrect. By default it is set to "Story". This can be changed to Task, Bug, or whatever type is in JIRA. Make sure that you are looking at the correct type.
- Make sure in your localsettings file that the property "report.associtations" is set to true. Otherwise when you are publishing to the DTP server, it will not contain the requirement information to properly track in JIRA.
If you see the output of widget say "Invalid Query Parameter":
- Then you haven't published Static Analysis results to the project in DTP. Once you have published Static Analysis to the project in DTP this will resolve this output.
If you suddenly see the widget is displayed as unavailable:
- You have accessed DTP on it's secure address but SSL is not enabled for DTP Enterprise Pack. Configure DTP Enterprise Pack for SSL and this will resolve the behavior. You could also use the non-https address for DTP and this will allow access to the widgets.
- This could also be caused by the DTP Enterprise Pack not running. Make sure the DTP Enterprise Pack is turned on.