Преобразование таблицы в сводную таблицу – Документация Aspose.Cells Cloud

Этот REST API создает сводную таблицу из объекта списка.

Сводная таблица агрегирует данные из объекта списка, позволяя анализировать и отображать большие наборы данных непосредственно в рабочей книге.

Необходимые условия:

  • Действующий JWT-токен для аутентификации.
  • Рабочая книга должна существовать в указанном хранилище.
  • Целевой рабочий лист должен содержать объект списка, который вы хотите агрегировать.

API PostWorksheetListObjectSummarizeWithPivotTable

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/SummarizeWithPivotTable

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

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

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

Имя параметра Тип Расположение Описание
name string path Имя файла рабочей книги.
sheetName string path Рабочий лист, содержащий объект списка.
listObjectIndex integer path Индекс объекта списка на рабочем листе.
destsheetName string query Имя целевого рабочего листа.
request object body JSON-полезная нагрузка, определяющая сводную таблицу.
folder string query Путь к папке, где находится рабочая книга.
storageName string query Имя хранилища.

Тело запроса должно соответствовать следующей JSON-схеме:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "Name": { "type": "string", "description": "Имя новой сводной таблицы." },
    "DestCellName": { "type": "string", "description": "Верхняя левая ячейка сводной таблицы (например, «C1»)." },
    "PivotFieldRows": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "Нулевые индексы полей для размещения в строках."
    },
    "PivotFieldColumns": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "Нулевые индексы полей для размещения в столбцах."
    },
    "PivotFieldData": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "Нулевые индексы полей, используемых в качестве полей данных."
    }
  },
  "required": ["Name", "DestCellName", "PivotFieldRows", "PivotFieldColumns", "PivotFieldData"]
}

Спецификация OpenAPI определяет общедоступное программное интерфейсное взаимодействие и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать инструмент командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнить вызов Cloud API с помощью cURL.

Коды HTTP-статуса

Код Значение Описание
200 OK Фильтр успешно применён; в ответе содержатся детали операции.
400 Bad Request Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401 Unauthorized Некорректный или отсутствующий JWT-токен.
413 Payload Too Large Загружаемый файл превышает допустимый размер.
500 Internal Server Error Непредвиденная ошибка сервера.

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

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

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