Default Insight custom field

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The default Insight custom fields gives you the most flexibility, and is what you'll use in most cases. When you're looking to add objects to issues while creating them, the default custom fields will help you achieve that. 

Create a default custom field

To create the default Insight custom field:

  1. Log in to Jira as an admin.
  2. Go to Administration > Custom fields.
  3. Select Add custom field Advanced.
  4. Search for Insight Object/s, and select it.
  5. Enter a name and description for your field.
  6. Once created, associate the custom field with desired screens in Jira.

The Insight default custom field is now created and associated with the right screen in Jira. Now, you need to configure this field so it allows your users to choose specific objects.

Configure the default custom field

With your custom field created and associated with the right screens in Jira, you can now configure how it will behave.

  1. Find your custom field on the Custom fields page, and select Configure next to it.
  2. Select Edit Insight Configuration.
  3. Select which object schema the custom field should use.
  4. Configure other settings. You can check what they mean in the table below.

Scope

SettingDescription
Object schemaObject schema that the custom field should use. If you want this field to refer to specific objects, make sure you point to the right schema.
Filter scope (IQL)

Define the scope of objects that are valid for this field. For example, if you want it to show only specific object types (Applications, but not Hardware), then you could use a query like this one:

objecttype = Application

Filter issue scope (IQL)

In the create/edit view, and in the customer portal, you can filter objects based on their attributes, in addition to the filter scope you configured above. This doesn't apply to JQL searches. Placeholders are supported, but only for "Select type".

Example

This IQL will show objects that are owned by the group selected in the request:

Server."Owner Group" = ${Group}

This IQL will show objects that are owned by the reporter:

Owner = currentReporter()

Filter assign scope (IQL)

Allows you to automatically set objects to the custom field. This can be filtered on any issue field values with support for placeholders.

Example

This IQL will show objects that are owned by the group selected in the request:

Server."Owner Group" = ${Group}

This IQL will show objects that are owned by the reporter:

Owner = currentReporter()

For more info on creating your queries, see:

User interaction

SettingDescription
Type of interaction

You can specify what type of interaction the custom field should use:

  • Select
  • Checkbox / Radio buttons
Filter objects with attributeYou can specify the attributes to filter on, this field is mandatory and at least one has to be configured. Label is default.
Object attributes on issue viewYou can specify which of the object's attributes will be displayed in a Jira issue. For example, you might specify only the most important attributes, so as to not clutter your issues, and users can view the rest after opening the object.
Multiple

You can specify if users can choose multiple values for this field.

Option to add all objectsIf you allowed multiple values (above), you can add an option to select all values.

Service Desk

SettingDescription
Show object picker on customer portalsThis is for Jira Service Management. You can choose whether the object picker (which allows to browse and select objects) should be available on the customer portal.

Enable access for customers

When you add Insight custom fields to Jira Service Management, you need to enable them for customer portals. Without these steps, customers won't be able to access these fields. Learn more...


Last modified on Feb 8, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.