Zusammenfassung
Importiert Änderungen aus einer Delta-Datei in eine Replikat-Geodatabase oder importiert eine Bestätigungsmeldung in eine Replikat-Geodatabase.
Verwendung
Dieses Werkzeug wird zum Synchronisieren von Replikaten im entkoppelten Modus verwendet. Dazu wird zunächst das Werkzeug Meldungen zu Datenänderungen exportieren ausgeführt, das eine Delta-Datei mit zu synchronisierenden Änderungen erstellt. Anschließend wird die Delta-Datei in das relative Replikat kopiert und mit dem Werkzeug Meldungen importieren importiert. Wenn eine Delta-Datei verloren geht und Sie sie erneut senden möchten, können Sie die Delta-Datei mit dem Werkzeug Unbestätigte Meldungen erneut exportieren neu generieren. Nach dem Importieren der Änderungen kann durch das relative Replikat mit dem Werkzeug Bestätigungsmeldungen exportieren eine Bestätigungsdatei exportiert werden. Die Bestätigungsdatei wird in das Replikat kopiert und mit dem Werkzeug Meldungen importieren importiert. Wenn keine Bestätigung empfangen wird, werden beim nächsten Senden von Änderungen sowohl die neuen als auch die zuvor gesendeten Änderungen einbezogen.
Die Geodatabase kann eine lokale Geodatabase oder ein Geodaten-Service sein.
Als Eingabe sind Bestätigungs- und Datenänderungsmeldungen möglich. Bestätigungsdateien sind XML-Dateien (.xml). Datenänderungsmeldungen können Delta-File-Geodatabase- (.gdb), Delta-Personal-Geodatabase- (.mdb) oder Delta-XML-Dateien (.xml) sein.
Nach dem Import einer Datenänderungsmeldung können Sie sofort eine Bestätigungsmeldung exportieren. Die Ausgabe-Bestätigungsdatei muss eine XML-Datei sein.
Informationen zum Synchronisieren von Replikaten im verbundenen Modus finden Sie im Abschnitt zum Werkzeug Änderungen synchronisieren.
Syntax
ImportMessage_management (in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})| Parameter | Erläuterung | Datentyp |
in_geodatabase | Gibt die Replikat-Geodatabase an, die die importierte Meldung empfangen soll. Die Geodatabase kann lokal oder remote sein. | Workspace ; GeoDataServer |
source_delta_file | Gibt die Datei an, aus der die Meldung importiert wird. | Workspace ; File |
output_acknowledgement_file (optional) | Hiermit können Sie beim Importieren von Datenänderungen optional eine Meldung exportieren, mit der der Import der Datenänderungsmeldung bestätigt wird. Diese Option wird für alle Meldungen außer Datenänderungsmeldungen ignoriert. | File |
conflict_policy (optional) | Gibt an, wie ermittelte Konflikte beim Importieren einer Datenänderungsmeldung gelöst werden.
| String |
conflict_definition (optional) | Legt fest, wie Konflikte definiert werden sollen:
| String |
reconcile_with_parent_version (optional) | Gibt an, ob ein automatischer Abgleich durchgeführt werden soll, sobald die Datenänderungen an das Parent-Replikat gesendet werden und sofern keine Konflikte bestehen. Diese Option ist nur für Check-Out-/Check-In-Replikate verfügbar.
| Boolean |
Codebeispiel
ImportMessage – Beispiel (Python-Fenster)
Im folgenden Beispiel wird veranschaulicht, wie die Funktion "ImportMessage" in einem Python-Fenster verwendet wird.
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", "acknowledgement.xml", "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")
ImportMessage - Beispiel 2 (eigenständiges Python-Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion "ImportMessage" zum Importieren einer Datenänderungsdatei in ein eigenständiges Python-Skript verwendet wird:
# Name: ImportMessage_Example2.py
# Description: Imports a data change message (from a delta gdb) into a replica workspace.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "DataChanges.gdb" # data changes file (delta gdb)
output_acknowledgement = "acknowledgement.xml" # optional
conflict_policy = "IN_FAVOR_OF_IMPORTED_CHANGES"
conflict_detection = "BY_OBJECT"
reconcile = "" # Only applicable for checkout replicas
# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, in_message, output_acknowledgement, conflict_policy, conflict_detection, reconcile)
ImportMessage - Beispiel 3 (eigenständiges Python-Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion "ImportMessage" zum Importieren einer Datenänderungsdatei in ein eigenständiges Python-Skript verwendet wird:
# Name: ImportMessage_Example3.py
# Description: Imports an acknowledgement message into a replica workspace.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "acknowledgement.xml" # Acknowledgement file
output_acknowledgement = "" # not applicable when importing an acknowledgement file
conflict_policy = "" # not applicable when importing an acknowledgement file
conflict_detection = "" # not applicable when importing an acknowledgement file
reconcile = "" # not applicable when importing an acknowledgement file
# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, dc_Message, output_acknowledgement, conflict_policy, conflict_detection, reconcile)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Nein
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja