Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Description

Used to copy a value from a source field of the origin issue to a destination field of a new issue.

You can add any number of Copy to New configurations.

Configuration

(info) Be aware, that all destination fields must also be on the create issue screen of the new issue.

When configuring your post function, you can copy the value from a source field to a destination field. Click the + Add button to add additional field pairs to your configuration.

Note that not all conversions from source to destination field are supported, nor feasible. We can only ensure that it will work if the source and destination fields are of the same field type, or if the destination field is a text field. Some additional combinations of different field types might work as well, however, they are not 'officially' supported.

Overwrite / Append / Prepend

For text fields and some fields that can take multiple values (e.g. checkboxes), you can choose to overwrite, append or prepend the new value to any existing value. In the case of a text field, you can also choose a separator that will be placed between the values.

Create version if necessary

If your origin issue has a version, it can be copied to the linked issue.

If the destination field is 'Fix Version/s', 'Affects Version/s' or a custom field of type 'Version Picker', you can choose to create a new version in the target project, if it does not yet exist. If you don't select this option and that version does not yet exist, an error message will be displayed to users and the transition won't complete.

The new version will be created even if the user does not have the 'Administer Projects' permission. (Normally a user needs that permission to be able to create a new version.)

Special 'Sources'

  • *** default value ***: The default value of the destination field will be set.

  • *** empty ***: The destination field will be set with the empty string value. When overwriting a field value, the resulting destination value will be null. When appending/prepending a field value, the resulting destination value will be the concatenation of the existing field value (if any) and the separator. If the aim is to clear the destination field value, then use the JSU "Set Any Field Value" or "Clear Field Value" post functions. (See: Post-Function Concatenation Operations)

  • *** transition comment ***: The comment, which the user entered on the transition screen.

  • *** last comment ***: The last (most recent) comment on the issue before the transition was started.

Special 'Destinations'

  • *** new comment ***: Create a new comment with the value from the source field.

Practical tips

(info) Tip: You might set up a special transition screen to mainly copy those fields to the newly created issue. 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), see Copy within the Origin Issue.

For 'Copy from the Origin Issue to the New Issue' append & prepend do only make sense, if the target field contains already a default value. So in practice append or prepend are more often used for 'Copy within the Origin Issue'. If at all.



  • No labels