Récapitulatif
Renommez les champs et les alias de champ, ou modifiez les propriétés de champ.
Utilisation
Cet outil permet de renommer les champs ou les alias de champ d'une classe d'entités ou d'une table de géodatabase.
Pour les classes d'entités ou tables de géodatabase vides, vous pouvez modifier les propriétés de champ, telles que le type de champ, sa longueur ou s'il accepte les valeurs Null.
Lorsque vous utilisez des tables ou classes d'entités en mémoire, le fait de renommer le champ OBJECTID, Shape ou d'autres champs obligatoires, tels que ceux présents dans les couches d'analyse de réseau, risque d'endommager les données ou d'entraîner un comportement inattendu.
Syntaxe
AlterField_management (in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})| Paramètre | Explication | Type de données |
in_table | Classe d’entités ou table en entrée contenant le champ à modifier. | Table View |
field | Nom du champ à modifier. Si le champ est un champ obligatoire (isRequired=vrai), seul l'alias de champ peut être modifié. | Field |
new_field_name (Facultatif) | Nouveau nom du champ. | String |
new_field_alias (Facultatif) | Nouvel alias du champ. | String |
field_type (Facultatif) | Nouveau type de champ du champ. Applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement).
| String |
field_length (Facultatif) | Nouvelle longueur du champ. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Cette option ne s'applique qu'aux champs de type TEXT ou BLOB. Applicable uniquement si la table est vide. | Long |
field_is_nullable (Facultatif) | Détermine si le champ peut contenir des valeurs Null. Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement).
| Boolean |
clear_field_alias (Facultatif) | Spécifiez si l'alias du champ en entrée doit être effacé ou non. Le paramètre d'alias de champ doit être vide pour effacer l'alias du champ.
| Boolean |
Exemple de code
Exemple 1 d'utilisation de l'outil AlterField (fenêtre Python)
Le script de fenêtre Python suivant illustre l'utilisation de l'outil AlterField en mode immédiat.
arcpy.AlterField_management(r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
Exemple 2 d'utilisation de l'outil AlterField (script autonome)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil AlterField dans un script autonome.
#Import geoprocessing
import arcpy
#Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'
#Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses() #get a list of feature classes
for fc in fcList: #loop through feature classes
fieldList = arcpy.ListFields(fc) #get a list of fields for each feature class
for field in fieldList: #loop through each field
if field.name.lower() == 'elev': #look for the name elev
arcpy.AlterField_management(fc, field.name, 'ELEVATION', 'Elevation in Metres')
Exemple 3 d'utilisation de l'outil AlterField (script autonome)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil AlterField sur une classe d'entités vide dans un script autonome.
#Import geoprocessing
import arcpy
#Set local variables
fc = "C:/Data/Garbo.gdb/trails" #Note:empty feature class
field = "condition_rating" #short int, non nullable field
new_name = "notes"
new_alias = "Comments on Trail Condition"
new_type = "TEXT"
new_length = "60"
new_is_nullable = "NULLABLE"
clear_alias = "FALSE"
#Alter the properties of a non nullable, short data type field to become a text field
arcpy.AlterField_management(fc, field, new_name, new_alias, new_type, new_length, new_is_nullable, clear_alias)
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Oui
- ArcGIS for Desktop Standard: Oui
- ArcGIS for Desktop Advanced: Oui