Breadcrumbs

Field Mappings

Define which fields are synchronized in the Fields - Mappings tab of the configuration.

With Backbone you can map fields either bi-directional or uni-directional. Standard Jira fields as well as most custom fields are supported. You can find a full list of supported fields here.

On this page you both find the requirements to synchronize fields and two ways on how to set up fields: simple and advanced.

Requirements to Sync Fields

To synchronize fields, you need to make sure that:

  • Every field which should be edited by Backbone should be on the edit screen for this project/work type. If you want to use a transition instead, please check out the advanced setting sync.editTransition.

  • Backbone needs the "Edit Issues" permission for each project where you define incoming field mappings

Add Field Mappings

You can add fields in two ways: through a simple mapping when the name and types are the same (e.g. summary <> summary) or an advanced mapping. You can always make use of a combination of both.

Simple mapping

You can use the simple mapping to quickly add fields that have the same name and type and don’t require any further configuration. To add fields through the simple mapping, you can follow these steps:

  1. Click + Field mapping > Simple

Field-mapping-add-menu.png
  1. In the dialog, select which field(s) you want to sync by checking the box(es)

  2. On the top, choose the direction you want these fields to be synced in

  3. Click on “Create“ to add the fields to your configuration

Field-mapping-simple.png

Advanced mapping

You can use the advanced mapping to add fields that are not of the same type, need to be synced for only certain work types or need further configuration. For example:

  • Fix Version <> Affected Version

  • Select Field One <> Select Field Two

  • Reporter > Text Field

You can follow these steps to add an advanced field mapping:

  1. Click + Field mapping > Advanced

  2. Choose the fields on each side which you want to map to each other

  3. Pick the direction in the middle of the two fields

Field-mapping-advanced.png
  1. Optional: uncheck “applies for all “work types” to only specify certain work types the field should be synced on.

  2. Optional: click on “configure“ to select different mappings

  3. Click on “save“ to add the field mapping to the configuration

Edit or Delete Field Mappings

Once you’ve added your fields, they show up in the Field - Mappings tab. From here you can take different actions:

  • Edit: click on the pencil icon to open up the dialog to alter the field mapping.

  • Disable/enable: click on the eye icon to disable/enable the field mapping. This can come in handy if you want to test something or later want to add the field mapping again.

  • Delete: click on the trash icon to delete your field. You can always add it again later if needed.

Field-mapping.png

Field Reference 

System Fields

This list shows which system fields are supported by Backbone. Read-only indicates that the field can only be synchronized in one direction. If you miss support for a certain field, please let us know via the support button.

In general, Backbone supports three different types of field mappings: PassthroughCorrelation and To Text. You can read more in the article about  Common Field Mapping Types. For detailed information on how to synchronize some of the more complex mappings, please refer to the  field mapping reference.

Field Name

Supported?

Affects Version/s

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Assets fields

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Assignee

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Attachment

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Comment

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Component/s

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Created

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png (read-only)

Creator

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Customer Request Type

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Description

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Due Date

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Environment

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Epic color

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Epic link

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png (only if the parent work item is part of the synchronization)

Epic name

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Epic status

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Epic theme

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Fix Version/s

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Flagged

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Images (this is not the Attachments field)

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

Work Type

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png (using advanced.issueTypeChangeAllowed advanced setting)

Key

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Labels

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Last Viewed

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Linked work items

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Multi-select fields

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Multi-level cascading select

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  

Original Estimate

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Parent

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png (only if the parent work item is part of the synchronization)

Priority

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Progress

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

Project

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

Project-specific select

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Project-specific multi-select

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Remaining Estimate

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Reporter

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Resolution

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Resolved

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Request participants

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Satisfaction date

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Security Level

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

Select fields

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Single version picker

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Sprint

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Status

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Story points

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Sub-Tasks

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Summary

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Time Spent

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Updated

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

Votes

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png (read-only)

Watchers

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

Work Ratio

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

Worklogs

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png

∑ Original Estimate

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

∑ Progress

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/error.png

∑ Remaining Estimate

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)

∑ Time Spent

https://k15t.jira.com/wiki/s/-1089340325/6452/b918cef7e880658f8bd9548f8f909a3bb00f5478/_/images/icons/emoticons/check.png  (read-only)