修改路径 ID 填充 (位置参考)

适用于 Location Referencing 许可。

摘要

修改属于多字段路径 ID 的字段的填充、空值和长度属性。

路径 ID 通过三个字段配置：RouteType、RouteNumber 和 RampNumber。 三个字段的示例填充和空值设置如下所示。

• RouteType 为长度为 3 的文本字段。 最多可输入三个字符；但是，某些路径的此字段可能会输入一个或两个字符。 连字符将用作右侧的填充字符。
• RouteNumber 为短整型字段类型。 该字段的值范围为 0 到 99999；0 将用作左侧的填充字符。
• RampNumber 为长度为 7 的文本字段；但是，某些路径的此字段不具有值，需要将其留空。 下划线将用作左右侧的填充字符。

插图

使用情况

• 路径 ID 中的每个字段都可以缩短其最大长度；可以设置为可变长度或固定长度；或者在左侧、右侧或左右两侧添加填充字符，以及在空白字段中添加填充。 此外，空值可用于串连路径 ID 中的一个或多个字段。

• 每条记录的路径 ID 将与填充和空值一同存储。 作为串连路径 ID 一部分的所有单个字段在存储时不包含填充字符。

• 创建网络后，可以更改填充和空值设置。 在数据库中存储时，在更改这些设置之前加载和创建的任何路径都将保持原样。 在数据库中存储时，在更改设置后加载和创建的任何路径都将使用这些更新设置。

• 更改长度只会更改作为网络中路径一部分的每个字段的 ArcGIS Roads and Highways 预期最大字符数。 您的数据仍应在地理数据库中进行建模，路径 ID 字段长度为构成串联路径 ID 的字段长度之和。

• 如果选中如果为空，则填充复选框，则必须选中允许空值复选框。

• 如果允许某字段使用空值，则也必须允许该字段右侧的所有字段使用空值。 但是，如果选中如果未提供值，则填充复选框，则右侧的字段不必允许空值。

• 不支持将数字符号 (#) 作为填充字符。

参数

对话框

标注	说明	数据类型
LRS 网络要素类	输入多字段路径 ID 网络图层，其中包含需要修改的填充、空值和长度值字段。	Feature Layer
路径 ID 填充	在此值表中指定了要修改的字段及其对应的填充、空值和长度值。 Field—要修改的字段。 Length—要修改的字段的长度值。 字段长度应介于 1 和数据库字段的长度之间。 Variable Length—指定长度值是可变值还是固定值。 Enable Padding—指定字段是否支持填充。 Padding Character—字段的填充字符。 默认为空格。 Padding Location—指定应将填充应用于字段值的位置。 左侧 - 将填充字符添加到字段中值的左侧。 这是默认设置。 右侧 - 将填充字符添加到字段中值的右侧。 左侧和右侧 - 将填充字符添加到字段中值的左右两侧。 Pad if Null—指定当字段具有空值时是否添加填充字符。 Allow Null Values—指定字段是否支持空值。	Value Table

派生输出

标注	说明	数据类型
输出网络要素类	更新的网络要素图层。	Feature Layer

Python

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)

名称	说明	数据类型
in_feature_class	输入多字段路径 ID 网络图层，其中包含需要修改的填充、空值和长度值字段。	Feature Layer
route_id_padding [route_id_padding,...]	在此值表中指定了要修改的字段及其对应的填充、空值和长度值。 Field—要修改的字段。 Length—要修改的字段的长度值。 字段长度应介于 1 和数据库字段的长度之间。 Variable Length—指定长度值是可变值还是固定值。 Enable Padding—指定字段是否支持填充。 Padding Character—字段的填充字符。 默认为空格。 Padding Location—指定应将填充应用于字段值的位置。 左侧 - 将填充字符添加到字段中值的左侧。 这是默认设置。 右侧 - 将填充字符添加到字段中值的右侧。 左侧和右侧 - 将填充字符添加到字段中值的左右两侧。 Pad if Null—指定当字段具有空值时是否添加填充字符。 Allow Null Values—指定字段是否支持空值。	Value Table

派生输出

名称	说明	数据类型
out_feature_class	更新的网络要素图层。	Feature Layer

代码示例

ModifyRouteIdPadding 示例 1（Python 窗口）

演示了如何在 Python 窗口中使用 ModifyRouteIdPadding 工具。

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