ArcGIS Help 10.1 - Classe d'entités vers classe d'entités (Conversion)

Niveau de licence :De base Standard Avancé

Récapitulatif

Convertit un fichier de formes, une classe d'entités de couverture ou une classe d'entités de géodatabase en fichier de formes ou en classe d'entités de géodatabase.

Utilisation

Le paramètre Appariement des champs contrôle l'écriture des champs en entrée des entités en entrée dans les entités en sortie.
- Pour supprimer des champs pendant la conversion, supprimez des champs en entrée de l'appariement des champs. Cette opération n'altère pas la classe d'entités en entrée.
- Un champ en sortie individuel peut être généré à partir de plusieurs champs en entrée, à condition qu'un champ soit créé et que le contenu du champ en sortie soit généré à partir de plusieurs champs (portant des noms différents).
- Le type de données d'un champ en sortie possède par défaut la même valeur que le type de données du premier champ en entrée (du même nom) qu'il rencontre. Vous pouvez à tout moment modifier manuellement ce type de données en type de données valide. Si vous utilisez la boîte de dialogue des outils, tous les types de données valides y sont répertoriés.
- Lorsque vous utilisez la règle de combinaison, vous pouvez spécifier votre propre délimiteur (espace, virgule, point, tiret, etc.). Pour utiliser un espace, vérifiez que le pointeur de votre souris se trouve au début de la zone de saisie et cliquez une fois sur la barre d'espacement.
- Plusieurs règles de combinaison sont disponibles : premier, dernier, jointure, somme, moyenne, médiane, minimum, maximum et écart type.
- Les options de format sont uniquement disponibles sur des champs en entrée de type texte (et en association avec la règle de combinaison de jointure). Vous pouvez spécifier le point de début, le point de fin, etc. Le format vous permet d'appliquer des modifications au champ en entrée sélectionné ou à toutes les occurrences d'un même champ en entrée.
- L'écart type ne doit pas être exécuté sur une entrée individuelle, car les valeurs ne peuvent pas être divisées par zéro. L'écart type n'est de ce fait pas une option valide pour les entrées individuelles.
  Pour en savoir plus sur l'appariement des champs Pour en savoir plus sur l'appariement des champs dans les scripts
L'outil Copier des entités permet également de convertir un fichier de formes, une classe d'entités de couverture ou une classe d'entités de géodatabase (fichier, personnelle ou ArcSDE) en fichier de formes ou en classe d'entités de géodatabase (fichier, personnelle ou ArcSDE).
Expression SQL permettant de sélectionner un sous-ensemble d'entités. Pour en savoir plus sur la syntaxe du paramètre Expression, reportez-vous à la rubrique Construction d'une expression SQL ou Référence SQL.
Lors de la conversion en un fichier de formes de données de géodatabase qui présentent des sous-types ou des domaines, les codes de domaine et de sous-types, ainsi que les descriptions peuvent figurer dans la sortie. Utilisez l'environnement de géotraitement Transfert des descriptions de domaine de champ pour contrôler ce comportement. Par défaut, seuls les codes de domaine et de sous-type sont inclus dans la sortie, mais pas les descriptions.
Remarque :
la conversion de fichiers de formes avec des descriptions de sous-type et de domaine risque de prendre plus de temps (performances moindres) que sans les descriptions. Si vous ne devez pas inclure les descriptions de sous-type et de domaine dans votre fichier de formes en sortie, nous vous conseillons d'utiliser le comportement par défaut (False ou NOT_TRANSFER_DOMAINS dans le script) de l'environnement Transfert des descriptions de domaine de champ en désactivant cette option pour obtenir les meilleures performances.

Syntaxe

FeatureClassToFeatureClass_conversion (in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})

Paramètre	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 sera créée. Il peut s'agir d'une géodatabase ou d'un dossier. Si l'emplacement en sortie est un dossier, la sortie sera un fichier de formes.	Workspace;Feature Dataset
out_name	Le 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. La syntaxe de l'expression diffère légèrement en fonction de la source des données. Par exemple, lorsque vous interrogez des géodatabases fichier ou ArcSDE, des fichiers de formes ou des couvertures, placez le nom des champs entre guillemets doubles : "MY_FIELD" Si vous interrogez des géodatabases personnelles, placez les champs entre crochets : [MON_CHAMP] Dans Python, les chaînes se trouvent entre guillemets simples ou doubles. Pour créer une chaîne contenant des guillemets (comme c'est souvent le cas pour les clauses WHERE dans les expressions SQL), vous pouvez désactiver les guillemets (à l'aide d'une barre oblique inverse) ou placer la chaîne entre guillemets triples. Par exemple, si la clause WHERE souhaitée est "CITY_NAME" = 'Chicago' vous pouvez mettre la chaîne entière entre guillemets doubles, puis désactiver les guillemets doubles intérieurs de la manière suivante : " \"CITY_NAME\" = 'Chicago' " Ou vous pouvez mettre la chaîne entière entre guillemets simples, puis désactiver les guillemets simples intérieurs de la manière suivante : ' "CITY_NAME" = \'Chicago\' ' Ou vous pouvez mettre la chaîne entière entre guillemets triples sans désactiver les guillemets : """ "CITY_NAME" = 'Chicago' """ Pour en savoir plus sur la syntaxe SQL et sur ses différences selon les sources de données, 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)	Champs et contenus de champ choisis à partir de la classe d'entités en entrée. Vous pouvez ajouter, renommer ou supprimer des champs en sortie et définir des propriétés telles que le type de données et la règle de fusion. Pour en savoir plus sur le choix et la définition des champs en sortie	Field Mappings
config_keyword (Facultatif)	Spécifie les paramètres de stockage (configuration) des géodatabases dans des géodatabases fichier et ArcSDE. Les géodatabases personnelles n'utilisent pas les mots-clés de configuration. Les mots-clés de configuration ArcSDE pour ArcSDE Enterprise Edition sont définis par l'administrateur de la base de données.	String

Exemple de code

Exemple 1 d'utilisation de l'outil Classe d'entités vers classe d'entités (fenêtre Python)

Le script de fenêtre Python suivant illustre l'utilisation de l'outil Classe d'entités vers classe d'entités en mode immédiat.

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

Exemple 2 d'utilisation de l'outil Classe d'entités vers classe d'entités (script autonome)

Le script autonome suivant illustre l'utilisation de l'outil Classe d'entités vers classe d'entités.

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