Exporter des entités (Outils de conversion)

Résumé

Convertit une classe d’entités ou une couche d’entités en une nouvelle classe d’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.
Vous pouvez réorganiser les lignes par ordre croissant ou décroissant en spécifiant la valeur du paramètre Sort Field (Champ de tri). Si plusieurs champs sont spécifiés, les lignes sont triées en fonction du premier champ, et dans cet ordre, en fonction du deuxième champ, et ainsi de suite.
Lorsque vous convertissez des données de géodatabase possédant des sous-types ou des domaines et que l’espace de travail en sortie n’est pas une géodatabase, les codes de domaine et de sous-type et les descriptions peuvent figurer dans la sortie. Utilisez l’environnement Transfer field domain descriptions (Transférer les descriptions des domaines de champs) 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 en shapefile avec des descriptions de sous-type et de domaine peut 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é afin d’optimiser les performances.
Si un fichier délimité, tel qu’un fichier .csv, est utilisé en entrée, l’espace de travail de fichier texte ArcGIS détermine les propriétés et valeurs de champ. Pour visualiser les mêmes propriétés et valeurs de champ que celles lues par l’outil, ouvrez la table.

Le paramètre Field Map (Appariement des champs) permet de modifier le type de champ en sortie et d’autres propriétés, mais ce paramètre ne modifie par les propriétés et valeurs de champ en entrée.

Utilisez un fichier schema.ini pour configurer la manière dont les propriétés et valeurs de champ en entrée sont interprétées par l’outil et dans ArcGIS Pro.
Si l’outil est utilisé dans ModelBuilder avec un itérateur, toute modification apportée au paramètre d’appariement des champs est respectée pour chaque entrée. Si le paramètre d’appariement des champs n’est pas modifié, l’appariement des champs est réinitialisé pour chaque entrée.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Entités en entrée à exporter vers une nouvelle classe d’entités.	Feature Layer
Classe d’entités en sortie	Classe d’entités en sortie contenant les entités exportées.	Feature Class
Expression (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble d’entités.	SQL Expression
Utiliser l’alias de champ comme nom (Facultatif)	Indique si les noms ou alias de champ en entrée seront utilisés comme nom de champ en sortie. Activé—Les alias de champ en entrée seront utilisés comme noms de champ en sortie. Décoché—Les noms de champ en entrée seront utilisés comme noms de champ en sortie. Il s’agit de l’option par défaut.	Boolean
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
Champ de tri (Facultatif)	Champ(s) dont les valeurs vont servir à réorganiser les enregistrements en entrée et sens de tri des enregistrements. Colonnes de la table de valeurs : Field(s)—The field that will be reordered. Order—The order in which the field will be reordered. Ascending—Records will be sorted from low value to high value. Descending—Records will be sorted from high value to low value.	Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})

Nom	Explication	Type de données
in_features	Entités en entrée à exporter vers une nouvelle classe d’entités.	Feature Layer
out_features	Classe d’entités en sortie contenant les entités exportées.	Feature Class
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
use_field_alias_as_name (Facultatif)	Indique si les noms ou alias de champ en entrée seront utilisés comme nom de champ en sortie. `USE_ALIAS`—Les alias de champ en entrée seront utilisés comme noms de champ en sortie. `NOT_USE_ALIAS`—Les noms de champ en entrée seront utilisés comme noms de champ en sortie. Il s’agit de l’option par défaut.	Boolean
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.	Field Mappings
sort_field [sort_field,...] (Facultatif)	Champ(s) dont les valeurs vont servir à réorganiser les enregistrements en entrée et sens de tri des enregistrements. Colonnes de la table de valeurs : `Field(s)`—The field that will be reordered. `Order`—The order in which the field will be reordered. `ASCENDING`—Records will be sorted from low value to high value. `DESCENDING`—Records will be sorted from high value to low value.	Value Table

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")

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

Le script autonome ci-après illustre l’utilisation de la fonction ExportFeatures.

# Name: ExportFeatures_Example2.py
# Description: Use Export Features 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/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
                               "NOT_USE_ALIAS")

Environnements

Espace de travail courant, Système de coordonnées en sortie, Etendue, 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, Gérer les noms de champs complets, 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 champs, Conserver les ID globaux

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui