Field mappings let you define which fields are mapped between synchronized issues.
Like Issue Type Mappings, they can either be mapped bi-directionally (master <> slave) or uni-directionally (master > slave or slave > master). However, field mappings can only be created on the master side.
This guide will explain how to work with field mappings on both the master and slave sides.
Field mappings – master
On the master side, you can create all the new field mappings which you'd like to have. You can also select the direction of the synchronization using the arrow dropdown menu in the middle of the form. If you leave the ‘All Issue Types’ box checked, this field mapping will be activated on issue syncs of all types. By unchecking the box, you can choose to have this field type mapping activated for only selected issue types. When creating field mappings, you cannot map a field directly to a certain field on the partner side. This is because each partner controls their own side of the synchronization. You must assign the mapping a message alias, which is a label that determines how it is presented to your synchronization partner. The message should make it clear to the synchronization partner which field they should map it to on their side.
Field mappings – slave
On the slave side, you can configure the new mappings by mapping them to the relevant fields on your side of the configuration. The mappings should come with a message alias that clarifies which field you should map it to on your side. In this case, the message alias is 'description' – so it is clear that you should map it to the 'description' field. Contact your synchronization partner If it is unclear what field you should assign the mapping to.
Field mappings cannot be created on the slave side – the slave can only configure field mappings sent to them from the master side.