Автоматическая подстройка строк в рабочей тетради Excel – Aspose.Cells Cloud API

Необходимые условия
Перед вызовом API получите действительный токен Bearer JWT из сервиса аутентификации Aspose и убедитесь, что целевая рабочая тетрадь хранится в поддерживаемом хранилище (по умолчанию — в облачном хранилище Aspose или в настроенном вами пользовательском хранилище).

Этот REST API позволяет вам автоматически подстраивать строки в рабочей тетради Excel, автоматически изменяя высоту строк после вставки или изменения данных.

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/autofitrows

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

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла рабочей тетради.
autoFitterOptions	AutoFitterOptions	body	Параметры, управляющие поведением автофиттера.
startRow	integer	query	Индекс первой строки для подстройки.
endRow	integer	query	Индекс последней строки для подстройки.
firstColumn	integer	query	Индекс первого столбца, учитываемого при подстройке.
lastColumn	integer	query	Индекс последнего столбца, учитываемого при подстройке.
onlyAuto	boolean	query	Если true, обрабатываются только строки с флагом AutoFit (по умолчанию false).
folder	string	query	Путь к папке, где хранится рабочая тетрадь.
storageName	string	query	Имя сервиса хранилища.

AutoFitterOptions — объект, определяющий поведение операции автофиттирования (например, AutoFitMergedCells, IgnoreHidden).

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

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

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

Вы можете использовать утилиту командной строки cURL для вызова веб-сервисов Aspose.Cells. Замените <jwt token> на действительный токен Bearer JWT, полученный из сервиса аутентификации Aspose.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/autofitrows" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"AutoFitMergedCells":true, "IgnoreHidden":true}'

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Пример ответа об ошибке (например, отсутствующая рабочая тетрадь):

{
  "Code": 404,
  "Status": "Not Found",
  "Message": "Указанная рабочая тетрадь 'myWorkbook.xlsx' не существует."
}

Примечания

Если AutoFitMergedCells установлено в true, объединённые ячейки обрабатываются как единое целое при операции автофиттирования.
При установке IgnoreHidden в true скрытые строки и столбцы пропускаются, сохраняя их текущие размеры.

Семейство облачных SDK

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

Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Очистка объектов в файле Excel Получение имен из рабочей книги Excel