Générer une règle attributaire de mise à jour associée (Gestion des données)

Synthèse

Génère une règle attributaire qui met à jour les enregistrements associés dans d’autres classes lorsque les mises à jour sont effectuées dans une table en entrée. Il peut s’agir d’associations de réseau de distribution, de classes de relations, de champs d’appariement et de relations spatiales.

Utilisation

• Une fois l’outil exécuté, importez la règle attributaire et appliquez-la au jeu de données. Si le jeu de données se trouve dans une géodatabase d’entreprise, vous devez être le propriétaire des données pour appliquer la règle attributaire du modèle en sortie.

  En savoir plus sur l’importation des règles attributaires

• Si la valeur du paramètre Table en entrée ou la valeur Couche cible du paramètre Options de recherche n’est pas une table ou une classe de réseau de distribution, la valeur de Type de recherche ne peut pas être un type d’association de réseau de distribution.

• Si la valeur du paramètre Table en entrée ou la valeur Couche cible du paramètre Options de recherche est une table, la valeur de Type de recherche ne peut pas être Spatial uniquement.

• Si la valeur du paramètre Table en entrée et la valeur Couche cible du paramètre Options de recherche ne participent pas à une classe de relations l’une avec l’autre, la valeur de Type de recherche ne peut pas être Classe de relations.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	La table ou classe d'entités à laquelle sera appliquée la nouvelle règle.	Table View
Dossier en sortie	Dossier dans lequel la sortie est enregistrée.	Folder
Options de recherche	Met à jour une valeur associée dans la couche cible, à l’aide d’une association de réseau de distribution, d’une classe de relations, de champs d’appariement ou d’une relation spatiale entre la classe en entrée et les classes cibles. Les composants des options de recherche sont les suivantes : Couche cible : couche à laquelle l’option de recherche est appliquée. Champ cible : champ de la couche cible mis à jour par la règle attributaire. Type de recherche : type de recherche appliqué à la table en entrée et à la table cible. Champ ou valeur en entrée : champ ou valeur mis à jour dans la classe en entrée. Opérateur : méthode utilisée pour relier les champs cibles et les champs en entrée. Distance de recherche : distance maximale d’une entité cible à partir d’une entité en entrée. Seules les entités se trouvant dans cette distance sont mises à jour. Champ d’appariement cible : champ de clé étrangère de la classe cible qui effectue la liaison avec la valeur de Champ d’appariement en entrée dans la classe en entrée. Champ d’appariement en entrée : champ de clé primaire de la classe source qui effectue la liaison avec la valeur de Champ d’appariement cible dans la classe cible. Les options Type de recherche sont les suivantes : Classe de relations : valeur associée dans la classe cible mise à jour à l’aide d’une classe de relations entre la classe en entrée et les classes cibles. Champs d’appariement : un champ des classes cibles est mis à jour en fonction des mises à jour apportées à un champ dans la classe en entrée (relation de clé primaire ou étrangère). Spatial uniquement : champ de la couche cible mis à jour en fonction de l’intersection entre les entités de la classe en entrée et des classes en sortie. Connecté (association de réseau de distribution) : les entités connectées à l’entité spécifiée via une association de connectivité sont renvoyées. Conteneur (association de réseau de distribution) : les entités contenant l’entité spécifiée via une association d’inclusion sont renvoyées. Contenu (association de réseau de distribution) : les entités contenant l’entité spécifiée via une association d’inclusion sont renvoyées. Structure (association de réseau de distribution) : l’entité à laquelle l’entité spécifiée est jointe via une association de dépendances structurelles est renvoyée. Joint (association de réseau de distribution) : les entités jointes à l’entité spécifiée via une association de dépendances structurelles est renvoyée. Jonction-tronçon (association de réseau de distribution) : les entités connectées à l’entité spécifiée par le biais d’une association de connectivité jonction-tronçon seront renvoyées. Mi-portée (association de réseau de distribution) : les entités connectées à l’entité spécifiée par le biais d’une association de connectivité jonction-tronçon à mi-portée seront renvoyées. Les options Opérateur sont les suivantes : Définir la valeur : la valeur du champ cible est mise à jour avec la valeur du champ en entrée. Concaténer : la valeur existante du champ cible est mise à jour par concaténation avec la valeur du champ source. Par défaut, les valeurs sont concaténées avec un trait d’union (-). Ou bit à bit : une opération bit à bit est effectuée sur la valeur existante du champ cible avec la valeur entrante du champ source. Les champs source et cible doivent être de type numérique.	Value Table
Expression	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression

