Renommer (Gestion des données)

Synthèse

Change le nom d’un jeu de données. Cet outil s’applique à différents types de données, notamment les jeux de classes d’entités, les rasters, les tables et les shapefiles.

Utilisation

• Le nom en sortie doit être unique. Si tel n’est pas le cas, un message d’erreur s’affiche, même si le paramètre Autoriser les outils de géotraitement à remplacer les jeux de données existants est activé.

• L’outil renomme également l’alias des données.

• L’outil ne renomme pas les couches, étant donné qu’une couche constitue une référence à un jeu de données.

• L’outil ne renomme pas les champs du jeu de données. Par exemple, supposons que vous ayez un champ nommé ROADS_ID dans une classe d’entités nommée Roads. Si la classe d’entités Roads est renommée Streets, le champ ROADS_ID n’est pas renommé STREETS_ID.

• L’outil ne fonctionne pas avec les données stockées dans une base de données DB2 en raison des contraintes liées à la base de données.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Élément de données en entrée	Données en entrée à renommer.	Data Element
Élément de données en sortie	Nom des données en sortie.	Data Element
Type de données	Type des données à renommer. Ce paramètre est utilisé en cas de conflit de noms. Une géodatabase peut contenir différents jeux de données portant le même nom. Par exemple, une classe d’entités, un jeu de classes d’entités, un jeu de données mosaïque et un atelier parcellaire portant le même nom peuvent exister dans la même géodatabase. Spécifier une valeur indiquera à l’outil d’utiliser ce type de données si deux jeux de données ou plus portent le même nom. FeatureClass : en cas de noms dupliqués, la classe d’entités est utilisée. FeatureDataset : en cas de noms dupliqués, le jeu de classes d’entités est utilisé. MosaicDataset : en cas de noms dupliqués, le jeu de données mosaïque est utilisé. ParcelFabric : en cas de noms dupliqués, l’atelier parcellaire est utilisé.	String

Python

arcpy.management.Rename(in_data, out_data, data_type)

Nom	Explication	Type de données
in_data	Données en entrée à renommer.	Data Element
out_data	Nom des données en sortie.	Data Element
data_type	Type des données à renommer. Ce paramètre est utilisé en cas de conflit de noms. Une géodatabase peut contenir différents jeux de données portant le même nom. Par exemple, une classe d’entités, un jeu de classes d’entités, un jeu de données mosaïque et un atelier parcellaire portant le même nom peuvent exister dans la même géodatabase. Spécifier une valeur indiquera à l’outil d’utiliser ce type de données si deux jeux de données ou plus portent le même nom. FeatureClass : en cas de noms dupliqués, la classe d’entités est utilisée. FeatureDataset : en cas de noms dupliqués, le jeu de classes d’entités est utilisé. MosaicDataset : en cas de noms dupliqués, le jeu de données mosaïque est utilisé. ParcelFabric : en cas de noms dupliqués, l’atelier parcellaire est utilisé.	String

Exemple de code

Exemple 1 d’utilisation de la fonction Rename (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction Rename en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Rename("customers.dbf", "customers_2010.dbf")

Exemple 2 d’utilisation de la fonction Rename (script Python autonome)

Le script Python suivant illustre l’utilisation de la fonction Rename dans un script autonome.

# Description: Rename a file geodatabase feature class

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/workspace/test.gdb"

# Set local variables
in_data =  "test"
out_data = "testFC"
data_type = "FeatureClass"

# Run Rename
arcpy.management.Rename(in_data, out_data, data_type)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

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