Импорт данных в файлы Excel и экспорт данных из файлов Excel

API Aspose.Cells Cloud поддерживает импорт данных из различных источников и позволяет экспортировать рабочие книги Excel, диаграммы и другие объекты в различные форматы, включая XLSX, CSV, PDF, HTML, PNG и другие. Это делает управление данными и их обмен простыми и эффективными.

Версия API: v3.0 – Последнее обновление: 2024‑03‑15

Краткое руководство по началу работы

Подготовьте полезную нагрузку – Создайте JSON-тело, описывающее параметры импорта или экспорта (например, ImportCSVDataOption, ExportOptions).
Отправьте запрос – Используйте curl, Postman или SDK для вызова соответствующего конечного узла (POST /cells/import или POST /cells/export).
Обработайте ответ – При успешном выполнении вы получите обработанный файл (двоичный или в формате Base64). В случае ошибки проанализируйте код состояния HTTP и сообщение об ошибке, возвращённое в JSON-теле.

Необходимые условия

Активная учётная запись Aspose Cloud и действующий JWT-токен.
Целевая рабочая книга должна существовать в указанном месте хранения (для API, использующих хранилище).
Правильные заголовки Content-Type (multipart/form-data для загрузки файлов, application/json для JSON-тел).

Как импортировать данные из различных источников данных

Импорт данных в файл Excel предполагает решение нескольких задач, которые необходимо учесть в процессе. Возможность импорта данных различных форматов и типов с профессиональным качеством — ключевая функция Aspose.Cells Cloud.

Сведения об API импорта данных

Для импорта данных в один или несколько файлов Excel доступны следующие API:

API	Описание
POST /cells/import	Импорт данных в файлы Excel без использования хранилища.
POST /cells/{name}/importdata	Импорт данных в файл Excel, хранящийся в облаке.

Параметры запроса

Без использования хранилища

Имя параметра	Тип	Расположение	Описание
file	файл	formData	Файл для загрузки
ImportOption	ImportOptions	body	Указывает формат импорта (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

С использованием хранилища

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла Excel
folder	string	query	Путь к папке в хранилище
storageName	string	query	Имя хранилища
importData	ImportOptions	body	Полезная нагрузка для импорта данных

Параметры опции импорта данных

Важные параметры описаны в следующих таблицах:

ImportBatchDataOption

Параметр	Тип	Описание
BatchData	List<CellValue>	Пакетные данные для импорта
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

ImportCSVDataOption

Параметр	Тип	Описание
ConvertNumericData	boolean	Нужно ли преобразовывать числовые данные (true/false)
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
SeparatorString	string	Разделитель столбцов
DestinationWorksheet	string	Имя целевого рабочего листа
CustomParsers	List<CustomParserConfig>	Настройки пользовательских парсеров
ImportDataType	string	CSVData
Source	FileSource	Расположение файла данных при отсутствии BatchData

ImportPictureOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
IsVertical	boolean	Размещать ли изображение вертикально (true/false)
Data	string[]	Данные изображения (строки Base64)
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	Picture
Source	FileSource	Расположение файла данных при отсутствии BatchData

Import2DimensionIntArrayOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
Data	int[,]	Двумерный целочисленный массив
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

Import2DimensionDoubleArrayOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
Data	double[,]	Двумерный массив чисел с плавающей точкой двойной точности
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

Import2DimensionStringArrayOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
Data	string[,]	Двумерный строковый массив
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

ImportIntegerArrayOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
IsVertical	boolean	Расположен ли массив вертикально (true/false)
Data	int[]	Одномерный целочисленный массив
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

ImportDoubleArrayOption

Параметр	Тип	Описание
FirstRow	int	Индекс первой строки
FirstColumn	int	Индекс первого столбца
IsVertical	boolean	Расположен ли массив вертикально (true/false)
Data	double[]	Одномерный массив чисел с плавающей точкой двойной точности
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

ImportStringArrayOption

Параметр	Тип	Описание
UpperLeftRow	int	Индекс верхней левой строки
UpperLeftColumn	int	Индекс верхнего левого столбца
LowerRightRow	int	Индекс нижней правой строки
LowerRightColumn	int	Индекс нижнего правого столбца
Filename	string	Имя исходного файла
Data	string	Строковые данные для импорта
DestinationWorksheet	string	Имя целевого рабочего листа
IsInsert	boolean	Нужно ли вставлять данные (true/false)
ImportDataType	string	StringArray
Source	FileSource	Расположение файла данных при отсутствии BatchData

CellValue

Параметр	Тип	Описание
rowIndex	int	Индекс строки ячейки
columnIndex	int	Индекс столбца ячейки
type	string	Тип данных значения ячейки
value	string	Значение ячейки
style	Style (object)	Определение стиля ячейки

FileSource

Параметр	Тип	Описание
FileSourceType	string	InMemoryFiles, CloudFileSystem или RequestFiles
FilePath	string	Путь к исходному файлу

Как экспортировать объекты Excel в различные форматы файлов

Если вы изначально создали файл Excel в формате XLS, XLSX, XLSB или CSV, вам может понадобиться преобразовать его в другой формат для использования конкретных возможностей. Например, экспорт в PDF защищает содержимое от неавторизованных изменений и облегчает чтение и обмен файлами.

Экспорт объектов Excel предполагает учёт ряда факторов. Aspose.Cells Cloud обеспечивает высококачественный экспорт рабочих книг, диаграмм, фигур и изображений в широкий спектр форматов:

Форматы только для экспорта: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Форматы для импорта и экспорта: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

Запрос использует составное содержимое, как определено в [RFC 2046] и [RFC 1341]. Первая часть содержит файл данных; вторая часть — параметры сохранения.

Сведения об API экспорта

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

Параметры запроса

Имя параметра	Тип	Расположение	Описание
file	файл	formData	Файл для загрузки
objectType	string	query	Тип объекта (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Желаемый выходной формат файла (см. Поддерживаемые форматы файлов)

Спецификация OpenAPI определяет публично доступное программное интерфейсное определение, позволяющее выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для вызова API. В приведённом ниже примере показан запрос и его JSON-ответ.

Запрос

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

Ответ

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Распространённые HTTP-коды состояния

Код	Значение	Рекомендуемое действие
200	Успех — файл успешно экспортирован	Обработать полученный(е) файл(ы)
400	Неверный запрос — отсутствуют или некорректны параметры	Проверьте полезную нагрузку запроса и строки запроса
401	Неавторизован — недействительный или истёкший JWT-токен	Обновите токен и повторите попытку
404	Не найдено — указанная рабочая книга или лист не существуют	Проверьте имя файла и путь к хранилищу
500	Внутренняя ошибка сервера — неожиданное состояние сервера	Свяжитесь со службой поддержки Aspose, указав ID запроса

Как вызывать API импорта и экспорта

В следующих статьях подробно описаны каждый API и содержат примеры с использованием cURL и SDK:

Объединение и разделение файлов Excel Преобразование файла Excel в другой формат или сохранение его иным способом.