Sortie obtenue

Étiquette	Explication	Type de données
Fichier CSV en sortie	Fichier .csv en sortie contenant la règle attributaire du modèle.	File

Python

arcpy.management.GenerateUpdateRelatedAttributeRule(in_table, out_folder, search_options, where_clause)

Nom	Explication	Type de données
in_table	La table ou classe d'entités à laquelle sera appliquée la nouvelle règle.	Table View
out_folder	Dossier dans lequel la sortie est enregistrée.	Folder
search_options [search_options,...]	Met à jour une valeur associée dans la couche cible, à l’aide d’une association de réseau de distribution, d’une classe de relations, de champs d’appariement ou d’une relation spatiale entre la classe en entrée et les classes cibles. Les composants des options de recherche sont les suivantes : Couche cible : couche à laquelle l’option de recherche est appliquée. Champ cible : champ de la couche cible mis à jour par la règle attributaire. Type de recherche : type de recherche appliqué à la table en entrée et à la table cible. Champ ou valeur en entrée : champ ou valeur mis à jour dans la classe en entrée. Opérateur : méthode utilisée pour relier les champs cibles et les champs en entrée. Distance de recherche : distance maximale d’une entité cible à partir d’une entité en entrée. Seules les entités se trouvant dans cette distance sont mises à jour. Champ d’appariement cible : champ de clé étrangère de la classe cible qui effectue la liaison avec la valeur de Champ d’appariement en entrée dans la classe en entrée. Champ d’appariement en entrée : champ de clé primaire de la classe source qui effectue la liaison avec la valeur de Champ d’appariement cible dans la classe cible. Les options Type de recherche sont les suivantes : RELATIONSHIP_CLASS : valeur associée dans la classe cible mise à jour à l’aide d’une classe de relations entre la classe en entrée et les classes cibles. MATCH_FIELDS : un champ des classes cibles est mis à jour en fonction des mises à jour apportées à un champ dans la classe en entrée (relation de clé primaire ou étrangère). SPATIAL_ONLY : champ de la couche cible mis à jour en fonction de l’intersection entre les entités de la classe en entrée et des classes en sortie. UN_CONNECTED : les entités connectées à l’entité spécifiée via une association de connectivité sont renvoyées. UN_CONTAINER : les entités contenant l’entité spécifiée via une association d’inclusion sont renvoyées. UN_CONTENT : les entités contenant l’entité spécifiée via une association d’inclusion sont renvoyées. UN_STRUCTURE : l’entité à laquelle l’entité spécifiée est jointe via une association de dépendances structurelles est renvoyée. UN_ATTACHED : les entités jointes à l’entité spécifiée via une association de dépendances structurelles est renvoyée. UN_JUNCTION_EDGE : les entités connectées à l’entité spécifiée par le biais d’une association de connectivité jonction-tronçon seront renvoyées. UN_MIDSPAN : les entités connectées à l’entité spécifiée par le biais d’une association de connectivité jonction-tronçon à mi-portée seront renvoyées. Les options Opérateur sont les suivantes : SET_VALUE : la valeur du champ cible est mise à jour avec la valeur du champ en entrée. CONCATENATE : la valeur existante du champ cible est mise à jour par concaténation avec la valeur du champ source. Par défaut, les valeurs sont concaténées avec un trait d’union (-). BITWISE_OR : une opération bit à bit est effectuée sur la valeur existante du champ cible avec la valeur entrante du champ source. Les champs source et cible doivent être de type numérique.	Value Table
where_clause	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression

Sortie obtenue

Nom	Explication	Type de données
out_rule_csv	Fichier .csv en sortie contenant la règle attributaire du modèle.	File

Exemple de code

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

L’exemple suivant illustre l’utilisation de la fonction GenerateUpdateRelatedAttributeRule.

import arcpy
arcpy.management.GenerateUpdateRelatedAttributeRule(
    in_table="A_Table",
    out_folder=r"C:/project/path/to/folder",
    search_options="Test Field 'Match Fields' Field 'Set Value' '20 Feet' Field_1 Field_1"
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.