Importer un message (Gestion des données)
Récapitulatif
Importe les modifications d'un fichier de deltas vers une géodatabase de réplica ou importe un message d'accusé de réception vers 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 les messages d'accusé de réception ou les messages de mouvements de données. Les fichiers d'accusés de réception sont au format XML (.xml). Les messages de mouvements de données peuvent être une géodatabase fichier de deltas (.gdb), une géodatabase personnelle de deltas (.mdb) ou des fichiers XML de deltas (.xml).
-
Après l'importation d'un message de mouvement de données, vous pouvez immédiatement exporter 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 le message sera importé. | 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éconciliaton 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 la fonction Importer un message 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")
Vous trouverez ci-dessous une illustration de l'utilisation de la fonction Importer un message pour importer un fichier des mouvements 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)
Vous trouverez ci-dessous une illustration de l'utilisation de la fonction Importer un message pour importer un fichier des mouvements 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)