Обзор
Операция Сопоставление всех непустых ячеек применяет автофильтр к рабочему листу и возвращает только те строки, в указанным столбце которых содержатся данные, игнорируя пустые ячейки. Это полезно для очистки наборов данных, генерации отчетов или подготовки данных к дальнейшему анализу.
Необходимые условия
- Действующий JWT-токен для аутентификации в Aspose.Cells Cloud.
- Книга должна быть загружена в облачное хранилище Aspose.
- Требуется имя файла, имя рабочего листа и индекс столбца (с нулевым основанием —
fieldIndex), к которому применяется фильтр.
Этот REST API сопоставляет все непустые ячейки в списке автофильтра на рабочем листе Excel.
API PostWorksheetMatchNonBlanks
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/matchNonBlanks
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя файла Excel. |
| sheetName | string | path | Имя рабочего листа, содержащего автофильтр. |
| fieldIndex | integer | query | Индекс столбца (с нулевым основанием), к которому применяется фильтр. |
| folder | string | query | (Опционально) Путь к папке, где хранится файл. |
| storageName | string | query | (Опционально) Имя используемого сервиса хранилища. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Неверный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой полезный груз) | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Пример ответа об ошибке (400)
{
"Code": 400,
"Message": "Неверный параметр: fieldIndex должен быть неотрицательным целым числом."
}
Как использовать API PostWorksheetMatchNonBlanks с SDK
Спецификация API PostWorksheetMatchNonBlanks
Спецификация OpenAPI определяет общедоступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже демонстрирует, как выполнять вызовы в облачный API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Примеры кода ниже показывают, как выполнять вызовы в веб-сервисы Aspose.Cells с использованием различных SDK: