Modifier le remplissage d’ID d’itinéraire (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Modifie les propriétés de remplissage, de valeur nulle et de longueur des champs qui font partie d’un ID d’itinéraire à champs multiples.

Un ID d’itinéraire est configuré avec trois champs : RouteType, RouteNumber et RampNumber. Des paramètres d’exemple de remplissage et de valeur nulle pour les trois champs sont indiqués ci-dessous.

  • RouteType est un champ de texte avec une longueur de 3. Le nombre maximal de caractères qui seront saisis est de trois. Toutefois, il peut arriver qu’un ou deux caractères soient saisis dans ce champ pour certains itinéraires. Un tiret sert de caractère de remplissage sur la droite.
  • RouteNumber est un type de champ court. Les valeurs du champ seront comprises entre 0 et 99999 ; 0 sert de caractère de remplissage sur la gauche.
  • RampNumber est un champ de texte d’une longueur de 7. Toutefois, certains itinéraires n’auront aucune valeur pour ce champ qui doit être laissé vierge. Un trait de soulignement sert de caractère de remplissage sur la gauche et la droite.

Illustration

Entrée et sortie d’exemple pour le remplissage d’ID d’itinéraire

Utilisation

  • Dans l’ID d’itinéraire, la longueur maximale de chaque champ peut être raccourcie, chaque champ peut être de longueur variable ou fixe, des caractères de remplissage peuvent être ajoutés à droite, à gauche ou à la fois à gauche et à droite de chaque champ et un remplissage peut être ajouté à un champ vide. En outre, une valeur nulle peut être utilisée pour un ou plusieurs des champs dans un ID d’itinéraire concaténé.
  • L’ID d’itinéraire de chaque enregistrement sera stocké avec le remplissage et les valeurs nulles. Chaque champ utilisé dans le cadre de l’ID d’itinéraire concaténé sera stocké sans caractère de remplissage.

  • Les paramètres de remplissage et des valeurs nulles peuvent être modifiés une fois le réseau créé. Les itinéraires chargés et créés avant la modification de ces paramètres restent enregistrés tels quels dans la base de données Un itinéraire chargé et créé après la modification des paramètres utilise ces paramètres mis à jour pour l’enregistrement dans la base de données.

  • Le changement de longueur modifie uniquement le nombre maximal de caractères attendu par ArcGIS Roads and Highways pour chaque champ dans le cadre d’un itinéraire du réseau. Vos données doivent toujours être modélisées dans votre géodatabase avec la longueur du champ d’ID d’itinéraire correspondant à la somme des longueurs des champs qui composent l’ID d’itinéraire concaténé.

  • La case Autoriser les valeurs nulles doit être cochée si la case Remplir si nul a été cochée.

  • Si vous autorisez les valeurs nulles dans un champ, tous les champs situés à droite de ce champ doivent également autoriser les valeurs nulles. Cependant, si la case Remplir si aucune valeur fournie est cochée, les champs situés à droite de ce champ n’ont pas besoin d’autoriser les valeurs nulles.

  • Le signe dièse (#) n’est pas pris en charge comme caractère de remplissage.

Paramètres

ÉtiquetteExplicationType de données
Classe d’entités de réseau LRS

Couche de réseau d’ID d’itinéraire à champs multiples qui contient des champs pour les valeurs de remplissage, nulles et de longueur à modifier.

Feature Layer
Remplissage d’ID d’itinéraire

Table de valeurs qui indique le champ à modifier et ses valeurs de remplissage, nulles et de longueur correspondantes.

  • FieldChamp à modifier.
  • LengthValeur de longueur du champ à modifier. La longueur de champ doit être comprise entre 1 et la longueur du champ de base de données.
  • Variable LengthIndique si la valeur Longueur est une valeur variable ou fixe.
  • Enable PaddingIndique si le champ prend en charge le remplissage.
  • Padding CharacterCaractère de remplissage du champ. La valeur par défaut est un espace.
  • Padding LocationIndique où appliquer le remplissage à la valeur de champ.
    • Gauche : ajoute les caractères de remplissage à gauche de la valeur dans le champ. Il s’agit de l’option par défaut.
    • Droite : ajoute les caractères de remplissage à droite de la valeur dans le champ.
    • Gauche et droite : ajoute les caractères de remplissage à gauche et à droite de la valeur dans le champ.
  • Pad if NullIndique si les caractères de remplissage sont ajoutés lorsque le champ a une valeur nulle.
  • Allow Null ValuesIndique si le champ prend en charge les valeurs nulles.
Value Table

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités de réseau en sortie

Couche d’entités de réseau mise à jour.

Feature Layer

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)
NomExplicationType de données
in_feature_class

Couche de réseau d’ID d’itinéraire à champs multiples qui contient des champs pour les valeurs de remplissage, nulles et de longueur à modifier.

Feature Layer
route_id_padding
[route_id_padding,...]

Table de valeurs qui indique le champ à modifier et ses valeurs de remplissage, nulles et de longueur correspondantes.

  • FieldChamp à modifier.
  • LengthValeur de longueur du champ à modifier. La longueur de champ doit être comprise entre 1 et la longueur du champ de base de données.
  • Variable LengthIndique si la valeur Longueur est une valeur variable ou fixe.
  • Enable PaddingIndique si le champ prend en charge le remplissage.
  • Padding CharacterCaractère de remplissage du champ. La valeur par défaut est un espace.
  • Padding LocationIndique où appliquer le remplissage à la valeur de champ.
    • Gauche : ajoute les caractères de remplissage à gauche de la valeur dans le champ. Il s’agit de l’option par défaut.
    • Droite : ajoute les caractères de remplissage à droite de la valeur dans le champ.
    • Gauche et droite : ajoute les caractères de remplissage à gauche et à droite de la valeur dans le champ.
  • Pad if NullIndique si les caractères de remplissage sont ajoutés lorsque le champ a une valeur nulle.
  • Allow Null ValuesIndique si le champ prend en charge les valeurs nulles.
Value Table

Sortie obtenue

NomExplicationType de données
out_feature_class

Couche d’entités de réseau mise à jour.

Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction ModifyRouteIdPadding (fenêtre Python)

Illustre l’utilisation de l’outil ModifyRouteIdPadding dans la fenêtre 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)
Exemple 2 d’utilisation de la fonction ModifyRouteIdPadding (script autonome)

Illustre l’utilisation de l’outil de géotraitement ModifyRouteIdPadding en tant que script Python autonome.

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

Informations de licence

  • Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)

Rubriques connexes