Renommer (Gestion des données)

Synthèse

Change le nom d’un jeu de données. Cet outil s’applique à un grand nombre de types de données, parmi lesquels figurent les jeux de classes d’entités, les rasters, les tables et les shapefiles.

Utilisation

• Le nom en sortie doit être unique. Si ce n’est pas le cas, un message d’erreur s’affiche, même si l’environnement de remplacement en sortie de l’outil de géotraitement est défini sur Vrai.

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

• L’outil Renommer 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.

• Cet 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 (Facultatif)	Type des données à renommer. Vous devez fournir une valeur uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de classes d’entités ou classe d’entités) de l’élément que vous souhaitez renommer.	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 (Facultatif)	Type des données à renommer. Vous devez fournir une valeur uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de classes d’entités ou classe d’entités) de l’élément que vous souhaitez renommer.	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.Rename_management("customers.dbf", "customers_2010.dbf")

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

Le script Python ci-dessous illustre l’utilisation de la fonction Rename dans un script autonome.

# Name: Rename_Example2.py
# Description: Rename fileGDB 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"

# Execute Rename
arcpy.Rename_management(in_data, out_data, data_type)

Environnements

Espace de travail courant, Espace de travail temporaire

Cas particuliers

Informations de licence

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