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(in_geodatabase, out_acknowledgement_file, in_replica)
Parameter | Explanation | Data 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
- Basic: No
- Standard: Yes
- Advanced: Yes