Synchronizing options

Learn how to synchronize options with a data source

Let’s test how objects of a JSON collection can be used as options in a select list. We’ll import a list of users from a JSON file. Then, we’ll display them in Jira in a Bundled Fields subfield of the Select list (single choice) type.

Adding the data source

Steps

1. Go to Jira Administration > Manage apps.
2. Select Data Sources from the Extension for Jira Service Desk app navigation.
3. Click Add data source.

4. Add a Data source name, in our case > External guests.
5. Choose the Data source type > REST Service.
6. Paste the REST API URL > https://jsonplaceholder.typicode.com/users
7. Select the Authentication method > No Auth.
8. Click Continue.

9. Click Test connection.
10. After receiving a confirmation, click Save connection.

11. Select a JSON path to be mapped > root - COLLECTION.
12. Provide an alias name for your JSON path > Users.
13. Select the option ID (the attribute that identifies the object on the list) > id - NUMBER.
14. Select the option > name - STRING.
15. Click Add mapping.
16. Click Continue.

17. Click Save to confirm creating the data source.

Result

The data source is added to the Data Sources list.

Connecting the data source

Steps

1. Select Bundled Fields from the Extension for Jira Service Desk app navigation.
2. Create a new Bundled Fields custom field and name it, for example, Event information.
3. Add a subfield that will contain your list of users > type: Select list (single choice), name: External guests.
4. In the three dots menu, click Connect data source.

5. Choose your data source > External guests.
6. Choose a list from your data source > Users.
7. Click Save.
8. Save the changes to your Bundled Fields configuration.

Result

Your data source is connected to the subfield. Options in the select list synchronize with the JSON collection of users:

Displaying the data source

Add the newly configured Bundled Field to your chosen screen and it will display the list of external users as a select list:

Synchronization

You can choose from three ways of synchronizing options in subfields connected to a data source:

• No synchronization (default)
• Manual synchronization
• Automatic synchronization

No synchronization

By default, the options won’t be synchronized unless you take an action. This prevents overwriting the options unexpectedly and any other errors caused by changes in the external data source, while the data is already displayed in Jira issues.

Manual synchronization

Click Synchronize under the subfield type to update the subfield with the current state of your data source:

Automatic synchronization

You can configure your subfield to be synchronized once a day.

In order to enable it, go to Bundled Fields > Settings and turn on the toggle next to Automatic synchronization:

Follow up

• Overview
• Adding a data source
• Connecting a data source
• Updating a data source
• Bundled Fields Configuration