イベントのアペンド (Append Events) (Location Referencing)—ArcGIS Pro

Location Referencing ライセンスで利用可能です。

サマリー

テーブル、レイヤー、またはフィーチャクラスから既存の ArcGIS Location Referencing イベントフィーチャクラスにイベントレコードを追加します。

注意:

ターゲットレイヤーがフィーチャサービスレイヤーの場合は、このツールの整合チェック結果が ArcGIS Server ディレクトリ内のファイルに書き込まれます。このファイルはデフォルトで 10 分後に自動的にクリーンアップされますが、この時間は、すべての整合チェックを処理し、ArcGIS Pro を実行しているワークステーションにこれらの整合チェックを書き込むには十分でない場合があります。大きいデータロードについては、ファイルの最大保存期間を少なくとも 1 時間に調整することをお勧めします。この設定を調整するには、ArcGIS Server Manager でサーバーディレクトリを編集します。

使用法

このツールの実行には、LRS データセットが必要です。 LRS データセットを追加するには、キャリブレーションポイント、中心線、およびレッドラインレイヤーをフィーチャデータセットに追加した後、ジオデータベースを入力データにして [LRS の変更 (Modify LRS)] ツールを実行します。
[入力イベント] として、テーブル、レイヤー、またはフィーチャクラスを使用できます。
ArcGIS Pipeline Referencing イベントデータモデルに必要なフィールドの詳細
Roads and Highways イベントデータモデルに必要なフィールドの詳細
[ターゲットイベント] は、Location Referencing に登録されているレイヤーまたはフィーチャクラスにする必要があります。
このツールでは、ポイントフィーチャとポリラインフィーチャがサポートされています。入力イベントパラメーターとターゲットイベントパラメーターのフィーチャタイプは同じにする必要があります。
[読み込まれたイベントのイベント ID GUID の生成] パラメーターがオンの場合に、GUID を生成するには、フィールドマッピングセクション内の EventID フィールドをマッピングしないか、ソースイベントデータの EventID 列に値が NULL のレコードを挿入してください。ソースイベントレコードの EventID フィールドが取り込まれた際に、[読み込まれたイベントのイベント ID GUID の生成] パラメーターがオンになっていると、ソースイベントレコードの EventID フィールドの値がターゲットイベントに読み込まれます。
競合の防止を有効にした場合は、次の処理が実行されます。
- イベントロックが利用可能な場合に、追加する必要のあるイベントでイベントロックが自動的に取得されます。ロックを取得できない場合は、このツールを実行すると、エラーが返され、問題となっているロックのテキストファイルが提示されます。
  - Pipeline Referencing での競合の回避の詳細
  - Roads and Highways での競合の回避の詳細
- デフォルトバージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックが自動的に解除されます。
- 子バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックがポストステータスのまま維持されます。ロックを解除するには、バージョンをポストまたは削除する必要があります。
- 子バージョンで作業している場合に、中断によってこのツールの実行が取り消されると、ロックが取得され、解除可能なステータスのまま維持されます。
物理的にギャップのあるルートに対してルートキャリブレーションを実行すると、追加されたイベントが次の影響を受けます。
- ギャップ間のルートキャリブレーションの差異がゼロでない場合は、追加されたイベントが各ギャップで分割されます。
- ギャップ間のルートキャリブレーションの差異がゼロの場合は、追加されたイベントがマルチパートイベントになります。
ASCII 形式の *.csv ファイルを、その *.csv ファイル内のカンマ区切りフィールドを定義する初期化ファイル (schema.ini) と組み合わせて使用すると、イベントを追加することができます。スキーマ初期化ファイルには、次のデータを入力する必要があります。
- 初期化する *.csv ファイルの名前と形式
- CSV 列ごとの名前とデータタイプ
- データタイプがテキストの場合に使用する最大幅
次の初期化例では、使用する *.csv ファイルの名前と形式、CSV 列ごとに使用するフィールド名とデータタイプ (左から右)、テキストフィールドの最大幅が宣言されています。
schema.ini
```
[source_events.csv]
Format=CSVDelimited
ColNameHeader=True
Col1=FromDate Date
Col2=ToDate Date
Col3=RouteID Text width 255
Col4=FromMeasure Double
Col5=ToMeasure Double
Col6=RdType Long
Col7=EventID Text width 50
```
ASCII またはテキストファイルテーブルの追加の詳細
このツールは競合の回避をサポートしており、ロックの取得と転送を試行します。
ArcGIS Pipeline Referencing での競合の回避または ArcGIS Roads and Highways での競合の回避の詳細をご参照ください。

