On this page

Use case

In this use case we will get the assets (formerly insight objects) of a Jira Cloud issue and write the respective object labels to a custom text field.

Prerequisites

For this use case we need a custom action for executing the get assets operation. It should be executed for a Jira Cloud instance.

Create a connection

Configure the connection either inside the post function configuration or using the Remote actions page in the Manage apps administration by setting the following input.

Name

Atlassian API

Connection type

Choose External.

Base URL

https://api.atlassian.com

Authentication

Choose Basic authentication and provide an email as the username and an API token as password.


Create an action

Create the action either inside the post function configuration or in the Remote actions page in the Manage apps administration by setting the following input.

Name

Get assets

Method

Choose GET.

Default connection

Choose Atlassian API.

REST path


/jsm/assets/workspace/{workspaceId}/v1/aql/objects?{qlQuery}


The values used below are created for the example only. Please provide real input from your instance for making the use case realistic.

Parameters

workspaceId

The workspaceId is used to identify your individual instance of Insight. It is retrieved through the following endpoint: https://SITE_NAME.atlassian.net/rest/servicedeskapi/insight/workspace.

qlQuery

The qlQuery parameter holds an AQL (Asset Query Language) expression and determines which objects should be fetched. For the sake of the example we set the issue key as ISSUE-1.

object HAVING connectedTickets(key = ISSUE-1)

Configuration

Add the Execute remote action post function to the desired transition or create a new transition.

Select action

Choose the previously created action which we named Get assets.

Select connection

It is automatically preselected with the default connection value of the selected action.

Update issue fields (optional)

Other default options like Response body, Response status or Set field value manually are available in any mode in the post function.

Select the field to be set.

Choose the text custom field to hold the object entry labels.

Set the value manually by using the following parser expression:

%{action.response.objectEntries[*].label}

This parser expression uses the field code Action response details and JMESPath in order to get the information from the response.

 






If you still have questions, feel free to refer to our support team.