RepositoryObjectVersion MergeVersion Method

Syntax

Call object.MergeVersion(otherVersion , flags)

The MergeVersion method syntax has the following parts.

Part	Description
object	An object expression that evaluates to a RepositoryObjectVersion object.
otherVersion	An object expression that evaluates to a RepositoryObjectVersion object; the object version whose value you want to merge into the current object version.
flags	A flag indicating which version (the current version or the other version) the Repository should use as the primary version of the merge operation.

Remarks

Relationships are inserted at the end of the sequenced collection.

The two object versions must be versions of the same object.

The current object version must be unfrozen. The other object version must be frozen.

MergeVersion compares the property values and collections of each object version to a third version, called the Basis Version.

The Repository considers one of the two to-be-merged object versions to be the primary version, and the other to be the secondary version, according to the value of flags you supply. During the merge, the Repository engine considers each property and origin collection type in turn. For each property, MergeVersion uses this rule:

If the primary version differs from the basis version, the Repository uses the property value from the primary version. If only the secondary version differs from the basis version, the Repository engine uses the property value from the secondary version. If neither version differs from the basis version, the Repository leaves the property value in the current version unchanged.

For each origin collection type whose COLLECTION_MERGEWHOLE flag is set, MergeVersion uses this rule:

If the primary version's collection differs from the basis version's collection, the Repository engine uses the collection from the primary version. If only the secondary version's collection differs from the basis version's, the Repository uses the collection from the secondary version. If neither version differs from the basis version, the Repository leaves the collection in the current version unchanged.

For each origin collection type whose COLLECTION_MERGEWHOLE flag is not set, MergeVersion combines the items in the two collections as follows:

MergeVersion includes in the resulting collection each item in the basis version not changed in or deleted from either the primary version or secondary version
MergeVersion includes in the resulting collection each item in the primary version's collection that differs from the basis version.
MergeVersion includes in the resulting collection each item in the secondary version's collection that differs from the basis version – provided that the corresponding items in the primary version and basis version do not differ from each other.

Note that the resulting collection can exclude some items found in the basis object version's collection. For example, if the primary version's collection excludes the item, the resulting collection will exclude the item. Similarly, if the primary version's collection includes an item that is identical to an item in the basis version's collection, but the secondary object version excludes the item, the resulting collection will exclude the item.