Table vers Excel (Conversion)

Synthèse

Convertit une table en un fichier Microsoft Excel (.xls ou .xlsx).

Utilisation

  • L’extension du fichier en sortie précise le format Excel en sortie utilisé. Si l’extension est .xls, le fichier est au format Excel binaire. Si l’extension est .xlsx, le fichier est au format Office Open XML.

  • Le fichier .xls est limité à 65 535 lignes et 256 colonnes.

  • Le fichier Excel en sortie peut contenir plusieurs feuilles. Le nom de chaque feuille sera identique au nom de la table en entrée correspondante, sans l’extension de fichier .xls ou .xlsx.

    Remarque :

    L’ordre d’apparence des feuilles de calcul sera identique à leur ordre d’affichage dans le paramètre. En cas de conflit de noms, un nombre est ajouté au nom de la feuille afin que chacun reste unique.

  • Lors de la conversion d’une table, les champs de type décalage de l’horodatage sont écrits dans Excel sous la forme de valeurs de chaîne ISO 8601.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table(s) à convertir en un fichier Excel.

Table View
Fichier Excel en sortie (.xls ou .xlsx)

Le fichier Excel en sortie. Indiquez le format du fichier Excel avec l’extension .xls ou .xlsx.

File
Utiliser l’alias de champ comme en-tête de colonne
(Facultatif)

Indique si les noms ou alias de champ en entrée seront utilisés comme noms de colonne en sortie.

  • Désactivé : les en-têtes de colonne seront définis à l’aide des noms de champ en entrée. Il s’agit de l’option par défaut.
  • Activé : les en-têtes de colonne sont définis à l'aide des alias de champ de la table de géodatabase en entrée. Si l'entrée est une couche dans une carte, la valeur définie sur l'alias de champ de la couche est ignorée.
Boolean
Utiliser la description des domaines et des sous-types
(Facultatif)

Indique si les valeurs des champs de sous-type ou des champs dotés d’un domaine de valeurs précodées seront transférées dans la sortie.

  • Désactivée : toutes les valeurs de champ sont utilisées lorsqu'elles sont stockées dans la table. Il s’agit de l’option par défaut.
  • Activée : pour les champs de sous-type, la description du sous-type est utilisée. Pour les champs dotés d'un domaine de valeurs précodées, les descriptions des valeurs précodées sont utilisées.
Boolean

arcpy.conversion.TableToExcel(Input_Table, Output_Excel_File, {Use_field_alias_as_column_header}, {Use_domain_and_subtype_description})
NomExplicationType de données
Input_Table
[Input_Table,...]

Table(s) à convertir en un fichier Excel.

Table View
Output_Excel_File

Le fichier Excel en sortie. Indiquez le format du fichier Excel avec l’extension .xls ou .xlsx.

File
Use_field_alias_as_column_header
(Facultatif)

Indique si les noms ou alias de champ en entrée seront utilisés comme noms de colonne en sortie.

  • NAMELes en-têtes de colonne seront définis à l’aide des noms de champ en entrée. Il s’agit de l’option par défaut.
  • ALIASLes en-têtes de colonne sont définis à l'aide des alias de champ de la table de géodatabase en entrée. Si l'entrée est une couche dans une carte, la valeur définie sur l'alias de champ de la couche est ignorée.
Boolean
Use_domain_and_subtype_description
(Facultatif)

Indique si les valeurs des champs de sous-type ou des champs dotés d’un domaine de valeurs précodées seront transférées dans la sortie.

  • CODEToutes les valeurs de champ sont utilisées lorsqu'elles sont stockées dans la table. Il s’agit de l’option par défaut.
  • DESCRIPTIONPour les champs de sous-type, la description du sous-type est utilisée. Pour les champs dotés d'un domaine de valeurs précodées, les descriptions des valeurs précodées sont utilisées.
Boolean

Exemple de code

Exemple d'utilisation de l'outil TableToExcel (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction TableToExcel en mode immédiat.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.TableToExcel("gdb.gdb/addresses", "addresses.xls")
2e exemple d'utilisation de l'outil TableToExcel (script autonome)

Conversion d’une table en classeur Excel.

import arcpy

# Set environment settings
arcpy.env.workspace = "c:/data"

# Set local variables
in_table = "gdb.gdb/addresses"
out_xls = "addresses.xls"

# Run TableToExcel
arcpy.conversion.TableToExcel(in_table, out_xls)

Rubriques connexes