Classe d'entités vers classe d'entités (Conversion)
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.
-
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 des données de géodatabase qui ont des domaines attributaires à un fichier de formes, une table dBase ou une couverture, les codes de domaine et les descriptions de domaine seront inclus dans la sortie. Les descriptions de domaine seront dans un nouveau champ nommé d'après le champ de domaine, en ajoutant _DESC à la fin du nom de champ.
Syntaxe
| 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. Les règles de combinaison permettent de spécifier la manière dont les valeurs de plusieurs champs en entrée sont combinées en une seule valeur en sortie. Vous pouvez utiliser plusieurs règles de combinaison :
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
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")
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)