Automatically show Insight referenced Object attribute values on Jira issue and based on selected Object


Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.

Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Purpose

Often Insight administrators and users want to show additional information related to the Object selected on a Jira issue, presented by related (referenced Objects). This article shows how to configure Insight to do that, right after the issue has been created. The result will be that related (referenced) Objects will be stored in separate Custom fields.

Solution

  1. Let's suppose we have a Computer object, that has an Attribute "Type", pointing to another Object called "Computer Type" (which can have values "Desktop" or "Laptop"):
  2. We created an Insight custom field "Affected Computer" that is visible for Jira user (and / or Service Desk customer) to select. An example configuration:
  3. Now, we created another Insight custom field "Computer Type" that will pull the value of "Type" attribute from issue context (the Object selected in "Affected Computer"). To automatically fill this custom field with the relevant value (so that a Jira user / customer does not need to select this value manually), we need to make us of "Filter Issue Scope" and "Filter Assign Scope IQL" fields and also check "Make Filter Assign Strict". An example configuration:

    (info) ${Affected Computer} is a placeholder that will address the selected Computer Object in the context of the current issue.

  4. Now, assuming the screens are configured properly to show "Affected Computer" and "Computer Type" custom fields, when we create a new issue and fill "Affected Computer", the related "Computer Type" value will get automatically filled:

Notes

  • Additional Object attributes' values can be also shown by adding them in scope of "Object attributes on Issue view" field, when configuring the custom field.An example configuration and the result can be seen below.

    However, on Service Desk customer portal, it is not possible to extend Object information in such way. Therefore, storing object attribute values and referenced objects into separate custom fields is the way to go.
  • To store other Insight attribute values (non-Object attribute type) into regular Jira custom fields, you can use Insight workflow post function "Set a Jira custom field with the attribute value from a selected object" to do that.
  • The Filter Issue / Assign Scope IQL in the "Computer Type" custom field in the above screenshot is written in a form supporting only a single value selected in the "Affected Computer" custom field. The global format, supporting any number of values in the "Affected Computer" custom field is:

    object HAVING inR(Key IN (${Affected Computer${0}}))

    Replacing the '=' with 'IN (...)' and adding the index ${0} to the placeholder will indicate ANY value in the "Affected Computer" whether one or multiple.

DescriptionAutomatically show Insight referenced Object attribute values on Jira issue and based on selected Object
ProductInsight




Last modified on Jul 13, 2023

Was this helpful?

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