Résumé
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 Importer 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
catégorie
Le fichier .csv des valeurs conditionnelles incluent 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
Syntaxe
arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
Paramètre | 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 au moment de l’importation.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
updated_table | La table cible mise à jour par les valeurs conditionnelles et les groupes de champs importés. | Vue tabulaire, couche raster, couche de mosaïque |
Exemple de code
Importez des valeurs conditionnelles et des groupes de champs dans le jeu de données GasPipes et remplacez les valeurs existantes.
import arcpy
arcpy.ImportContingentValues_management("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
"C:\\MyProject\\MyFieldGroups.csv",
"C:\\MyProject\\MyContingentValues.csv",
"REPLACE")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?