ArcMap

Meldungen importieren

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 Geodatenservice 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

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})
ParameterErklärungDatentyp
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.

  • MANUAL —Manuelle Beseitigung von Konflikten in der Umgebung zum Abgleich der Versionierung.
  • IN_FAVOR_OF_DATABASE —Konflikte werden automatisch zugunsten der Datenbank gelöst, die die Änderungen empfängt.
  • IN_FAVOR_OF_IMPORTED_CHANGES —Konflikte werden automatisch zugunsten der importierten Änderungen gelöst.
String
conflict_definition
(optional)

Legt fest, wie Konflikte definiert werden sollen:

  • BY_OBJECT —Erkennt Konflikte zeilenweise.
  • BY_ATTRIBUTE —Erkennt Konflikte spaltenweise.
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.

  • DO_NOT_RECONCILE —Es wird kein Abgleich durchgeführt. Dies ist die Standardeinstellung.
  • RECONCILE —Abgleichen.
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)

Umgebungen

Lizenzinformationen

  • Basic: Nein
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen