Importar mensaje (Administración de datos)

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

• Utilice esta herramienta al sincronizar una réplica mientras está desconectada. Primero ejecute la herramienta Exportar mensaje de cambio de datos, que crea un archivo delta con cambios para sincronizar. A continuación, copie e importe el archivo delta en la réplica relativa utilizando la herramienta Importar mensaje. Si el archivo delta se pierde y desea volver a enviarlo, utilice la herramienta Volver a exportar mensajes no reconocidos para volver a generar el archivo delta. Una vez importados los cambios, puede exportar un archivo de reconocimiento desde la réplica relativa utilizando la herramienta Exportar mensaje de reconocimiento. Copie e importe el archivo de reconocimiento utilizando la herramienta Importar mensaje. Si no se recibe el reconocimiento, la próxima vez que se envíen cambios, incluirán los nuevos cambios y los cambios enviados anteriormente.

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

• La herramienta acepta mensajes de reconocimiento o mensajes de cambio de datos. Los archivos de reconocimiento son archivos .xml. Los mensajes de cambio de datos pueden ser archivos de geodatabase de archivos delta (.gdb) o archivos .xml delta.

• Después de importar un mensaje de cambio de datos, puede exportar inmediatamente un mensaje de reconocimiento. El archivo de reconocimiento de salida debe ser un archivo .xml.

• Para sincronizar réplicas en un modo conectado, consulte la herramienta Sincronizar cambios.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Importar a geodatabase de réplica	La geodatabase de réplica que recibirá el mensaje importado. La geodatabase puede ser local o remota.	Workspace; GeoDataServer
Importar desde archivo delta	El archivo desde el que se importará el mensaje.	Workspace ; File
Archivo de reconocimiento de salida (Opcional)	El archivo que contendrá el mensaje de reconocimiento. Al importar cambios de datos, también puede exportar un mensaje para confirmar la importación de un mensaje de cambio de datos. Este parámetro solo es compatible con un mensaje de cambio de datos.	File
Política de resolución de conflictos (Opcional)	Especifica cómo se resolverán los conflictos cuando se encuentren al importar un mensaje de cambio de datos. Resolver conflictos manualmente—Los conflictos se deben resolver manualmente en el entorno de conciliación de versiones. A favor de la base de datos—Los conflictos se resolverán automáticamente a favor de la base de datos que recibe los cambios. A favor de los cambios importados—Los conflictos se resolverán automáticamente a favor de los cambios importados.	String
Definición de conflicto (Opcional)	Especifica si las condiciones requeridas para que se genere un conflicto se detectarán por objeto (fila) o por atributo (columna). Por objeto—Los conflictos se detectarán por fila. Por atributo—Los conflictos se detectarán por columna.	String
Conciliar con la versión principal (réplicas de check-out) (Opcional)	Especifica si los cambios de los datos se conciliarán automáticamente una vez que se envíen a la réplica principal si no hay conflictos. Este parámetro solo está activo para réplicas de check-out/check-in. Desactivado: los cambios no se conciliarán con la versión principal. Esta es la opción predeterminada. Activado: los cambios se conciliarán con la versión principal.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Geodatabase de réplica de salida	La geodatabase de réplica actualizada.	Workspace; GeoDataServer

Python

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

Nombre	Explicación	Tipo de datos
in_geodatabase	La geodatabase de réplica que recibirá el mensaje importado. La geodatabase puede ser local o remota.	Workspace; GeoDataServer
source_delta_file	El archivo desde el que se importará el mensaje.	Workspace ; File
output_acknowledgement_file (Opcional)	El archivo que contendrá el mensaje de reconocimiento. Al importar cambios de datos, también puede exportar un mensaje para confirmar la importación de un mensaje de cambio de datos. Este parámetro solo es compatible con un mensaje de cambio de datos.	File
conflict_policy (Opcional)	Especifica cómo se resolverán los conflictos cuando se encuentren al importar un mensaje de cambio de datos. MANUAL—Los conflictos se deben resolver manualmente en el entorno de conciliación de versiones. IN_FAVOR_OF_DATABASE—Los conflictos se resolverán automáticamente a favor de la base de datos que recibe los cambios. IN_FAVOR_OF_IMPORTED_CHANGES—Los conflictos se resolverán automáticamente a favor de los cambios importados.	String
conflict_definition (Opcional)	Especifica si las condiciones requeridas para que se genere un conflicto se detectarán por objeto (fila) o por atributo (columna). BY_OBJECT—Los conflictos se detectarán por fila. BY_ATTRIBUTE—Los conflictos se detectarán por columna.	String
reconcile_with_parent_version (Opcional)	Especifica si los cambios de los datos se conciliarán automáticamente una vez que se envíen a la réplica principal si no hay conflictos. Este parámetro solo está habilitado para réplicas de check-out/check-in. DO_NOT_RECONCILE—Los cambios no se conciliarán con la versión principal. Esta es la opción predeterminada. RECONCILE—Los cambios se conciliarán con la versión principal.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_geodatabase	La geodatabase de réplica actualizada.	Workspace; GeoDataServer

Muestra de código

Ejemplo de ImportMessage (ventana de Python)

El siguiente ejemplo muestra cómo utilizar la función ImportMessage en una ventana de Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", 
                               "acknowledgement.xml", 
                               "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")

Ejemplo 2 de ImportMessage (script independiente)

A continuación, se muestra cómo utilizar la función ImportMessage para importa un archivo de cambo de datos en un script independiente de Python.

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

Ejemplo 3 de ImportMessage (script independiente)

A continuación, se muestra cómo utilizar la función ImportMessage para importa un archivo de cambo de datos en un script independiente de Python.

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

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal