Ajouter une valeur conditionnelle (Gestion des données)

Résumé

Ajoute une valeur conditionnelle à un groupe de champs sur une classe d'entités ou dans une table.

En savoir plus sur les valeurs contingentes

Utilisation

• Un ou plusieurs groupes de champs doivent avoir été créés pour le jeu de données pour qu’une valeur conditionnelle puisse être ajoutée. L’outil Créer un groupe de champs peut être utilisé pour créer un groupe de champs.

• Si la classe d'entités ou la table en entrée contient des sous-types et que vous souhaitez ajouter la valeur conditionnelle à plusieurs sous-types, cet outil doit être exécuté une fois par sous-type. Aucune option ne permet de l’ajouter simultanément à tous les sous-types.

• Si vos données sont conservées dans une géodatabase d’entreprise, vous devez être connecté comme propriétaire des données pour pouvoir utiliser cet outil.

• Les valeurs conditionnelles sont compatibles avec ArcGIS Pro 2.3 et les géodatabases ultérieures. Si votre géodatabase provient d’une version antérieure, mettez à niveau votre géodatabase pour qu’elle accepte les valeurs conditionnelles.

• Une fois un groupe de champs ajouté à un jeu de données, la version du jeu de données est définie sur ArcGIS Pro 2.3. Le jeu de données ne peut donc plus être utilisé dans ArcMap.

Syntaxe

arcpy.management.AddContingentValue(target_table, field_group_name, values, {subtype}, {retire_value})

Paramètre	Explication	Type de données
target_table	Table ou classe d'entités de la géodatabase en entrée à laquelle la valeur conditionnelle doit être ajoutée.	Table View
field_group_name	Groupe de champ auquel la valeur conditionnelle doit être ajoutée.	String
values [[Field Name, Field Value Type, Field Value],...]	Nom de champ, type de valeur de champ et valeurs de champ associées à utiliser pour la nouvelle valeur d’attribut conditionnelle. Field Name : nom du champ qui participe au groupe de champs Field Value Type : type de valeur conditionnelle. Les types ANY et NULL ignorent toute valeur spécifiée dans le paramètre Field Value. ANY : la valeur peut correspondre à toute valeur de champ. NULL : la valeur est nulle. CODED_VALUE : la valeur provient d’un domaine de valeurs précodées. RANGE : la valeur correspond à un sous-ensemble minimal/maximal d’un domaine par plage. Field Value (Valeur de champ) : valeur de champ spécifique. Si le Field Value Type est CODED_VALUE, spécifiez la description du code. Si le Field Value Type est RANGE, spécifiez les valeurs minimale et maximale au format min;max (par exemple, 10;100).	Value Table
subtype (Facultatif)	Sous-type de la table en entrée auquel la valeur conditionnelle doit être ajoutée.	String
retire_value (Facultatif)	Indique si la valeur conditionnelle doit être retirée. La valeur conditionnelle est considérée comme retirée lorsqu’elle n’est plus créée, mais qu’elle peut toujours être utilisée dans un champ existant. Lorsqu’une valeur conditionnelle est retirée, elle apparaît toujours dans la liste des valeurs valides d’un champ, comme dans la fenêtre Attribute (Attribut), mais elle désactivée et ne peut pas être sélectionnée comme valeur de champ. C’est notamment le cas pour l’utilisation de l’amiante comme matériau de construction. Une nouvelle construction ne peut pas utiliser d’amiante comme matériau de construction, mais les structures existantes peuvent toujours posséder cet attribut. RETIRE —La valeur conditionnelle doit être retirée. DO_NOT_RETIRE —La valeur conditionnelle n’est pas retirée. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_table	Entrée mise à jour avec une valeur conditionnelle ajoutée.	Vue tabulaire, couche raster, couche de mosaïque

Exemple de code

Exemple d’utilisation de l’outil AddContingentValue (fenêtre Python)

Ajoutez une nouvelle valeur conditionnelle pour laquelle un domaine de valeurs précodées est affecté au champ.

import arcpy
CV = "FieldName1 CODED_VALUE DomainValue1; FieldName2 CODED_VALUE DomainValue2"
arcpy.AddContingentValue_management("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup",	CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

Environnements

Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui