Atlassian Marketplace **Raledo Services Raise a Support Request**
Apps
More Info
© RALEDO 2022
<aside> ⚡ Changes to Custom Field Configuration -5 Sept 2022 🚀 We have changed how the custom field is configured. Instead of using the custom field context, we have provided a dedicated configuration screen for all fields of this type. You can easily migrate your old configuration to the new configuration screen. See Instructions →
</aside>
The Simple Issue Links add-on provides an alternative and more powerful way to create relationships between issues. It includes the Issue Reference Field Type, which allows users to quickly and easily select an issue from a list generated using a configurable JQL query. The add-on also provides the ability to view and edit these relationships directly from the issue view.
The Issue Reference Field Type is an easy to use alternative to the standard Jira Issue Linking mechanism. It is a simple select list of Jira Issues. The contents of the select list are configured using a JQL statement, allowing users to select from a restricted list of issues.
For example, if you have a project which contains issues representing customers, and another project containing support requests raised by those customers, you can use an Issue Reference Field to establish a relationship between the two issues. You can even use this to automatically trigger the creation of a standard Jira issue link of a defined type.
The Issue Reference Field Type is ideal for building hierarchies, such as Parent Links, Portfolio structures, and Product Release hierarchies. With this tool, you can create multiple fields to store each type of relationship you need. Check out our Use Cases section for more information and examples.
<aside> ⚡ More Examples 🚀 Check out our Use Cases for simple solutions to complex problems Go to Use Cases →
</aside>
Log into your Jira instance as a Jira Administrator.
Click the Apps dropdown and choose Find new apps.
The Find new apps screen loads.
Search for Simple Issue Links and click on the app tile.
The App Details screen loads.
Click Get app to start installing your app.
You're all set!
Click Close in the Installed and ready to go dialog.
In previous versions of the app we used the custom field context to configure the JQL that is associated with the instance of the custom field. However, we have now changed this so that the app has its own configuration screen.
This will list all the custom fields of type Issue Reference Field Type, and allow you to configure each independently, without using the custom field context.
It will also provide a mechanism to import the configuration from the custom field context should you have any existing fields created with an older version. If you click this button next to the field name, the JQL for your custom field will be imported. Once imported, the option to import will disappear for the relevant field.
When you click on Config, you will be presented with the configuration screen. Here you can add a new Context and Configure existing contexts.
We start by creating the custom field in the normal way and choose the Issue Reference field type.
Login as a Jira Administrator and Select Admin ⚙ > Issues.
Under FIELDS, select Custom fields.
Click Create custom field. Make sure to select All to view the available field options.
Scroll down the list and select the Issue Reference Field Type and click Next.
Type the Name and Description of the field.
The name you select appears as the custom field's title wherever the field appears.
When you have entered the field Name and Description details, select Create.
Optionally, add the new custom field to one or multiple screens by ticking the corresponding box and click Update.
Once the field is created we can configure the field by setting the JQL query that should be used to populate the select list.
Changes to the field value can be used to trigger automation rules, just like any other field. For example if you want to automatically create or delete a Jira Issue Link when the value in your Issue Reference field changes, you can do the following.
Issue Reference Field Type is built in Forge because we want to support Atlassian's new cloud app development platform that helps developers to build trusted and scalable apps with Atlassian-hosted compute and storage. Our team monitors the latest developments and releases from the Altassian Forge team and we will incorporate the relevant improvements and new capabilities as quickly as possible.
At the moment, fields built using the Forge framework, including the Issue Reference Fields have the following limitations:
A workaround exists which involves using automation rules to update a backing field. For example, we could have a Customer Issue Reference field, and a Customer Name text field. Using Automation Rules we can update the Customer Name text field each time the Customer Issue Reference field changes. Then we can display the Customer Name field in the boards and issue navigator.
As a user, the issue reference field created by your administrator will look like a normal select list field.
In the above screenshot the administrator has created a Hardware Asset issue reference field. It is configured with the JQL ‘project = “Asset Management” and assettype=Hardware and status = Active’, thus allowing the user to establish a relationship with any active hardware asset from the Asset Management project.
Clicking on the field will open a dialog box and allow the user to select from the list of available issues, which in this case are all Hardware Assets. See Demo Video
Note, if you click on the issue key link within the issue reference field, the issue will be opened in another tab.
As a user you need to grant access to the app. The first time you view an issue that uses an Issue Reference Field, you will be presented with the following