Modificar relleno de Id. de ruta (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Modifica las propiedades de relleno, nulas y de longitud para los campos que forman parte de un Id. de ruta de varios campos.

En el ejemplo de imagen siguiente, un Id. de ruta se configura con tres campos: RouteType, RouteNumber y RampNumber. Esta es la configuración de relleno de muestra y nulo para los tres campos:

• RouteType es un campo de texto con una longitud de 3. El número máximo de caracteres que se pueden introducir es tres; sin embargo, algunas rutas pueden tener uno o dos caracteres introducidos para este campo. Se utiliza un guion como carácter de relleno a la derecha.
• RouteNumber es un tipo de campo corto. El campo tendrá valores que oscilarán entre 0 y 99999. Se utiliza un cero (0) como carácter de relleno a la izquierda.
• RampNumber es un campo de texto con una longitud de 7; sin embargo, algunas rutas no tendrán un valor para este campo y debe dejarse en blanco. Se utiliza un guion bajo como carácter de relleno a la izquierda y a la derecha.

Ilustración

Uso

• La longitud máxima de cada campo del Id. de ruta puede acortarse, ser de longitud variable o fija, o tener caracteres de relleno agregados a la izquierda, a la derecha o a ambos lados, así como tener relleno agregado a un campo vacío. Además, se puede utilizar un valor nulo para uno o más de los campos de un Id. de ruta concatenado.

• El Id. de ruta de cada registro se almacenará con el relleno y los valores nulos incluidos. Cada campo individual utilizado como parte del Id. de ruta concatenado se almacenará sin ningún carácter de relleno.

• La configuración de relleno y nulo se puede cambiar una vez creada la red. Cualquier ruta cargada y creada antes de cambiar esta configuración permanece guardada tal cual en la base de datos. Cualquier ruta cargada y creada después de cambiar la configuración utilizará esta configuración actualizada al guardar en la base de datos.

• Al cambiar la longitud solo se cambia el número máximo de caracteres que se esperan en ArcGIS Roads and Highways para cada campo como parte de una ruta en la red. Los datos deben seguir siendo modelados en la geodatabase con la longitud del campo Id. de ruta representando la suma de las longitudes de los campos que componen el Id. de ruta concatenado.

• La opción de relleno Permitir valores nulos debe estar activada si también lo está la opción de relleno Rellenar si es nulo.

• Si permite valores nulos en un campo, todos los campos a la derecha de ese campo también deben permitir valores nulos.

• No se admite un signo de número (#) como carácter de relleno.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red LRS	La capa de red de Id. de ruta de varios campos de entrada que contiene campos para valores de relleno, nulos y longitud que se deben modificar.	Feature Layer
Relleno de Id. de ruta	Una tabla de valores que especifica el campo que se va a modificar y sus valores de relleno, nulos y longitud correspondientes. Field—El campo que se va a modificar. Length—El valor de longitud del campo que se va a modificar. La longitud del campo debe estar entre 1 y la longitud del campo de base de datos. Variable Length—Especifica si el valor de Longitud es un valor de variable o un valor fijo. Enable Padding—Especifica si el campo admite relleno. Padding Character—El carácter de relleno del campo. El valor predeterminado es un espacio. Padding Location—Especifica dónde se aplicará el relleno al valor de campo. Izquierda: los caracteres de relleno se agregarán a la izquierda del valor en el campo. Esta es la opción predeterminada. Derecha: los caracteres de relleno se agregarán a la derecha del valor en el campo. Izquierda y derecha: los caracteres de relleno se agregarán a la izquierda y a la derecha del valor en el campo. Pad if Null—Especifica si se agregarán caracteres de relleno cuando el campo tenga un valor nulo. Allow Null Values—Especifica si el campo admite valores nulos.	Value Table

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red de salida	La capa de entidad de red actualizada.	Feature Layer

Python

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)

Nombre	Explicación	Tipo de datos
in_feature_class	La capa de red de Id. de ruta de varios campos de entrada que contiene campos para valores de relleno, nulos y longitud que se deben modificar.	Feature Layer
route_id_padding [route_id_padding,...]	Una tabla de valores que especifica el campo que se va a modificar y sus valores de relleno, nulos y longitud correspondientes. Field—El campo que se va a modificar. Length—El valor de longitud del campo que se va a modificar. La longitud del campo debe estar entre 1 y la longitud del campo de base de datos. Variable Length—Especifica si el valor de Longitud es un valor de variable o un valor fijo. Enable Padding—Especifica si el campo admite relleno. Padding Character—El carácter de relleno del campo. El valor predeterminado es un espacio. Padding Location—Especifica dónde se aplicará el relleno al valor de campo. Izquierda: los caracteres de relleno se agregarán a la izquierda del valor en el campo. Esta es la opción predeterminada. Derecha: los caracteres de relleno se agregarán a la derecha del valor en el campo. Izquierda y derecha: los caracteres de relleno se agregarán a la izquierda y a la derecha del valor en el campo. Pad if Null—Especifica si se agregarán caracteres de relleno cuando el campo tenga un valor nulo. Allow Null Values—Especifica si el campo admite valores nulos.	Value Table

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	La capa de entidad de red actualizada.	Feature Layer

Muestra de código

Ejemplo 1 de ModifyRouteIdPadding (ventana de Python)

Este ejemplo muestra cómo usar la herramienta ModifyRouteIdPadding en la ventana de 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)

Ejemplo ModifyRouteIdPadding 2 (script independiente)

Este ejemplo muestra cómo usar la herramienta ModifyRouteIdPadding en una secuencia de comandos de Python independiente.

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)