Change Detection

Introduction

Once you've configured your Conflict Resolution Strategy, your next step will be to configure your Change Detection settings. 

Tasktop's default global change detection settings can be found on the Settings screen.  However, if you'd like to override the global defaults, you can configure integration-specific change detection and full scan intervals on this screen.

The Change Detection Interval is the time between polling requests to detect only changed artifacts. This defaults to 1 minute on the Settings screen, but can be customized as desired.

The Full Scan Interval is the time between polling requests to detect changed artifacts, in which all artifacts of a collection are scanned. Not all changes to an artifact will register as a change. Some repositories do not mark items as changed when (for example) a relationship is added or an attachment has changed. These may not be picked up by regular Change Detection, but will be picked up by a Full Scan. The Full Scan Interval defaults to 24 hours on the Settings screen, but can be customized as desired.

Instructions

To configure integration-specific change detection, click the 'Change Detection' link on the Integration Configuration screen.

Click 'Change Detection'

This will bring you to the Change Detection screen, where you can view the current change detection and full scan intervals configured for each collection in this integration.  These will default to the global intervals configured on the Settings screen.

Change Detection Screen

To override the current settings, click the 'Override' button on your desired collection.  This will allow you to set a custom change detection and/or full scan interval for each collection within the context of this integration.  Note that these custom settings will only impact this integration; they will not impact other integrations that make use of the same collections.

Click 'Override'

Once you click 'Override,'  you will be able to configure custom change detection and full scan intervals for that collection within the context of this integration:

Configure Custom Change Detection

Full Scan Style and Interval

In addition to customizing the full scan interval, you can also select your desired full scan style in order to best meet your specific performance and server load needs.

The following full scan styles are available:

  • Tasktop-Optimized (Recommended): This is the default selection.  It optimizes your full scan style in real-time based on your integration configuration.
  • High Performance: This full scan style reduces server load, but certain artifact changes may be missed.
  • High Fidelity: This full scan style ensures no artifact changes are missed, but may cause significant server load.

If High Performance style is selected, Tasktop will provide a warning identifying any specific artifact changes which may be missed:

High Performance Warning

Once you have configured your change detection and full scan intervals for your first collection, you can update the settings for the remaining collection, if desired.

Update Change Detection for Remaining Collection

If you'd like to restore the global change detection settings, simply click the 'Revert' button to remove the custom settings:

Revert to Global Settings

Once you've updated the change detection settings as desired, click 'Save' and 'Done' to save your changes.

Click 'Save' and 'Done'

Next Steps

Congratulations!  Configuring Change Detection is the final step in configuring your Work Item Synchronization!  You are now ready to run your integration.