Пакетное добавление текста в Excel — добавление префиксов, суффиксов и пользовательского текста в ячейки — пошаговое руководство

Добавляйте текст в несколько ячеек Excel за одну операцию. Добавляйте префиксы, суффиксы, метки или пользовательские символы в начало, конец или до/после указанного текста внутри ячеек с помощью API Aspose.Cells.

Обзор

Однократное пакетное добавление префиксов, суффиксов или привязанных строк во все ячейки целевого диапазона — без формул и вспомогательных столбцов.

• Добавление пользовательского текста в любую позицию внутри каждой ячейки

• Четыре режима позиционирования: префикс, суффикс, до/после подстроки.

• Пропуск пустых ячеек для избежания засорения.

• API затрагивает только значения строкового типа; числа, логические значения и формулы сначала преобразуются в текст.

• Пустые ячейки

  • skipEmptyCells = true → пустые ячейки пропускаются.
  • skipEmptyCells = false → в пустые ячейки добавляется текст (ячейка становится строкового типа).

• Якорь не найден: если position = BeforeText | AfterText, а selectText отсутствует, значение ячейки остаётся без изменений.

Веб-API

PUT https://api.aspose.cloud/v4.0/cells/content/add/text

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

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

-H "Authorization: Bearer {access_token}"

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

Пример cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/add/text?text=Report&position=AtTheBeginning&skipEmptyCells=true" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@/path/to/workbook.xlsx" \
  -F "outPath=output/workbook_modified.xlsx"

Ответ

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

Коды ошибок

Где использовать API Add Text для электронных таблиц?

• Динамическая маркировка отчётов: добавляйте динамические заголовки, метки даты или примечания к автоматически генерируемым финансовым отчётам и отчётам о продажах.
• Массовая вставка водяных знаков: добавляйте логотипы компании, водяные знаки конфиденциальности или информацию о версии к пакету файлов Excel.
• Заполнение шаблонов данными: автоматически заполняйте имена клиентов, суммы и другой текст в заданных позициях шаблонов договоров или счёт-фактур.
• Метки классификации данных: автоматически добавляйте метки классификации или статусы (например, «Ожидает проверки», «Утверждено») к строкам данных на основе результатов анализа.
• Аннотации качества данных: добавляйте примечания к проблемным данным при очистке данных.
• Массовое форматирование текста: единообразно добавляйте префиксы или суффиксы к названиям товаров или клиентов.

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

• Пакетное добавление текста: добавляйте текст в сотни ячеек или файлов одновременно, сэкономив до 95 % времени по сравнению с ручной работой.
• Точное управление позицией: поддерживает вставку текста в шести позициях — в начало, в конец, до или после указанного текста внутри ячейки.
• Умная условная обработка: решайте, добавлять текст или нет, в зависимости от того, пуста ли ячейка или содержит ли она определённый текст.
• Поддержка стратегии нескольких позиций:
  • AtTheBeginning: добавляет один и тот же текст перед содержимым всех выбранных ячеек.
  • AtTheEnd: добавляет текст после содержимого всех выбранных ячеек.
  • BeforeText / AfterText: добавляет текст только до или после ячеек, содержащих указанный текст.
  • None: заменяет исходное содержимое.
• Точное управление диапазоном: позволяет указывать конкретные листы или диапазоны ячеек для операций.
• Опция пропуска условий: поддерживает пропуск пустых ячеек, чтобы избежать ненужного добавления текста.
• Удобно для разработчиков: Aspose.Cells Cloud предоставляет SDK на множестве языков, что обеспечивает быструю разработку, и сопровождается подробной документацией. По сравнению с созданием собственных решений для визуализации графиков, это значительно сокращает объём работы.
• Экономически эффективно: можно добавлять текст в ячейку без предварительной загрузки файла книги, что экономит место в хранилище и снижает затраты.

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

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

Используйте SDK Aspose.Cells Cloud

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

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