How View Compare/Merge Handles Target Folders with Floating Shares

View Compare/Merge, by its very nature, tends to perform many move, share, and reverse-share operations. If one or more of the target folders has floating child shares elsewhere in the repository, and if View Compare/Merge performs a share, reverse-share, or move operation, View Compare/Merge could appear to be creating extra copies of items during the commit. Items could be automatically propagated to other locations throughout the repository, often creating floating child shares unintentionally. In such cases, subsequent operations that trigger automatic propagation can cause unexpected results.

To prevent this from happening, View Compare/Merge is defensive in the presence of folders that have floating child shares. It recognizes situations where an item is being shared, reverse-shared, or moved into a target folder that has active floating child shares, and disallows the operation reporting a Fail. To resolve the situation, you can review each failed difference and change the action (for example, to Ignore) before committing the session, or correct the floating share problem and redo the session.

In this topic:

Example Move Operation in View Compare/Merge

Move operations present an interesting problem for View Compare/Merge. Consider the example below.

In this example, an item has been moved and modified in a child view. View Compare/Merge is then used to promote the changes to the parent view.

Suppose the user were to select Move and Merge as the current action for File.doc. In this case, the selected action would move the item into Folder B, which has floating child shares elsewhere in the repository. View Compare/Merge must therefore prevent the move operation from occurring.

On the other hand, if the user were to set the action to Merge, then the item would remain in its existing folder, and the operation would be permitted. Thus, View Compare/Merge must recognize the possibility that certain operations may change the target folder, and enable and disable actions appropriately as the target folder changes.

Back to top

Target Folder Has Floating Shares

The View Compare/Merge engine has a difference type called “Target folder has floating shares” which is unlike the other difference types in that it is never selected from the View Compare/Merge Action Decision Table based on the MatchState that describes the relationship between a source item and target item. Instead, it is overlaid on top of an existing DifferenceType in the context of a given DifferenceType, based on an analysis of the target folder that would result from the currently selected action.

Consider again the example above. Use the View Compare/Merge Action Decision Table rows as the reference, where row [2] is “Target folder has floating shares”, and row [30] is “Moved and modified in source, target on different branch”. In this case, the difference type selected from the decision table for File.doc is:

Row [30]: Moved and modified in source, target on different branch
    Action: Merge
    Legal Actions: Merge; Ignore; Move; Mark Resolved; Move and Merge; Overwrite

When a client application requests the difference type for this ItemDifference, the View Compare/Merge engine looks at the currently selected action, and determines whether or not a move, share or reverse share will be performed. At this point, the current action is Merge, and therefore nothing special happens.

Now, suppose the user sets the action to Move and Merge. In this case, when the client application requests the difference type for this ItemDifference, the View Compare/Merge engine notes the move operation and determines whether or not the new target folder has any floating child shares. If it does, then the engine does not return the actual difference type, but instead returns “Target folder has floating shares”.

Furthermore, the View Compare/Merge engine presents a different current action, and a different set of legal actions. These are determined dynamically, by removing all of the problematic actions and replacing them with Fail. Thus, by overlaying row [2] over row [30], the engine exposes the difference type to client applications as if it were the following:

Row [2]: Target folder has floating child shares

    Action: Fail
    Legal Actions: Fail; Merge; Ignore; Mark Resolved; Overwrite

Suppose now that the user changes the current action back to Merge. At this point, the engine no longer needs to overlay row [2] over row [30]; it exposes the difference type, current action and set of legal actions in their original, unaltered forms.

Back to top

Frequency of Checking for Floating Shares

You should note that there is no way to prevent you from adding new floating shares. Thus, no matter when View Compare/Merge checks, it is always possible that a new floating share is added immediately afterwards, and is missed.

Checking often for a floating child share would decrease the likelihood that we would miss one. However, since this test is lengthy and resource intensive, this would result in unacceptable performance.

Currently, View Compare/Merge only checks for floating child shares in the source view since the source view is already open, and since checking the source view can be done rather easily and quickly.

To improve performance, View Compare/Merge checks each target folder at most once per session. However, for sessions that are saved and then later restored, View Compare/Merge checks again when the session is restored.

Back to top