This is the documentation of JSU for Jira Server/Data Center. If you are using JSU on Jira Cloud, see our JSU Cloud documentation.
On this page: |
The 'Copy / Move Attachments' feature is available from JSU 2.9.0
Description
This post function will copy attachments from/to all related issues. A user defines which issue should be a source and which is a destination. Any number of attachments can be copied to the related issue(s).
Configuration
Copy attachment from/to any related issue
You have several options which define which issue/s will be treated as source/destination for attachments.
Related issues will be found by one of the following Jira concepts:
Issue Link
You can define the link type to define which issues exactly will be affected by the operation.
Since JSU 2.2.0, we introduced the value ANY. The operation will be performed on any linked issues.Parent / Subtask
The related issue is either parent or subtask of each other.Epic / Issue in Epic
This is only applicable if you have Jira Software installed. The other issue is either the epic related by an epic link, or it is part of an epic.
Issue in transition
We use the term 'Issue in Transition' when we refer to the issue for which a workflow condition is checked, for which a workflow validator is examined, or for which a workflow post function is performed.
Or in other words, the issue which triggered a workflow condition/validator/post function to be executed.
Conditional copying attachments
Conditional copying attachment (controlled by custom field) is always checked only for the issue in transition, regardless of whether the issue in transition is a source or destination.
Source and destination
You can define the issue in transition as the source or destination of the copy operations. Other workflow modules do not have source and destination; you just define the issue relation, which will apply to that workflow module. For example, Create a Linked Issue will create a new issue, and then connect it through an issue relation to the issue in transition.
Controlled by custom field
With a checkbox custom field on the transition screen, a user can control some of the functionality.
For example, a checkbox 'Copy Attachments' might be configured as a custom field that enables copying existing attachments. Only if it is ticked, all attachments will be copied. Typically this checkbox custom field won't appear on the normal issue screen. Instead of letting a user choose to copy/move the attachments, you can also configure it to either never or always copy them.
You can also choose 'Move Attachments added during Transition'. When a user adds some attachments on the transition screen of the source issue, it appears as if they added the attachments to all related issues.
Position of the post function
If you use 'Move Attachment' you must position the post function before 'Update change history for an issue and store the issue in the database. 'This post function can also be used in a combination with preconditions.
If you use ‘Move Attachments added during Transition' it is important that the 'Copy / Move Attachments' post function is before the Jira’s 'Update change history for an issue and store the issue in the database' post function.
In such case ‘Copy Move Attachments’ must be placed between ‘Update change history for an issue and store the issue in the database’ and 'Re-index an issue to keep indexes in sync with the database’.
Otherwise transition attachment will not be properly stored and it will be not attached to the current issue.
Existing attachments are not copied again
When an identical attachment (same file name and same content) already exists in the destination issue, it will not be copied again. This is the case for both, existing and transition attachments.