パラメーター

ラベル	説明	データタイプ
入力イベント	追加するソースイベントレコード	Table View
ターゲットイベント	ソースイベントレコードが追加される Location Referencing イベントレイヤーまたはフィーチャクラス	Feature Layer
フィールドマップ	[入力イベント] パラメーター値のフィールド内の属性情報を [ターゲットイベント] パラメーター値に転送する方法を制御します。 [入力イベント] パラメーター値は、スキーマ (フィールド定義) があらかじめ定義されている既存のイベントに追加されるため、フィールドをターゲットデータセットに追加したり、ターゲットデータセットから削除したりすることはできません。出力フィールドごとにマージルールを設定することもできますが、設定したルールはこのツールで無視されます。	Field Mappings
読み込みタイプ (オプション)	追加されたイベントのうち、メジャーまたは一時性のオーバーラップがあり、[ターゲットイベント] レコードと同じイベント ID を持つイベントをイベントフィーチャクラスに読み込む方法を指定します。追加—[入力イベント] レコードが [ターゲットイベント] パラメーター値に追加されます。 [ターゲットイベント] レコードには何も変更が加えられません。オーバーラップの破棄—[入力イベント] レコードが [ターゲットイベント] パラメーター値に追加され、[ターゲットイベント] パラメーター値のレコードのうち、追加されたイベントと同じメジャーまたは一時性のオーバーラップがあるレコードがすべて破棄されます。追加されたイベントが [ターゲットイベント] パラメーター値に優先する場合は、[ターゲットイベント] パラメーター値が削除されます。このオプションは、リニアイベントにのみ使用する必要があります。イベント ID による破棄—[入力イベント] レコードが [ターゲットイベント] パラメーター値に追加され、[ターゲットイベント] パラメーター値のレコードのうち、イベント ID および一時性のオーバーラップが追加されたイベントと同じであるレコードがすべて破棄されます。追加されたイベントが同じイベント ID を持つ [ターゲットイベント] パラメーター値に優先する場合は、[ターゲットイベント] パラメーター値が削除されます。イベント ID による置換—[入力イベント] レコードが [ターゲットイベント] パラメーター値に追加され、[ターゲットイベント] パラメーター値のレコードのうち、追加されたイベントと同じイベント ID を持つレコードがすべて破棄されます。	String
読み込まれたイベントのイベント ID GUID の生成 (オプション)	追加される [入力イベント] レコードのイベント ID を生成するかどうかを指定します。イベント ID の生成は、Event ID フィールドで値が NULL の [入力イベント] レコードにのみ適用されます。オン - 追加される [入力イベント] レコードのイベント ID が生成されます。オフ - 追加される [入力イベント] レコードのイベント ID が生成されません。これがデフォルトです。	Boolean
シェープの生成 (オプション)	追加されるレコードの形状を再生成するかどうかを指定します。このパラメーターは、[入力イベント] がフィーチャレイヤーまたはフィーチャクラスの場合にのみ有効になります。オン - 入力イベントフィーチャの形状が再生成されます。これがデフォルトです。オフ - 入力イベントフィーチャの形状が再生成されません。	Boolean

派生した出力

ラベル	説明	データタイプ
出力ターゲットイベント	ソースイベントレコードが追加されているイベントレイヤーまたはフィーチャクラス	Feature Layer
出力結果ファイル	このツールで変更された内容が詳しく記述されたテキストファイル。	Text File

arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, {load_type}, {generate_event_ids}, {generate_shapes})

