Краткая информация
Импортирует изменения из дельта-файла в базу геоданных реплики, или импортирует подтверждающее сообщение в базу геоданных реплики.
Использование
Этот инструмент используется для синхронизации при подключении. Это делается путем первого запуска инструмента Экспорт сообщения об изменении данных (Export Data Change Message), который создает дельта-файл с изменениями для синхронизации. Дельта-файл затем копируется в связанную реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если дельта-файл теряется и вы хотите повторно отправить, вы можете использовать инструмент Ре-экспорт неподтвержденного сообщения (Re-Export Unacknowledged Messages), чтобы заново создать дельта-файл. После импортирования изменений относительная реплика может экспортировать файл подтверждения при помощи инструмента Экспорт подтвержденного сообщения (Export Acknowledgement Message). Файл подтверждения копируется в реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если подтверждение не получено, в следующий раз, когда отправляются изменения, они включают новые, а также ранее отправленные изменения.
База геоданных может быть локальной базой геоданных или сервисом геоданных.
Принимает либо сообщения подтверждения, либо сообщения об изменении данных. Файлы подтверждения – это XML-файлы (.xml). Сообщениями об изменении данных могут быть файловая дельта-база геоданных (.gdb), персональная дельта-база геоданных (.mdb) или дельта-файлы XML (.xml).
После импорта сообщения об изменении данных, у вас есть опция для непосредственного экспорта подтвержденного сообщения. Выходной файл подтверждения должен быть формата XML.
Чтобы синхронизировать реплики в режиме подключения, см. инструмент Синхронизировать изменения (Synchronize Changes).
Синтаксис
ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})
Параметр | Объяснение | Тип данных |
in_geodatabase | Указывает реплику базы геоданных для получения импортированного сообщения. Базы геоданных могут быть локальными или удаленными. | Workspace ; GeoDataServer |
source_delta_file | Указывает файл, из которого будет импортировано сообщение. | Workspace ; File |
output_acknowledgement_file (Дополнительный) | При импорте изменений данных это позволяет вам дополнительно экспортировать сообщение в предупреждение об импорте изменений данных. Эта опция игнорируется везде, кроме сообщений об изменении данных. | File |
conflict_policy (Дополнительный) | Указывает, как разрешаются конфликты, если они встречаются, в процессе импорта сообщения об изменении данных.
| String |
conflict_definition (Дополнительный) | Задает, как вы предпочитаете определять конфликты:
| String |
reconcile_with_parent_version (Дополнительный) | Означает автоматическое согласование как только изменения данных отправляются в родительскую реплику в случае наличия конфликтов. Эта опция доступна только для реплик открепления/прикрепления.
| Boolean |
Пример кода
ImportMesage Пример (окно Python)
На следующем примере демонстрируется, как использовать функцию Импорт сообщения (Import Message) в окне 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")
ImportMesage Пример 2 (автономный скрипт Python)
Демонстрируется, как используется функция Импорт сообщения (Import Message) для импорта файла изменений данных в автономном скрипте Python.
# 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)
ImportMesage Пример 3 (автономный скрипт Python)
Демонстрируется, как используется функция Импорт сообщения (Import Message) для импорта файла изменений данных в автономном скрипте Python.
# 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)
Параметры среды
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да