Importar mensaje

Resumen

Importa cambios desde un archivo delta a una geodatabase de réplica, o importa un mensaje de reconocimiento a una geodatabase de réplica.

Uso

• Esta herramienta se utiliza cuando se sincroniza la réplica sin conexión. El procedimiento se realiza ejecutando en primer lugar la herramienta Exportar mensaje de cambio de datos que crea un archivo delta con cambios para sincronizar. A continuación, el archivo delta se copia a la réplica relativa y se importa utilizando la herramienta Importar mensaje. Si un archivo delta se pierde y quiere volver a enviarlo, puede utilizar la herramienta Volver a exportar mensajes no reconocidos para volver a generar el archivo delta. Una vez importados los cambios, la réplica relativa puede exportar un archivo de reconocimiento utilizando la herramienta Exportar mensaje de reconocimiento. El archivo de reconocimiento se copia a la réplica relativa y se importa utilizando la herramienta Importar mensaje. Si no se recibe un reconocimiento, la próxima vez que se envíen cambios, se incluirán los cambios nuevos más los cambios enviados anteriormente.

• La geodatabase puede ser una geodatabase local o un servicio de geodatos.

• Acepta los mensajes de reconocimiento o los mensajes de cambio de datos. Los archivos de reconocimiento son XML (.xml). Los mensajes de cambio de datos pueden ser geodatabases de archivos delta (.gdb), geodatabases personales delta (.mdb) o archivos XML delta (.xml).

• Después de haber importado un mensaje de cambio de datos, tiene la opción de exportar inmediatamente un mensaje de reconocimiento. El archivo de reconocimiento de salida debe ser XML.

• Para sincronizar las réplicas en un modo con conexión, consulte la herramienta Sincronizar cambios.

Sintaxis

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})

Parámetro	Explicación	Tipo de datos
in_geodatabase	Especifica la geodatabase de réplica que recibirá el mensaje importado. La geodatabase puede ser local o remota.	Workspace ; GeoDataServer
source_delta_file	Especifica el archivo desde el cual se importará el mensaje.	Workspace ; File
output_acknowledgement_file (Opcional)	Cuando importe cambios de datos, también tendrá la opción de exportar un mensaje para reconocer la importación de un mensaje de cambio de datos. Esta opción se ignora para cualquier otra cosa que no sea un mensaje de cambio de datos.	File
conflict_policy (Opcional)	Especifica cómo se resuelven los conflictos que se encuentran al importar un mensaje de cambio de datos. MANUAL —Resolver manualmente los conflictos en el entorno de conciliación versionado. IN_FAVOR_OF_DATABASE —Los conflictos se resuelven automáticamente a favor de la base de datos que recibirá los cambios. IN_FAVOR_OF_IMPORTED_CHANGES —Los conflictos se resuelven automáticamente a favor de los cambios importados.	String
conflict_definition (Opcional)	Especifica la manera en que usted desea definir los conflictos: BY_OBJECT —Detecta los conflictos por fila. BY_ATTRIBUTE —Detecta los conflictos por columna.	String
reconcile_with_parent_version (Opcional)	Indica si se realizará una conciliación automática una vez que los cambios de datos se envíen a la réplica principal si no hay conflictos presentes. Esta opción solo está disponible para las réplicas de check-out/check-in. DO_NOT_RECONCILE —No conciliar. Esta es la opción predeterminada. RECONCILE —Conciliar.	Boolean

Muestra de código

Ejemplo de ImportMesage (ventana de Python)

El siguiente ejemplo demuestra cómo utilizar la función ImportMesage en una ventana de 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")

Ejemplo 2 de ImportMesage (secuencia de comandos de Python independiente)

A continuación se demuestra cómo utilizar la función ImportMessage para importar un archivo de cambios de datos en una secuencia de comandos de Python independiente.

# 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)

Ejemplo 3 de ImportMesage (secuencia de comandos de Python independiente)

A continuación se demuestra cómo utilizar la función ImportMessage para importar un archivo de cambios de datos en una secuencia de comandos de Python independiente.

# 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)

Entornos

• Espacio de trabajo actual
• Espacio de trabajo temporal

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí