Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
This is the documentation of JSU for Jira Server/Data Center. If you are using JSU on Jira Cloud, see our JSU Cloud documentation. |
Table of Contents |
---|
Info |
---|
The 'Copy / Move Attachments' feature is available from JSU 2.9.0 |
...
Copy attachment from/to any related issue
You have several different options, which define which issue/s will be treated as source/destination for attachments.
Several of JSU's workflow modules provide the option to define the scope of the module on some related issues.
For example, instead of copying attachments from one issue to another, you might choose to copy them from all linked issues to the issue in transition (e.g. to group all attachments within one issue)
...
Issue Link
You can define the link type to defined 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 / Sub-TaskSubtask
The related issue is either parent or sub-task subtask of each other.Epic / Issue in Epic
This 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.
...
Or in other words, the issue which triggered a workflow condition/validator/post function to be executed.
Warningnote |
---|
Conditional copying attachmentsConditional copying attachment (controlled by custom field) is always checked always only for the issue in transition.Independently if , regardless of whether the issue in transition is a source or destination. |
Source and destination
For example, the Copy Value From Other Field Post-Functionpost function allows you to define the issue in transition as the source or destination of the copy operations, while you define the other end with an issue relation.
The field value will then be read from the source issue and be written to the destination issue.
Other workflow modules do not have source and destination. So ; you just define the issue relation, which will apply for to that workflow module.
For example, Create a Linked Issue will just create a new issue, and then connect it with some Issue Relation through an issue relation to the issue in transition.
Controlled by custom field
Here the idea is, that you have a checkbox custom field on the transition screen , so that the user can control some of the functionality.
...
For example, a checkbox 'Copy Existing Attachments' might be configured as Custom Field a custom field that enables copying existing attachments. Only if it is ticked, all attachments will be copied.
Typically this checkbox custom fields field won't appear in on the normal issue screen of the issue. Instead of letting the a user choose to copy/move the attachments, you can also configure it to either never /or always copy them.
Tip: You might can also choose 'Move Attachments added during Transition'. The When a user then adds some attachments on the transition screen of the source issue. However, since they are moved to all related issues, it feels it appears as if he just they added the attachments to all related issues.
...
If you use 'Move Attachment' (see below) 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 also used in a combination with preconditions.
Infonote | ||||||
---|---|---|---|---|---|---|
If you use 'Move ‘Move Attachments added during Transition' it is important that the 'Copy / Move Attachments' Post-Function post function is before JIRA Post-Function the Jira’s 'Update change history for an issue and store the issue in the database' !
In such case "Copy Move Attachments" has to ‘Copy Move Attachments’ must be placed between "Update ‘Update change history for an issue and store the issue in the database" database’ and "'Re-index an issue to keep indexes in sync with the database"database’. |
Warning |
---|
Due to a Bug in Jira JRASERVER-65939, 'Copy or Move Attachments' functionality, which are added through a Transition Screen, does not work in Jira 7.5.x & 7.6.0. If you require this functionality, please upgrade to minimum Jira Version 7.6.1! |
Already 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.
Tips
You might set up a special transition screen to mainly copy those attachments to all linked issues. So it feels more like it would be the create screen of the new issue. In that case, you won't show those fields on the origin issue, but reset them again afterward (just empty or back to the default value).