Преобразование файлов Excel в PDF, CSV, JSON и другие форматы с помощью Aspose.Cells Cloud

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

Необходимые условия
Перед вызовом API для преобразования получите токен доступа OAuth 2.0 от Aspose Cloud и убедитесь, что рабочая книга хранится в облачном хранилище Aspose Cloud (или передаётся в теле запроса для эндпоинта преобразования PUT).

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

Сервис одинаково хорошо работает для преобразования документов любого формата. Вы можете как импортировать, так и экспортировать документы в следующих форматах:

Поддерживаемые форматы

API для преобразования

API Описание
GET /cells/{name} Извлекает рабочую книгу Excel из облачного хранилища и преобразует её в указанный формат.
PUT /cells/convert Преобразует рабочую книгу Excel, переданную в теле запроса, в указанный выходной формат.
POST /cells/{name}/saveAs Сохраняет существующую рабочую книгу Excel в другом формате непосредственно в облачное хранилище.

Детали API

  • GET /cells/{name}

    • Параметры пути: name — имя файла рабочей книги (обязательный параметр).
    • Параметры запроса: format — целевой формат (например, pdf, csv, json); storage — имя облачного хранилища (необязательный); folder — путь к папке внутри хранилища (необязательный).
    • Ответ: Поток данных преобразованной рабочей книги; Content-Type соответствует целевому формату.
    • Коды состояния: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 500 Internal Server Error.

  • PUT /cells/convert

    • Тело запроса: multipart/form‑data, содержащее исходный файл рабочей книги (file) и обязательное поле format, указывающее желаемый выходной формат.
    • Ответ: Бинарный поток преобразованного файла.
    • Коды состояния: 200 OK, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error.

  • POST /cells/{name}/saveAs

    • Параметры пути: name — имя существующей рабочей книги.

    • Параметры запроса: format — целевой формат; outPath — путь назначения в облачном хранилище (необязательный); storage — имя хранилища (необязательный).

    • Ответ: Объект JSON с результатом операции и путём сохранённого файла. Пример ответа:

      {
  "status": "OK",
  "code": 200,
  "message": "Файл успешно сохранён.",
  "path": "Converted/MyWorkbook.pdf"
}

    • Коды состояния: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 500 Internal Server Error.

Пример cURL для преобразования в PDF

curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx?format=pdf" \
  -H "Authorization: Bearer {access_token}" \
  -o MyWorkbook.pdf

Фрагмент кода SDK для Java (GET /cells/{name})

CellsApi apiInstance = new CellsApi();
String name = "MyWorkbook.xlsx";
String format = "pdf";
File result = apiInstance.cellsGetWorkbook(name, format, null, null);
result.renameTo(new File("MyWorkbook.pdf"));

Фрагмент кода SDK для .NET (PUT /cells/convert)

var api = new CellsApi();
var file = File.ReadAllBytes("MyWorkbook.xlsx");
var format = "pdf";
var result = api.ConvertWorkbook(new MemoryStream(file), format);
File.WriteAllBytes("MyWorkbook.pdf", result);

Фрагмент кода SDK для Python (POST /cells/{name}/saveAs)

import asposecellscloud
api = asposecellscloud.CellsApi()
api.post_save_as(name="MyWorkbook.xlsx", format="pdf", out_path="Converted/MyWorkbook.pdf")

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

Объединение и разделение файлов Excel Пакетная обработка файлов Excel: преобразование, блокировка, защита, разделение и снятие блокировки