Добавление диаграммы в рабочий лист — руководство по Aspose.Cells Cloud API
Этот REST API добавляет новую диаграмму в рабочий лист.
Необходимые условия
Перед вызовом данной операции получите действительный JWT-токен доступа и убедитесь, что целевая рабочая книга хранится в указанной папке или месте хранения.
API PutWorksheetAddChart
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя рабочей книги. |
| sheetName | string | path | Имя рабочего листа. |
| chartType | string | query | Тип диаграммы (см. свойство Type ресурса диаграммы). Поддерживаемые типы диаграмм включают Bar, Column, Line, Pie, Scatter, Area, Doughnut, Radar и др. |
| upperLeftRow | integer | query | Индекс верхней левой строки области диаграммы (начинается с 0). |
| upperLeftColumn | integer | query | Индекс верхнего левого столбца области диаграммы (начинается с 0). |
| lowerRightRow | integer | query | Индекс нижней правой строки области диаграммы (начинается с 0). |
| lowerRightColumn | integer | query | Индекс нижнего правого столбца области диаграммы (начинается с 0). |
| area | string | query | Диапазон, содержащий значения для построения диаграммы (например, A1:B5). |
| isVertical | boolean | query | Указывает, является ли ориентация диаграммы вертикальной. |
| categoryData | string | query | Диапазон значений оси категорий (например, D1:E10). |
| isAutoGetSerialName | boolean | query | Если true, имена серий генерируются автоматически. |
| title | string | query | Заголовок диаграммы. |
| folder | string | query | Папка, содержащая рабочую книгу. |
| storageName | string | query | Имя хранилища. |
| dataLabels | boolean | query | Отображать метки данных, если true. |
| dataLabelsPosition | string | query | Положение меток данных (например, Above). |
| pivotTableSheet | string | query | Имя листа, содержащего сводную таблицу. |
| pivotTableName | string | query | Имя сводной таблицы. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр успешно применён; ответ содержит подробную информацию об операции. |
| 400 | Bad Request | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large | Загружаемый файл превышает предельный размер. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Как использовать API PutWorksheetAddChart с SDK
Спецификация API PutWorksheetAddChart
OpenAPI-спецификация определяет общедоступное программное интерфейсное определение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Для доступа к веб-сервисам Aspose.Cells можно использовать утилиту командной строки cURL. Пример ниже демонстрирует вызов Cloud API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK абстрагирует низкоуровневые детали и позволяет сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud приведён в репозитории GitHub.
Примеры кода ниже демонстрируют вызовы веб-сервисов Aspose.Cells с использованием различных SDK: