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

Поиск битых ссылок в удалённой электронной таблице через API

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

Веб-API

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

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

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

-H "Authorization: Bearer {access_token}"

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

Имя параметра Тип Путь / Строка запроса / HTTPBody Описание
name String Path Обязательный. Имя файла книги Excel, подлежащего сканированию на битые ссылки (например, Quarterly_Report.xlsx).
worksheet String Query Обязательный. Имя листа, в котором будет выполняться операция поиска. Укажите точное имя листа, как оно отображается в книге.
cellArea String Query Обязательный. Диапазон ячеек, подлежащий анализу на битые ссылки, в нотации A1 (например, C5:J50). API ищет только в пределах этого диапазона.
folder String Query Необязательный. Путь к каталогу, содержащему книгу в вашем облачном хранилище. Если не указан, считается корневой каталог.
storageName String Query Необязательный. Имя пользовательской конфигурации облачного хранилища. Если не указано, используется хранилище по умолчанию.
region String Query Необязательный. Языковой стандарт, применяемый при обработке (например, ru-RU). Может повлиять на интерпретацию синтаксиса формул или ссылок.
password String Query Необязательный. Пароль, необходимый для открытия зашифрованной электронной таблицы. Пропустите, если файл не защищён паролем.

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

curl -X PUT "https://api.aspose.cloud/v4.0/cells/Quarterly_Report.xlsx/search/broken-links?worksheet=Sheet1&cellArea=C5:J50" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

Ответ

{
  "Name": "BrokenLinksResponse",
  "Type": "Class",
  "ParentName": "CellsCloudResponse",
  "Properties": [
    {
      "Name": "BrokenLinks",
      "DataType": {
        "Identifier": "Container",
        "Reference": "BrokenLink",
        "ElementDataType": {
          "Identifier": "Class",
          "Reference": "BrokenLink"
        }
      }
    },
    {
      "Name": "Code",
      "DataType": {
        "Identifier": "Integer"
      }
    },
    {
      "Name": "Status",
      "DataType": {
        "Identifier": "String"
      }
    }
  ]
}

Пример JSON-ответа

{
  "BrokenLinks": [
    {
      "Worksheet": "Sheet1",
      "CellName": "D12",
      "Link": "https://example.com/data/source.xlsx",
      "IsValid": false,
      "ErrorMessage": "Файл не найден"
    },
    {
      "Worksheet": "Sheet1",
      "CellName": "F30",
      "Link": "C:\\LocalFolder\\data.xlsx",
      "IsValid": false,
      "ErrorMessage": "Внешняя ссылка не поддерживается в облачном режиме"
    }
  ],
  "Code": 200,
  "Status": "OK"
}

Коды ошибок

  • 400 Bad Request – Неверный URI API Aspose.Cells Cloud.
  • 401 Unauthorized – Неверный токен доступа, client ID или client secret.
  • 404 Not Found – Файл электронной таблицы недоступен.
  • 500 Server Error – Возникла ошибка при получении данных для расчёта.

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

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

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

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

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

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

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

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

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

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