تبدیل ODS به XLSX در پایتون - مثال کامل کد

مثال زیر نشان می‌دهد که چگونه می‌توان یک فایل ODS ذخیره‌شده در GroupDocs Cloud را با استفاده از Python SDK به XLSX تبدیل کرد.

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. دریافت توکن دسترسی - با شناسه مشتری و رمز عبور خود احراز هویت کنید.

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 در پایتون

گردش کار SDK می‌تواند به چند گام منطقی تقسیم شود:

1. پیکربندی - 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 نگاشته می‌شود و به شما امکان می‌دهد بین 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 در پایتون با استفاده از GroupDocs.Conversion Cloud SDK for Python راهنمایی کرد. شما یک مثال کامل کد را مشاهده کردید، یاد گرفتید چگونه همان عملیات را با cURL انجام دهید، و گزینه‌های پیکربندی را بررسی کردید که به شما کمک می‌کند تبدیل را بر اساس نیازهای خود تنظیم کنید. SDK یک محصول تجاری است؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت برای ارزیابی از صفحه لایسنس موقت دریافت کنید. امروز شروع به یکپارچه‌سازی تبدیل جدول‌های محاسباتی در برنامه‌های خود کنید و از پردازش بدون Office لذت ببرید.

سوالات متداول

• چگونه بهترین روش‌های تبدیل ODS به XLSX در Python قابلیت اطمینان را بهبود می‌بخشند؟
  برای جلوگیری از وابستگی‌های محلی Office از SDK ابری استفاده کنید، فایل‌ها را به صورت جریان پردازش کنید تا مصرف حافظه کم بماند و همیشه مسیر خروجی صریحی را مشخص کنید. SDK همچنین خطاهای موقت شبکه را به‌صورت خودکار دوباره تلاش می‌کند.

• در هنگام مقایسه کتابخانه‌های تبدیل ODS به XLSX در پایتون، چه نکاتی را باید در نظر بگیرم؟
  GroupDocs.Conversion Cloud نقاط انتهایی اختصاصی، پشتیبانی گسترده از فرمت‌ها و ویژگی‌های امنیتی داخلی را ارائه می‌دهد که بسیاری از کتابخانه‌های عمومی فاقد آن هستند. برای مشاهده ماتریس ویژگی‌های دقیق، صفحه مقایسه کتابخانه‌ها را بررسی کنید.

• آیا راهی برای نظارت بر عملکرد تبدیل ODS به XLSX در پایتون وجود دارد؟
  ثبت‌گیری SDK را فعال کنید یا از هدر X-RateLimit-Remaining API برای ردیابی تأخیر درخواست و توان پردازشی استفاده کنید. برای دسته‌های بزرگ، تبدیل ناهمزمان را در نظر بگیرید تا عملکرد کلی بهبود یابد.

• آیا می‌توانم تبدیل ODS به XLSX را بدون نصب Microsoft Office اجرا کنم؟
  بله. سرویس ابری تبدیل را به طور کامل بر روی سرورهای GroupDocs انجام می‌دهد، بنابراین نیازی به نصب Office بر روی دستگاه شما نیست.

Read More

• تبدیل CSV به HTML به صورت گام به گام در پایتون
• آموزش تبدیل PNG به PPTX به صورت گام به گام در پایتون
• آموزش تبدیل PDF به DOCX در پایتون: سریع و ناهمزمان