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 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
| 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. 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) |
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
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)