...

To create new relations, please navigate to the Jira Cloud Administration → Apps → STAGIL ASSETS app administration and choose “Relations”. Here you can see all relations already created. Click “Add Relation” to create a new relation:

...

Now you can add a relation by filling out will see the following screendialogue:

...

Color: color of the relation if its displayed in a graph.

...

Relation: choose “Custom Asset Relation” in case you want to create a custom relation type (this is the main use case of our app).

Outward Field: Name of field that represents the start point of the relation.Inward Field: Name of the field that represents the end point of your relationIssue Link: Imagine 2 issues A and B. The outward link is the direction from A → B.

Inward Issue Link: The inward link is the opposite direction from B → A.

Show in Graph: check the box to show your relation in graphs (checked by default).

Status (Active / Inactive): Search status of your relationColor: color of the relation if it is displayed in a graph.

Example

Here you can see a relation that connects databases with applications. The field “Application Database” will appear in issues from type “Application” and will show the database connected to the application. The field “Database used by” will appear in issues from type “Database” and will list all applications that are connected to the database.

...

You want to connect applications with databases. Your relation name is “Application - Database”. So you have the outward link named “Application Database” which will link the application with databases connected to it. Vice versa you have the inward link named “Database used by” which will link the database with applications.

Set Relation Field Contexts

The context defines in which projects and issue types your relation fields will appear. The context has to be set individually for each relation field. To choose a context for a relation field you have to click on the name of the field:

...

The following dialog will open. Choose in which projects and issue types your field should appear, then click Add:

...

Configure Relations

After setting the context the relation is ready to be configured. Click Configure to start:

...

To make your relation work you have to define in which contexts your fields should appear. Going back to our example relation 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.

...

Click on the field you want to edit. Now you can add/delete or edit the relation field context:

...

Configure Relations

Until now your relation is not more than an empty structure. We will fill it with data in the next step. Click on “Edit STAGIL Assets Relation” to proceed with the configuration:

...

Data Logic

Under the Data Logic tab you can define the scope of your relation:

...

Fields to show: Select the fields that should be displayed in the panel.Fields to sum up:

Issue Progress Bar: Sums up the progress of linked issues in panel based on status and visualizes it in a progress bar.

Add new: Define assets for quick-creation from issue viewWhen you choose the display style "Table", you can allow users to create new assets directly at the table in the issue view. To enable this feature, please choose the project and the issue type that should be pre-selected in the create new issue screen that will appear after the user clicks on the small plus icon above the table.

Service Desk

In case you want to make your relation field available in Jira Service Management as well you can define projects and issuetypes in this menu.

...