Группировка столбцов — Документация Aspise.Cells Cloud API

Группировка столбцов в Excel-таблице

Версия API: v3.0
Операция: PostGroupWorksheetColumns — группировка столбцов рабочего листа.

Обзор

Этот REST API позволяет сгруппировать диапазон столбцов на рабочем листе. Группируемые столбцы можно отображать или скрывать, что позволяет создавать сворачиваемые секции, аналогичные тем, что реализованы в Microsoft Excel.

Предварительные требования

Действующий JWT-токен доступа, полученный из службы аутентификации Aspose Cloud.
Книга должна храниться в месте, доступном для Aspose.Cells Cloud (по умолчанию — в облачном хранилище, либо в пользовательском хранилище).
Требуемая версия SDK (если используется SDK): последняя версия, поддерживающая API v3.0.

Аутентификация

Все запросы требуют аутентификации с использованием Bearer-токена.

Authorization: Bearer <access_token>

Сведения о получении токена см. в руководстве по аутентификации JWT.

HTTP-запрос

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

Параметр	Место	Обязательный	Описание
`name`	Path	Да	Имя файла книги (например, `test.xlsx`).
`sheetName`	Path	Да	Имя рабочего листа, содержащего столбцы для группировки.
`firstIndex`	Query	Да	Нулевой индекс первого столбца, включаемого в группу.
`lastIndex`	Query	Да	Нулевой индекс последнего столбца, включаемого в группу.
`hide`	Query	Нет	Если `true`, сгруппированные столбцы скрываются; иначе остаются видимыми.
`folder`	Query	Нет	Путь к папке, содержащей книгу.
`storageName`	Query	Нет	Имя сервиса хранилища, где расположен файл.

Пример запроса (cURL)

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Примечание: Запрос использует HTTPS для обеспечения зашифрованной передачи данных.

Ответ

Успех (200)

Поле	Тип	Описание
`Code`	integer	HTTP-код статуса (`200`).
`Status`	string	Текстовое описание состояния операции (`OK`).

Пример

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

Ошибка (например, 400 Bad Request)

Поле	Тип	Описание
`Code`	integer	HTTP-код статуса (`400`, `401`, `404`, `500`, …).
`Status`	string	Текстовое описание (`Error`).
`ErrorMessage`	string	Человекочитаемое описание ошибки.
`ErrorCode`	string	Программный идентификатор ошибки.

Пример — Неверный запрос

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Недопустимый индекс столбца.",
  "ErrorCode": "InvalidParameter"
}

Примеры SDK

Ниже приведены фрагменты кода, демонстрирующие вызов операции Group Worksheet Columns с использованием поддерживаемых SDK.

Примечания

Поведение при группировке: API создаёт группу столбцов, которую можно разворачивать и сворачивать в Excel. При установке hide=true группа сразу сворачивается.
Нумерация с нуля: Параметры firstIndex и lastIndex начинаются с 0; первый столбец на листе имеет индекс 0.
Работа со хранилищем: Если книга хранится не в хранилище по умолчанию, необходимо указать оба параметра запроса: folder и storageName.

См. также

Иллюстрация: {: .img-fluid alt=“Снимок экрана сгруппированных столбцов в Excel-таблице” }

Вышеприведённое заглушечное изображение следует заменить реальным скриншотом, демонстрирующим визуальный результат группировки столбцов.