Как добавить сводную таблицу в рабочий лист Excel с помощью Aspose.Cells Cloud
Этот REST API добавляет сводную таблицу в рабочий лист.
Необходимые условия:
- Учётная запись Aspose.Cells Cloud с действительным JWT-токеном доступа.
- Целевая рабочая книга должна быть сохранена в поддерживаемом хранилище (по умолчанию или указанном пользователем).
- Рабочий лист, указанный через параметр
sheetName, должен существовать в рабочей книге.
API PutWorksheetPivotTable
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | путь | Имя документа Excel. |
| sheetName | string | путь | Имя рабочего листа, в котором будет создана сводная таблица. |
| request | object | тело | Объект CreatePivotTableRequest — DTO, содержащий определение сводной таблицы. |
| folder | string | запрос | Папка, содержащая документ. |
| storageName | string | запрос | Имя хранилища, в котором находится документ. |
| sourceData | string | запрос | Диапазон, предоставляющий исходные данные для нового кэша сводной таблицы (например, A5:E10). |
| destCellName | string | запрос | Адрес левой верхней ячейки целевого диапазона для отчёта сводной таблицы. |
| tableName | string | запрос | Имя, присваиваемое новой сводной таблице. |
| useSameSource | boolean | запрос | Если true, новая сводная таблица повторно использует существующий источник данных, экономя память, если другой сводная таблица уже использует этот источник. |
Спецификация OpenAPI определяет общедоступное программное API-интерфейс и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример показывает, как вызвать облачный API с помощью cURL.
Примечание по безопасности: Всегда используйте https:// при вызове API и храните JWT-токен в секрете; передача его по незащищённому HTTP может привести к его перехвату.
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали выполнения операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой payload) | Загруженный файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Семейство облачных SDK
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:
Дополнительные операции доступны на соответствующих страницах API: Получить сводную таблицу, Удалить сводную таблицу и Обновить сводную таблицу.