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.

Paramètres

ÉtiquetteExplicationType de données
Table cible

Table ou classe d'entités de la géodatabase en entrée à laquelle la valeur conditionnelle doit être ajoutée.

Table View
Nom du groupe de champs

Groupe de champ auquel la valeur conditionnelle doit être ajoutée.

String
Valeurs

Nom de champ, type de valeur de champ et valeurs de champ associées à utiliser pour la nouvelle valeur conditionnelle.

  • Nom de champ : nom du champ qui participe au groupe de champs
  • Type de valeur de champ : type de valeur conditionnelle. Les types Any (Tout membre de l’équipe) et Null (Null) ignorent toute valeur spécifiée dans le champ Field Value (Valeur de champ).
    • Any (Tout membre de l’équipe) : la valeur peut correspondre à toute valeur de champ.
    • Null (Null) : la valeur est nulle.
    • Coded Value (Valeur codée) : la valeur provient d’un domaine de valeurs précodées.
    • Range (Plage) : 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 type de valeur de champ est Coded Value (Valeur codée), spécifiez la description du code. Si le type de valeur de champ est Range (Plage), spécifiez les valeurs minimale et maximale au format min;max (par exemple, 10;100).

Value Table
Sous-type
(Facultatif)

Sous-type de la table en entrée auquel la valeur conditionnelle doit être ajoutée.

String
Retirer la valeur
(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 est inactive 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.

  • Activé : la valeur conditionnelle doit être retirée.
  • Désactivé : la valeur conditionnelle n’est pas retirée. Il s’agit de l’option par défaut.

Boolean

Sortie dérivée

ÉtiquetteExplicationType de données
Classe d'entités en sortie

Entrée mise à jour avec une valeur conditionnelle ajoutée.

Vue tabulaire, couche raster, couche de mosaïque

arcpy.management.AddContingentValue(target_table, field_group_name, values, {subtype}, {retire_value})
NomExplicationType 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.

  • RETIRELa valeur conditionnelle doit être retirée.
  • DO_NOT_RETIRELa valeur conditionnelle n’est pas retirée. Il s’agit de l’option par défaut.
Boolean

Sortie dérivée

NomExplicationType 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")

Informations de licence

  • Basic: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes