Backbone has multiple options for synchronizing user fields (such as assignee and reporter).
The synchronization user needs the 'Assign Issues' permission if you want to map the assignee, and the 'Modify Reporter' permission if you want to map the reporter.
Synchronize a user field to the same user
To synchronize the user to the same user in the partner project, select User Passthrough Mapping:
There are three options, depending on how you want to synchronize the field:
- The User Passthrough Mapping (by username) simply maps the user to a user in the partner instance with the same username.
- The User Passthrough Mapping (by email) simply maps the user to the partner instance with the same email address.
- The User Prefix Mapping lets you add or remove prefixes to the start of synchronized user values. This is helpful in cases where your organization has certain naming conventions for internal or external users. E.g. if you add the prefix 'INT-' to synchronized users, the user John Doe in project A would appear as INT-John Doe in project B.
If the same user does not exist in the partner instance, Backbone will throw an error. In order to avoid this, you can set a fallback user – whenever a user does not exist in the partner project, the field will be set to this fallback user instead.
Synchronize specific users to specific users
You can synchronize specific users to other specific users (for example, user 'Tom' in Project A to user 'Thomas' in Project B).
To do so, select the User Field Value Mapping setting, and in the User mapping section, click Add Entry to enter the users you want to map. The versions are mapped according to the number they are assigned to – so the version assigned to number 1 on the left side will be synchronized to version 1 on the right side.
You must also select a default user for the field to be mapped to in case you are synchronizing a user that you haven't created a mapping for. You can do this using the Fallback User dropdown. The field value will automatically fall back to this user if the synced user is not mapped.
Synchronize a user field to a text string field
You must map the user field to a text field. The mapping can only be unidirectional, because Backbone doesn't support parsing the user field from the other instance.
In the field mapping configuration, you can enter the text string in the Custom User Format text box:
You can use the following placeholders in the text string:
|the user's Jira display name|
|the user's Jira log-in name|
|the email address associated with the user's Jira account|
When ignore unassigned is activated, empty user field values are not synchronized. For example: user John Doe is synchronized as an assignee from project A to project B. Activating ignore unassigned means that if John Doe is removed as assignee from project A, project B will ignore this because it is a change to an empty field, and John Doe will remain as the assignee in project B.
Activate the ignore unassigned setting by clicking the Ignore empty values for this user field checkbox: