Create an Assets object custom field
To create or edit Assets object custom fields, users must have a Jira license.
First, create a field in the admin settings of Jira, then you can configure the Assets object field.
An Assets object custom field can store up to 200 objects.
Create an Assets object custom field
Navigate to the Jira admin panel by selecting Settings () in the top navigation, then select Work items.
In the Fields section in the side navigation, select Fields, then Create new field.
In the panel that opens:
Select Assets objects under Field type.
Give your field a name — this will appear on the work items across your site, so be sure to choose a clear name.
Add a description — this description appears on the Fields table you’re currently viewing for sorting purposes.
When you’re done, select Create.
Under the Field type column, find your Assets object field, or search using the field name.
Select the more actions icon (···) under the Actions column, then select Contexts and default values.
Select Edit Assets object/s field configuration.
Under Field scope:
Select the Object schema the field should access.
[Optional] Add an AQL query in Filter scope (AQL) to filter objects based on attributes. Find out more about using Assets Query Language (AQL) syntax
[Optional] Add an AQL query in Filter work scope (AQL) to filter objects based on values from other fields.
Under User interaction, select which Assets attributes users can search and view.
[Optional] Enable Field can store multiple objects to store up to 200 objects.
[Optional] Enable Display a default object when this field appears in customer portal in Jira Service Management to prefill the field using the Filter Work Scope AQL.
Select Save.
Placeholders can’t be used in the Filter scope (AQL) field on the Assets object field configuration screen.
Add an Assets object custom field to a space
You can add the Assets object custom field to work items in Jira and Jira Service Management spaces.
For service spaces in Jira Service Management, you can add an Assets object custom field to your request types and make it visible on the portal so end-users can select objects in their requests, and agents can access them directly in the work view.
When a field is added to a request type, all portal customers are automatically granted the User (view-only) role. Find out more about roles
Once an object is selected in a request, the work will appear under Connected Jira work items in the Assets view.
Objects visibility may vary across experiences. Most experiences such as creating, viewing or updating Work items and Portal view in Jira Service Management will display the full list of 200 objects. Meanwhile some other views such as Kanban Board, Scrum Board, Backlog and will display a truncated list of 50 objects.
To test your setup:
Go to a work item.
Find your Assets object field.
Select the field to open the object, or select the graph icon to view the object graph.
You can boost this setup with automation rules to trigger actions based on object data. Find out more about automation smart values for Assets
Was this helpful?