View Source

This page illustrates add-on Create and link feature by example, via same miscellaneous types of configured mappings.

Notice that a mapping enables issue creation and link via the quick action button only if the Quick Action Button box is checked.

Create a new issue on the present JIRA instance and link it via a JIRA link

Precondition:

configure a partnership as per the example below

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 15:22:31.png

configure a mapping as per the example below

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 12:54:59.png

Due to the Allow issue creation/linking via partnership credentials has been checked, the issue is created by applying the Partnership Credential.

It implies that:

the Source and Destination Users on the Partnership must be allowed to create and link issues on the Source and Destination Project
the Destination User on the Partnership is recorded on the target issue history as the issue creator and having linked it
the Source User on the Partnership is recorded on the source issue history as the user having linked it
the Destination User on the Partnership is set as issue reporter.

Following, it's going to be illustrated the Issue Creation and linking functionality based on the setting illustrated above.

1

Go to an issue belonging to the project selected as Source Project and having as Issue Type the Source Issue Type.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 13:6:12.png

Issue view screen

2

The Herzum Quick actions panel shows the button associated to the configured mapping.

Herzum Quick actions panel

3

Click the Herzum Quick Action button to display the Create screen of the issue to be created on the Target Project and having the Target Issue Type.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 14:20:54.png

Issue Create screen opened via the Herzum Quick action button

4

Complete data on the form, check the Create another box to create more then one issue and click Create.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 14:35:2.png

Issue Create screen opened via the Herzum Quick action button

5

If the Create another box has been checked, an alert confirm issue successful creation and the screen allows to insert data to create the next issue.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 14:41:51.png

Issue Create screen opened via the Herzum Quick action button

6

Review issues successful creation and linking via JIRA Issue Links as per Link type setting on the Mapping.

Due to the Link type versus setting, the issue link on the source issue reports the Link Type Inward Description.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 15:6:39.png

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-10 14:43:50.png

Issue View screen - JIRA Links panel

Create a new issue on the present JIRA instance and link it via a Quick link

Precondition:

configure a mapping as per the example below

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-14 11:54:18.png

As already showed via the previous example, the Herzum Quick actions panel shows the button associate to the configured mapping.

1

Click the Herzum Quick Action button to display the Create Screen of the issue to be created on the Target Project and having the Target Issue Type.

Due to the Allow issue creation/linking via partnership credentials has been un-checked, the issue is created by applying the logged user credential.

It implies that:

the logged user must be allowed to create issues on the Destination Project. No linking permission is checked due to the Link Type has been set to Quick Link.
the logged user is recorded on the source and target issues history as the user having linked it
the logged user is recorded on the target issue history as the user having created it
the logged user is set as issue reporter.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-14 12:15:51.png

Issue Create screen opened via the Herzum Quick action button

2

Review issue successful creation and linking via Quick Link as per Link type setting on the Mapping.

Due to the Link type versus setting, the issue link on the source issue reports the Link Type Outward Description.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-14 12:22:0.png

Issue View screen - Quick Links panel

Create a new issue on the present JIRA instance and link it via both JIRA and Quick link

When the Link type is set to both, you can expect same behavior described previously but exception is made for the displayed links.

Due to this setting, either JIRA Links and Quick Links are created and displayed on the issue view screen.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-14 12:39:32.png

The issue view screen of the linked issue display both links to the source issue as well.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-14 13:15:20.png

Create a new issue on a remote JIRA instance and link it

Restrictions:

remote issue linking is allowed for Quick link type only.
only issue creation and linking via partnership credentials is allowed
the sub-task issue type cannot be set as target issue type.

Precondition:

configure a partnership as per the example below

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-15 12:5:0.png

configure a mapping as per the example below
Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-15 12:51:48.png

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-15 12:51:48.png

Likewise to the previous examples, the Herzum Quick actions panel shows the button associate to the configured mapping.

1

Click the Herzum Quick Action button to display the Create Screen of the issue to be created on the Target JIRA Instance, Project and having the Target Issue Type.

The issue is created by applying the Partnership Credential. It implies that:

the Source and Destination Users on the Partnership must be allowed to create and link issues on the Source and Destination Project respectively
the Destination User on the Partnership is recorded on the target issue history as the issue creator and having linked it
the Source User on the Partnership is recorded on the source issue history as the user having linked it
the Destination User on the Partnership is set by default as the issue reporter but it can be updated.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-15 13:3:52.png

Remote issue create screen

2

If the Create another box was checked the screen allows to insert data to create a new issue.

Herzum Quick Linker Documentation > Creating and linking an issue via the quick action button > image2015-7-15 13:9:28.png

Remote issue create screen

Additional facilities

The add-on provides a set of facilities increasing usability:

Herzum Quick links panel allow to rank links via drag & drop.The links ranking is allowed on the source and on target issue.
On moving the mouse cursor on the Quick Link icon, you can display the tool tip reporting the name of the label has been set on the mapping associated to the existing link.

On moving the mouse cursor on the Quick link button, you can display display the tool tip reporting the Partnership and the target Project configured on the Mapping.