Конвертація ODS у XLSX за допомогою Python — повний приклад коду

У наведеному прикладі продемонстровано, як конвертувати файл ODS, збережений у GroupDocs Cloud, у формат XLSX за допомогою Python SDK.

import sys
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    XlsxConvertOptions,
    ConversionResult
)

def main():
    # -------------------- Configuration --------------------
    config = Configuration()
    config.client_id = "YOUR_CLIENT_ID"
    config.client_secret = "YOUR_CLIENT_SECRET"

api_client = ApiClient(config)
    convert_api = ConvertApi(api_client)

# -------------------- Input File --------------------
    input_file = FileInfo()
    input_file.file_path = "input.ods"          # Path in the storage
    # input_file.storage_name = "MyStorage"    # Optional: specify storage name

# -------------------- Conversion Options --------------------
    xlsx_options = XlsxConvertOptions()
    # Example: set specific options if needed
    # xlsx_options.password = "myPassword"

# -------------------- Conversion Settings --------------------
    settings = ConvertSettings()
    settings.file_info = input_file
    settings.format = "xlsx"
    settings.output_path = "output.xlsx"
    settings.options = xlsx_options

# -------------------- Perform Conversion --------------------
    try:
        result: ConversionResult = convert_api.convert(settings)
        print(f"Conversion successful. Output file stored at: {result.path}")
    except Exception as e:
        print(f"Error during conversion: {e}", file=sys.stderr)

if __name__ == "__main__":
    main()

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

Перетворення ODS у XLSX за допомогою cURL та REST API

Нижче наведено швидкий покроковий огляд того ж перетворення за допомогою сирих HTTP‑викликів. Замініть заповнювачі реальними обліковими даними.

1. Отримати токен доступу - автентифікуйтеся за допомогою вашого client ID та secret.

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "grant_type": "client_credentials",
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

2. Завантажте вихідний файл ODS у ваше сховище.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.ods" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.ods

3. Почати конвертацію у XLSX.

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": "input.ods" },
           "format": "xlsx",
           "outputPath": "output.xlsx",
           "options": {}
         }'

4. Завантажте перетворений файл XLSX

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Для повного списку параметрів та додаткових опцій перегляньте офіційну документацію API.

Розуміння логіки конвертації ODS у XLSX у Python

Робочий процес SDK можна розбити на кілька логічних кроків:

1. Configuration - Configuration() містить ваші облікові дані клієнта.

config = Configuration()
config.client_id = "YOUR_CLIENT_ID"
config.client_secret = "YOUR_CLIENT_SECRET"

2. Створення API-клієнта - ApiClient(config) створює низькорівневий клієнт, який використовується сервісами вищого рівня.

api_client = ApiClient(config)

3. Інстанціювання Convert API - ConvertApi(api_client) надає доступ до операцій конвертації.

convert_api = ConvertApi(api_client)

4. Налаштування FileInfo - FileInfo() вказує на вихідний ODS файл у сховищі GroupDocs.

input_file = FileInfo()
input_file.file_path = "input.ods"

5. Налаштування конвертації - ConvertSettings() об’єднує вихідний файл, цільовий формат, шлях виводу та будь‑які специфічні для формату параметри.

settings = ConvertSettings()
settings.file_info = input_file
settings.format = "xlsx"
settings.output_path = "output.xlsx"
settings.options = xlsx_options

6. Виконати конвертацію - convert_api.convert(settings) надсилає запит і повертає ConversionResult, що містить шлях до згенерованого файлу XLSX.

result = convert_api.convert(settings)

Кожен компонент безпосередньо відображається на REST‑endpoint, що дозволяє переключатися між SDK та сирими HTTP‑викликами без зміни загальної логіки.

Вимоги та налаштування для конвертації ODS у XLSX

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

• Встановлений Python 3.7 або новіший.
• Обліковий запис GroupDocs Cloud з client ID та client secret.
• Доступ до сховища GroupDocs, де буде розміщений файл ODS.

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

pip install groupdocs-conversion-cloud

Ви також можете завантажити пакет вручну зі сторінки випуску. Після встановлення налаштуйте ваші облікові дані, як показано у прикладі коду.

Параметри конвертації: Налаштування ODS у XLSX

Клас XlsxConvertOptions дозволяє точно налаштувати вихідні дані. У прикладі ми використовуємо параметри за замовчуванням, але ви можете ввімкнути такі функції, як захист паролем:

xlsx_options = XlsxConvertOptions()
# xlsx_options.password = "myPassword"

Інші корисні налаштування (див. довідка API) включають:

• page_range - Конвертувати лише певні листи.
• preserve_formulas - Зберегти формули Excel без змін.
• include_gridlines - Показати сітку у згенерованій робочій книзі.

Налаштуйте ці властивості перед присвоєнням об’єкта параметрів settings.options.

Висновок

У цьому посібнику ви пройшли процес конвертації ODS у XLSX за допомогою Python, використовуючи GroupDocs.Conversion Cloud SDK for Python. Ви побачили повний приклад коду, дізналися, як виконати ту ж операцію за допомогою cURL, і ознайомилися з параметрами конфігурації, які допомагають налаштувати конвертацію відповідно до ваших потреб. SDK є комерційним продуктом; деталі ціноутворення доступні на сторінці продукту, а тимчасову ліцензію для оцінки можна отримати на сторінці тимчасової ліцензії. Почніть інтегрувати конвертацію електронних таблиць у свої додатки вже сьогодні та насолоджуйтеся безшовною обробкою без Office.

FAQs

• Як практики кращого перетворення ODS у XLSX у Python підвищують надійність?
  Використовуйте хмарний SDK, щоб уникнути локальних залежностей Office, передавайте файли потоково, щоб знизити використання пам’яті, і завжди вказуйте явний шлях вихідного файлу. SDK також автоматично повторює спроби при тимчасових мережевих помилках.

• Що слід враховувати при порівнянні бібліотек конвертації ODS у XLSX у Python?
  GroupDocs.Conversion Cloud пропонує спеціалізовані кінцеві точки, широкий спектр підтримуваних форматів та вбудовані функції безпеки, яких бракує багатьом загальним бібліотекам. Перегляньте сторінку порівняння бібліотек для детальної матриці функцій.

• Чи є спосіб відстежувати продуктивність конвертації ODS у XLSX у Python?
  Увімкніть журналювання SDK або використайте заголовок X-RateLimit-Remaining API, щоб відстежувати затримку запитів та пропускну здатність. Для великих пакетів розгляньте асинхронну конвертацію, щоб підвищити загальну продуктивність.

• Чи можу я виконати конвертацію ODS у XLSX без встановленого Microsoft Office?
  Так. Хмарний сервіс виконує конвертацію повністю на серверах GroupDocs, тому встановлення Office на вашому комп’ютері не потрібно.

Читати далі

• Конвертація CSV у HTML крок за кроком у Python
• Покроковий посібник з конвертації PNG у PPTX у Python
• Посібник з конвертації PDF у DOCX у Python: швидка асинхронна