Как переименовать листы в Excel — изменение названий листов

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

Переименование названия листа в Spreadsheet API

Web API

PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName={sourceName}&targetName={targetName}&outPath={outPath}&outStorageName={outStorageName}&region={region}&password={password}

Пример cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Report_Q1" \
     -H "Authorization: Bearer {access_token}" \
     -F "spreadsheet=@myWorkbook.xlsx"

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

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

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

Имя параметра Тип Расположение Описание
Spreadsheet Файл FormData Обязательный. Файл рабочей книги Excel (.xlsx, .xls и др.), содержащий лист, который необходимо переименовать.
sourceName String Query Обязательный. Текущее название листа, который вы хотите переименовать.
targetName String Query Обязательный. Новое название для присвоения листу. Должно соответствовать правилам именования Excel (не допускаются символы :, \, ?, *, [, ]) и быть уникальным в пределах книги.
outPath String Query Необязательный. Путь к целевой папке в облачном хранилище, куда будет сохранена переименованная книга. Если null или параметр опущен, файл сохраняется в ту же папку, что и исходная книга (или в путь по умолчанию).
outStorageName String Query Необязательный. Идентификатор настроенного облачного хранилища (например, ArchiveStorage). Если опущен, используется хранилище по умолчанию.
region String Query Необязательный. Языковая настройка (например, ko-KR), которая может повлиять на кодировку символов или региональные соглашения по именованию.
password String Query Необязательный. Пароль расшифровки, необходимый для открытия и редактирования защищённой паролем книги. Пропустите, если файл не зашифрован.

Примечание: Названия листов ограничены 31 символом и не могут содержать символы :, \, ?, *, [, ].

Ответ

Успешный запрос возвращает JSON-объект с информацией о статусе и ссылкой на переименованный файл.

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

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

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

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

  • Генерация отчётов и соблюдение корпоративных стандартов — При автоматической генерации отчётов для клиентов общие названия листов (например, Sheet1) заменяются на имена, специфичные для клиента (например, AcmeCorp_Q1_Summary), чтобы обеспечить профессиональное оформление.
  • Стандартизация конвейера обработки данных — В ETL-процессах листы, экспортированные с нерегулярными названиями, переименовываются в стандартизированные, такие как Raw_Data или Cleaned_Data, для соответствия требованиям последующего анализа.
  • Многоязычная доставка контента — В зависимости от языковых предпочтений пользователя названия листов локализуются (например, 数据 или Data) перед отправкой файла, обеспечивая персонализированный опыт.

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

  • Удобно для разработчиков — Предоставляет SDK для множества языков с подробной документацией, упрощая интеграцию по сравнению с созданием собственного решения.
  • Снижение трудозатрат — Автоматизирует переименование листов, уменьшая объём ручной работы.
  • Модель оплаты по факту использования — Взимается плата только за вызовы API, что исключает первоначальные лицензионные расходы.
  • Отсутствие необходимости в обслуживании серверов — Как облачная служба, она устраняет необходимость в размещении и обслуживании серверов или установке обновлений программного обеспечения.
  • Поддержка автоматизации — Облегчает автоматическую стандартизацию документов в рамках рабочих процессов.

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

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

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

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

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

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

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

GetMergedCellsInRemotedWorksheet GetMergedCellsInWorksheet