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.

Utilisation

• Pour gérer les champs dans le jeu de données en sortie, ainsi que le contenu de ces champs, utilisez le paramètre Appariement des champs.

  • Pour modifier l’ordre des champs, sélectionnez un nom de champ et faites-le glisser jusqu’à la nouvelle position.
  • Le type de données par défaut d’un champ en sortie est identique au type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez à tout moment changer manuellement le type de données pour tout autre type de données valide.
  • Les règles de combinaison disponibles sont : premier, dernier, joindre, somme, moyenne, médiane, mode, minimum, maximum, écart type, et total.
  • Lorsque vous utilisez la règle de combinaison Join (Joindre), vous pouvez spécifier un délimiteur (espace, virgule, point, tiret, etc.). Pour utiliser un espace, vérifiez que le pointeur de la souris se trouve au début de la zone de saisie et appuyez une fois sur la barre d’espacement.
  • Vous pouvez spécifier les positions de début et de fin des champs de texte à l'aide de l'option de format.
  • N’exécutez pas d’écart type sur une entrée unique car les valeurs ne peuvent pas être divisées par zéro. L'écart type n'est pas une option valide pour les entrées uniques.

  En savoir plus sur l'appariement de champs dans les scripts

• Expression SQL permettant de 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 éléments utilisés dans des expressions de requête.

• 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 sortie de shapefile, nous vous conseillons d'utiliser le comportement non sélectionné par défaut de l'environnement Transfert des descriptions de domaine de champ (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 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
Nom en sortie	Le 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 attributaires qui figurent dans la sortie avec les propriétés de champ correspondantes et les champs source. Par défaut, tous les champs des entrées seront inclus. Il est possible d’ajouter, de supprimer, de renommer, de réorganiser les champs, ainsi que de modifier leurs propriétés. Les règles de combinaison permettent de spécifier la manière dont les valeurs de deux champs en entrée ou plus sont combinées ou fusionnées en une seule valeur en sortie. Plusieurs règles de combinaison permettent de déterminer de quelle manière sont renseignées les valeurs du champ en sortie. Premier : utilisez la première valeur des champs en entrée. Dernier : utilisez la dernière valeur des champs en entrée. Joindre : concaténez (joignez) les valeurs des champs en entrée. Somme : calculez le total des valeurs des champs en entrée. Moyenne : calculez la moyenne des valeurs des champs en entrée. Médiane : calculez la valeur médiane (milieu) des valeurs des champs en entrée. Mode – Utilisez la valeur avec la plus haute fréquence. Min. : utilisez la valeur minimale de toutes les valeurs des champs en entrée. Max. : utilisez la valeur maximale de toutes les valeurs des champs en entrée. Écart type : utilisez la méthode de classification par écart type sur les valeurs de tous les champs en entrée. Total – Recherchez le nombre d'enregistrements inclus dans le calcul.	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 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)	Les champs attributaires qui figurent dans la sortie avec les propriétés de champ correspondantes et les champs source. Par défaut, tous les champs des entrées seront inclus. Il est possible d’ajouter, de supprimer, de renommer, de réorganiser les champs, ainsi que de modifier leurs propriétés. Les règles de combinaison permettent de spécifier la manière dont les valeurs de deux champs en entrée ou plus sont combinées ou fusionnées en une seule valeur en sortie. Plusieurs règles de combinaison permettent de déterminer de quelle manière sont renseignées les valeurs du champ en sortie. Premier : utilisez la première valeur des champs en entrée. Dernier : utilisez la dernière valeur des champs en entrée. Joindre : concaténez (joignez) les valeurs des champs en entrée. Somme : calculez le total des valeurs des champs en entrée. Moyenne : calculez la moyenne des valeurs des champs en entrée. Médiane : calculez la valeur médiane (milieu) des valeurs des champs en entrée. Mode – Utilisez la valeur avec la plus haute fréquence. Min. : utilisez la valeur minimale de toutes les valeurs des champs en entrée. Max. : utilisez la valeur maximale de toutes les valeurs des champs en entrée. Écart type : utilisez la méthode de classification par écart type sur les valeurs de tous les champs en entrée. Total – Recherchez le nombre d'enregistrements inclus dans le calcul. Dans Python, vous pouvez utiliser 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 l'outil FeatureClassToFeatureClass (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction FeatureClassToFeatureClass en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/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 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'"
 
# Execute FeatureClassToFeatureClass
arcpy.FeatureClassToFeatureClass_conversion(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

Cas particuliers

Informations de licence

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