Importer un message (Gestion des données)
Récapitulatif
Importe les modifications d'un fichier de deltas dans une géodatabase de réplica ou importe un message d'accusé de réception dans une géodatabase de réplica.
Utilisation
-
Cet outil est utilisé lors de la synchronisation du réplica hors connexion. Pour ce faire, on commence par exécuter l'outil Exporter le message de mouvement de données qui crée un fichier de deltas avec les changements à synchroniser. Le fichier de deltas est ensuite copié dans le réplica associé et importé à l'aide de l'outil Importer un message. Si un fichier de deltas se perd et que vous souhaitez le renvoyer, vous pouvez utiliser l'outil Réexporter les messages sans accusé de réception pour régénérer le fichier de deltas. Une fois les changements importés, le réplica associé peut exporter un fichier d'accusé de réception à l'aide de l'outil Exporter le message d'accusé de réception. Le fichier d'accusé de réception est copié dans le réplica et importé à l'aide de l'outil Importer un message. Si aucun accusé de réception n'est reçu, à l'envoie suivant des changements, ils comprendront les nouveaux changements ainsi que les changements envoyés précédemment.
-
La géodatabase peut être une géodatabase locale ou un service de géodonnées.
-
Accepte des messages d'accusé de réception ou des messages de mouvements de données. Les fichiers d'accusé de réception sont en XML (.xml). Les messages de mouvements de données peuvent être des fichiers d'une géodatabase de fichier de deltas (.gdb), des fichiers d'une géodatabase personnelle de deltas (.mdb) ou des fichiers XML de deltas (.xml).
-
Après avoir importé un message de mouvements de données, vous avez la possibilité d'exporter immédiatement un message d'accusé de réception. Le fichier d'accusé de réception en sortie doit être au format XML.
-
Pour synchroniser des réplica en mode connecté, voir l'outil Synchroniser les modifications.
Syntaxe
| Paramètre | Explication | Type de données |
in_geodatabase |
Spécifie la géodatabase de réplica qui doit recevoir le message importé. La géodatabase peut être locale ou distante. | Workspace ; GeoDataServer |
source_delta_file |
Spécifie le fichier à partir duquel sera importé le message. | Workspace ; File |
output_acknowledgement_file (Facultatif) |
Vous permet au besoin d'exporter un message pour confirmer l'importation d'un message de mouvement de données. Cette option n'est utilisable que pour un message de mouvement de données. | File |
conflict_policy (Facultatif) |
Spécifie le mode de résolution des conflits rencontrés lors de l'importation d'un message de mouvement de données.
| String |
conflict_definition (Facultatif) |
Vous permet d'indiquer comment vous voulez définir les conflits.
| String |
reconcile_with_parent_version (Facultatif) |
Indique si une réconciliation automatique doit être effectuée une fois les modifications de données envoyées au réplica parent en l'absence de conflits. Cette option n'est disponible que pour les réplicas d'extraction/d'insertion.
| Boolean |
Exemple de code
L'exemple suivant montre comment utiliser le fonction ImportMessage dans une fenêtre Python.
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")
Les éléments suivants montrent comment utiliser la fonction ImportMessage pour importer un fichier de changements de données dans un script Python autonome.
# 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)
Les éléments suivants montrent comment utiliser la fonction ImportMessage pour importer un fichier de changements de données dans un script Python autonome.
# 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)