Ajouter une valeur conditionnelle (Gestion des données)

Synthèse

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

En savoir plus sur les valeurs conditionnelles

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, vous devez exécuter cet outil une fois par sous-type. Vous ne pouvez pas 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 la géodatabase provient d’une version antérieure, mettez-la à niveau 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 qui est utilisée 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 Tout membre de l’équipe et Null ignorent toute valeur spécifiée dans le champ 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.
    • Plage : la valeur correspond à un sous-ensemble minimal/maximal d’un domaine par plage.
  • Valeur de champ : valeur de champ spécifique. Si Type de valeur de champ a pour valeur Valeur codée, spécifiez le code. Si Type de valeur de champ a pour valeur 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 Attribut. 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. Pour plus d’informations sur les valeurs retirées, reportez-vous à la rubrique Créer et gérer des valeurs conditionnelles.

  • 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 obtenue

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

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

Table View; Raster Layer; Mosaic Layer

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 qui est utilisée 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 et NULL ignorent toute valeur spécifiée dans le champ de valeur de champ.
    • 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. 
  • Valeur de champ : valeur de champ spécifique. Si le type de valeur de champ est CODED_VALUE, spécifiez le code. Si le type de valeur de champ 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 Attribut. 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. Pour plus d’informations sur les valeurs retirées, reportez-vous à la rubrique Créer et gérer des valeurs conditionnelles.

  • 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 obtenue

NomExplicationType de données
out_table

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

Table View; Raster Layer; Mosaic Layer

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.management.AddContingentValue("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup", CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

Rubriques connexes