Importer des données dans des fichiers Excel et exporter des données depuis des fichiers Excel

L’API Aspose.Cells Cloud permet d’importer des données provenant de nombreuses sources différentes, ainsi que d’exporter des classeurs, des graphiques et d’autres objets Excel vers divers formats, notamment XLSX, CSV, PDF, HTML, PNG, etc. Cela simplifie la gestion et le partage des données.

Version de l’API : v3.0 – Dernière mise à jour : 2024‑03‑15

Guide de démarrage rapide

Préparer le corps de la requête (payload) – Construisez un corps JSON décrivant les options d’importation ou d’exportation (par exemple, ImportCSVDataOption, ExportOptions).
Envoyer la requête – Utilisez curl, Postman ou un SDK pour appeler le point de terminaison approprié (POST /cells/import ou POST /cells/export).
Gérer la réponse – En cas de succès, vous recevez le fichier traité (binaire ou en Base64). En cas d’erreur, examinez le code de statut HTTP et le message d’erreur renvoyé dans le corps JSON.

Conditions préalables

Un compte Aspose Cloud actif et un jeton JWT valide.
Le classeur cible doit exister à l’emplacement de stockage spécifié (pour les API basées sur le stockage).
En-têtes Content-Type corrects (multipart/form-data pour les téléchargements de fichiers, application/json pour les corps JSON).

Comment importer des données à partir de diverses sources

L’importation de données dans un fichier Excel implique plusieurs considérations à prendre en compte pendant le processus. La capacité à importer de nombreux formats et types de données avec une qualité professionnelle constitue l’une des principales fonctionnalités d’Aspose.Cells Cloud.

Informations sur les API d’importation de données

Les API suivantes sont fournies pour importer des données dans un ou plusieurs fichiers Excel :

API	Description
POST /cells/import	Importer des données dans des fichiers Excel sans utiliser de stockage.
POST /cells/{name}/importdata	Importer des données dans un fichier Excel stocké dans le cloud.

Paramètres de la requête

Sans utilisation de stockage

