Modifier le groupe de champs (Gestion des données)

Résumé

Modifie les propriétés d’un groupe de champs.

Utilisation

• La suppression d’un groupe de champs supprime les valeurs conditionnelles qui y sont associées. Cet outil permet de modifier le groupe de champs sans supprimer les valeurs conditionnelles associées.

• La modification des champs qui participent au groupe de champs peut affecter les valeurs conditionnelles qui en dépendent, comme décrit dans le tableau suivant :

  Opération	Résultat
  Supprimer un champ	Les valeurs conditionnelles associées au champ supprimé sont également supprimées.
  Ajouter un champ	Pour les valeurs conditionnelles associées au groupe de champs, le nouveau champ est ajouté à la valeur conditionnelle avec le type de valeur de champ ANY.

• Les champs utilisés pour créer un groupe de champs ne peuvent pas être des champs gérés par le système tels que ObjectID ou Shape, ni correspondre au champ de sous-type.

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

Syntaxe

arcpy.management.AlterFieldGroup(target_table, name, {new_name}, {fields}, {is_restrictive})

Paramètre	Explication	Type de données
target_table	Table contenant le groupe de champs à modifier.	Table View
name	Nom du groupe de champs à modifier.	String
new_name (Facultatif)	Nouveau nom unique du groupe de champs.	String
fields [fields,...] (Facultatif)	Champs qui participent au groupe de champs. Pour modifier les champs, entrez de nouveaux noms de champ. Les valeurs spécifiées remplacent la liste actuelle des champs qui participent au groupe de champs ; elles n’y sont pas ajoutées. Si aucune valeur n’est spécifiée, les champs ne sont pas modifiés.	String
is_restrictive (Facultatif)	Détermine si le groupe de champs est restrictif. Ce paramètre vous permet de contrôler l’expérience de mise à jour lorsque vous utilisez des valeurs conditionnelles. RESTRICT —Le groupe de champs est restrictif. Les valeurs saisies dans un champ du groupe de champs sont limitées aux valeurs indiquées comme valeurs conditionnelles. Il s’agit de l’option par défaut. DO_NOT_RESTRICT —Le groupe de champs n’est pas restrictif. Les valeurs peuvent être validées dans un champ d’un groupe de champs même si elles ne sont pas indiquées comme valeurs conditionnelles.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_table	Table cible en entrée avec le groupe de champs modifié.	Vue tabulaire

Exemple de code

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

Modifiez les propriétés d’un groupe de champs en le renommant, en remplaçant ses champs actuels et en le rendant non restrictif.

import arcpy
arcpy.AlterFieldGroup_management("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC",
                                 "MyFieldGroup", "MyNewFieldGroupName",
                                 ["Field1", "Field3"],
                                 "DO_NOT_RESTRICT")

Environnements

Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui