Витягування необробленого тексту з Excel‑книг часто потрібно при створенні конвеєрів даних або генерації простих звітів. Якщо вам потрібно знати як конвертувати Excel Workbook у текст за допомогою Python, GroupDocs.Conversion Cloud SDK for Python робить це простим. У цьому посібнику ви пройдете процес встановлення SDK, завантаження книги, налаштування параметрів конвертації та отримання простого результату у форматі TXT. Після завершення у вас буде багаторазовий скрипт і набір команд cURL для автоматизації на базі REST.

Перед початком: вимоги та встановлення

Перш ніж почати, переконайтеся, що у вас є наступне:

  • Python 3.7 або новішої версії, встановлений на вашому комп’ютері.
  • Активний обліковий запис GroupDocs Cloud (client ID і client secret).
  • Мережевий доступ до кінцевих точок GroupDocs Cloud.

Встановіть SDK за допомогою pip:

pip install groupdocs-conversion-cloud

Ви також можете завантажити останній пакет з офіційної сторінки релізу. Після встановлення встановіть ваші облікові дані як змінні середовища або пізніше замініть заповнювачі у коді. Коли SDK готовий, ви готові розпочати процес конвертації.

Створюємо крок за кроком: як конвертувати книгу Excel у текст у Python

Крок 1: Налаштуйте облікові дані

Спочатку створіть об’єкт Configuration і вкажіть ваш client ID та secret. Цей об’єкт використовується у всіх наступних викликах API.

import os
from groupdocs_conversion_cloud import Configuration

client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

Клас Configuration задокументовано у довіднику API.

Крок 2: Завантажити книгу Excel

Завантажте локальний файл Excel у сховище GroupDocs Cloud. Цей крок є необов’язковим, якщо ваш файл вже знаходиться у хмарі.

from groupdocs_conversion_cloud import ApiClient, UploadFileApi, UploadFileRequest

api_client = ApiClient(config)
upload_api = UploadFileApi(api_client)

local_excel_path = "sample.xlsx"
remote_excel_path = "sample.xlsx"

with open(local_excel_path, "rb") as f:
    upload_request = UploadFileRequest(
        path=remote_excel_path,
        file=f.read()
    )
    upload_api.upload_file(upload_request)

UploadFileApi обробляє передачу файлів; перегляньте його документацію для отримання докладнішої інформації.

Крок 3: Визначення параметрів конвертації

Створіть об’єкт TxtConvertOptions, щоб вказати будь‑які необов’язкові параметри, наприклад діапазон сторінок. Потім створіть об’єкт ConvertSettings, який об’єднує все разом.

from groupdocs_conversion_cloud import (
    FileInfo,
    TxtConvertOptions,
    ConvertSettings,
)

file_info = FileInfo()
file_info.file_path = remote_excel_path

txt_options = TxtConvertOptions()
# txt_options.page_number = 1   # Uncomment to start from a specific page
# txt_options.page_count = 1    # Uncomment to limit the number of pages

convert_settings = ConvertSettings()
convert_settings.file_info = file_info
convert_settings.format = "txt"
convert_settings.output_path = "sample.txt"
convert_settings.options = txt_options

Клас TxtConvertOptions дозволяє точно налаштувати конвертацію; зверніться до офіційної документації для отримання всіх доступних полів.

Крок 4: Виконати конвертацію

Викличте метод convert об’єкта ConvertApi з підготовленими налаштуваннями. Відповідь містить URL для завантаження конвертованого файлу.

from groupdocs_conversion_cloud import ConvertApi, ApiException

convert_api = ConvertApi(api_client)

try:
    conversion_result = convert_api.convert(convert_settings)
    print(f"Conversion succeeded. Download URL: {conversion_result.url}")
except ApiException as e:
    print(f"Conversion failed: {e}")

Якщо виклик успішний, ви отримаєте пряме посилання для завантаження файлу TXT.

Крок 5: Отримати результат

Використайте URL з попереднього кроку, щоб завантажити текстовий файл у ваше локальне середовище або обробити його далі у вашому застосунку.

Порада: Ви можете автоматизувати завантаження за допомогою простого виклику requests.get(), обробляючи автентифікацію за допомогою того ж токена доступу, який використовується для запиту конвертації.

За допомогою цих кроків у вас тепер є повний робочий процес як конвертувати книгу Excel у текст за допомогою Python з використанням бібліотеки GroupDocs.

Конвертація тексту Excel Workbook - Повний приклад коду

Наступний приклад демонструє повну реалізацію від початку до кінця.

import os
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    UploadFileApi,
    UploadFileRequest,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    TxtConvertOptions,
    ApiException,
)

def main():
    # ----------------------------------------------------------------------
    # 1. Configure credentials (replace placeholders or set env variables)
    # ----------------------------------------------------------------------
    client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
    client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
    config.client_id = client_id
    config.client_secret = client_secret

api_client = ApiClient(config)

