Elements Connect

Connected items settings

Connected items are the legacy field type in Elements Connect, historically used to display external data on the Jira Service Management customer portal. This guide explains how to create and configure them.

For new configurations, we recommend using https://doc.elements-apps.com/elements-connect-cloud/connected-custom-fields-settings instead, unless you specifically need advanced display customization only available on connected items.

Connected custom fields are fully integrated Jira custom fields with broader capabilities. See https://doc.elements-apps.com/elements-connect-cloud/connected-fields-configuration for a comparison between both.

How to create connected items

Once at least one data source has been configured in Elements Connect, you can use the Create a Connected field button to create your connected items.

image-20240906-083226.png

In this case, select “Connected item” and click on the Next button.

Connected item types

Elements Connect supports three types of connected items, each suited to a specific use case:

image-20240910-095849.png

Single select list

  • Users can pick only one value

  • Unlimited data sets are available (external data sources retrieving more than 1000 options)

  • Dependencies to other connected items available

Multi-value select list

  • Users can pick one or multiple values

  • Unlimited data sets are available (external data sources retrieving more than 1000 options)

  • Cannot be a parent for dependencies between fields

  • Maximum 15 options can be selected

Read-only

  • Value is automatically calculated and displayed

  • Value is not editable

  • Can be single-value or multiple-values

  • If multiple-values:

    • Maximum 55 values displayed

    • Cannot be a parent for dependencies between fields

We are not stopping here! We want to bring features that matter to you, so if something is missing to achieve your use case, please contact us.

Connection to data source

The next step in the creation of a connected item is giving it a name and connecting it to the data source:

image-20240910-121102.png

The "Create the associated mirror field" option is enabled by default. Mirror fields are standard Jira custom fields that mirror the value of the connected item. Learn more: https://doc.elements-apps.com/elements-connect-cloud/mirror-data-in-custom-fields

The data source can be a REST API (including a REST API pointing to another Jira project, a Jira-to-Jira data source) or a SQL database (PostgreSQL, MySQL, SQL Server, Oracle, Azure SQL). See https://doc.elements-apps.com/elements-connect-cloud/datasource-configuration for details.

How to configure connected items

In the following pages, you will find the full explanation of the options available when configuring connected items in Elements Connect.