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

EtiquetaExplicaciónTipo 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 manualmenteLos conflictos se deben resolver manualmente en el entorno de conciliación de versiones.
  • A favor de la base de datosLos conflictos se resolverán automáticamente a favor de la base de datos que recibe los cambios.
  • A favor de los cambios importadosLos 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 objetoLos conflictos se detectarán por fila.
  • Por atributoLos 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

EtiquetaExplicaciónTipo de datos
Geodatabase de réplica de salida

La geodatabase de réplica actualizada.

Workspace; GeoDataServer

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})
NombreExplicaciónTipo 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.

  • MANUALLos conflictos se deben resolver manualmente en el entorno de conciliación de versiones.
  • IN_FAVOR_OF_DATABASELos conflictos se resolverán automáticamente a favor de la base de datos que recibe los cambios.
  • IN_FAVOR_OF_IMPORTED_CHANGESLos 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_OBJECTLos conflictos se detectarán por fila.
  • BY_ATTRIBUTELos 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_RECONCILELos cambios no se conciliarán con la versión principal. Esta es la opción predeterminada.
  • RECONCILELos cambios se conciliarán con la versión principal.
Boolean

Salida derivada

NombreExplicaciónTipo 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)

Temas relacionados