Issue Update Notifications to Salesforce from JIRA
Jira Issue updates are sent to Salesforce in configurable batches. Specifically, Jira notifies Salesforce with a list of Issues which have been updated. This list comprises of Issues which have related Salesforce Case(s) and have one or more fields updated which are shared with Salesforce via zAgileConnect configuration. Salesforce receives this batch of updated Issues list and initiates a request to Jira for details for all the Issues in the batch. Once the details (updated Issue fields) are received, they are updated in the local ZIssue object in Salesforce to bring ZIssue data current with what is represented in Jira for each Issue.
Failures in Issue Updates to Salesforce
Under normal circumstances, the Issue Update Notifications are sent to Salesforce and applied on a regular configurable interval. However, some scenarios may cause these notifications to fail:
- Network timeouts – If Jira is unable to send the notifications to Salesforce due to network-related issues (typically timeouts), zAgileConnect’s Issue Update Notification will be retried for up to 5 days.
- Failing Custom ZIssue Triggers – If a custom trigger on ZIssue fails on some validation without properly handling the exception, it can cause the entire batch to fail updating ZIssue. In such scenario, while the Issue Update Notification will continue to be retried (for up to 5 days), unless the trigger is corrected, the batch will continue to fail. The failure of this batch will not cause all subsequent updates to fail. However, without resolving the trigger failure, other Issue updated may also fail and cause inconsistency between the Issue data in Jira and its representation in ZIssue in Salesforce.
Configuring Issue Update Notifications
To address these types of failures, zAgileConnect provides a number of configurable settings for regulating Issue Update Notifications to Salesforce, as shown below.
Interval between successive issue events sent to Salesforce – This setting controls how often Issue Update notifications should be sent to Salesforce. The default value is 10 seconds.
Delay interval between issue update event notification and Issue update in Salesforce – This setting controls the minimal wait time (pause) between Issue update events and the notification sent to Salesforce for these events. A value of 0 for this setting would indicate that Issue update events must be sent to Salesforce immediately. For Jira Data Center, due to the lag time typically associated with node synchronization, we recommend this value to be > 0s (default 5s). For more on this, please refer to Integrating Salesforce with Jira Data Center
Max number of issue events sent to Salesforce per request – This setting determines the size of the batch containing the list of Issues updated in Jira for which Salesforce is to be notified. Salesforce will request updated information for all Issues in this batch to apply to ZIssue. The default value is 75.
Configuring Email Notification Parameters
After a failed retry, failed Issue Update Notifications with more error details may be received via email, along with the list of Issue Keys. The following parameters are available for configuring the email address, the interval for receiving such notifications, as well as the format.
Send Notifications by Email to – The email address to which Issue Update Notification failures will be sent
Interval between Notifications by Email – The interval between such email notifications in hours. No notification will be sent for any error that occurs during this interval.
Default Notification email format – The default format for such email notifications (text or HTML)
Following are examples of such an email in text/HTML, showing the list of issues in a batch that failed in updating ZIssue in Salesforce:
