Перемещение именованного диапазона в рабочей книге Excel с помощью API Aspose.Cells Cloud
Перемещение именованного диапазона — распространённая задача при необходимости программной переорганизации данных. В этом разделе описано, как переместить определённый диапазон на новую позицию в той же рабочей книге с использованием REST API Aspose.Cells Cloud.
Этот REST API перемещает указанный диапазон в целевой диапазон на рабочей книге Excel.
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/moveto
Аутентификация
API требует Bearer JWT-токена, полученного через OAuth-процедуру Aspose Cloud. Включите токен в заголовок Authorization:
Authorization: Bearer <jwt token>
Токен должен иметь область доступа Cells.
Предварительные требования
- Рабочая книга должна храниться в облачном хранилище Aspose Cloud.
- Укажите имя хранилища (
storageName) и путь к папке (folder), если файл находится не в корневом каталоге. - Используйте последнюю версию SDK Aspose.Cells Cloud, поддерживающую версию API v3.0.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя файла рабочей книги |
| sheetName | string | path | Имя рабочей книги |
| destRow | integer | query | Индекс первой строки целевого диапазона (начиная с 0) |
| destColumn | integer | query | Индекс первого столбца целевого диапазона (начиная с 0) |
| range | object | body | Описание исходного диапазона, который необходимо переместить |
| folder | string | query | Путь к папке, где хранится рабочая книга |
| storageName | string | query | Имя облачного хранилища Aspose Cloud |
Тело запроса
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| ColumnCount | integer | Нет | Количество столбцов в исходном диапазоне |
| ColumnWidth | integer | Нет | Ширина каждого столбца (в пунктах) |
| FirstColumn | integer | Нет | Индекс первого столбца исходного диапазона (начиная с 0) |
| FirstRow | integer | Нет | Индекс первой строки исходного диапазона (начиная с 0) |
| Name | string | Нет | Имя диапазона (если это именованный диапазон) |
| RefersTo | string | Нет | Ссылка в стиле A1, определяющая диапазон |
| RowCount | integer | Нет | Количество строк в исходном диапазоне |
| RowHeight | integer | Нет | Высота каждой строки (в пунктах) |
| Worksheet | string | Нет | Рабочая книга, содержащая исходный диапазон |
Порядок выполнения
- Загрузите рабочую книгу в облачное хранилище Aspose Cloud (если она ещё не загружена).
- Создайте JWT-токен с помощью OAuth-эндпоинта.
- Сформируйте JSON-полезную нагрузку, описывающую исходный диапазон.
- Вызовите эндпоинт
moveto, указав необходимые параметры пути, запроса и JSON-тело. - Проверьте ответ: при успешном вызове возвращается статус
200 OK.
Пример запроса / ответа
При возникновении ошибки в ответе присутствует необязательное поле ErrorMessage, содержащее дополнительные сведения об ошибке.
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (Успех) | Фильтр применён успешно; ответ содержит сведения об операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Некорректный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой payload) | Загружаемый файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Схема ответа
| Поле | Тип | Описание |
|---|---|---|
| Code | integer | Код статуса HTTP-подобного ответа, возвращаемого API (например, 200) |
| Status | string | Текстовое описание результата (например, “OK”) |
| ErrorMessage | string (необязательно) | Читаемые человеком сведения об ошибке при неудачном вызове |
Семейство облачных SDK
Использование SDK — оптимальный способ ускорить разработку. SDK скрывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Примеры кода ниже демонстрируют, как вызывать веб-сервисы Aspose.Cells с помощью различных SDK: