Importer des valeurs conditionnelles (Gestion des données)

Synthèse

Importe plusieurs valeurs conditionnelles et groupes de champs à partir d’un fichier de valeurs séparées par des virgules (.csv) dans un jeu de données.

Utilisation

  • Cet outil importe des valeurs conditionnelles et des groupes de champs dans un jeu de données ; il offre la possibilité de remplacer les valeurs ou de fusionner les nouvelles valeurs aux valeurs existantes.

  • La structure de la table cible doit correspondre aux valeurs à importer. Si les champs ou les valeurs spécifiées dans le fichier .csv n’existent pas dans le jeu de données cible, l’importation du groupe de champs ou des valeurs conditionnelles ne se produit pas.

  • Si la table cible est stockée dans une géodatabase d’entreprise, cet outil doit être exécuté par le propriétaire des données.

  • Cet outil peut être utilisé avec l’outil Exporter des 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.

  • Le fichier .csv des groupes de champs inclut les colonnes NAME, IS_RESTRICTIVE et FIELD. Le nom de la colonne FIELD sera incrémenté comme il convient pour inclure tous les champs dans le groupe de champs, par exemple, FIELD1, FIELD2, FIELD3, etc.

    Colonnes .csv de groupe de champs

    ColonneDescriptionExemple

    NAME

    Nom du groupe de champs

    Catégories_animales

    IS_RESTRICTIVE

    Précise si le groupe de champs est restrictif

    TRUE

    FIELD1

    Nom du champ

    category

  • Le fichier .csv des valeurs conditionnelles inclut les colonnes suivantes : CAV_ID, IS_RETIRED, FIELD_GROUP, SUBTYPE, SUBTYPE_NAME, CV_TYPE, CV_VALUE et DESCRIPTION.

    Il existe autant de colonnes CV_TYPE, CV_VALUE et DESCRIPTION qu’il est requis pour refléter la structure de la définition de la valeur conditionnelle. Ces noms de colonne sont incrémentés comme il convient (par exemple, CV_TYPE1, CV_VALUE1, DESCRIPTION1, CV_TYPE2, CV_VALUE2, DESCRIPTION2, etc.) et correspondent à l’ordre des champs figurant dans le fichier .csv des groupes de champs. Par exemple, CV_TYPE1, CV_VALUE1 et DESCRIPTION1 du fichier .csv de valeurs conditionnelles correspondent à FIELD1 du fichier .csv des groupes de champs.

    Colonnes .csv des valeurs conditionnelles

    ColonneDescriptionExemple

    CAV_ID

    ID de la valeur conditionnelle.

    1

    IS_RETIRED

    Valeur booléenne définissant si la valeur conditionnelle est retirée.

    False

    FIELD_GROUP

    Nom du groupe de champs auquel correspond la valeur conditionnelle.

    Catégories_animales

    SUBTYPE

    Si le jeu de données possède un sous-type et que le sous-type est utilisé dans la définition de la valeur conditionnelle, la règle sera appliquée à ce code de sous-type.

    2

    SUBTYPE_NAME

    Si le jeu de données possède un sous-type et que le sous-type est utilisé dans la définition de la valeur conditionnelle, il s’agit du texte descriptif du code de sous-type.

    À sang froid

    CV_TYPE1

    Type de valeur conditionnelle. La valeur de type est conservée sous forme d’entier comme suit :

    • 1 : n’importe lequel
    • 2 : nul
    • 3 : valeur codée
    • 4 : plage

    3

    CV_VALUE1

    Valeur de champ spécifique. Si le type est n’importe lequel ou nul, la valeur figurant dans le fichier .csv est vide.

    1

    DESCRIPTION1

    Si le type de la valeur conditionnelle est une valeur codée, il s’agit du texte descriptif de la valeur codée.

    Poisson

Paramètres

ÉtiquetteExplicationType de données
Table cible

Table de géodatabase ou classe d’entités en entrée dans laquelle les groupes de champs et les valeurs conditionnelles sont importés.

Table View
Fichier en entrée des groupes de champs (.csv)

Fichier .csv avec des noms de colonnes spécifiques contenant des informations sur les groupes de champs.

File
Fichier en entrée des valeurs conditionnelles (.csv)

Fichier .csv avec des noms de colonnes spécifiques contenant des informations sur les valeurs conditionnelles.

File
Remplacer les valeurs conditionnelles existantes
(Facultatif)

Spécifie si les valeurs existantes sont remplacées ou fusionnées lorsqu’elles sont importées.

  • Activé : les valeurs existantes de la table cible sont remplacées par les valeurs figurant dans les fichiers .csv en entrée.
  • Désactivé : les valeurs existantes sont fusionnées avec les valeurs figurant dans les fichiers .csv en entrée. Tous les doublons sont exclus. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Table mise à jour

La table cible mise à jour par les valeurs conditionnelles et les groupes de champs importés.

Table View; Raster Layer; Mosaic Layer

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
NomExplicationType de données
target_table

Table de géodatabase ou classe d’entités en entrée dans laquelle les groupes de champs et les valeurs conditionnelles sont importés.

Table View
field_group_file

Fichier .csv avec des noms de colonnes spécifiques contenant des informations sur les groupes de champs.

File
contingent_value_file

Fichier .csv avec des noms de colonnes spécifiques contenant des informations sur les valeurs conditionnelles.

File
import_type
(Facultatif)

Spécifie si les valeurs existantes sont remplacées ou fusionnées lorsqu’elles sont importées.

  • REPLACELes valeurs existantes de la table cible sont remplacées par les valeurs figurant dans les fichiers .csv en entrée.
  • UNIONLes valeurs existantes sont fusionnées avec les valeurs figurant dans les fichiers .csv en entrée. Tous les doublons sont exclus. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
updated_table

La table cible mise à jour par les valeurs conditionnelles et les groupes de champs importés.

Table View; Raster Layer; Mosaic Layer

Exemple de code

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

Importez des valeurs conditionnelles et des groupes de champs dans le jeu de données GasPipes et remplacez les valeurs existantes.

import arcpy
arcpy.management.ImportContingentValues("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
                                        "C:\\MyProject\\MyFieldGroups.csv",
                                        "C:\\MyProject\\MyContingentValues.csv",
                                        "REPLACE")

Rubriques connexes