Getting started with customization

On this page

Summary

This will provide an example of how to provide a customize clone operation. You must be a JIRA Administrator to do customization. If you are on at least release 3.1, you can configure customization via the Configuration user interface. Prior to release 3.1, you will also need access to the JIRA installation server file system.  You should do this on a test environment before moving to production! Both the default clone plus operations and specialized clone plus operations can be customized.

We recommend just doing a simple customization on the default clone plus operations to set fieldExcludes and leave all other customization to the specialized operations. In your environment, it is likely there are a bunch of custom fields that should NOT be copied when cloning issues. It is easy to exclude them by adding a global fieldExcludes line in your clone-plus.properties. If necessary this can be extended or overridden on a specific custom action.

Start simple

Start by doing a simple customization following the steps below and one of the examples on this page. Once you are comfortable with the process, you can look at the detail documentation for all the customization possibilities: Clone properties

Steps

Example

This example properties file defines 2 custom clone actions. See Clone properties for more information.
Example clone-plus.properties
# Example property file for Clone Plus
# More details are available in the Administrator's Guide: https://bobswift.atlassian.net/wiki/display/JCPP/Administrator%27s+Guide

## Custom 1

# Show this action for all projects, issue types and status
1.condition.*.*.* = true

Enable Bulk Clone
1.bulkClone = true

# Restrict clone operation to support and administrators
1.role.* = Support, Administrators

# Names that show to users
1.label = Escalate to Engineering
1.tooltip = Creates a task for Engineering

## Custom 1.plus

# Show this action for all issues of type bug (id = 1) or task (3)
1.plus.condition.*.1.* = true
1.plus.condition.*.3.* = true
1.plus.bulkClone = true

# Restrict clone operation so administrators
1.plus.role.* = Administrators

# Names that show to users
1.plus.label = Clone for administrators
1.plus.tooltip = Custom clone action

# Map issue type to default to a task (id = 3)
1.plus.type.*.*.* = 3

# Set fields
1.plus.set.summary = Clone of issue with summary: %original_summary%

# Set default clone options
1.option.copyAttachments = true
1.option.copyWatchers = false
1.option.copyWorklogs = hide