Поиск и исправление битых ссылок в удалённом рабочем листе Excel – облачный проверщик ссылок

Поиск битых ссылок в удалённом рабочем листе — API

Автоматически обнаруживайте битые ссылки в рабочем листе Excel, хранящемся в облачном хранилище. Наш API сканирует указанные диапазоны, выявляя битые внешние ссылки, некорректные формулы и отсутствующие источники данных. Поддерживает аудит облачных таблиц, автоматическую проверку качества и интеграцию с поставщиками облачных хранилищ. RESTful API для автоматизации корпоративных рабочих процессов.

Веб-API

PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/search/broken-links

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

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

-H "Authorization: Bearer {access_token}"

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

Имя параметра Тип Путь / Строка запроса / Тело HTTP-запроса Описание
name String Путь Обязательный. Имя файла (с расширением) Excel-книги, в которой необходимо найти битые ссылки (например, Annual_Report.xlsx).
worksheet String Путь Обязательный. Точное имя рабочего листа, в котором будет выполняться сканирование ссылок (например, DataSheet1).
folder String Параметр запроса Необязательный. Путь к папке в вашем облачном хранилище, где расположен целевой файл книги. Если параметр опущен, используется корневая папка.
storageName String Параметр запроса Необязательный. Идентификатор вашей настраиваемой конфигурации облачного хранилища. Если не указан, используется хранилище по умолчанию для аккаунта.
region String Параметр запроса Необязательный. Языковой стандарт, применяемый во время поиска (например, fr-FR). Может влиять на интерпретацию некоторых формул и региональных форматов данных. Поддерживаемые коды языков: en-US, fr-FR, de-DE, es-ES и др.
password String Параметр запроса Необязательный. Пароль для расшифровки файла, защищённого паролем. Пропустите, если файл не зашифрован.

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

curl -X PUT "https://api.aspose.cloud/v4.0/cells/Annual_Report.xlsx/worksheets/DataSheet1/search/broken-links?folder=Reports&storageName=MyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

Ответ

{
  "Code": 200,
  "Status": "OK",
  "BrokenLinks": [
    {
      "Address": "='C:\\Data\\Source.xlsx'!A1",
      "ErrorCode": "404",
      "ErrorMessage": "Исходный файл не найден"
    }
  ]
}

Объект ответа имеет тип BrokenLinksResponse и содержит:

  • BrokenLinks — коллекция элементов BrokenLink, каждый из которых описывает проблемную ссылку (адрес, код и сообщение об ошибке).
  • Code — числовой код статуса, возвращаемый сервисом.
  • Status — текстовое описание результата.

Примечания: API не реализует постраничную выборку результатов. За один запрос можно вернуть до 10 000 битых ссылок. Ограничение частоты запросов — 100 запросов в минуту на аккаунт.

Коды ошибок

  • 400 Bad Request — некорректный URI API Aspose.Cells Cloud.
  • 401 Unauthorized — недействительный или отсутствующий токен доступа.
  • 404 Not Found — файл таблицы недоступен.
  • 500 Server Error — возникла ошибка при получении данных для расчётов.

Где следует использовать поиск битых ссылок в рабочем листе таблицы через API?

  • Регулярный аудит крупных финансовых моделей: Перед выпуском ежемесячных или ежеквартальных отчётов автоматически сканируйте ключевые расчётные зоны (например, Dashboard!B5:K50), содержащие множество внешних ссылок, чтобы убедиться, что все они указывают на существующие исходные файлы.
  • Интеграция данных при слияниях и поглощениях: После объединения нескольких файлов таблиц, представляющих различные бизнес-подразделения, проверьте рабочий лист «Обзор», чтобы выявить ссылки, ставшие недействительными из-за изменений путей к исходным файлам или проблем с правами доступа.
  • Подготовка пакетов данных для инвесторов: Перед финализацией презентационных материалов, содержащих диаграммы и таблицы, связанные с внешними базами данных или источниками рыночной информации, проверьте все ссылки на их валидность.

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

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

Как использовать поиск битых ссылок в рабочем листе таблицы через API с SDK

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

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

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

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

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