メッセージのインポート (Import Message) (データ管理)

サマリー

デルタ ファイルの変更内容をレプリカ ジオデータベースにインポートするか、承認メッセージをレプリカ ジオデータベースにインポートします。

使用法

  • 非接続環境でレプリカを同期する場合にこのツールを使用します。 まず、同期する変更を含むデルタ ファイルを作成する [データ変更メッセージのエクスポート (Export Data Change Message)] ツールを実行します。 次に、[メッセージのインポート (Import Message)] ツールを使用して、デルタ ファイルを相対レプリカにコピーおよびインポートします。 デルタ ファイルが失われていて再送信する場合、[非承認メッセージの再エクスポート (Re-Export Unacknowledged Messages)] ツールを使用してデルタ ファイルを再生成します。 変更をインポートしたら、[承認メッセージのエクスポート (Export Acknowledgment Message)] ツールを使用して相対レプリカから承認ファイルをエクスポートできます。 [メッセージのインポート (Import Message)] ツールを使用して承認ファイルをコピーおよびインポートします。 承認を受け取っていない場合、次回の変更送信時に新しい変更と前に送信した変更が含まれます。

  • ジオデータベースは、ローカル ジオデータベースでもジオデータ サービスでもかまいません。

  • このツールは承認メッセージまたはデータ変更メッセージを受け付けます。 承認ファイルは *.xml ファイルです。 デルタ ファイル ジオデータベース (*.gdb) またはデルタ *.xml ファイルをデータ変更メッセージとして使用できます。

  • データ変更メッセージをインポートした直後から承認メッセージをエクスポートできます。 出力承認ファイルは *.xml ファイルにする必要があります。

  • 接続モードでレプリカを同期する方法については、[変更の同期 (Synchronize Changes)] ツールをご参照ください。

パラメーター

ラベル説明データ タイプ
インポート先のレプリカ ジオデータベース

インポートされたメッセージを受信するレプリカ ジオデータベース。 ジオデータベースは、ローカルでもリモートでもかまいません。

Workspace; GeoDataServer
デルタ ファイルからインポート

メッセージのインポート元となるファイル。

Workspace ; File
出力承認ファイル
(オプション)

承認メッセージを含むファイル。 データ変更をインポートすると、メッセージをエクスポートしてデータ変更メッセージのインポートを承認することもできます。 このパラメーターはデータ変更メッセージでのみサポートされています。

File
競合解決ポリシー
(オプション)

データ変更メッセージのインポート中に競合が検出された場合の、競合の解決方法を指定します。

  • 競合を手動で解決バージョニングのリコンサイル環境では競合を手動で解決する必要があります。
  • データベース優先変更を受信するデータベースを優先して競合が自動的に解決されます。
  • インポートされる変更を優先インポートされる変更を優先して競合が自動的に解決されます。
String
競合の定義
(オプション)

競合が発生するために必要な条件が、オブジェクト (行) または属性 (列) のいずれによって定義されるかを指定します。

  • オブジェクトによる競合は行によって定義されます。
  • 属性による競合は列によって定義されます。
String
親バージョンとのリコンサイル (チェックアウト レプリカ)
(オプション)

データ変更が親レプリカに送信された際に、競合が存在しない場合はデータ変更を自動的にリコンサイルするかどうかを指定します。 このパラメーターは、チェックアウト/チェックイン レプリカの場合にのみ有効となります。

  • オフ - 変更は親バージョンとリコンサイルされません。 これがデフォルトです。
  • オン - 変更は親バージョンとリコンサイルされます。
Boolean

派生した出力

ラベル説明データ タイプ
出力レプリカ ジオデータベース

更新されたレプリカ ジオデータベース。

Workspace; GeoDataServer

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

派生した出力

名前説明データ タイプ
out_geodatabase

更新されたレプリカ ジオデータベース。

Workspace; GeoDataServer

コードのサンプル

メッセージのインポート (ImportMessage) の例 (Python ウィンドウ)

次の例は、Python ウィンドウで ImportMessage 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", 
                               "acknowledgement.xml", 
                               "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")
メッセージのインポート (ImportMessage) の例 2 (スタンドアロン スクリプト)

次の例は、スタンドアロン Python スクリプトで ImportMessage 関数を使用してデータ変更ファイルをインポートする方法を示しています。

# 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)
メッセージのインポート (ImportMessage) の例 3 (スタンドアロン スクリプト)

次の例は、スタンドアロン Python スクリプトで ImportMessage 関数を使用してデータ変更ファイルをインポートする方法を示しています。

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

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック