Create and configure Advanced Links
Advanced Links are connections established between issues.
This connection allows us to show relevant data from linked issues in the current issue view and build custom dependencies that fit any asset portfolio.
Advanced Links are created and managed on the app administration page: Settings → Apps → STAGIL Assets → Advanced Links OR press . and look for the Advanced Links option in the quick search dialog.
To access the page and create and manage Advanced Links, users must have Jira administrator permissions.
The app has 5 sample Advanced Links for users to get to know the feature. These links are created without context. Click Edit and assign issue types to the each link field to see them in issue view.
How to create an Advanced Link
To create an Advacned Link click on the Create advanced link button.
Next, create the following properties for the link:
Name: a name to identify your Advanced Link (used in JQL queries & automation).
From type: select issue types where the field should be displayed.
Outward field: field name in issue view.
To type: elect issue types where the field should be displayed.
Inward field: field name in issue view.
Storage link type: used for syncing our field values with other link types.
Color: The color of the link in the data model is accessible via the Diagram tab on the same page.
Advanced Link fields
In DC version of the app, Advacned Links are built as custom fields. In Cloud, link values are stored in issue properties and displayed to users via our custom panels.
Advanced Link has two equal properties: inward and outward fields, each representing the link direction towards an issue. It follows the same logic as Jira’s default links.
For example: If you wish to link applications with databases, you can use the Advanced Link called "Application - Database". This link consists of two fields - an outward field called "Application Database" that links applications to the databases connected to them, and an inward field called "Database used by" that links databases to the applications that use them.
Set Advanced Link Field Contexts
To make your Advanced Link work you have to define in which contexts your fields should appear. Going back to our example this means that we have to place our field “Application Database” in the screen(s) for the issue type “Application” and the field “Database used by” for the issue type “Database”. This way we link two issue types by linking two custom fields.
Unactived/activated indicates whether your Advanced Link is searchable.
Click on the field you want to edit. Now you can add/delete or edit the Advanced Link field context.
Configure Advanced Links
To configure either the inward or outward Advanced Link, click on the field title on the Advanced Link configuration page.
At this stage, an Advanced Link is simply an empty structure. We will fill it with data in the next step. Click on “Edit Advanced Link Filed” to proceed with the configuration:
Issue View
Under the Display Style tab, you can define the appearance of the issue panels that display Advanced Links in the issue view.
Panel: select where to display the Advanced Link panel in the issue view.
Display Style: select panel view: table or list.
Rows per page: The number of rows per page (the rest will be shown via pagination).
Fields to show: select the fields that should be displayed in the table.
Fields to sum up: sums up the number of fields if table view is configured.
Issue Progress Bar: sums up the progress of linked issues in the panel based on status and visualizes it in a progress bar.
Order results by: enables Advanced Links (table or list) sorting based on the selected field’s values.
Enable field on create screen: allows to add an Advanced Link to the issue create screen (see more https://stagil.atlassian.net/wiki/spaces/SAJC/pages/2161279046).
Customer Portal
In case you want to make your Advanced Link field available in Jira Service Management as well you can define projects and issue types in this menu.
Projects: the list of JSM projects included in the Advanced Link field context.
Request Types: the list of request types that are mapped to an issue type part of the Advanced Link context.
Parent Field Filter (Dynamic)
In this tab, you can apply a filter on the configured amount of assets you chose in the Data Logic tab based on a selected parent field. So it is possible to have a different list of assets for selection in issues, depending on the selected asset relation:
Parent field: Advanced Link upon which you want to base the dynamic behaviour.
Link types: link types that should be shown.
Link level: the levels of links that should be displayed.
© 2023, STAGIL