| Table of Contents |
|---|
Overview
This page illustrates what you can expect when the field synchronization has been configured on a mapping.
Notice that not all fields defined on your Jira instances are available for synchronization.
Following you can find the list of field that can be synchronized and the admissible combinations of synchronizations for different field types.
Furthermore, notice that the syncing behavior can differ with respect to the type of field in sync.
E.g. Case of Component, the synchronization is performed on adding a new component same way then deleting a component. Case of Attachment, the synchronization is performed on adding a new attachment exclusively.
In particular, you can expect a different behavior with respect to the following groups of fields:
- Comment
- Attachment
- Summary and Description
- Component, Affect Version and Fix Version
- Priority, Assignee and Reporter
- Custom Fields.
Consider that the synchronization is active on issue creation, editing and linking.
Additionally, the Sync on create option allows chosing:
- if the create screen opened via the via Herzum Quick actions button must be pre-populated (Sync on create = True) when creating an issue via the Herzum Quick actions button
- if the issue created via the Escalate issue post function must be populated based on the value on the source issue.
While on issue editing the sync type both is naturally provisioning, on issue creation and/or linking the add-on behavior follows some established conventions that are going to be detailed for:
- issue creation and/or linking via Herzum Quick actions
- issue creation and linking via Escalate Issue post function.
At last, notice that, in general, you can expect the same behavior for a Local Partnerships as for a Remote Partnership.
This guide explain in detail all mentioned topics so that you can configure suitable fields mappings.
...
Fields availability
All Jira default fields are available for a Fields mapping configuration.
Custom fields available for a field syncing configuration are:
- Text Field (single and multi line)
- third party custom fields (e.g. the Tempo "Customer Account" custom field) recognized to be text type
- Select List (single and multiple choice) - (for Local Partnership exclusively)
- Radio Buttons - (for Local Partnership exclusively)
- Checkboxes - (for Local Partnership exclusively)
- Select List (cascading) - (for Local Partnership exclusively)
- User and Group Picker, Number Field and Date Picker. New v. 4.13
Fields mapping around different Jira field’s type
...
From
...
To
...
Allowed
...
Summary, Description
...
Component, Fix/Affect Versions,Assignee, Reporter
...
...
Priority
...
Summary, Description, Custom fields
...
...
Component
...
Fix/Affect Versions
...
...
Fix/Affect Versions
...
Component
...
...
Assignee
...
Reporter
...
...
Reporter
...
Assignee
...
...
Component, Fix/Affect Versions,Assignee
...
Summary, Description
...
Fields mapping around different custom field’s type
...
From
...
To
...
Allowed
...
Text Field (multi line)
...
Text Field (single line)
...
...
Checkboxes
...
Custom fields (Text Field)
...
Priority
...
...
Priority
...
Custom fields(Text Field)
...
...
Table of Contents
Overview
This page illustrates what you can expect when the field synchronization has been configured on a mapping.
Notice that not all fields defined on your Jira instances are available for synchronization.
Following you can find the list of field that can be synchronized and the admissible combinations of synchronizations for different field types.
Furthermore, notice that the syncing behavior can differ with respect to the type of field in sync.
E.g. Case of Component, the synchronization is performed on adding a new component same way then deleting a component. Case of Attachment, the synchronization is performed on adding a new attachment exclusively.
In particular, you can expect a different behavior with respect to the following groups of fields:
- Comment
- Attachment
- Summary and Description
- Component, Affect Version and Fix Version
- Priority, Assignee and Reporter
- Custom Fields.
Consider that the synchronization is active on issue creation, editing and linking.
Additionally, the Sync on create option allows chosing:
- if the create screen opened via the via Herzum Quick actions button must be pre-populated (Sync on create = True) when creating an issue via the Herzum Quick actions button
- if the issue created via the Escalate issue post function must be populated based on the value on the source issue.
While on issue editing the sync type both is naturally provisioning, on issue creation and/or linking the app behavior follows some established conventions that are going to be detailed for:
- issue creation and/or linking via Herzum Quick actions
- issue creation and linking via Escalate Issue post function.
At last, notice that, in general, you can expect the same behavior for a Local Partnerships as for a Remote Partnership.
This guide explain in detail all mentioned topics so that you can configure suitable fields mappings.
Anchor field-available field-available
Fields availability and Fields mapping around different field’s type
| field-available | |
| field-available |
Fields availability
The set of Jira fields available for a syncing on a Fields mapping configuration include:
- Affected version
- Assignee
- Attachments
- Comment
- Component
- Description
- Due Date
- Fix version
- Priority
- Reporter
- Summary
Custom fields available for a field syncing configuration are:
- Text Field (single and multi line)
- Number field
- third party custom fields (e.g. the Tempo "Customer Account" custom field) recognized to be text type
- Select List (single and multiple choice) - (for Local Partnership exclusively)
- Radio Buttons - (for Local Partnership exclusively)
- Checkboxes - (for Local Partnership exclusively)
- Select List (cascading) - (for Local Partnership exclusively)
- User and Group Picker.
- Data Picker
- Data Time Picker
Fields mapping around different field types
Exception made for the following fields, you are able to create a field mappings between the same JIRA field types.
| Summary | Description |
Priority | Summary, Description, Text field |
| Affect Versions | Fix Versions |
Text Field (single line) | Text Field (multi line) |
Select List (single choice) | Radio Buttons |
Select List (multiple choices) | Check-boxes |
Custom fields (Text Field) | Priority |
Summary, Description | Text Field (single line),Text Field (multi line) |
Allowable fields for Sync on create
...
Notice that the comments added by the user, that are candidates to be synced, are managed by the add-onapp, so that they can be associated to the synced comment created by the system, by following the following convention:
- a comment added by the user includes the following header: Comment synced by HQL (id:<Issue id>)
- a comment added by the system includes the following header: Comment synced by HQL (<Partnership Id>: <Issue id>)
Notice that sync behavior is the same for Partnerships configured across the same or different source and destination Url/s.
...
On issue linking via the Quick actions buttons, all and only the comments added by the user on the linked issue are synced on the source issue.
Anchor Summary Description Summary Description
Summary, Description, Assignee, Reporter and Due Date
| Summary Description | |
| Summary Description |
Sync behavior for the fields Summary, Description, Assignee, Reporter is Reporter and Due Date is the same for Partnerships configured across the same or different source and destination Url/s.
...
Notice that when sync fails as default the add-on app set to Null the value of the target field. An exception is made for field configured to be required where the existing value is retained.
...