Поиск текста в удаленных файлах Excel — извлечение данных из конкретных диапазонов
Contents
[
Hide
]
Поиск содержимого в удаленном диапазоне
Программно ищите конкретный текст в любом диапазоне электронных таблиц Excel с помощью API Aspose.Cells Cloud. Находите текст, числа или формулы в файлах, хранящихся в облачном хранилище. RESTful API для автоматизированного обнаружения данных, анализа содержимого и выполнения процессов аудита электронных таблиц.
Веб-API
PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{cellArea}/search/content
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.
-H "Authorization: Bearer {access_token}"
Пример cURL
curl -X PUT "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/worksheets/Orders_2024/ranges/B2:H100/search/content?searchText=Report&ignoreCase=true" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"
Параметры запроса
| Имя параметра | Тип | Путь/Запрос/Строка/HTTPBody | Описание |
|---|---|---|---|
| name | String | Path | Обязательный. Имя файла (с расширением) книги Excel, в которой необходимо выполнить поиск, например customer_data.xlsx. |
| worksheet | String | Path | Обязательный. Точное имя листа внутри книги, в котором необходимо выполнить поиск, например Orders_2024. |
| cellArea | String | Path | Обязательный. Целевой диапазон ячеек для поиска, указанный в нотации A1 (например, B2:H100). Поиск ограничен этой областью. |
| searchText | String | Query | Обязательный. Конкретная строка текста, число или фрагмент содержимого, который необходимо найти в заданном диапазоне ячеек. |
| ignoreCase | Boolean | Query | Необязательный. Если установлено значение true, поиск игнорирует регистр (например, «Report» соответствует «report»). По умолчанию — false (с учетом регистра). |
| folder | String | Query | Необязательный. Путь к каталогу в вашем облачном хранилище, где находится книга. Если не указан, используется корневой каталог. |
| storageName | String | Query | Необязательный. Идентификатор настраиваемой конфигурации облачного хранилища. Если не указан, используется хранилище по умолчанию для аккаунта. |
| region | String | Query | Необязательный. Настройки культуры/региона (например, ru-RU), которые могут повлиять на интерпретацию регионально-специфичных символов или форматов при поиске. |
| password | String | Query | Необязательный. Пароль для расшифровки и доступа к защищенному паролем файлу электронной таблицы. Не указывайте, если файл не зашифрован. |
Ответ
{
"Code": 200,
"Status": "OK",
"TextItems": [
{
"Filename": "string",
"Worksheet": "string",
"Position": "string",
"Content": "string"
}
]
}
Коды ошибок
- 400 Bad Request — Неверный URI API Aspose.Cells Cloud.
- 401 Unauthorized — Неверный токен доступа, client ID или client secret.
- 404 Not Found — Файл электронной таблицы недоступен.
- 500 Server Error — Непредвиденное состояние, препятствующее выполнению запроса сервером.
Где следует использовать API поиска содержимого в диапазоне электронной таблицы?
- Масштабная проверка качества данных — На этапе приемки в процессе ETL хранилища данных ищите отсутствующие описания полей, неопредленные сокращения или заполнители (например,
"TBD"или"NULL") в таблице сопоставления данных (DataDictionary!B2:F1000), чтобы выявить неполные определения данных. - Динамическая генерация отчетов и извлечение содержимого — В автоматизированных системах формирования отчетов интеллектуально ищите и извлекайте блоки данных текущего периода, помеченные конкретными идентификаторами (например,
"[KPI]"), из шаблонных листов с разнородными данными (Monthly_Metrics!C10:G50) для формирования окончательного отчета. - Анализ контрактных и юридических документов — При проверке приложений к электронным таблицам, содержащих много условий, эффективно находите конкретные юридические термины (например,
"liability limit"), названия сторон или даты в заданном диапазоне (Contract_Terms!A:A), чтобы ускорить процесс проверки.
Почему стоит использовать API поиска содержимого в диапазоне электронной таблицы?
- Удобный для разработчиков — Aspose.Cells Cloud предоставляет SDK-библиотеки на множестве языков программирования, что позволяет быстро разрабатывать решения при наличии подробной документации, значительно сокращая объем работы по сравнению с созданием собственных решений.
- Снижение трудозатрат — Устраняет необходимость в отдельных сотрудниках, отвечающих за консолидацию документов.
- Платежи по факту использования — Нет необходимости в первоначальных вложениях; вы платите только за фактически выполненные вызовы API.
- Отсутствие затрат на обслуживание — Нет необходимости в обслуживании серверов, обновлении программного обеспечения и решении проблем совместимости.
Как использовать API поиска содержимого в диапазоне электронной таблицы с помощью SDK
Спецификация OpenAPI
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия напрямую из веб-браузера.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK скрывает детали реализации, позволяя вам просто реализовать поиск содержимого в диапазоне ячеек с минимальным количеством кода. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Следующие примеры кода демонстрируют, как выполнять вызовы веб-сервисов Aspose.Cells Cloud с использованием различных SDK: