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

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

サマリー

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

注意:

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

使用法

このツールの実行には、LRS データセットが必要です。
詳細については、「ArcGIS Pipeline Referencing での LRS データセットの作成」か「ArcGIS Roads and Highways での LRS データセットの作成」をご参照ください。
[入力イベント] の値として、テーブル、レイヤー、またはフィーチャクラスを使用できます。
ArcGIS Pipeline Referencing イベントデータモデルに必要なフィールドの詳細
Roads and Highways イベントデータモデルに必要なフィールドの詳細
[ターゲットイベント] の値は、Location Referencing に登録されているレイヤーまたはフィーチャクラスにする必要があります。
このツールでは、ポイントフィーチャとポリラインフィーチャがサポートされています。入力イベントパラメーターとターゲットイベントパラメーターのフィーチャタイプは同じにする必要があります。
[読み込みタイプ] パラメーターの値として [追加] を使用して新しいイベントを追加する際に、[ターゲットイベント] 値で RouteName フィールドが構成されている場合、RouteName フィールドを使用してイベントを追加できます。
- [入力イベント] レコードに NULL の RouteID フィールドがあるものの RouteName フィールドが存在する場合は、RouteName フィールドを使用してイベントを追加できます。 RouteID その後、これらの追加されたイベントにフィールドが自動的に生成されます。
- [入力イベント] レコードに RouteID フィールドと RouteName フィールドが両方とも存在する場合は、RouteID フィールドを使用してイベントが追加されます。
[読み込まれたイベントのイベント ID 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=RouteName Text width 255
Col5=FromMeasure Double
Col6=ToMeasure Double
Col7=RdType Long
Col8=EventID Text width 50
```
ASCII またはテキストファイルテーブルの追加の詳細

パラメーター

ラベル	説明	データタイプ
入力イベント	追加するソースイベントレコード。	Table View
ターゲットイベント	ソースイベントレコードが追加される Location Referencing イベントレイヤーまたはフィーチャクラス。	Feature Layer
フィールドマップ	[入力イベント] パラメーター値のフィールド内の属性情報を [ターゲットイベント] パラメーター値に転送する方法を制御します。 [入力イベント] パラメーター値は、スキーマ (フィールド定義) があらかじめ定義されている既存のイベントに追加されるため、フィールドをターゲットデータセットに追加したり、ターゲットデータセットから削除したりすることはできません。出力フィールドごとにマージルールを設定することもできますが、設定したルールはこのツールで無視されます。	Field Mappings
読み込みタイプ (オプション)	追加されたイベントがターゲットイベントフィーチャクラスに読み込まれる方法を指定します。追加—[入力イベント] レコードが、指定されたターゲットイベントフィーチャクラスに追加されます。オーバーラップの破棄—[入力イベント] レコードが指定されたターゲットイベントフィーチャクラスに追加され、追加されたイベントと同じメジャーまたは一時性のオーバーラップがあるレコードがすべて破棄されます。追加されたイベントが指定されたターゲットイベントフィーチャと重複する場合は、ターゲットイベントレコードは削除されます。このオプションは、リニアイベントにのみ使用します。イベント 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 レコードが、指定されたターゲットイベントフィーチャクラスに追加されます。ターゲットイベントレコードには何も変更が加えられません。 RETIRE_OVERLAPS—in_dataset レコードが指定されたターゲットイベントフィーチャクラスに追加され、追加されたイベントと同じメジャーまたは一時性のオーバーラップがあるレコードがすべて破棄されます。追加されたイベントが指定されたターゲットイベントフィーチャと重複する場合は、ターゲットイベントレコードは削除されます。このオプションは、リニアイベントにのみ使用します。 RETIRE_BY_EVENT_ID—in_dataset レコードが指定されたターゲットイベントフィーチャクラスに追加され、追加されたイベントと同じイベント ID または一時性のオーバーラップがあるレコードがすべて破棄されます。追加されたイベントが同じイベント ID を持つターゲットイベントレコードと重複する場合は、ターゲットイベントレコードは削除されます。 REPLACE_BY_EVENT_ID—in_dataset レコードが指定されたターゲットイベントフィーチャクラスに追加され、追加されたイベントと同じイベント 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

# 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;RouteName "RouteName" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,0,255'

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)

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 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;RouteName \"RouteName\" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,0,255"

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
in_dataset = 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;RouteName "RouteName" true true false 255 Text 0 0,First,#,C:\Pipeline.gdb\LRS\PTMS_Add,RouteName,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.
in_target_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/34"

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

環境

現在のワークスペース

ライセンス情報

Basic: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)
Standard: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)
Advanced: 次のものが必要 ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways)

サマリー

注意:

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容