Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Create a new partnership

Warning
iconfalse
titlePrerequisites

In order to create a remote partnership, you must install the app on both the Source and the Remote Jira instances.


By default, there are no partnerships created when you first install the Quick Linker plugin.  Your first configuration option will be to create a new partnership.  

1

Click on Add new partnership to create a new Partnership.

Image Modified

Add New Partnership


2

Configure the Partnership via the Herzum Quick Linker Partnership Configuration Screen.

The Source URL configured on your System General Configuration Settings is automatically set by

the add-on to the Base URL configured on your System General Configuration Settingsinfo

the app as the Source Base URL.

Info

Review below the detail of the Partnership Fields.




Image Added

Herzum Quick Linker Partnership Configuration Screen

3

Click on the Test Connection button to run a Connection Diagnostic test and Save.

Info

The check is performed on the Destination URL only. Destination credentials are not checked.


Image Added

Test Connection pop-up

4

Verify successful creation of the Partnership.

Image Added

Herzum Quick Linker Partnership Configuration Screen

6Click on one header field to display the listed partnerships alfabetically reordered based on the selected field.

Image Added

Herzum Quick Linker Partnership Configuration Screen

Anchor
PartnershipFields
PartnershipFields
Partnership fields

All fields are required.  

  • Name
    • This is the Partnership Name.
    • It cannot be longer than 50 characters.
    • This is not editable on Partnership update.
  • Source URL
    • The Default Value is the URL to the current

...

    • Jira instance
  • Source Username
    • This is the Username for accessing the Source URL. 
  • Source Password
    • This is the Password for accessing the Source URL.
  • Destination Url
    • This is the URL to the destination

...

    • Jira instance
  • Destination Username
    • This is the Username for accessing the Destination URL. 
  • Destination Password
    • This is the Password for accessing the Destination URL.
  • Partnership Icon
    • This is the Icon for the Quick Linker button that will be configured toward the partnership via the Mapping configuration. It's suggested choosing different icons for each partnership.

All fields are required.  

Image Removed

Herzum Quick Linker Partnership Configuration Screen

...

3

...

Image Removed

Test Connection pop-up

...

4

...

Image Removed

Herzum Quick Linker Partnership Configuration Screen

...

Image Removed

Herzum Quick Linker Partnership Configuration Screen

  

Review the Recommended best practices for Partnership credentials for further information on this setting.

Update an existing partnership

To update an existing Partnership just click the  icon under the Operations column. You are not allowed to update all Partnership Properties and some updates are allowed depending by the specific scenarios,

Partnership Name cannot be updated.

Source URL, Username and Password can be updated  only from the Source Jira instance.

Destination URL, Username and Password can be updated from both the Source and the Target Jira instance.

Notice that, on changing the Partnership Source  Properties, a consistence check will be performed on the associated Source

and Destination URL, a consistence check will be performed on the associated Source and Destination Server ID.

on the local as on the remote Jira instance. If Partnership Properties aren' validated, an alert advertises that changes cannot be pensisted.

Image Added

Delete a partnership

To delete an existing Partnership just click the  icon under the Operations column.

...

  • always, if the Partnership is a Local Partnership
  • always,if the current JIRA Jira instance is the Source URL of a Remote Partnership
  • if the current JIRA Jira instance is the Target URL of a Remote Partnership and  if the Partnership is disabled (e.g. Source URL no more existing, password changes, license expired etc).

...

On click , all associated mappings and quick links are deleted too.