Импорт сообщения (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).

Синтаксис

ImportMessage_management (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)

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

Параметры среды

Информация о лицензиях

ArcGIS Desktop Basic: Нет
ArcGIS Desktop Standard: Да
ArcGIS Desktop Advanced: Да

ArcMap

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