Skip to main content

イベントのアペンド (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

読み込みタイプ

(オプション)

付加されたイベントがターゲット イベントに読み込まれる方法を指定します。

  • 追加ソース イベント レコードが、指定されたターゲット イベントに付加されます。

  • オーバーラップの破棄ソース イベント レコードが、指定されたターゲット イベントに付加され、付加されたイベントと同じメジャーまたは一時性のオーバーラップがあるレコードはすべて破棄されます。 付加されたイベントと指定されたターゲット イベント レコードが重複する場合、ターゲット イベント レコードは削除されます。 このオプションはライン イベントだけに使用します。

  • イベント ID による破棄ソース イベント レコードが、指定されたターゲット イベントに付加され、付加されたイベントと同じイベント ID または一時性のオーバーラップがあるレコードはすべて破棄されます。 付加されたイベントが同じイベント ID を持つターゲット イベント レコードと重複する場合は、ターゲット イベント レコードは削除されます。

  • イベント ID による置換ソース イベント レコードが、指定されたターゲット イベントに付加され、付加されたイベントと同じイベント ID を持つレコードはすべて置換されます。

String

読み込まれたイベントのイベント ID GUID の生成

(オプション)

付加されるソース イベント レコードのイベント ID を生成するかどうかを指定します。 イベント ID の生成は、Event ID フィールドの値が NULL であるソース イベント レコードにのみ適用されます。

  • オン付加されるソース イベント レコードのイベント 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) が必要