Изменить заполнение ID маршрута (Location Referencing)

Доступно с лицензией Location Referencing.

Краткая информация

Изменяет свойства заполнения, пустых значений и длины для полей, являющихся частью ID маршрута с несколькими полями.

На примере изображения ниже ID маршрута настраивается с помощью трех полей: RouteType, RouteNumber и RampNumber. Примеры настроек заполнения и пустых значений для трех полей показаны ниже:

• RouteType текстовое поле длиной 3. Максимальное количество вводимых символов — три; однако для некоторых маршрутов в это поле может быть введен один или два символа. Дефис используется как символ заполнения справа.
• RouteNumber короткий целочисленный тип поля. Значения поля варьируются от 0 до 99999. Ноль (0) используется как символ заполнения слева.
• RampNumber текстовое поле длиной 7; однако для некоторых маршрутов это поле не будет иметь значения, и его нужно оставить пустым. Символ подчеркивания используется как символ заполнения слева и справа.

Иллюстрация

Использование

• Каждое поле в идентификаторе маршрута может иметь укороченную максимальную длину; быть переменной или фиксированной длины; иметь добавленные символы заполнения слева, справа или как слева, так и справа, а также иметь добавленные заполнения в пустое поле. Кроме того, для одного или нескольких полей объединенного идентификатора маршрута можно использовать пустое значение.

• Идентификатор маршрута для каждой записи будет хранится с включенным заполнением и нулевыми значениями. Каждое отдельное поле, используемое как часть объединенного идентификатора маршрута, будет храниться без каких-либо символов заполнения.

• Настройки заполнения и пустоты можно изменить после создания сети. Любые маршруты, загруженные и созданные до изменения этих настроек, сохраняются в базе данных как есть. Любой маршрут, загруженный и созданный после изменения настроек, использует эти обновленные настройки при сохранении в базе данных.

• Изменение длины изменяет только максимальное количество символов, которое ожидается в ArcGIS Roads and Highways для каждого поля как часть маршрута в сети. Данные по-прежнему должны быть смоделированы в вашей базе геоданных с длиной поля идентификатора маршрута, представляющей собой сумму длин полей, составляющих объединенный идентификатор маршрута.

• Опция заполнения Разрешить значения Null должна быть включена, если включен параметр Заполнить, если Null.

• Если для поля разрешены значения null, все поля справа от этого поля также должны допускать значения null.

• Знак номера (#) не поддерживается в качестве заполняющего символа.

Параметры

Диалог

Подпись	Описание	Тип данных
Класс объектов сети LRS	Входной слой сети идентификатора маршрута с несколькими полями, содержащий поля, которые необходимо изменить, используя заполнения, пустые значения и длину поля.	Feature Layer
Заполнение ID маршрута	Таблица значений, указывающая поле, которое нужно изменить, и соответствующие значения заполнения, пустых значений и длин. 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	Входной слой сети идентификатора маршрута с несколькими полями, содержащий поля, которые необходимо изменить, используя заполнения, пустые значения и длину поля.	Feature Layer
route_id_padding [route_id_padding,...]	Таблица значений, указывающая поле, которое нужно изменить, и соответствующие значения заполнения, пустых значений и длин. 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)