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

  Colonne	Description	Exemple
  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

  Colonne	Description	Exemple
  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

Boîte de dialogue

Étiquette	Explication	Type 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

Étiquette	Explication	Type 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

Python

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})

Nom	Explication	Type 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. REPLACE—Les valeurs existantes de la table cible sont remplacées par les valeurs figurant dans les fichiers .csv en entrée. UNION—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

Nom	Explication	Type 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")

Environnements

Espace de travail courant