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
ImportMessage_management (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.
| String |
conflict_definition (Opcional) | Especifica la manera en que usted desea definir los conflictos:
| 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.
| Boolean |
Ejemplo 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
Información sobre licencias
- ArcGIS for Desktop Basic: No
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí