Configuration tester


Table of Contents



Definition

The Configuration tester is a tool available on the right part of the field configuration screen:






You can use the Configuration tester to test an Elements Connect field configuration when you configure it.

It contains 3 or 5 sections, depending on the datasource type:

  • Results
  • Transformed JSON / XML (JSON and XML datasources only)
  • Table result (JSON and XML datasources only)
  • Preview
  • Metrics

To launch the configuration tester:

  • click on the green Run test button
  • or use the keyboard shortcut: CTRL + Enter on a PC, Command + Enter on a Mac.


If the query contains a dependency to $issue, you'll have to select an issue before running the Configuration Tester.

An issue is required to set the query context so that the dependencies can be evaluated


The query tester is executed on the view selected in the field configuration.



Results

This section displays the query after Velocity evaluation and the raw result as returned by the datasource.

For JQL, SQL, LDAP and CSV datasources, results are displayed in a table:





When getting a CSV or JSON file (wether using a File or URL datasource), this tab displays:

  • the query URL
  • the file size
  • the HTTP status - in case of a URL datasource
  • the raw file







Transformed JSON / XML

This section is only available when connected to a JSON or XML datasource.

It shows the result of the first transformation:

  • output of the XPath evaluation on the raw XML document
  • or output of the Root element evaluation on the raw JSON document





Each document is then sent to the second transformation step to feed the result table.



Table result

This section is only available when connected to a JSON or XML datasource.

It shows the result of the second transformation applied on the result of the first transformation (previous step).







Preview

You can see here a preview of the field values as they will be displayed to the Jira users in the field editor:





It shows up to 10 results preview.



Metrics

In order to prevent potential slowdowns of your Jira instance due to slow queries, you can see the execution time of the previous test in this section.

The execution time is coloured according to the response time:

  • GREEN : between 0 and 500 ms
  • YELLOW : between 500 and 1500 ms
  • RED : higher than 1500 ms

If you observe slow response times, please consider applying our performances improvement tips.

If you still encounter performances issues after having applied the performance tips, you can reach our support team.
Please do not forget to attach your Elements Connect support dump and the full metrics report to your request.