Help

Export Acknowledgement Message

Summary

Creates an output acknowledgement file to acknowledge the reception of previously received data change messages.

Usage

  • This tool is used when synchronizing replica while disconnected. This is done by first running the Export Data Change Message tool which creates a delta file with changes to synchronize. The delta file is then copied to the relative replica and imported using the Import Message tool. If a delta file gets lost and you want to resend, you can use the Re-Export Unacknowledged Messages tool to regenerate the delta file. After the changes are imported, the relative replica can export an acknowledgment file using the Export Acknowledgement Message tool. The acknowledgment file is copied to the replica and imported using the Import Message tool. If an acknowledgment is not received, the next time changes are sent they will include the new changes plus the previously sent changes.

  • The geodatabase may be a local geodatabase or a geodata service.

  • The output acknowledgement file must be XML.

  • This tool is not applicable for check-out replicas.

  • To synchronize replicas in a connected mode see the Synchronize Changes tool.

Syntax

ExportAcknowledgementMessage_management (in_geodatabase, out_acknowledgement_file, in_replica)
ParameterExplanationData Type
in_geodatabase

Specifies the replica geodatabase from which to export the acknowledgement message. The geodatabase may be local or remote.

Workspace ; GeoDataServer
out_acknowledgement_file

Specifies the delta file to export to.

File
in_replica

The replica from which the acknowledgement message will be exported.

String

Code sample

ExportAcknowledgement Example (Python Window)
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.ExportAcknowledgementMessage_management("MySDEdata.sde", "AcknowledgementMessage.xml" , "MyReplica1")
ExportAcknowledgement Example 2 (stand-alone Python script)
# Name: ExportAcknowledgement_Example2.py
# Description: Exports an acknowledgement message from a replica geodatabase (SDE).
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
env.workspace = "C:/Data"

# Set local variables
in_geodatabase = "MySDEdata.sde"
output_file = "AcknowledgementMessage.xml"
replica_name = "MyReplica1"
arcpy.ExportAcknowledgementMessage_management(in_geodatabase, output_file , replica_name)

Environments

Licensing information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics