Как переместить листы в Excel — переупорядочивание листов и изменение их позиций

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

Перемещение листа в API электронной таблицы

Web API

PUT http://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?sheetName={sheetName}&position={position}&outPath={outPath}&outStorageName={outStorageName}&region={region}&password={password}

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

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

-H "Authorization: Bearer {access_token}"

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

Имя параметра Тип Путь/Строка запроса/HTTPBody Описание
Spreadsheet Файл FormData Обязательный параметр. Исходный файл рабочей книги Excel (.xlsx, .xls и др.), содержащий лист, который необходимо переместить.
worksheet Строка Запрос Обязательный параметр. Точное имя перемещаемого листа (например, Summary, RawData_2024).
position Целое число Запрос Обязательный параметр. Новая позиция (индекс, начиная с нуля) для листа. Например, 0 перемещает его на первую позицию, 2 — на третью.
outPath Строка Запрос Необязательный параметр. Путь к целевой папке в облачном хранилище, куда будет сохранена переупорядоченная рабочая книга. Если параметр null или опущен, используется путь исходного файла.
outStorageName Строка Запрос Обязательный параметр. Идентификатор имени настроенного облачного хранилища (например, TeamDrive), куда будет сохранён выходной файл.
region Строка Запрос Необязательный параметр. Языковой стандарт (например, es-MX), который может повлиять на некоторые правила форматирования при сохранении.
password Строка Запрос Необязательный параметр. Пароль расшифровки, необходимый для открытия и изменения защищённой паролем рабочей книги. Опустите, если файл не зашифрован.

Ответ

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

Коды HTTP-статусов

Код Значение Описание
200 OK (Успех) Фильтр успешно применён; в ответе содержатся детали операции.
400 Bad Request (Неверный запрос) Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401 Unauthorized (Неавторизованный доступ) Неверный или отсутствующий токен JWT.
413 Payload Too Large (Слишком большой объём полезной нагрузки) Загруженный файл превышает допустимый размер.
500 Internal Server Error (Внутренняя ошибка сервера) Непредвиденная ошибка сервера.

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

  • Стандартизированная генерация отчётов: После автоматической генерации ежемесячных или ежеквартальных отчётов лист Summary или Executive Overview перемещается в начало рабочей книги, чтобы основные выводы отображались при её открытии.
  • Конвейер обработки данных: После обработки исходных листов из разных источников в ETL-процессе лист Processed_Data, содержащий очищенные и преобразованные данные, перемещается в логически обоснованное положение в книге (например, в середину), обеспечивая чёткую структуру процесса с исходными данными и результатами анализа.
  • Индивидуальная поставка файлов пользователю: После выбора предпочитаемой компоновки через интерфейс настройки (например, размещения страницы диаграмм на первом месте) система автоматически переупорядочивает листы в книге в соответствии с выбором и поставляет персонализированный файл.

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

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

Как использовать API перемещения листа в электронной таблице с помощью SDK

Спецификация API перемещения листа в электронной таблице

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

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells Cloud. В следующем примере показано, как выполнять вызовы облачного API с помощью cURL.

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

Использование SDK — самый быстрый способ разработки, поскольку оно скрывает низкоуровневые детали, позволяя перемещать листы в электронной таблице с помощью компактного кода. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells Cloud с использованием различных SDK:

GetMergedCellsInRemotedWorksheet GetMergedCellsInWorksheet