Konversi ODS ke XLSX di Python - Contoh Kode Lengkap

Contoh berikut menunjukkan cara mengonversi file ODS yang disimpan di GroupDocs Cloud ke XLSX menggunakan 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()

Catatan: Contoh kode ini menunjukkan fungsionalitas inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Mengonversi ODS ke XLSX Menggunakan cURL dan REST API

Berikut ini adalah panduan singkat tentang konversi yang sama menggunakan panggilan HTTP mentah. Ganti nilai placeholder dengan kredensial Anda yang sebenarnya.

1. Dapatkan token akses - otentikasi dengan ID klien dan rahasia Anda.

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. Unggah file sumber ODS ke penyimpanan Anda.

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. Mulai konversi ke 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. Unduh file XLSX yang telah dikonversi.

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

Untuk daftar lengkap parameter dan opsi tambahan, lihat dokumentasi API resmi.

Memahami Logika Konversi ODS ke XLSX dalam Python

Alur kerja SDK dapat dipecah menjadi beberapa langkah logis:

1. Configuration - Configuration() menyimpan kredensial klien Anda.

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

2. Pembuatan Klien API - ApiClient(config) membuat klien tingkat‑rendah yang digunakan oleh layanan tingkat‑tinggi.

api_client = ApiClient(config)

3. Instansiasi Convert API - ConvertApi(api_client) memberikan akses ke operasi konversi.

convert_api = ConvertApi(api_client)

4. Pengaturan FileInfo - FileInfo() menunjuk ke file ODS sumber di penyimpanan GroupDocs.

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

5. Pengaturan Konversi - ConvertSettings() menggabungkan file sumber, format target, jalur output, dan opsi khusus format.

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

6. Execute Conversion - convert_api.convert(settings) mengirim permintaan dan mengembalikan ConversionResult yang berisi jalur file XLSX yang dihasilkan.

result = convert_api.convert(settings)

Setiap komponen dipetakan langsung ke endpoint REST, memungkinkan Anda beralih antara SDK dan panggilan HTTP mentah tanpa mengubah logika keseluruhan.

Prasyarat dan Penyiapan untuk Konversi ODS ke XLSX

Sebelum Anda memulai, pastikan Anda memiliki:

• Python 3.7 atau yang lebih baru terpasang.
• Akun GroupDocs Cloud dengan client ID dan client secret.
• Akses ke penyimpanan GroupDocs tempat file ODS akan disimpan.

Instal SDK melalui pip:

pip install groupdocs-conversion-cloud

Anda juga dapat mengunduh paket secara manual dari halaman rilis. Setelah instalasi, konfigurasikan kredensial Anda seperti yang ditunjukkan dalam contoh kode.

Opsi Konversi: Menyesuaikan Pengaturan ODS ke XLSX

Kelas XlsxConvertOptions memungkinkan Anda menyesuaikan output secara detail. Dalam contoh ini kami menggunakan opsi default, tetapi Anda dapat mengaktifkan fitur seperti perlindungan kata sandi:

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

Pengaturan berguna lainnya (lihat referensi API) meliputi:

• page_range - Konversi hanya lembar tertentu.
• preserve_formulas - Pertahankan rumus Excel tetap utuh.
• include_gridlines - Tampilkan garis kisi dalam buku kerja yang dihasilkan.

Sesuaikan properti ini sebelum menetapkan objek opsi ke settings.options.

Kesimpulan

Panduan ini memandu Anda melalui konversi ODS ke XLSX di Python menggunakan GroupDocs.Conversion Cloud SDK for Python. Anda melihat contoh kode lengkap, mempelajari cara melakukan operasi yang sama dengan cURL, dan menjelajahi opsi konfigurasi yang membantu menyesuaikan konversi sesuai kebutuhan Anda. SDK ini adalah produk komersial; detail harga tersedia di halaman produk, dan Anda dapat memperoleh lisensi sementara untuk evaluasi dari halaman lisensi sementara. Mulailah mengintegrasikan konversi spreadsheet ke dalam aplikasi Anda hari ini dan nikmati pemrosesan tanpa Office yang mulus.

FAQ

• Bagaimana praktik terbaik konversi ODS ke XLSX di Python meningkatkan keandalan?
  Gunakan SDK cloud untuk menghindari ketergantungan Office lokal, alirkan file untuk menjaga penggunaan memori tetap rendah, dan selalu tentukan jalur output yang eksplisit. SDK juga secara otomatis mengulang kembali kesalahan jaringan sementara.

• Apa yang harus saya pertimbangkan saat membandingkan perpustakaan konversi ODS ke XLSX di Python?
  GroupDocs.Conversion Cloud menawarkan endpoint khusus, dukungan format yang luas, dan fitur keamanan bawaan, yang tidak dimiliki banyak perpustakaan umum. Tinjau halaman Perbandingan perpustakaan untuk matriks fitur terperinci.

• Apakah ada cara untuk memantau Kinerja Konversi ODS ke XLSX di Python?
  Aktifkan logging SDK atau gunakan header API X-RateLimit-Remaining untuk melacak latensi dan throughput permintaan. Untuk batch besar, pertimbangkan konversi asynchronous untuk meningkatkan kinerja keseluruhan.

• Apakah saya dapat menjalankan konversi ODS ke XLSX tanpa menginstal Microsoft Office?
  Ya. Layanan cloud melakukan konversi sepenuhnya di server GroupDocs, sehingga tidak diperlukan instalasi Office di mesin Anda.

Baca Selengkapnya

• Konversi CSV ke HTML Langkah demi Langkah di Python
• Tutorial Konversi PNG ke PPTX Langkah demi Langkah di Python
• Tutorial Konversi PDF ke DOCX di Python: Asinkron Cepat