Установка значения диапазона в рабочем листе Excel — Aspose.Cells Cloud API
Используйте этот REST API для установки значения в указанный диапазон. При необходимости значение преобразуется в другой тип данных, а формат числа ячейки сбрасывается.
Необходимые условия
- Действующая учетная запись Aspose Cloud.
- JWT-токен, включающий область
Cells.ReadWrite. - Книга уже должна быть загружена в целевое хранилище.
API PostWorksheetCellsRangeValue
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value
Параметры запроса:
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя книги |
| sheetName | string | path | Имя рабочего листа |
| value | string | query | Входное значение |
| range | object | body | Объект диапазона на рабочем листе |
| isConverted | boolean | query | Указывает, следует ли преобразовывать входное значение |
| setStyle | boolean | query | Указывает, следует ли применять стиль к целевым ячейкам |
| folder | string | query | Папка книги |
| storageName | string | query | Имя хранилища |
Пример объекта range, который можно отправить в теле запроса:
{
"range": {
"FirstRow": 0,
"FirstColumn": 0,
"RowCount": 1,
"ColumnCount": 1
}
}
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия прямо из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример показывает, как вызвать облачный API с помощью cURL. Обязательно включите действующий JWT-токен в заголовке Authorization.
Схема ответа
| Поле | Тип | Описание |
|---|---|---|
| Code | integer | Код HTTP-статуса операции. |
| Status | string | Краткое описание результата (например, “OK”). |
| Message | string | Подробное сообщение об ошибке при неудачном запросе (необязательно). |
| Result | object | Дополнительные данные, возвращаемые при успешных вызовах (необязательно). |
Возможные HTTP-коды состояния
- 200 OK – значение диапазона успешно установлено.
- 400 Bad Request – недопустимые параметры или некорректно сформированное тело запроса.
- 401 Unauthorized – отсутствует или недействителен JWT-токен.
- 403 Forbidden – недостаточно прав для выполнения запрошенной операции.
- 404 Not Found – указанная книга, рабочий лист или диапазон не существует.
- 500 Internal Server Error – непредвиденная ошибка сервера.
Пример ответа об ошибке для кода 400 Bad Request:
{
"Code": 400,
"Status": "Bad Request",
"Message": "В объекте 'range' отсутствуют обязательные поля."
}
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах вашего проекта. Посетите репозиторий на GitHub, чтобы ознакомиться со полным списком облачных SDK Aspose.Cells.
Следующие примеры кода демонстрируют, как выполнять вызовы к веб-сервисам Aspose.Cells с использованием различных SDK: