API для поиска по содержимому электронной таблицы

Программно ищите конкретный текст в любой электронной таблице Excel с помощью Aspose.Cells Cloud API. API позволяет находить текст, числа или формулы в локальных файлах, хранящихся в облаке, что позволяет автоматизировать поиск данных, анализ содержимого и аудит электронных таблиц.

Веб-API

PUT https://api.aspose.cloud/v4.0/cells/search/content

Если вы предпочитаете использовать прямые HTTP-запросы, приведённый ниже пример cURL демонстрирует тот же запрос:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/search/content?searchText=Invoice&ignoringCase=true" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: multipart/form-data" \
     -F "spreadsheet=@/path/to/your/file.xlsx"

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

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

-H "Authorization: Bearer {access_token}"

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

Ответ

API возвращает объект SearchResult, содержащий массив найденных ячеек. Каждый элемент содержит имя рабочего листа, адрес ячейки и найденный текст.

{
  "textItems": [
    {
      "cellName": "A1",
      "text": "Итого",
      "occurrences": 1
    },
    {
      "cellName": "B5",
      "text": "Итого",
      "occurrences": 2
    }
  ],
  "code": 200,
  "status": "OK"
}

Коды ошибок

• 400 Bad Request — Недопустимый URI запроса или параметры.
• 401 Unauthorized — Отсутствует или недействителен токен доступа, либо неверные учётные данные клиента.
• 404 Not Found — Указанный файл электронной таблицы не может быть доступен.
• 500 Internal Server Error — Во время обработки рабочей книги произошла непредвиденная ошибка сервера.

Где следует использовать API поиска по содержимому электронной таблицы?

• Комплексный аудит соответствия рабочей книги — Сканирование всей рабочей книги для поиска конфиденциальных терминов (например, «Конфиденциальное условие», «Внутренние данные») в целях обеспечения безопасности данных и соответствия требованиям.
• Межлистовой запрос связанных данных — Поиск номера проекта или имени клиента, встречающегося на нескольких рабочих листах, для быстрой интеграции между листами.
• Пакетная проверка содержимого шаблонов — После генерации отчётов проверьте, что все шаблонные заполнители (например, {{Date}}) корректно заменены во всей пачке файлов Excel.
• Архивирование и майнинг исторических данных — Поиск в устаревших файлах Excel конкретных кодов событий или деловых терминов для ускорения анализа и «археологии» данных.

Почему стоит использовать API поиска по содержимому электронной таблицы?

• Удобный для разработчиков — SDK доступны для множества языков, что снижает объём разработки по сравнению с созданием собственного решения.
• Снижение трудозатрат — Автоматизирует задачи, которые иначе требовали бы ручной проверки электронных таблиц.
• Оплата по факту использования — Вы платите только за фактически выполненные вызовы API.
• Отсутствие необходимости в обслуживании — Нет серверов для управления, обновлений ПО и проблем совместимости.
• Сохранение сложного форматирования — Результаты можно экспортировать в PDF, сохранив исходное оформление Excel.

Как использовать поиск по содержимому электронной таблицы с помощью SDK

Спецификация OpenAPI

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

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ интеграции функционала поиска. SDK абстрагирует HTTP-уровень, позволяя вызывать API с минимальным объёмом кода. Полный список SDK доступен в репозитории на GitHub.

Примеры кода ниже демонстрируют вызов операции поиска по содержимому электронной таблицы с использованием различных SDK: