Добавление OLE-объекта в рабочий лист Excel с помощью Aspose.Cells Cloud API

Aspose.Cells Cloud API позволяет программно управлять книгами Excel, включая возможность встраивания OLE-объектов (например, документов Word, PDF или других двоичных файлов) непосредственно в рабочий лист.

Этот REST API добавляет OLE-объект в рабочий лист Excel.

Предварительные требования: У вас должен быть действительный JWT-токен аутентификации, а все исходные файлы, на которые ссылается oleFile или imageFile, должны быть загружены в указанное местоположение хранилища до вызова конечной точки.

PutWorksheetOleObject API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects

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

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

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

Имя параметра Тип Расположение Описание
name string path Имя файла книги.
sheetName string path Имя рабочего листа.
oleObject object body Определение OLE-объекта.
upperLeftRow integer query Индекс строки верхнего левого угла (по умолчанию 0).
upperLeftColumn integer query Индекс столбца верхнего левого угла (по умолчанию 0).
height integer query Высота OLE-объекта (по умолчанию 0).
width integer query Ширина OLE-объекта (по умолчанию 0).
oleFile string query Имя исходного файла OLE.
imageFile string query Имя файла изображения-предпросмотра.
folder string query Папка, содержащая книгу.
storageName string query Имя используемого хранилища.

Примечания: upperLeftRow и upperLeftColumn используют нумерацию, начинающуюся с нуля. oleFile (и при необходимости imageFile) должен уже существовать в целевом хранилище; в противном случае запрос вернёт ошибку.

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

Вы можете использовать инструмент командной строки cURL для вызова веб-сервисов Aspose.Cells. Пример ниже демонстрирует, как добавить OLE-объект с помощью cURL. Для всех вызовов в рабочей среде требуется HTTPS.

Скриншот, показывающий OLE-объект, встроенный в рабочий лист Excel

Возможные коды HTTP-статуса

Код Описание
200 OLE-объект успешно добавлен.
400 Неверный запрос — отсутствующие или недопустимые параметры.
401 Неавторизовано — недействительный или отсутствующий JWT-токен.
404 Не найдено — книга, рабочий лист или исходный файл не существуют.
500 Внутренняя ошибка сервера — непредвиденный сбой.

Типичный успешный ответ возвращает следующий JSON-payload:

{
  "Code": 200,
  "Status": "OK",
  "Data": {
    "OleObjectId": "12345",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Width": 400,
    "Height": 400,
    "SourceFullName": "Sample_Book2.xls",
    "ImageSourceFullName": "aspose-logo.png"
  }
}

Семейство облачных SDK

Использование SDK ускоряет разработку. SDK абстрагирует низкоуровневые детали, позволяя сосредоточиться на бизнес-логике. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

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

Получение OLE-объекта из рабочего листа Excel – Aspose.Cells Cloud API Обновление OLE-объекта в листе Excel