名前	説明	データタイプ
in_dataset	追加するソースイベントレコード	Table View
in_target_event	ソースイベントレコードが追加される Location Referencing イベントレイヤーまたはフィーチャクラス	Feature Layer
field_mapping	in_dataset のフィールド内の属性情報を in_target_event に転送する方法を制御します。 in_dataset パラメーター値は、スキーマ (フィールド定義) があらかじめ定義されている既存のイベントに追加されるため、フィールドをターゲットデータセットに追加したり、ターゲットデータセットから削除したりすることはできません。出力フィールドごとにマージルールを設定することもできますが、設定したルールはこのツールで無視されます。このパラメーターを定義するには、FieldMappings クラスを使用します。	Field Mappings
load_type (オプション)	追加されたイベントのうち、メジャーまたは一時性のオーバーラップがあり、in_target_event レコードと同じイベント ID を持つイベントをイベントフィーチャクラスに読み込む方法を指定します。 ADD—in_dataset レコードが in_target_event パラメーター値に追加されます。 in_target_event レコードには何も変更が加えられません。 RETIRE_OVERLAPS—in_dataset レコードが in_target_event パラメーター値に追加され、in_target_event パラメーター値のレコードのうち、追加されたイベントと同じメジャーまたは一時性のオーバーラップがあるレコードがすべて破棄されます。追加されたイベントが in_target_event パラメーター値に優先する場合は、in_target_event パラメーター値が削除されます。このオプションは、リニアイベントにのみ使用する必要があります。 RETIRE_BY_EVENT_ID—in_dataset レコードが in_target_event パラメーター値に追加され、in_target_event パラメーター値のレコードのうち、イベント ID および一時性のオーバーラップが追加されたイベントと同じであるレコードがすべて破棄されます。追加されたイベントが同じイベント ID を持つ in_target_event パラメーター値に優先する場合は、in_target_event パラメーター値が削除されます。 REPLACE_BY_EVENT_ID—in_dataset レコードが in_target_event パラメーター値に追加され、in_target_event パラメーター値のレコードのうち、追加されたイベントと同じイベント ID を持つレコードがすべて破棄されます。	String
generate_event_ids (オプション)	追加される in_dataset レコードのイベント ID を生成するかどうかを指定します。イベント ID の生成は、Event ID フィールドで値が NULL の in_dataset レコードにのみ適用されます。 GENERATE_EVENT_IDS—追加される in_dataset レコードのイベント ID が生成されます。 NO_GENERATE_EVENT_IDS—追加される in_dataset レコードのイベント ID が生成されません。これがデフォルトです。	Boolean
generate_shapes (オプション)	追加されるレコードの形状を再生成するかどうかを指定します。このパラメーターは、in_dataset がフィーチャレイヤーまたはフィーチャクラスの場合にのみ有効になります。 GENERATE_SHAPES—入力イベントフィーチャの形状が再生成されます。これがデフォルトです。 NO_SHAPES—入力イベントフィーチャの形状が再生成されません。	Boolean

派生した出力

名前	説明	データタイプ
out_target_event	ソースイベントレコードが追加されているイベントレイヤーまたはフィーチャクラス	Feature Layer
out_details_file	このツールで変更された内容が詳しく記述されたテキストファイル。	Text File

コードのサンプル

AppendEvents の例 1 (Python ウィンドウ)

AppendEvents 関数を Python ウィンドウで使用してイベントレコードを既存のイベントフィーチャクラスに追加する方法を示しています。。

# Name: AppendEvents_ex1_pro.py
# Description: Append event records into an existing Location Referencing event feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set current workspace
arcpy.env.workspace= r"C:\Pipeline.gdb"

# Set tool variables
# Source Event Table in fgdb
in_dataset = "PTMS_Add"

# Target Event Feature Class in fgdb
in_target_event = "LRSE_PTMS"

#Map fields between target and source
field_mapping = r'AADT "AADT" true true false 4 Long 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,AADT,-1,-1;YEAR_ "YEAR_" true true false 2 Short 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,YEAR_,-1,-1;Cosite "Cosite" true true false 6 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Cosite,0,6;Classd "Classd" true true false 3 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Classd,0,3;SECTION_ "SECTION_" true true false 8 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,SECTION_,0,8;COMM "COMM" true true false 254 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,COMM,0,254;Active "Active" true true false 1 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Active,0,1;Sitetype "Sitetype" true true false 11 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Sitetype,0,11;KFCTR "KFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,KFCTR,-1,-1;DFCTR "DFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,DFCTR,-1,-1;TFCTR "TFCTR" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,TFCTR,-1,-1;LOCATION "LOCATION" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,LOCATION,-1,-1;FromDate "FromDate" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,FromDate,-1,-1;ToDate "ToDate" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,ToDate,-1,-1;EventID "EventID" true true false 50 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,EventID,0,50'

