Exporter des entités (Conversion)

Synthèse

Exporte les lignes d’une classe d’entités ou couche d’entités vers une 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 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 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.

  • Lors de la conversion de données de géodatabase qui possèdent des sous-types ou des domaines, les codes de domaine et de sous-type, ainsi que les descriptions peuvent figurer dans la sortie. Utilisez l'environnement 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 les descriptions de sous-type et de domaine ne sont pas requises dans la sortie, il est recommandé d’utiliser le paramètre par défaut (non coché) de l’environnement Transfert des descriptions de domaine de champ afin d’optimiser les performances.

Paramètres

ÉtiquetteExplicationType de données
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.

  • Désactivé : 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.
  • Activé : les alias de champ en entrée seront utilisés comme noms de champ en sortie.
Boolean
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
Champ de tri
(Facultatif)

Le ou les champs dont les valeurs vont servir à réorganiser les enregistrements en entrée et le sens de tri des enregistrements.

  • Croissant : les enregistrements seront triés du plus petit au plus grand.
  • Décroissant : les enregistrements seront triés du plus grand au plus petit.

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
NomExplicationType 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.

  • NOT_USE_ALIASLes noms de champ en entrée seront utilisés comme noms de champ en sortie. Il s’agit de l’option par défaut.
  • USE_ALIASLes alias de champ en entrée seront utilisés comme noms de champ en sortie.
Boolean
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.

Field Mappings
sort_field
[sort_field,...]
(Facultatif)

Le ou les champs dont les valeurs vont servir à réorganiser les enregistrements en entrée et le sens de tri des enregistrements.

  • ASCENDING : les enregistrements seront triés du plus petit au plus grand.
  • DESCENDING : les enregistrements seront triés du plus grand au plus petit.

Value Table

Exemple de code

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

La fenêtre de script Python suivante illustre l’utilisation de la fonction ExportFeatures en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportTable("streets", "C:/output/output.gdb/streets")
Exemple 2 d’utilisation de la fonction ExportFeatures (script autonome)

Le script autonome suivant 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'"

# Execute ExportFeatures
arcpy.ExportTable_conversion(inFeatures, outFeatureClass, expression,
                             "NOT_USE_ALIAS", None, None)

Informations de licence

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

Rubriques connexes