Full Sync runs every 12 hours and does the following:
- Downloads all issue changes for the certain period. How the period is calculated is explained further.
- Downloads JIRA configuration for all connections.
Quick sync runs every 2.5 minutes and does the following:
First JIRA Client checks if there were any changes since the last update. To do this, JIRA Client requests the last updated issue from JIRA and compares it to the issue that was downloaded last during the latest update. If the issues and their update times are the same, no further actions are taken. If the issues are different or the time doesn't match, the update procedure starts.
For the update JIRA Client downloads changes for a certain period. How the period is calculated is explained below.
Both for the full and quick sync the period for which changes are downloaded is the same and is calculated as follows:
JIRA Client takes the time of the last update and then subtracts the Stepback parameter (jira.reload.stepback for full sync and jira.reload.stepback.quick for quick sync). Then it calculates the difference between the resulting timestamp and the current timestamp and rounds up to days. Then JIRA Client adds one more day to the result. This is done to make sure no changes are missed because of the possible time zone differences on the server and the client.
This method is not perfect, but it makes sure there are no changes missed and JIRA Client is in perfect sync with JIRA. New more optimized synchronization mechanisms will be implemented once we switch to the new JIRA API.
There are several types of synchronization, which may happen in JIRA Client:
- Quick Synchronization. In this case JIRA Client in one request to the server downloads details for several issues selected based on some query. This download includes most of the fields, comments, work logs, links, lists of attachments.
- Detailed Synchronization. JIRA Client does several requests to the server for a single issue. It downloads remaining fields (voters, watchers), meta data about editing, applicable workflow actions.
- Small Attachments. JIRA Client downloads smaller attachment files - up to 100Kb by default. This size can be modified through auto.download.maxsize parameter in the settings.