Импорт изображения в рабочий лист Excel позволяет обогатить электронные таблицы визуальным содержимым — например, логотипами, диаграммами или схемами. В этом руководстве описано, как использовать операцию Aspose.Cells Cloud ImportPicture, необходимый формат запроса и способы обработки ответов.
Необходимые условия: Перед вызовом операции импорта убедитесь, что у вас есть действительный JWT-токен аутентификации и уже сохраненная в хранилище Aspose Cloud электронная таблица.
API PostImportData
POST https://api.aspose.cloud/v3.0/cells/import
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
Запрос представляет собой HTTP POST с содержимым типа multipart/related (см. RFC 2046 или RFC 1341).
- Первая часть содержит JSON-объект с именем ImportPictureOption, описывающий, куда и как следует разместить изображение.
- Вторая часть передает файл изображения (или его Base64-кодированные данные).
ImportPictureOption — определение
{
"UpperLeftRow": 0,
"UpperLeftColumn": 0,
"LowerRightRow": 10,
"LowerRightColumn": 5,
"Filename": "logo.png",
"Data": "iVBORw0KGgoAAAANSUhEUgAA...",
"DestinationWorksheet": "Sheet1",
"IsInsert": true,
"ImportDataType": "Picture",
"Source": { "FileSource": "Storage" }
}
IsInsert — логическое значение: true означает вставку нового изображения, false — замену существующего.
Важные параметры
ImportPictureOption
| Имя параметра | Тип | Описание |
|---|---|---|
| UpperLeftRow | int | Индекс строки верхнего левого угла, в котором будет размещено изображение. |
| UpperLeftColumn | int | Индекс столбца верхнего левого угла, в котором будет размещено изображение. |
| LowerRightRow | int | Индекс строки нижнего правого угла, определяющего границы изображения. |
| LowerRightColumn | int | Индекс столбца нижнего правого угла, определяющего границы изображения. |
| Filename | string | Имя файла изображения. |
| Data | string | Base64-кодированные двоичные данные изображения (необязательно, если файл передается во второй части запроса). |
| DestinationWorksheet | string | Имя рабочего листа, в который будет вставлено изображение. |
| IsInsert | boolean | true — вставить новое изображение; false — заменить существующее. |
| ImportDataType | string | Тип импортируемых данных (например, Picture, IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | Указывает местоположение файла данных, когда параметр BatchData равен null. |
Ответ
Успешный запрос возвращает HTTP 200 с JSON-полезной нагрузкой следующего вида:
{
"Code": 200,
"Status": "OK"
}
Возможные коды состояния:
| Код | Значение |
|---|---|
| 200 | Импорт успешно завершен |
| 400 | Неверный запрос — отсутствуют или некорректны данные |
| 401 | Неавторизованный доступ — недействительный или отсутствующий токен |
| 500 | Внутренняя ошибка сервера |
Как использовать API PostImportData с SDK
Спецификация API PostImportData
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять взаимодействие с REST напрямую из веб-браузера.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK берет на себя обработку низкоуровневых деталей, позволяя сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Приведенные ниже примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: