3. Working with AccuSync™ Configurations : Setting Watermarks

Setting Watermarks
A watermark is a value that identifies the most recent transaction in a system. In AccuRev, the watermark is represented by the transaction number in a depot. For example, a watermark of 10979 means that the last recorded transaction for a given depot was number 10979. In Rally and JIRA, the watermark is represented by the timestamp of the most recent transaction. For example, a watermark of 2012-03-29 12:45:33 means that the last transaction occurred at 12:45:33 on March 29.
The current watermark is displayed on the status page for the AccuSync Configuration for the currently selected system, as shown in the following illustration, which displays the watermark for AccuWork:
Generally speaking, you do not need to adjust the watermark, but there are occasions when you might want to. For example, you might want to adjust the watermark:
Prior to the initial synchronization. Imagine the current AccuWork transaction number is at 1000 when you install and configure AccuSync. If you want to synchronize with your ITS using an earlier watermark -- either based on transaction number or date -- you can do so. If you do not modify the watermark, AccuSync synchronizes all the issues in your systems, starting with the first transaction/earliest date, that match the mapping definitions you have defined for your synchronization patterns.
To synchronize a previously skipped issue. Imagine that you make a change to an issue that was skipped by the synchronization process -- perhaps a filter prevented the issue from being synchronized -- and you now want to synchronize the issue. You can redefine the filter to include this issue the next time you synchronize, but because the watermark is now greater than it was when you changed the filter, AccuSync will still not synchronize the issue. In this case, you can set the watermark to a value lower/earlier than the watermark recorded for that issue and then run synchronization again.
You adjust the watermark using the watermark tool.
The Watermark Tool
The AccuSync watermark tool displays the current watermark for the system you select, and optionally lets you change the watermark. There are separate tools for AccuWork and your ITS, as shown in the following table:
Adjusting the AccuWork Watermark
To adjust the AccuWork watermark:
1.
The status page for the AccuSync Configuration appears.
2.
Click the Change Watermark button.
The Change Watermark dialog box appears.
The value in the New watermark field reflects the most recent transaction in the depot synchronized by this AccuSync Configuration. The Available range slider indicates the range of transactions for the depot, from 1 to the current transaction level.
3.
Drag the Available range slider (the value in the New watermark field changes as you move the slider)
4.
The new watermark is set and will be used by AccuSync the next time you synchronize. After synchronization, the watermark is set to the current transaction number.
Adjusting the ITS Watermark
To adjust the watermark for your ITS:
1.
The status page for the AccuSync Configuration appears.
2.
3.
Click the Change Watermark button.
The Change Watermark dialog box appears.
The calendar and timestamp values reflect the time of the most recent transaction. The timestamp is based on a 24-hour clock (hh:mm:ss).
4.
Click Today to reset the watermark to the current date. The timestamp fields (hh:mm:ss) are set to 00:00:00.
5.
The new watermark is set and will be used by AccuSync the next time you synchronize. After synchronization, the watermark is set to the current timestamp.

Micro Focus