load_type = "Add"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, generate_shapes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

AppendEvents の例 2 (スタンドアロンスクリプト)

AppendEvents 関数をスタンドアロン Python スクリプトで使用してイベントレコードを既存のイベントフィーチャクラスに追加する方法を示しています。

# Name: AppendEvents_StandAlonePython_Example.py
# Description: Append event records into an existing event feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set tool variables
# Source Event Table in fgdb
in_dataset = r"C:\Pipeline.gdb\LRS\PTMS_Add"

# Target Event Feature Class in fgdb
in_target_event = r"C:\Pipeline.gdb\LRS\LRSE_PTMS"

#Map fields b/w target and source
field_mapping = r"AADT \"AADT\" true true false 4 Long 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,AADT,-1,-1;YEAR_ \"YEAR_\" true true false 2 Short 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,YEAR_,-1,-1;Cosite \"Cosite\" true true false 6 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Cosite,0,6;Classd \"Classd\" true true false 3 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Classd,0,3;SECTION_ \"SECTION_\" true true false 8 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,SECTION_,0,8;COMM \"COMM\" true true false 254 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,COMM,0,254;Active \"Active\" true true false 1 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Active,0,1;Sitetype \"Sitetype\" true true false 11 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,Sitetype,0,11;KFCTR \"KFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,KFCTR,-1,-1;DFCTR \"DFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,DFCTR,-1,-1;TFCTR \"TFCTR\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,TFCTR,-1,-1;LOCATION \"LOCATION\" true true false 8 Double 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,LOCATION,-1,-1;FromDate \"FromDate\" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,FromDate,-1,-1;ToDate \"ToDate\" true true false 8 Date 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,ToDate,-1,-1;EventID \"EventID\" true true false 50 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,EventID,0,50"

load_type = "REPLACE_BY_EVENT_ID"

generate_event_ids = "NO_GENERATE_EVENT_IDS"

generate_shapes = "GENERATE_SHAPES"

# Execute the tool
arcpy.locref.AppendEvents(in_dataset, in_target_event, field_mapping, load_type, generate_event_ids, generate_shapes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

AppendEvents の例 3 (スタンドアロンスクリプト)

AppendEvents 関数をスタンドアロン Python スクリプトで使用してイベントレコードをフィーチャサービスに追加する方法を示しています。

# Name: AppendEvents_Pro_Ex3.py
# Description: Append events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set tool variables
sourceevent = r"C:\LocationReferencing\LR.gdb\LRS\LineEvent"
field_mapping = r'FROMDATE "From Date" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,FROMDATE,-1,-1;TODATE "To Date" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,TODATE,-1,-1;EVENTID "Event ID" true true false 50 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,EVENTID,0,50;ROUTEID "Route ID" true true false 255 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,ROUTEID,0,255;FROMMEASURE "From Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,FROMMEASURE,-1,-1;TOMEASURE "To Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\LineEvent,TOMEASURE,-1,-1'
load_type = "ADD"
generate_event_ids = "NO_GENERATE_EVENT_IDS"
generate_shapes = "GENERATE_SHAPES"

# Target event is in a feature service. Sign in to portal is required to access the feature service. 
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the target event from the feature service. In the feature service, 34 corresponds to the target event.
targetevent = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/34"

# Execute the tool
arcpy.locref.AppendEvents(sourceevent, targetevent, field_mapping, load_type, generate_event_ids, generate_shapes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

環境

現在のワークスペース

ライセンス情報

Basic: 次のものが必要 ArcGIS Location Referencing
Standard: 次のものが必要 ArcGIS Location Referencing
Advanced: 次のものが必要 ArcGIS Location Referencing

ARCGIS

機能

ArcGIS の購入

業種

サポートとサービス

セルフサービス

Esri に連絡

Esri ストーリー

Esri について

GIS について

イノベーションへの取り組み

派生した出力

派生した出力

コードのサンプル

サマリー

注意:

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容