ArcMap

Импорт сообщения (Import Message)

Сводка

Импортирует изменения из дельта-файла в базу геоданных реплики, или импортирует подтверждающее сообщение в базу геоданных реплики.

Использование

  • Этот инструмент используется для синхронизации при подключении. Это делается путем первого запуска инструмента Экспорт сообщения об изменении данных (Export Data Change Message), который создает дельта-файл с изменениями для синхронизации. Дельта-файл затем копируется в связанную реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если дельта-файл теряется и вы хотите повторно отправить, вы можете использовать инструмент Ре-экспорт неподтвержденного сообщения (Re-Export Unacknowledged Messages), чтобы заново создать дельта-файл. После импортирования изменений относительная реплика может экспортировать файл подтверждения при помощи инструмента Экспорт подтвержденного сообщения (Export Acknowledgement Message). Файл подтверждения копируется в реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если подтверждение не получено, в следующий раз, когда отправляются изменения, они включают новые, а также ранее отправленные изменения.

  • База геоданных может быть локальной базой геоданных или сервисом геоданных.

  • Принимает либо сообщения подтверждения, либо сообщения об изменении данных. Файлы подтверждения – это XML-файлы (.xml). Сообщениями об изменении данных могут быть файловая дельта-база геоданных (.gdb), персональная дельта-база геоданных (.mdb) или дельта-файлы XML (.xml).

  • После импорта сообщения об изменении данных, у вас есть опция для непосредственного экспорта подтвержденного сообщения. Выходной файл подтверждения должен быть формата XML.

  • Чтобы синхронизировать реплики в режиме подключения, см. инструмент Синхронизировать изменения (Synchronize Changes).

Синтаксис

arcpy.management.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
(Дополнительный)

Указывает, как разрешаются конфликты, если они встречаются, в процессе импорта сообщения об изменении данных.

  • MANUAL —Конфликты разрешаются вручную в среде согласования версий.
  • IN_FAVOR_OF_DATABASE —Конфликты разрешаются автоматически в пользу базы данных, получающей изменения.
  • IN_FAVOR_OF_IMPORTED_CHANGES —Конфликты разрешаются автоматически в пользу импортируемых изменений.
String
conflict_definition
(Дополнительный)

Задает, как вы предпочитаете определять конфликты:

  • BY_OBJECT —Обнаруживает конфликты по строке.
  • BY_ATTRIBUTE —Обнаруживает конфликты по столбцу.
String
reconcile_with_parent_version
(Дополнительный)

Означает автоматическое согласование как только изменения данных отправляются в родительскую реплику в случае наличия конфликтов. Эта опция доступна только для реплик открепления/прикрепления.

  • DO_NOT_RECONCILE —Не согласовывать. Это значение используется по умолчанию.
  • RECONCILE —Согласовывать
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: Да

Связанные разделы