Объединение совпадающих таблиц в удалённой папке

Объединение нескольких файлов электронных таблиц, расположенных в удалённой папке облачного хранилища Aspose Cloud, в один выходной файл. Операция выполняется полностью в облаке, исключая необходимость загрузки исходных файлов локально. Поддерживается более 30 выходных форматов (PDF, CSV, JSON, XLSX, ODS, XPS и др.).

API MergeSpreadsheetsInRemoteFolder

PUT https://api.aspose.cloud/v4.0/cells/merge/remote-spreadsheets

Безопасность и аутентификация

API Aspose.Cells Cloud являются защищёнными и требуют аутентификации по токену JWT.

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

Имя Тип Расположение Обязательный Описание
folder string query Да Папка облачного хранилища, содержащая исходные таблицы.
fileMatchExpression string query Да Шаблон для выбора файлов (например, *отчёт*.xlsx). Поддерживаются подстановочные знаки * и ?.
outFormat string query Да Желаемый выходной формат (PDF, CSV, JSON, XLSX, ODS, XPS и др.).
mergeInOneSheet boolean query Да true — все данные объединяются в одну рабочую таблицу. false — каждый исходный файл получает свою таблицу.
storageName string query Нет Имя пользовательского хранилища; по умолчанию используется основное хранилище.
outPath string query Нет Папка назначения для объединённого файла. Если не указано, файл сохраняется в исходной папке.
outStorageName string query Нет Имя хранилища, в которое будет записан объединённый файл.
fontsLocation string query Нет Путь к папке с пользовательскими шрифтами (требуется для экспорта в PDF/изображения).
region string query Нет Локаль для форматирования чисел, дат и валют (например, ru-RU, de-DE).
password string query Нет Пароль для открытия защищённых исходных таблиц.

Пример запроса (cURL) 

curl -X PUT "https://api.aspose.cloud/v4.0/cells/merge/remote-spreadsheets?folder=MyFolder&fileMatchExpression=*.xlsx&outFormat=PDF&mergeInOneSheet=true" \
     -H "Authorization: Bearer <access_token>" \
     -H "Accept: application/json"

Ответ

{
  "Name": "ResponseFile",
  "DataType": {
    "Identifier": "File",
    "Reference": "Stream"
  }
}

Файл можно загрузить непосредственно по ссылке FileUrl или сохранить в папке, указанной в outPath.

Детали успешного ответа

Код статуса Content‑Type Описание
200 OK application/octet-stream Бинарный поток объединённого файла.
202 Accepted application/json JSON, содержащий FileUrl, FileName и др.

Коды HTTP-статусов

Код Значение Описание
200 OK Фильтр применён успешно; ответ содержит детали операции.
400 Bad Request Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401 Unauthorized Недействительный или отсутствующий JWT-токен.
413 Payload Too Large Размер загружаемого файла превышает предельно допустимый.
500 Internal Server Error Непредвиденная ошибка сервера.

Как использовать API объединения таблиц с помощью SDK

Спецификация OpenAPI

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

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример показывает, как делать вызовы в облачный API с помощью cURL.

Использование SDK Aspose.Cells Cloud

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

Разделение таблицы Импорт данных XML в электронную таблицу