Getting Started With Customization

Owned by Former user (Deleted)
Last updated: Aug 19, 2019
2 min read

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 two custom clone operations. See Clone properties for more information.

Example clone-plus.properties
# Example property file for Clone Plus
# More details are available in the Administrator Guide: https://bobswift.atlassian.net/wiki/display/JCPP/Administrator%27s+Guide

## Custom 1

# Show this operation 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

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

# Set clone options available for fields
1.option.copycustomfield_11060 = true
1.option.copysummary = false
1.option.copyfixVersions = true
1.option.copycomponents = false
1.option.copyduedate = true
1.option.copyassignee = false
1.option.copytimeestimate = true
1.option.copysecurity = false

# Set target project
1.project.*.*.* = ZCLONE

# Set project category
1.condition.*.*.*.newcategory = true

## Custom 1.plus

# Show this operation 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 operation

# 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.plus.option.copyAttachments = true
1.plus.option.copyWatchers = false
1.plus.option.copyWorklogs = hide