イベントのアペンド (Append Events) (Location Referencing ツール)
サマリー
テーブル、レイヤー、またはフィーチャクラスから既存の LRS イベント フィーチャクラスにイベント レコードを付加します。
注意:
ターゲット レイヤーがフィーチャ サービス レイヤーの場合は、検証結果が ArcGIS Server ディレクトリー内のファイルに書き込まれます。 このファイルはデフォルトで 10 分後に自動的にクリーン アップされますが、この時間は、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションにこれらの検証を書き込むには十分でない場合があります。 大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをお勧めします。 この設定を調整するには、ArcGIS Server Manager でサーバー ディレクトリーを編集します。
使用法
このツールを実行するには、LRS データセットが必要です。
入力イベント パラメーターの値として、テーブル、レイヤー、またはフィーチャクラスを使用できます。
ターゲット イベント パラメーターの値は、LRS に登録されているレイヤーまたはフィーチャクラスにする必要があります。
ターゲット イベント パラメーター値の選択セットと定義クエリーは無視されます。
このツールではポイント フィーチャとライン フィーチャがサポートされます。 入力イベント パラメーターと ターゲット イベント パラメーターのフィーチャ タイプが一致していなければなりません。
読み込みタイプ パラメーターのオプションとして 追加 を使用して新しいイベントを付加する際に、ターゲット イベント 値で
RouteNameフィールドが構成されている場合、そのフィールドを使用してイベントを付加できます。入力イベント レコードの
RouteIDフィールドは NULL であるがRouteNameフィールドには値が含まれている場合、RouteNameフィールドを使用してイベントを付加できます。 その後、これらの付加されたイベントにRouteIDフィールドが自動的に生成されます。入力イベント レコードの
RouteIDフィールドとRouteNameフィールドの両方に値が含まれている場合、RouteIDフィールドを使用してイベントが付加されます。
FromDateおよびToDateフィールドのマッピングは 読み込みタイプ パラメーターの 追加 オプションでは任意です。 次のシナリオがサポートされています。FromDateおよびToDateフィールドがマッピングされない場合、追加イベントの開始日は、ルートのアクティブなタイム スライスの開始日と同じになり、終了日は NULL 値になります。FromDateフィールドはマッピングされ、ToDateフィールドはマッピングされない場合、追加イベントの終了日は NULL 値になります。FromDateフィールドはマッピングされないがToDateフィールドはマッピングされる場合は、エラーが返されます。またがるライン イベントでは、ツールは最初に、同じライン ID を共有するすべてのルートの最新のタイム スライスを特定します。 次にルートの最新のタイム スライスの開始日が、追加されるイベントの開始日として割り当てられ、終了日は NULL 値になります。
注意:
ToDateフィールド、あるいはFromDateおよびToDateフィールドをマッピングしない場合は、フィールド マップ パラメーターのフィールド リストからフィールドを削除する必要があります。読み込まれたイベントのイベント ID GUID の生成 パラメーターがオンの場合、フィールド マップ パラメーターで
EventIDフィールドをマッピングしないようにするか、入力イベントのEventIDフィールドに NULL 値が含まれていることを確認してください。 ソース イベント レコードのEventIDフィールドが取り込まれた際に、読み込まれたイベントのイベント ID GUID の生成 パラメーターがオンになっていると、ソース イベント レコードのEventIDフィールドの値がターゲット イベントに読み込まれます。主要ルートへのイベントの付加 パラメーターがオンになっているときに、ルート並行性が存在する場合、入力イベント パラメーター値からのレコードは主要ルートに付加されます。 ルート上に複数の並行性が存在する場合、入力イベント のレコードが分割され、並行ルートの各セクションの主要ルートに付加されます。 ルートの並行性が存在しない場合、入力イベント パラメーター値からのレコードは、入力データセットで指定されているルートに引き続き付加されます。
- このツールでは、入力データセットで指定されているルートとは異なる、主要ルートに付加されたイベント レコードのテキスト ファイルが返されます。
このツールは競合の防止をサポートしており、ロックの取得と転送を試行します。
競合の防止を有効にした場合は、次の処理が実行されます。
イベント ロックが利用可能な場合に、追加する必要のあるイベントでイベント ロックが自動的に取得されます。 ロックを取得できない場合は、このツールを実行すると、エラーが返され、問題となっているロックのテキスト ファイルが示されます。
主要ルートへのイベントの付加 パラメーターがオンになっている場合、イベント ロックは、イベントが付加される最も主要なルートであるターゲット ルートとだけ比較されます。 ターゲット ルートに対するロックを取得できない場合は、このツールを実行すると、エラーが返され、問題となっているロックのテキスト ファイルが示されます。
競合防止ロックがある場合でも追加 パラメーターがオンになっている場合、既存のロックはバイパスされ、このツールを実行した結果として新しいロックは取得されません。
注意:
競合防止ロックをバイパスすると、データが破損したり、予期しない動作が発生する可能性があります。 競合防止ロックがある場合でも追加 パラメーターをオンにしてこのツールを実行する前に、起こりうる結果について検討し、必ずデータベース バックアップを作成してください。
デフォルト バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックが自動的に解除されます。
指定バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックがポスト ステータスのまま維持されます。 ロックを解除するには、バージョンをポストまたは削除する必要があります。
指定バージョンで作業している場合に、このツールのプロセスが取り消されると、取得されたロックは解除可能ステータスのまま維持されます。
物理的にギャップのあるルートに対してルート キャリブレーションを実行すると、付加されたイベントが次の影響を受けます。
ギャップ間のルート キャリブレーションの差異がゼロでない場合は、付加されたイベントが各ギャップで分割されます。
ギャップ間のルート キャリブレーションの差異がゼロの場合は、付加されたイベントがマルチパート イベントになります。
ASCII 形式の
.csvファイルを、その.csvファイル内のカンマ区切りフィールドを定義する初期化ファイル (schema.ini) と組み合わせて使用すると、イベントを付加することができます。 スキーマ初期化ファイルには、次のデータを入力する必要があります。初期化する
.csvファイルの名前と形式各列の名前とデータ タイプ
データ タイプがテキストの場合に使用する最大幅
次の初期化ファイルの例では、使用する
.csvファイルの名前と形式、各列に使用するフィールド名とデータ タイプ (左から右)、テキスト フィールドの最大幅が宣言されています:schema.ini
<!--```other [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 またはテキスト ファイル テーブルの追加の詳細](../../help/data/tables/add-an-ascii-or-text-file-table.md) > [!LEGACY] > **シェープの生成** パラメーターはサポートされなくなりました。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力イベント |
付加されるソース イベント レコード。 |
Table View |
|
ターゲット イベント |
ソース イベント レコードが付加される LRS イベント レイヤーまたはフィーチャクラス。 |
Feature Layer |
|
フィールド マップ |
入力イベントのフィールドの属性情報をターゲット イベントに転送する方法を制御します。 ソース イベント レコードは、スキーマ (フィールド定義) があらかじめ定義されている既存のイベントに付加されるため、ターゲット イベントに対するフィールドの追加または削除は行えません。 出力フィールドごとにマージ ルールを設定できますが、ツールはそのルールを無視します。 |
Field Mappings |
|
読み込みタイプ (オプション) |
付加されたイベントがターゲット イベントに読み込まれる方法を指定します。
|
String |
|
読み込まれたイベントのイベント ID GUID の生成 (オプション) |
付加されるソース イベント レコードのイベント ID を生成するかどうかを指定します。 イベント ID の生成は、
|
Boolean |
|
シェープの生成 (オプション) |
注意:このパラメーターはサポートされていません。 |
Boolean |
|
主要ルートへのイベントの付加 (オプション) |
ルートの並行性が存在する場合に主要ルートにソース イベント レコードを付加するかどうかを指定します。 このパラメーターは 読み込みタイプ のすべてのオプションで使用できます (追加、オーバーラップの破棄、イベント ID による破棄、イベント ID による置換)。
|
Boolean |
|
競合防止ロックがある場合でも追加 (オプション) |
競合防止ロックがある場合でもイベントを追加するかどうかを指定します。 このパラメーターは、LRS データセットで競合の防止が有効になっている場合のみ使用できます。 注意:競合防止ロックをバイパスすると、データが破損したり、予期しない動作が発生する可能性があります。 このパラメーターをオンにしてこのツールを実行する前に、起こりうる結果について検討し、データベース バックアップを作成してください。
|
Boolean |
派生した出力
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
出力ターゲット イベント |
ソース イベント レコードが付加されるイベント レイヤーまたはフィーチャクラス。 |
Feature Layer |
|
出力結果ファイル |
このツールで変更された内容が詳しく記述されたテキスト ファイル。 |
Text File |
環境
ライセンス情報
- 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) が必要