Копирование столбцов в рабочем листе Excel с использованием Aspose.Cells Cloud API
Этот REST API позволяет копировать столбцы в рабочем листе Excel. Операция Copy Columns (Копировать столбцы) позволяет дублировать один столбец или диапазон столбцов и вставить копию в указанное место того же рабочего листа. Используйте этот конечный пункт для эффективного копирования столбцов при работе с большими электронными таблицами. Дополнительные задачи управления столбцами можно выполнить с помощью связанных операций, таких как Добавление столбца и Скрытие столбца.
Безопасность и аутентификация
API Aspose.Cells Cloud безопасны и требуют аутентификации на основе JWT-токена.
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/copy
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя рабочей книги. |
| sheetName | string | path | Имя рабочего листа. |
| sourceColumnIndex | integer | query | 0‑индексированный номер столбца, который нужно скопировать. |
| destinationColumnIndex | integer | query | 0‑индексированный номер столбца, куда будут вставлены скопированные столбцы. |
| columnNumber | integer | query | Количество последовательных столбцов для копирования. |
| worksheet | string | query | (Опционально) Идентификатор рабочего листа, используемый, если имя отличается от пути. |
| folder | string | query | Путь к папке, содержащей рабочую книгу в облачном хранилище Aspose. |
Полный контракт для этой операции описан в OpenAPI Specification.
Пример cURL
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/copy?sourceColumnIndex=1&destinationColumnIndex=12&columnNumber=10" \
-H "Authorization: Bearer $ASPOSE_TOKEN" \
-H "accept: application/json"
Ответ
{
"Code": 200,
"Status": "OK"
}
Обработка ошибок
API возвращает стандартные HTTP-коды состояния и JSON-тело с описанием ошибки.
| Код состояния | Значение | Пример JSON-тела |
|---|---|---|
| 400 | Неверный запрос — некорректные параметры | { "Code": 400, "Message": "Invalid column index." } |
| 401 | Неавторизован — отсутствует или недействителен токен | { "Code": 401, "Message": "Access token is invalid or expired." } |
| 404 | Не найдено — рабочая книга или лист не существуют | { "Code": 404, "Message": "Workbook not found." } |
| 500 | Внутренняя ошибка сервера — непредвиденное условие | { "Code": 500, "Message": "An unexpected error occurred." } |
Как устранить неполадки: Убедитесь, что токен доступа актуален, имена рабочей книги и листа указаны верно, а значения
sourceColumnIndex,destinationColumnIndexиcolumnNumberнаходятся в пределах допустимого диапазона столбцов рабочего листа.
Семейство облачных SDK
Использование SDK — оптимальный способ ускорить разработку. SDK берёт на себя обработку низкоуровневых деталей, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
В приведённых ниже примерах кода показано, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: