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.

Se configura un Id. de ruta con tres campos: RouteType, RouteNumber y RampNumber. A continuación se muestra 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 introducirán 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 varían entre 0 y 99999; 0 se utiliza 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 deben dejarse en blanco. Se utiliza un guion bajo como carácter de relleno a la izquierda y a la derecha.

Ilustración

Ejemplo de entrada y salida para relleno de Id. de ruta

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 utiliza 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 ArcGIS Roads and Highways espera para cada campo como parte de una ruta en la red. Sus 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 casilla de verificación Permitir valores nulos debe estar activada si se ha activado la casilla de verificación 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. Sin embargo, si la casilla de verificación Rellenar si no se proporciona valor está activada, los campos situados a la derecha no tienen que permitir valores nulos.

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

Parámetros

EtiquetaExplicaciónTipo 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.

  • FieldEl campo que se va a modificar.
  • LengthEl 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 LengthEspecifica si el valor de Longitud es un valor de variable o un valor fijo.
  • Enable PaddingEspecifica si el campo admite relleno.
  • Padding CharacterEl carácter de relleno del campo. El valor predeterminado es un espacio.
  • Padding LocationEspecifica dónde se debe aplicar el relleno al valor de campo.
    • Izquierda: agrega los caracteres de relleno a la izquierda del valor en el campo. Esta es la opción predeterminada.
    • Derecha: agrega los caracteres de relleno a la derecha del valor en el campo.
    • Izquierda y derecha: agrega los caracteres de relleno a la izquierda y a la derecha del valor en el campo.
  • Pad if NullEspecifica si los caracteres de relleno se agregan cuando el campo tiene un valor nulo.
  • Allow Null ValuesEspecifica si el campo admite valores nulos.
Value Table

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de red de salida

La capa de entidad de red actualizada.

Feature Layer

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)
NombreExplicaciónTipo 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.

  • FieldEl campo que se va a modificar.
  • LengthEl 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 LengthEspecifica si el valor de Longitud es un valor de variable o un valor fijo.
  • Enable PaddingEspecifica si el campo admite relleno.
  • Padding CharacterEl carácter de relleno del campo. El valor predeterminado es un espacio.
  • Padding LocationEspecifica dónde se debe aplicar el relleno al valor de campo.
    • Izquierda: agrega los caracteres de relleno a la izquierda del valor en el campo. Esta es la opción predeterminada.
    • Derecha: agrega los caracteres de relleno a la derecha del valor en el campo.
    • Izquierda y derecha: agrega los caracteres de relleno a la izquierda y a la derecha del valor en el campo.
  • Pad if NullEspecifica si los caracteres de relleno se agregan cuando el campo tiene un valor nulo.
  • Allow Null ValuesEspecifica si el campo admite valores nulos.
Value Table

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

La capa de entidad de red actualizada.

Feature Layer

Muestra de código

Ejemplo de ModifyRouteIdPadding 1 (ventana de Python)

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

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo ModifyRouteIdPadding 2 (script independiente)

Demuestra cómo utilizar la herramienta ModifyRouteIdPadding como un script independiente de 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')

Información de licenciamiento

  • Basic: Requiere ArcGIS Location Referencing
  • Standard: Requiere ArcGIS Location Referencing
  • Advanced: Requiere ArcGIS Location Referencing

Temas relacionados