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

Synthèse

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érationRé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.

Paramètres

ÉtiquetteExplicationType de données
Table cible

Table contenant le groupe de champs à modifier.

Table View
Nom du groupe de champs

Nom du groupe de champs à modifier.

String
Nouveau nom du groupe de champs
(Facultatif)

Nouveau nom unique du groupe de champs.

String
Nouveaux champs
(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 (Restrictif)
(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.

  • Activé - 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.
  • Désactivé - 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 obtenue

ÉtiquetteExplicationType de données
Table mise à jour

Table cible en entrée avec le groupe de champs modifié.

Vue tabulaire

arcpy.management.AlterFieldGroup(target_table, name, {new_name}, {fields}, {is_restrictive})
NomExplicationType 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.

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

NomExplicationType 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")

Rubriques connexes