Nom du paramètre	Type	Emplacement	Description
file	fichier	formData	Fichier à télécharger
ImportOption	ImportOptions	body	Spécifie le format d’importation (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Avec utilisation de stockage

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du fichier Excel
folder	string	query	Chemin du dossier dans le stockage
storageName	string	query	Nom du stockage
importData	ImportOptions	body	Corps de données à importer

Paramètres des options d’importation de données

Les paramètres importants sont décrits dans les tableaux suivants :

ImportBatchDataOption

Paramètre	Type	Description
BatchData	List<CellValue>	Données en lot à importer
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

ImportCSVDataOption

Paramètre	Type	Description
ConvertNumericData	boolean	Indique s’il faut convertir les données numériques (true/false)
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
SeparatorString	string	Séparateur de colonnes
DestinationWorksheet	string	Nom de la feuille de calcul de destination
CustomParsers	List<CustomParserConfig>	Configurations des analyseurs personnalisés
ImportDataType	string	CSVData
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

ImportPictureOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
IsVertical	boolean	Indique si l’image est placée verticalement (true/false)
Data	string[]	Données d’image (chaînes en Base64)
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	Picture
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

Import2DimensionIntArrayOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
Data	int[,]	Tableau d’entiers à deux dimensions
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

Import2DimensionDoubleArrayOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
Data	double[,]	Tableau de nombres à virgule flottante à deux dimensions
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

Import2DimensionStringArrayOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
Data	string[,]	Tableau de chaînes à deux dimensions
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

ImportIntegerArrayOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
IsVertical	boolean	Indique si le tableau est vertical (true/false)
Data	int[]	Tableau d’entiers à une dimension
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

ImportDoubleArrayOption

Paramètre	Type	Description
FirstRow	int	Index de la première ligne
FirstColumn	int	Index de la première colonne
IsVertical	boolean	Indique si le tableau est vertical (true/false)
Data	double[]	Tableau de nombres à virgule flottante à une dimension
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

ImportStringArrayOption

Paramètre	Type	Description
UpperLeftRow	int	Index de la ligne supérieure gauche
UpperLeftColumn	int	Index de la colonne supérieure gauche
LowerRightRow	int	Index de la ligne inférieure droite
LowerRightColumn	int	Index de la colonne inférieure droite
Filename	string	Nom du fichier source
Data	string	Données textuelles à importer
DestinationWorksheet	string	Nom de la feuille de calcul de destination
IsInsert	boolean	Indique s’il faut insérer les données (true/false)
ImportDataType	string	StringArray
Source	FileSource	Emplacement du fichier de données lorsque BatchData est null

CellValue

Paramètre	Type	Description
rowIndex	int	Index de ligne de la cellule
columnIndex	int	Index de colonne de la cellule
type	string	Type de données de la valeur de la cellule
value	string	Valeur de la cellule
style	Style (objet)	Définition du style de cellule

FileSource

Paramètre	Type	Description
FileSourceType	string	InMemoryFiles, CloudFileSystem ou RequestFiles
FilePath	string	Chemin vers le fichier source

Comment exporter des objets Excel vers divers formats de fichier

Si vous avez initialement créé un fichier Excel dans un format tel que XLS, XLSX, XLSB ou CSV, vous souhaiterez peut-être le convertir vers un autre format afin de tirer parti de fonctionnalités spécifiques. Par exemple, l’exportation vers PDF protège le contenu contre les modifications non autorisées tout en facilitant sa lecture et son partage.

L’exportation d’objets Excel implique plusieurs considérations. Aspose.Cells Cloud permet d’exporter des classeurs, des graphiques, des formes et des images vers de nombreux formats, avec une qualité élevée :

Formats à usage uniquement d’exportation : PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Formats supportant à la fois l’importation et l’exportation : XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

La requête utilise un contenu multiparte tel que défini dans [RFC 2046] et [RFC 1341]. La première partie contient le fichier de données ; la deuxième partie contient les options d’enregistrement.

Informations sur l’API d’exportation

POST https://api.aspose.cloud/v3.0/cells/export

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
file	fichier	formData	Fichier à télécharger
objectType	string	query	Type d’objet (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Format de fichier de sortie souhaité (voir Formats de fichier pris en charge)

La Spécification OpenAPI définit une interface de programmation accessible publiquement qui permet d’effectuer des interactions REST directement depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler l’API. L’exemple ci-dessous illustre une requête et sa réponse JSON.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>" \
  -F 'file1=@exemple1.xlsx' \
  -F 'file2=@exemple2.xlsx'

Réponse

{
  "Files": [
    {
      "Filename": "exemple1.pdf",
      "FileSize": 274022,
      "FileContent": "-----ChaîneBase64--------"
    },
    {
      "Filename": "exemple2.pdf",
      "FileSize": 274022,
      "FileContent": "-----ChaîneBase64--------"
    }
  ]
}

Codes de statut HTTP courants

Statut	Signification	Action recommandée
200	Succès – le fichier a été exporté	Traiter le ou les fichiers renvoyés
400	Requête incorrecte – paramètres manquants ou non valides	Vérifier le corps et les chaînes de requête
401	Non autorisé – jeton JWT invalide ou expiré	Actualiser le jeton et réessayer
404	Introuvable – le classeur ou la feuille de calcul spécifié n’existe pas	Vérifier le nom du fichier et le chemin de stockage
500	Erreur interne du serveur – condition inattendue sur le serveur	Contacter le support Aspose avec l’ID de la requête

Comment appeler les API d’importation et d’exportation

Les articles suivants expliquent chaque API en détail et contiennent des exemples cURL et SDK :

Fusionner et diviser des fichiers Excel Convertir un fichier Excel dans un autre format ou l’enregistrer différemment.