Skip to main content
Skip table of contents

Connected fields configuration

Elements Connect lets you bring external data inside Jira through two different types of fields: connected custom fields and connected items.

In this page, you will learn how they differ and how your specific business needs will let you know when ones should be used over the others.

Connected fields types

Connected custom fields

Connected custom fields are fully integrated Jira custom fields which can be connected to external data sources. From a technical standpoint, these are Forge custom fields made possible by our free companion app.

Learn more: Connected custom fields settings

Connected items

Connected items are the only way to bring external data directly on the customer portal in Jira Service Management, to satisfy all your ITSM needs. It should be noted that from a technical standpoint, connected items are not exactly Jira custom fields, which can lead to some limitations.

Learn more: Connected items settings

Differences in capabilities

Here is a comparison table for Connected Custom Fields and Connected Items that will help you decide when to use one of the other:

Feature/Capability

Connected Custom Fields

Connected Items

Visibility in Jira Service Management

(error) Not available

(tick) Available on request creation forms in the customer portal

Usage in Jira projects

(tick) Available

(warning) Usable in view screens of any project type, but not on issue creation screens

Integration with workflow validators

(tick) Available

(error) Not available

Integration with advanced reports created with native JQL

(tick) Available

(error) Not available

Integration with Automation and 3rd-party apps

(tick) Available

(error) Not available

Data import from Jira Data Center

(tick) Available

(error) Not available

Advanced customization of display

(error) Not available

(tick) Available, see our Template guide

How do connected fields work?

The diagram below summarizes how Elements Connect works through an example. Here we retrieve data from an external database, but the same concept is used for REST APIs.

elements-connect-how-does-it-work.png

Let's say we have access to a database where our printers are stored in a "Printers" table.

  1. The first step is to execute a Query to get the printer list from the database.
    This query execution returns a “result set”: the printer list.

  2. The second step is to apply a Template on each row of this “result set”.
    Each row is thus converted into a text which is used as an option in the connected field.

Known limitations

For now, it is only possible to create up to 250 connected fields in total (custom fields + connected items). If you need to create more, please contact us and tell us why.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.