Configurer la table de correspondance (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Configure une table de correspondance pour un ou plusieurs champs utilisés dans un ID d’itinéraire à champs multiples.

Cet outil peut être exécuté après l’outil Créer un réseau LRS à partir d’un jeu de données existant ou Modifier le réseau LRS pour un ID d’itinéraire à champs multiples.

En savoir plus sur la création du LRS, des réseaux et des événements

Une table de correspondance constitue une alternative à l’utilisation de domaines de valeurs précodées lorsqu’un champ comprenant plusieurs ID d’itinéraire de champs multiples possède plusieurs centaines ou plusieurs milliers de valeurs potentielles. Il peut s’agir par exemple d’une liste de noms de rue ou d’un code GNIS (Système d'information des noms géographiques). La table de correspondance est utilisée principalement lors de la création d’un itinéraire.

Utilisation

  • La table de correspondance peut être configurée avec à la fois les champs des paramètres Clé de correspondance et Affichage de correspondance, ce qui permet à l’utilisateur de rechercher une valeur de clé à l’aide de sa valeur d’affichage :

    • Le champ Lookup Key est la valeur qui sera enregistrée pour le champ dans l’ID d’itinéraire à champs multiples.
    • Le champ Lookup Display est la valeur qui apparaît dans la zone de texte pour l’ID d’itinéraire à champs multiples.

  • Le menu déroulant du paramètre Champ appliqué à affiche uniquement les champs qui font partie d’un ID d’itinéraire à champs multiples pour la valeur Classe d’entités de réseau LRS choisie.

    Remarque :

    La valeur du paramètre Clé de correspondance est enregistrée dans la géodatabase à la fois en tant que champ et dans le cadre d’un ID d’itinéraire à champs multiples.

    Les champs Lookup Key et Lookup Display peuvent être identiques ou différents dans la table de correspondance.

    Le menu déroulant du paramètre Clé de recherche affiche uniquement les champs de la table de correspondance qui ont le même type de champ et une longueur inférieure ou égale au champ d’itinéraire sélectionné dans le menu déroulant du paramètre Champ appliqué à.

  • La valeur du paramètre Affichage de correspondance est facultative. Si vous voulez autoriser une valeur qui ne figure pas dans la table de correspondance, vous ne pouvez pas configurer le paramètre Affichage de correspondance.

  • Location Referencing lit uniquement la table de correspondance ; il n’ajoute pas d’enregistrements à la table. Si la valeur souhaitée n’est pas présente, vous pouvez l’ajouter dans la table de correspondance avec cet outil.

  • Si le remplissage est configuré pour le champ, il est ajouté si la valeur du champ Lookup Key est inférieure à la longueur du champ.

  • Une seule table de correspondance peut être configurée par réseau LRS.

  • Si la table de correspondance se trouve dans une géodatabase multi-utilisateurs, elle doit être non versionnée.

Paramètres

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

Classe d’entités de réseau LRS en entrée dans laquelle la table de correspondance sera configurée. Le réseau doit avoir un ID d’itinéraire à champs multiples.

Feature Layer
Table de correspondance

Table contenant une liste de noms de rue et leurs codes GNIS correspondants. Cette table peut être autonome ou résider dans un SDE.

Table View
Champ appliqué à

Champ d’ID d’itinéraire du réseau LRS dans lequel le paramètre Table de correspondance sera configuré.

String
Clé de correspondance

Champ de clé dans le paramètre Table de correspondance.

String
Affichage de correspondance
(Facultatif)

Champ de description de la Table de correspondance. Ce champ apparaît dans la zone de texte pour l’ID d’itinéraire à champs multiples.

String
Autoriser une valeur de correspondance
(Facultatif)

Indique si une valeur qui ne figure pas dans la table de correspondance peut être ajoutée. Le paramètre Affichage de correspondance ne peut pas être configuré lorsque cette option est sélectionnée.

  • Activé : une valeur peut être configurée si aucune n’est présente dans la table.
  • Désactivé : aucune valeur d’affichage de correspondance ne peut être configurée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

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

Classe d’entités de réseau d’itinéraire mise à jour avec le paramètre Table de correspondance configuré.

Feature Layer

arcpy.locref.ConfigureLookupTable(in_feature_class, lookup_table, field_applied_to, lookup_key, {lookup_display}, {allow_any_lookup_value})
NomExplicationType de données
in_feature_class

Classe d’entités de réseau LRS en entrée dans laquelle la table de correspondance sera configurée. Le réseau doit avoir un ID d’itinéraire à champs multiples.

Feature Layer
lookup_table

Table contenant une liste de noms de rue et leurs codes GNIS correspondants. Cette table peut être autonome ou résider dans un SDE.

Table View
field_applied_to

Champ d’ID d’itinéraire du réseau LRS dans lequel le paramètre lookup_table sera configuré.

String
lookup_key

Champ de clé dans le paramètre lookup_table.

String
lookup_display
(Facultatif)

Champ de description lookup_table. Ce champ apparaît dans la zone de texte pour l’ID d’itinéraire à champs multiples.

String
allow_any_lookup_value
(Facultatif)

Indique si une valeur qui ne figure pas dans la table de correspondance peut être ajoutée. Le paramètre lookup_display ne peut pas être configuré lorsque cette option est sélectionnée.

  • DO_NOT_ALLOW_ANY_VALUEUne valeur peut être configurée si aucune n’est présente dans la table.
  • ALLOW_ANY_VALUEAucune valeur d’affichage de correspondance ne peut être configurée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_feature_class

Classe d’entités de réseau d’itinéraire mise à jour avec le paramètre Table de correspondance configuré.

Feature Layer

Exemple de code

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

Illustre l’utilisation de l’outil ConfigureLookupTable dans la fenêtre Python.

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table outside of database.
# Requires: ArcGIS Location Referencing

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

# Tool variables
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\Data\cityCodeLookup.dbf"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 2 d’utilisation de la fonction ConfigureLookupTable (script autonome)

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

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table present in the same database.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set LRS network and table
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\RH_Data.gdb\cityCodeLookup"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

print("Table configured successfully")

# 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