Classe d’entités vers classe d’entités (Conversion)

Synthèse

Convertit une classe d’entités ou une couche d’entités en classe d’entités.

Héritage :

Il s’agit d’un outil déconseillé. Cette fonction a été remplacée par l’outil Exporter des entités.

Utilisation

• Le paramètre Field Map (Appariement des champs) permet de gérer les champs et leur contenu dans le jeu de données en sortie.

  • Ajoutez et supprimez des champs de la liste des champs, réorganisez la liste des champs et renommez des champs.
  • Le type de données par défaut d’un champ en sortie est le même que le type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez modifier le type de données en un autre type de données valide.
  • Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs en entrée sont fusionnées en un seul champ en sortie. Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).
  • Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.
  • L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.
  • L’option Export (Exporter) permet d’enregistrer un appariement des champs sous forme de fichier .fieldmap.
  • L’option Load (Charger) permet de charger un fichier .fieldmap. La couche d’entités ou le jeu de données spécifié dans le fichier doit correspondre à celui utilisé dans l’outil. Sinon, le paramètre Field Map (Appariement des champs) est réinitialisé.
  • Utilisez le bouton Slice Text (Texte de tranche) sur les champs de la source du texte pour sélectionner les caractères d’une valeur en entrée à extraire dans le champ en sortie. Pour accéder au bouton Slice Text (Texte de tranche), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin.
  • Il est également possible d’apparier des champs dans un script Python.

• Une expression SQL peut être utilisée pour sélectionner un sous-ensemble d’entités. Pour plus d’informations sur la syntaxe du paramètre Expression, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.

• Lors de la conversion en shapefile de données de géodatabase qui présentent des sous-types ou des domaines, les codes de domaine et de sous-type, ainsi que les descriptions peuvent figurer dans la sortie. Pour ce faire, utilisez l’environnement de géotraitement Transférer les descriptions des domaines de champs. Par défaut, seuls les codes de domaine et de sous-type sont inclus dans la sortie, mais pas les descriptions.

  Remarque :

  La conversion en shapefile avec des descriptions de sous-type et de domaine risque de prendre plus de temps (performances moindres) que la conversion sans les descriptions. Si les descriptions de sous-type et de domaine ne sont pas requises dans la sortie, laissez l’environnement Transférer les descriptions des domaines de champs non sélectionné (False ou NOT_TRANSFER_DOMAINS dans Python) afin d’optimiser les performances.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Classe ou couche d’entités à convertir.	Feature Layer
Emplacement en sortie	Emplacement dans lequel la classe d’entités en sortie est créée. Il peut s’agir d’une géodatabase ou d’un dossier. Si l’emplacement en sortie est un dossier, la sortie est un shapefile.	Workspace;Feature Dataset
Nom en sortie	Nom de la classe d’entités en sortie.	String
Expression (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble d’entités.	SQL Expression
Appariement des champs (Facultatif)	Les champs sont transférés au jeu de données en sortie avec leurs propriétés et champs sources respectifs. Par défaut, la sortie inclut tous les champs du jeu de données en entrée. Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs. L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie.	Field Mappings
Mot-clé de configuration (Facultatif)	Spécifie les paramètres de stockage par défaut (configuration) des géodatabases d'un SGBDR (système de gestion de bases de données relationnelles). Ce paramètre est applicable uniquement dans le cas de tables de géodatabase d'entreprise. Les mots-clés de configuration sont définis par l'administrateur de base de données. Pour en savoir plus sur les mots-clés de configuration	String

Sortie obtenue

Étiquette	Explication	Type de données
Classe d’entités en sortie	Classe d’entités en sortie.	Feature Class

Python

arcpy.conversion.FeatureClassToFeatureClass(in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})

Nom	Explication	Type de données
in_features	Classe ou couche d’entités à convertir.	Feature Layer
out_path	Emplacement dans lequel la classe d’entités en sortie est créée. Il peut s’agir d’une géodatabase ou d’un dossier. Si l’emplacement en sortie est un dossier, la sortie est un shapefile.	Workspace;Feature Dataset
out_name	Nom de la classe d’entités en sortie.	String
where_clause (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble d'entités. Pour en savoir plus sur la syntaxe SQL reportez-vous à la rubrique d’aide Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
field_mapping (Facultatif)	Les champs sont transférés au jeu de données en sortie avec leurs propriétés et champs sources respectifs. Par défaut, la sortie inclut tous les champs du jeu de données en entrée. Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs. L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie. Dans Python, utilisez la classe FieldMappings pour définir ce paramètre.	Field Mappings
config_keyword (Facultatif)	Spécifie les paramètres de stockage par défaut (configuration) des géodatabases d'un SGBDR (système de gestion de bases de données relationnelles). Ce paramètre est applicable uniquement dans le cas de tables de géodatabase d'entreprise. Les mots-clés de configuration sont définis par l'administrateur de base de données. Pour en savoir plus sur les mots-clés de configuration	String

Sortie obtenue

Nom	Explication	Type de données
out_feature_class	Classe d’entités en sortie.	Feature Class

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction FeatureClassToFeatureClass en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
arcpy.conversion.FeatureClassToFeatureClass("buildings_point", 
                                            "C:/output/output.gdb", 
                                            "buildings_point")

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

Le script autonome ci-dessous illustre l’utilisation de la fonction FeatureClassToFeatureClass.

# Name: FeatureClassToFeatureClass_Example2.py
# Description: Use FeatureClassToFeatureClass with an expression to create a subset
#  of the original feature class.  
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
 
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(arcpy.env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
 
# Run FeatureClassToFeatureClass
arcpy.conversion.FeatureClassToFeatureClass(inFeatures, outLocation, 
                                            outFeatureClass, expression)

Environnements

Espace de travail courant, Système de coordonnées en sortie, Étendue, Transformations géographiques, Résolution XY, Tolérance XY, Valeurs M en sortie, Résolution M, Tolérance M, Valeurs Z en sortie, Valeur Z en sortie par défaut, Résolution Z, Tolérance Z, Noms de champ qualifiés, Mot-clé CONFIG en sortie, Conserver les pièces jointes, Validation automatique, Domaine XY en sortie, Domaine M en sortie, Domaine Z en sortie, Transférer les descriptions des domaines de champ, Conserver les ID globaux

Informations de licence

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