com.esri.arcgis.geodatabasedistributed
Interface IExportDataChanges2

All Superinterfaces:
IExportDataChanges, Serializable
All Known Implementing Classes:
DataChangesExporter

public interface IExportDataChanges2
extends IExportDataChanges, Serializable

Provides access to members that export edits from a version or from a check-out, one way or two way replica to a data changes file.

Remarks

The IExportdataChanges2 interface provides methods to export edits in a two way or one way replica to a delta file.

See the DataChangesExporter coclass for more information on delta files.

Product Availability

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


Method Summary
 void exportDataChanges2(String exportFileName, int exportOption, IDataChanges dataChanges, boolean overwriteIfExists, boolean compressed, boolean binaryGeometry, boolean lastSend)
          Exports the edits to a delta file.
 void reExportDataChanges(String exportFileName, int exportOption, IReplica2 sourceReplica, int genOption, boolean overwriteIfExists, boolean compressed, boolean binaryGeometry)
          Exports the edits to a delta file.
 
Methods inherited from interface com.esri.arcgis.geodatabasedistributed.IExportDataChanges
exportDataChanges
 

Method Detail

exportDataChanges2

void exportDataChanges2(String exportFileName,
                        int exportOption,
                        IDataChanges dataChanges,
                        boolean overwriteIfExists,
                        boolean compressed,
                        boolean binaryGeometry,
                        boolean lastSend)
                        throws IOException,
                               AutomationException
Exports the edits to a delta file.

Remarks

The ExportDataChanges2 method exports data changes from a version or from a check-out, one way or two way replica to a data changes file.

The exportFileName parameter is the name of the file that will be generated. The exportoption parameter takes a member of the esridatachangesexportoption enumeration to determine whether the data changes file created will be XML, delta database, or a delta file geodatabase format.

The datachanges parameter must reference a ReplicaDataChanges object to export edits from a mult-generation replica. The overwriteexists parameter indicates if the target data changes file will be overwritten during the export. Setting this to TRUE will overwrite the data changes file if it already exists. If you set this to FALSE and the data changes file already exists, the file will not be overwritten, and the export will not succeed.

The Compressed parameter is TRUE the edits will be exported in compressed format.

The Binarygeometry parameter is used to specify binary or normalized geometry. If set to TRUE, binary format will be used.

The LastSend parameter indicates whether there will be a change in the directionality of the data change flow between the replica pair. The lastsend parameter should be set to TRUE if you no longer want to send data change messages to the relative, but instead want to receive edits from the relative. If the lastsend parameter is set to TRUE, the source replica will transition from a Sending Data state to a Receiving Data state upon export of the data change message. When the relative replica successfully imports this delta file, the relative replica will transition from a Receiving Data state to a Sending Data state.

The ExportDataChanges2 method only applies to replicas in the Sending Data state. The replica state can be determined by using the IReplica2::ReplicaState property.

Product Availability

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

Parameters:
exportFileName - The exportFileName (in)
exportOption - A com.esri.arcgis.geodatabasedistributed.esriExportDataChangesOption constant (in)
dataChanges - A reference to a com.esri.arcgis.geodatabasedistributed.IDataChanges (in)
overwriteIfExists - The overwriteIfExists (in)
compressed - The compressed (in)
binaryGeometry - The binaryGeometry (in)
lastSend - The lastSend (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

reExportDataChanges

void reExportDataChanges(String exportFileName,
                         int exportOption,
                         IReplica2 sourceReplica,
                         int genOption,
                         boolean overwriteIfExists,
                         boolean compressed,
                         boolean binaryGeometry)
                         throws IOException,
                                AutomationException
Exports the edits to a delta file.

Remarks

The ReExportDataChanges method exports previously sent edits (unacknowledged edits) from a two-way or one-way replica to a delta file (data change message). New edits performed since sending the most recent data change message will not be included. To export both unacknowledged and new data changes you must use the ExportDataChanges2 method. See the DataChangesExporter and the ReplicaDataChanges coclasses for more information.

The exportfilename parameter is the name of the data changes file to create. The exportoption parameter takes a member of the esridatachangesexportoption enumeration to determine whether the data changes file created will be XML, delta database, or a delta file geodatabase format. The sourcereplica parameter identifies the replica which is the source of the data changes.

The genoption parameter takes an esriReExportGenerationsOption to indicate what data changes will be reexported. If esriReExportGenerationsAllUnAcknowledged is specified, all unacknowledged edits from all previously sent data change messages will be reexported. If esriReExportGenerationsLastUnAcknowledged is specified, only those unacknowledged edits from the most recently exported data change message will be reexported. See the esriReExportGenerationsOption enumeration for more information.

The overwriteexists parameter indicates if the target delta file will be overwritten during the export.

The Compressed parameter is TRUE the edits will be exported in compressed format.

The Binarygeometry parameter is used to specify binary or normalized geometry. If set to TRUE, binary format will be used.

The ReExportDataChanges2 method only applies to replicas which have sent data change messages which have not been acknowledged. This can include replicas in the Sending Data state, which have previously sent a data change message, as well as replicas who have just transitioned into a Receiving Data state after exporting a data change switch message (lastsend parameter = TRUE). See the ExportDataChanges2 method for more information.

Product Availability

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

Parameters:
exportFileName - The exportFileName (in)
exportOption - A com.esri.arcgis.geodatabasedistributed.esriExportDataChangesOption constant (in)
sourceReplica - A reference to a com.esri.arcgis.geodatabase.IReplica2 (in)
genOption - A com.esri.arcgis.geodatabasedistributed.esriReExportGenerationsOption constant (in)
overwriteIfExists - The overwriteIfExists (in)
compressed - The compressed (in)
binaryGeometry - The binaryGeometry (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.