ルート ID パディングの変更 (Modify Route ID Padding) (Location Referencing)

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

サマリー

マルチフィールド ルート ID を構成する各フィールドのパディング、NULL、長さのプロパティを変更します。

ルート ID は、RouteType、RouteNumber、RampNumber の 3 つのフィールドで構成されます。 3 つのフィールドのパディングおよび NULL の設定例を以下に示します。

• RouteType は、長さが 3 のテキスト フィールドです。 入力可能な最大文字数は 3 です。ただし、一部のルートについては、このフィールドに入力される文字数が 1 文字か 2 文字であることがあります。 右側のパディング文字には、ハイフンが使用されます。
• RouteNumber は、Short フィールド タイプです。 フィールドには、0 ～ 99999 の値を指定できます。0 は、左側のパディング文字として使用されます。
• RampNumber は、長さが 7 のテキスト フィールドです。一部のルートでは、このフィールドに値がなく、空白のままにしておく必要があります。 左右のパディング文字には、アンダースコアが使用されます。

図

使用法

• ルート ID の各フィールドでは、最大長を短くしたり、可変長または固定長にしたりできます。あるいは、パディング文字を左側、右側、両側に追加できるほか、パティングを空白のフィールドに追加したりすることもできます。 さらに、結合ルート ID の 1 つ以上のフィールドで NULL 値を使用することもできます。

• 各レコードのルート ID は、パディングと NULL 値が含まれた状態で格納されます。 結合ルート ID の一部として使用される個々のフィールドは、パディング文字がない状態で格納されます。

• パディングと NULL の設定は、ネットワークの作成後に変更できるようになります。 これらの設定を変更する前に読み込まれたり、作成されたりしたルートは、そのままの形でデータベースに保存されます。 設定を変更した後に読み込まれたり、作成されたりしたルートは、データベースへの保存時に、更新された設定を使用します。

• 長さを変更しても、ArcGIS Roads and Highways がネットワークのルートの一部として各フィールドに対して予期する最大文字数だけが変更されるだけです。 データは、引き続きジオデータベースでモデル化する必要があり、そのルート ID フィールド長は、連結ルート ID を構成するフィールド長の合計である必要があります。

• [NULL の場合はパッド] チェックボックスをオンにした場合は、[NULL 値を許可] チェックボックスをオンにする必要があります。

• フィールドで NULL 値を許可した場合、そのフィールドの右側にあるすべてのフィールドも、NULL 値を許可する必要があります。 ただし、[値を指定しない場合はパッド] チェックボックスをオンにした場合、右側にあるフィールドで NULL 値を許可する必要はありません。

• パディング文字として数字記号 (#) はサポートされません。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
LRS ネットワーク フィーチャクラス	変更する必要があるパディング値、NULL 値、長さ値のフィールドを含む入力マルチフィールド ルート ID ネットワーク レイヤー。	Feature Layer
ルート ID パディング	変更の必要があるフィールドと、対応するパディング値、NULL 値、長さ値を含む値のテーブル。 Field—変更されるフィールド。 Length—変更されるフィールドの長さの値。 フィールドの長さは、1 からデータベース フィールドの長さまでの間でなければなりません。 Variable Length—[長さ] 値が可変的であるか固定値であるかを指定します。 Enable Padding—フィールドがパディングをサポートするかどうかを指定します。 Padding Character—フィールドのパディング文字。 デフォルトはスペースです。 Padding Location—フィールド値でパディングを適用する場所を指定します。 [左] - フィールドの値の左側にパディング文字を追加します。 これがデフォルトです。 [右] - フィールドの値の右側にパディング文字を追加します。 [左および右] - フィールドの値の両側にパディング文字を追加します。 Pad if Null—フィールドに NULL 値が含まれる場合に、パディング文字を追加するかどうかを指定します。 Allow Null Values—フィールドが NULL 値をサポートするかどうかを指定します。	Value Table

派生した出力

ラベル	説明	データ タイプ
出力ネットワーク フィーチャクラス	更新されたネットワーク フィーチャ レイヤー。	Feature Layer

Python

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)

名前	説明	データ タイプ
in_feature_class	変更する必要があるパディング値、NULL 値、長さ値のフィールドを含む入力マルチフィールド ルート ID ネットワーク レイヤー。	Feature Layer
route_id_padding [route_id_padding,...]	変更の必要があるフィールドと、対応するパディング値、NULL 値、長さ値を含む値のテーブル。 Field—変更されるフィールド。 Length—変更されるフィールドの長さの値。 フィールドの長さは、1 からデータベース フィールドの長さまでの間でなければなりません。 Variable Length—[長さ] 値が可変的であるか固定値であるかを指定します。 Enable Padding—フィールドがパディングをサポートするかどうかを指定します。 Padding Character—フィールドのパディング文字。 デフォルトはスペースです。 Padding Location—フィールド値でパディングを適用する場所を指定します。 [左] - フィールドの値の左側にパディング文字を追加します。 これがデフォルトです。 [右] - フィールドの値の右側にパディング文字を追加します。 [左および右] - フィールドの値の両側にパディング文字を追加します。 Pad if Null—フィールドに NULL 値が含まれる場合に、パディング文字を追加するかどうかを指定します。 Allow Null Values—フィールドが NULL 値をサポートするかどうかを指定します。	Value Table

派生した出力

名前	説明	データ タイプ
out_feature_class	更新されたネットワーク フィーチャ レイヤー。	Feature Layer

コードのサンプル

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

ModifyRouteIdPadding ツールを Python ウィンドウで使用する方法を示しています。

# Name: ModifyRouteIdPadding_inline.py
# Description: Modifies the padding, null, and length properties for fields that are part of a multifield route ID in the Python window.
# Requires: ArcGIS Location Referencing

# Tool variables 
in_feature_class = r"C:\Data\DOT.gdb\LRS\StateRoutes"

## Values format: "Field Length VariableLength EnablePadding PaddingCharacter PaddingLocation PadifNull AllowNullValues;Field2......" 
route_id_padding = "RouteSystem 3 false true @ LEFT false false;RouteNumber 10 true true 0 LEFT true true"

# Set current workspace
arcpy.env.workspace = "C:\Data\DOT.gdb"

# Execute the tool
arcpy.locref.ModifyRouteIdPadding(in_feature_class,route_id_padding)

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

ModifyRouteIdPadding ツールをスタンドアロン Python スクリプトで使用する方法を示します。

# Name: ModifyRouteIdPadding_standalone.py
# Description: Modifies the padding, null, and length properties for fields that are part of a multifield route ID in standalone mode.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set local variables
in_feature_class = r"C:\Data\DOT.gdb\LRS\StateRoutes"

# Values format: "Field Length VariableLength EnablePadding PaddingCharacter PaddingLocation PadifNull AllowNullValues;Field2......" 
route_id_padding = "RouteSystem 3 false true @ LEFT false false;RouteNumber 10 true true 0 LEFT true true"

# Execute the tool
arcpy.locref.ModifyRouteIdPadding(in_feature_class,route_id_padding)

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