Обновление фигуры на листе Excel — API Aspose.Cells Cloud

Этот REST API обновляет фигуру на листе Excel.

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

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

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}

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

Имя параметра Тип Местоположение Описание
name string path Имя файла рабочей книги.
sheetName string path Имя листа, содержащего фигуру.
shapeindex integer path Индекс фигуры (начиная с нуля) на листе.
dto object body Объект передачи данных фигуры, содержащий обновлённые свойства (см. Схему DTO ниже).
folder string query Папка, в которой хранится рабочая книга.
storageName string query Имя облачного хранилища Aspose Cloud.

Схема DTO

Объект dto содержит свойства, которые можно обновить. Все поля являются необязательными, если не указано иное.

Поле Тип Обязательное Описание
Name string Нет Новое имя фигуры.
UpperLeftRow integer Нет Индекс строки верхнего левого угла фигуры.
UpperLeftColumn integer Нет Индекс столбца верхнего левого угла фигуры.
Width integer Нет Ширина фигуры (в пунктах).
Height integer Нет Высота фигуры (в пунктах).
RotationAngle integer Нет Угол поворота в градусах.
IsHidden boolean Нет true, чтобы скрыть фигуру.
IsLocked boolean Нет true, чтобы заблокировать фигуру.
Font object Нет Параметры шрифта (см. OpenAPI-спецификацию для подсвойств).
… … Нет Дополнительные свойства, такие как HtmlText, AlternativeText, ZOrderPosition и др.

Полный список доступен в официальной OpenAPI-спецификации: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

Заголовки запроса

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (JWT-токен, полученный на этапе Аутентификации)

Тело запроса (пример)

{
  "Name": "MyShape",
  "UpperLeftRow": 2,
  "UpperLeftColumn": 3,
  "Width": 150,
  "Height": 80,
  "RotationAngle": 0,
  "IsHidden": false,
  "IsLocked": false,
  "Font": {
    "Name": "Calibri",
    "Size": 12,
    "IsBold": true,
    "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }
  }
}

Пример с использованием cURL (инструмент командной строки)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes/0?folder=Temp" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
        "Name": "UpdatedShape",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

Ответ

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

Обработка ошибок – API может возвращать следующие коды состояния:

Код Значение Типичная причина
400 Bad Request Неверный JSON или отсутствуют обязательные поля.
401 Unauthorized Отсутствует или недействителен JWT-токен.
404 Not Found Рабочая книга, лист или индекс фигуры не найдены.
500 Internal Server Error Непредвиденная ошибка на стороне сервера.

Примеры ответов об ошибках

400 – Bad Request

{
  "Code": 400,
  "Message": "Неверный полезный запрос. Поле 'Name' превышает максимальную длину."
}

401 – Unauthorized

{
  "Code": 401,
  "Message": "Ошибка аутентификации. Недействительный или просроченный JWT-токен."
}

404 – Not Found

{
  "Code": 404,
  "Message": "Указанная рабочая книга, лист или индекс фигуры не найдены."
}

500 – Internal Server Error

{
  "Code": 500,
  "Message": "На сервере произошла непредвиденная ошибка."
}

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

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

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

Добавление фигуры в рабочий лист Excel Удаление всех фигур на листе Excel