Additional Jira Field Syncing

This feature lets you extend your Jira integration to share additional business-critical information between Jira and Kantata, and to override unwanted default mappings.

For each Jira issue, additional fields can be configured to sync from Jira to Kantata standard task or custom task fields. This can be configured in the Additional Fields section of the Jira scenario configuration page.

The syncing of additional fields only goes one direction: from Jira to Kantata, even if you are using a two-way scenario. Values that are created or updated in Jira will sync to Kantata-designated task fields, but changes to those fields in Kantata will not sync back to Jira.

Additional Field Mapping Best Practices

There are several things to keep in mind when setting up additional field syncing:

• Jira field names are case sensitive, so be sure to reference the exact name and type from your Jira Settings > Issues > Fields > Custom fields list.
• To preserve values with decimals in a Jira Number Field, you must map it to a Kantata currency field.
• You must map fields of a compatible type:
  • Jira date fields map to Kantata date fields.
  • Jira integers map to Kantata number or text fields.
  • Jira text fields map to Kantata text fields.
  • Jira single choice fields map to Kantata single choice fields. The values must match exactly. If the Jira choice value is not a Kantata choice option, the sync event will fail.
    • If you want to sync to the Priority standard task field, note that is a standard choice field with preset values. The value in the Jira field that you want to sync must exactly match the Kantata values: low, normal, high, and critical.
  • Jira single choice fields may also be mapped to Kantata text fields.
• If the maximum number of characters accepted in a Kantata input field is less than in Jira, the value will be truncated in Kantata.
• If you map to the Kantata task Start Date or Due Date fields, be aware that Kantata enforces the following business logic: the Due Date must be set to a value that comes chronologically after the Start Date value, or else an error will occur.
• In a two-way scenario, you should not use additional fields to overwrite fields that are part of a standard mapping, as the Kantata to Jira part of the sync will likely change the values in an undesirable way. This is because the integration uses the additional field mapping instead of the standard during the Jira to Kantata part of the sync. However, it will use the standard mapping during the Kantata to Jira part of the sync, therefore overwriting the Jira field in the standard mapping.