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 uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent. 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é. RelationshipClass : en cas de noms dupliqués, la classe de relations est utilisée. Topology : en cas de noms dupliqués, la topologie est utilisée.	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 uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent. 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é. RelationshipClass : en cas de noms dupliqués, la classe de relations est utilisée. Topology : en cas de noms dupliqués, la topologie est utilisée.	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