Importer un message (Gestion des données)

Synthèse

Importe les modifications depuis 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

  • Utilisez cet outil lorsque vous synchronisez un réplica en mode déconnecté. Exécutez d’abord l’outil Exporter le message de changement de données qui crée un fichier de deltas contenant les modifications à synchroniser. Puis, copiez et importez le fichier de deltas dans le réplica associé à l’aide de l’outil Importer un message. Si le fichier de deltas est perdu et que vous souhaitez le renvoyer, utilisez l’outil Réexporter les messages sans accusé de réception pour générer à nouveau le fichier de deltas. Une fois les modifications importées, vous pouvez exporter un fichier d’accusé de réception à partir du réplica associé à l’aide de l’outil Exporter le message d’accusé de réception. Copiez et importez le fichier d’accusé de réception à l’aide de l’outil Importer un message. Si l’accusé de réception n’est pas reçu, lors de l’envoi suivant, les modifications incluent les nouvelles modifications ainsi que les modifications envoyées précédemment.

  • La géodatabase peut être une géodatabase locale ou un service de géodonnées.

  • L’outil accepte les messages d’accusé de réception ou les messages de changement de données. Les fichiers d’accusé de réception sont des fichiers .xml. Les messages de changement des données peuvent être une géodatabase de fichiers de deltas (.gdb) ou des fichiers .xml de deltas.

  • Après avoir importé un message de changement 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 un fichier .xml.

  • Pour synchroniser les réplicas en mode connecté, reportez-vous à l’outil Synchroniser les modifications.

Paramètres

ÉtiquetteExplicationType de données
Importer dans une géodatabase de réplica

Géodatabase de réplica qui reçoit le message importé. La géodatabase peut être locale ou distante.

Workspace; GeoDataServer
Importer à partir du fichier de deltas

Fichier à partir duquel le message est importé.

Workspace ; File
Fichier d’accusé de réception en sortie
(Facultatif)

Fichier contenant le message d’accusé de réception. Lorsque vous importez des changements de données, vous pouvez également exporter un message pour accuser réception de l’importation d’un message de changement de données. Ce paramètre est uniquement pris en charge pour un message de changement de données.

File
Règle de résolution des conflits
(Facultatif)

Spécifie le mode de résolution des conflits détectés lors de l’importation d’un message de changement de données.

  • Résoudre manuellement les conflitsLes conflits doivent être résolus manuellement dans l’environnement de réconciliation de versionnement.
  • En faveur de la base de donnéesLes conflits sont automatiquement résolus en faveur de la base de données recevant les changements.
  • En faveur des changements importésLes conflits sont automatiquement résolus en faveur des changements importés.
String
Définition des conflits
(Facultatif)

Indique si les conditions requises pour la survenance d’un conflit sont détectées par objet (ligne) ou par attribut (colonne).

  • Par objetLes conflits sont détectés par ligne.
  • Par attributLes conflits sont détectés par colonne.
String
Réconcilier avec la version parent (réplicas d’extraction)
(Facultatif)

Indique si une réconciliation automatique des changements de données doit être effectuée une fois qu’ils sont envoyés au réplica parent en l’absence de conflits. Ce paramètre est actif uniquement pour les réplicas d’extraction/d’insertion.

  • Désactivé : les changements ne sont pas réconciliés avec la version parent. Il s’agit de l’option par défaut.
  • Activé : les changements sont réconciliés avec la version parent.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Géodatabase de réplica en sortie

Géodatabase de réplica mise à jour.

Workspace; GeoDataServer

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})
NomExplicationType de données
in_geodatabase

Géodatabase de réplica qui reçoit le message importé. La géodatabase peut être locale ou distante.

Workspace; GeoDataServer
source_delta_file

Fichier à partir duquel le message est importé.

Workspace ; File
output_acknowledgement_file
(Facultatif)

Fichier contenant le message d’accusé de réception. Lorsque vous importez des changements de données, vous pouvez également exporter un message pour accuser réception de l’importation d’un message de changement de données. Ce paramètre est uniquement pris en charge pour un message de changement de données.

File
conflict_policy
(Facultatif)

Spécifie le mode de résolution des conflits détectés lors de l’importation d’un message de changement de données.

  • MANUALLes conflits doivent être résolus manuellement dans l’environnement de réconciliation de versionnement.
  • IN_FAVOR_OF_DATABASELes conflits sont automatiquement résolus en faveur de la base de données recevant les changements.
  • IN_FAVOR_OF_IMPORTED_CHANGESLes conflits sont automatiquement résolus en faveur des changements importés.
String
conflict_definition
(Facultatif)

Indique si les conditions requises pour la survenance d’un conflit sont détectées par objet (ligne) ou par attribut (colonne).

  • BY_OBJECTLes conflits sont détectés par ligne.
  • BY_ATTRIBUTELes conflits sont détectés par colonne.
String
reconcile_with_parent_version
(Facultatif)

Indique si une réconciliation automatique des changements de données doit être effectuée une fois qu’ils sont envoyés au réplica parent en l’absence de conflits. Ce paramètre est activé uniquement pour les réplicas d’extraction/d’insertion.

  • DO_NOT_RECONCILELes changements ne sont pas réconciliés avec la version parent. Il s’agit de l’option par défaut.
  • RECONCILELes changements sont réconciliés avec la version parent.
Boolean

Sortie obtenue

NomExplicationType de données
out_geodatabase

Géodatabase de réplica mise à jour.

Workspace; GeoDataServer

Exemple de code

Exemple d’utilisation de l’outil ImportMessage (fenêtre Python)

L’exemple Python suivant illustre l’utilisation de la fonction ImportMessage dans la fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", 
                               "acknowledgement.xml", 
                               "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")
Exemple 2 d’utilisation de l’outil ImportMessage (script autonome)

L’exemple suivant illustre l’utilisation de la fonction ImportMessage pour importer un fichier de changement des données dans un script Python autonome.

# Name: ImportMessage_Example2.py
# Description: Import a data change message (from a delta gdb) into a replica workspace.   

# Import system modules
import arcpy

# Set workspace
arcpy.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)
Exemple 3 d’utilisation de l’outil ImportMessage (script autonome)

L’exemple suivant illustre l’utilisation de la fonction ImportMessage pour importer un fichier de changement des données dans un script Python autonome.

# Name: ImportMessage_Example3.py
# Description: Import an acknowledgement message into a replica workspace.  

# Import system modules
import arcpy

# Set workspace
arcpy.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)

Rubriques connexes