com.esri.arcgis.geodatabasedistributed
Interface ICheckInDataSynchronizer2

All Superinterfaces:

ICheckInDataSynchronizer, Serializable

All Known Implementing Classes:

CheckInDataSynchronizer

public interface ICheckInDataSynchronizer2
extends ICheckInDataSynchronizer, Serializable

Provides access to members that synchronize changes from a check-out geodatabase or delta database with the master geodatabase.

Remarks

This interface provides Synchronize2 a method to synchronize changes in a check-out. It provides the same functionality as the ICheckinDataSynchronizer::Synchronize method, and additionally allows for specification of how conflicts are defined, detected, and treated during synchronization.

The Synchronize method transfers the changes from a check-out geodatabase (either personal, file, or ArcSDE) or a delta file to the parent replica (previously referred to as the master geodatabase). It does not unregister the check-out.

NOTE: It is recommended that you use ICheckin2 interface to check in changes instead of this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

boolean

synchronize2(IDataChanges dataChanges, String editVersionName, IWorkspaceName parentWorkspace, boolean reconcileCheckout, int reconcilePolicy, boolean columnLevel, boolean createOIDMappingTable) Synchronizes the changes in the check-out geodatabase or delta database with the master geodatabase.

Methods inherited from interface com.esri.arcgis.geodatabasedistributed.ICheckInDataSynchronizer

synchronize

Method Detail

synchronize2

boolean synchronize2(IDataChanges dataChanges,
                     String editVersionName,
                     IWorkspaceName parentWorkspace,
                     boolean reconcileCheckout,
                     int reconcilePolicy,
                     boolean columnLevel,
                     boolean createOIDMappingTable)
                     throws IOException,
                            AutomationException

Synchronizes the changes in the check-out geodatabase or delta database with the master geodatabase.

Remarks

The Synchronize2 method transfers the changes from a check-out geodatabase (either personal, file, or ArcSDE) or a delta file to a parent replica (previously referred to as a master geodatabase). It does not unregister the check-out.

If reconcileCheckout is TRUE, the changes are applied to the check-out version and this version is reconciled with it’s parent version. If reconcileCheckout is FALSE, the changes are applied to the check-out version, but no reconcile is performed.

The editVersionName is the check-out version.

The childReconcilePolicy parameter takes an esriReplicaReconilePolicyType enumeration to determine how conflicts will be handled during reconcile. The following describes the meaning of each enumeration:

esriReplicaDetectConflicts -If conflicts occur, the reconcile process is aborted and you must reconcile and post manually after sycnhronization is completed.

esriReplicaResolveConflictsInFavorOfImportedChanges - The representation in the check-out geodatabase is automatically applied if conflicts arrise.

esriReplicaResolveConflictsInFavorOfDatabaseChanges - The representation from the parent replica importing is automatically applied if conflicts arrise.

esriReplicaResolveConflictsNone - It indicates that a reconcile and post should not be applied during synchronization.

If columnLevel is TRUE, conflicts are detected only when the same attribute is updated in both the check-out and the parent replica. For example, if the check-out has modified the parcel's owner attribute and the parent replica has modified the parcel's street address attribute the feature will not be in conflict. It is only when each version modifies the same attribute that the object will be in conflict.

The Synchronize2 method returns TRUE if conflicts were detected. It returns FALSE if no conflicts were detected.

NOTE: It is recommended that you use ICheckin interface to check in changes instead of this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

dataChanges - A reference to a com.esri.arcgis.geodatabasedistributed.IDataChanges (in)

editVersionName - The editVersionName (in)

parentWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspaceName (in)

reconcileCheckout - The reconcileCheckout (in)

reconcilePolicy - A com.esri.arcgis.geodatabase.esriReplicaReconcilePolicyType constant (in)

columnLevel - The columnLevel (in)

createOIDMappingTable - The createOIDMappingTable (in)

Returns:

The conflictsDetected

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.