# ----------------------------------------------------------------------
    # 2. Upload local Excel workbook to GroupDocs Cloud storage (optional)
    # ----------------------------------------------------------------------
    local_excel_path = "sample.xlsx"          # path to the Excel file on your machine
    remote_excel_path = "sample.xlsx"         # path where the file will be stored in the cloud

upload_api = UploadFileApi(api_client)
    try:
        with open(local_excel_path, "rb") as f:
            upload_request = UploadFileRequest(
                path=remote_excel_path,
                file=f.read()
            )
            upload_api.upload_file(upload_request)
        print(f"Uploaded '{local_excel_path}' to cloud storage as '{remote_excel_path}'.")
    except (ApiException, IOError) as e:
        print(f"Failed to upload file: {e}")
        return

# ----------------------------------------------------------------------
    # 3. Prepare conversion settings to transform Excel → plain text
    # ----------------------------------------------------------------------
    convert_api = ConvertApi(api_client)

file_info = FileInfo()
    file_info.file_path = remote_excel_path          # source file in cloud storage

txt_options = TxtConvertOptions()
    # (optional) you can limit conversion to specific pages:
    # txt_options.page_number = 1
    # txt_options.page_count = 1

convert_settings = ConvertSettings()
    convert_settings.file_info = file_info
    convert_settings.format = "txt"                  # target format
    convert_settings.output_path = "sample.txt"      # result file name in cloud storage
    convert_settings.options = txt_options

# ----------------------------------------------------------------------
    # 4. Execute conversion
    # ----------------------------------------------------------------------
    try:
        conversion_result = convert_api.convert(convert_settings)
        # The result contains a URL to download the converted file
        print(f"Conversion succeeded. Download URL: {conversion_result.url}")
    except ApiException as e:
        print(f"Conversion failed: {e}")

if __name__ == "__main__":
    main()

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що всі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь‑якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Перетворення Excel у текст за допомогою cURL та REST API

Якщо ви віддаєте перевагу чистому підходу REST, та ж конвертація може бути виконана за допомогою команд cURL.

  1. Отримати токен доступу
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Завантажте вихідний файл Excel
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @sample.xlsx
  1. Почати конвертацію у TXT
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.xlsx" },
           "format": "txt",
           "outputPath": "sample.txt",
           "options": {}
         }'
  1. Завантажте конвертований файл TXT
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Ці команди ілюструють повний життєвий цикл від автентифікації до завантаження. Для додаткових параметрів та обробки помилок зверніться до довідка API.

Налаштування параметрів конвертації для Excel

SDK пропонує кілька параметрів для налаштування виводу. Нижче наведено найкорисніші налаштування для конвертації Excel‑у‑TXT:

  • Page Number - Почати конвертацію з конкретного листа або сторінки.
txt_options.page_number = 1
  • Page Count - Обмежити кількість листів/сторінок для конвертації.
txt_options.page_count = 2
  • Output Path - Визначити ім’я та розташування отриманого TXT‑файлу в хмарному сховищі.
convert_settings.output_path = "output/sample.txt"

Інші розширені параметри, такі як encoding або preserveFormatting, доступні в довідці API; досліджуйте їх, щоб задовольнити ваші точні вимоги.

Підсумкові думки

Перетворення книги Excel у простий текст у Python тепер стало простим, повторюваним процесом завдяки GroupDocs.Conversion Cloud SDK for Python. SDK обробляє автентифікацію, зберігання файлів та конвертацію за лаштунками, дозволяючи вам зосередитися на бізнес‑логіці. Не забудьте переглянути варіанти ліцензування на сторінці цін та отримати тимчасову ліцензію для оцінки перед переходом у продакшн. За допомогою наданих прикладів коду та cURL ви можете інтегрувати конвертацію Excel‑to‑TXT у будь‑який робочий процес або мікросервіс на базі Python.

Поширені питання

  • Який найпростіший спосіб конвертувати книгу Excel у текст у Python?
    Використовуйте GroupDocs.Conversion Cloud SDK for Python. Він абстрагує REST‑виклики та надає чистий Python‑подібний API для завантаження, конвертування та завантаження файлів.

  • Чи можу я конвертувати лише певні листи або сторінки Excel‑книги?
    Так. Встановіть page_number і page_count у об’єкті TxtConvertOptions, щоб орієнтуватися на конкретні листи. Дивіться довідка API для отримання повної інформації.

  • Чи потрібен мені обліковий запис GroupDocs для використання SDK?
    Потрібен дійсний обліковий запис GroupDocs Cloud з ідентифікатором клієнта та секретом. Ви можете створити обліковий запис на порталі GroupDocs і отримати облікові дані з панелі управління.

  • Чи існує обмеження розміру файлу для конвертації Excel у TXT?
    Хмарний сервіс підтримує файли розміром до 200 МБ для конвертації. Великі файли слід розділяти або обробляти частинами перед завантаженням.

Подальше читання