Conversione da ODS a XLSX in Python - Esempio di codice completo

Il seguente esempio dimostra come convertire un file ODS memorizzato in GroupDocs Cloud in XLSX utilizzando il 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()

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione di ODS in XLSX con cURL e l’API REST

Di seguito è una rapida panoramica della stessa conversione usando chiamate HTTP grezze. Sostituisci i valori segnaposto con le tue credenziali effettive.

1. Ottieni un token di accesso - autenticati con il tuo client ID e 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. Carica il file sorgente ODS nel tuo storage.

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. Avvia la conversione in 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. Scarica il file XLSX convertito.

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

Per un elenco completo di parametri e opzioni aggiuntive, consulta la documentazione ufficiale dell’API.

Comprendere la logica di conversione da ODS a XLSX in Python

Il flusso di lavoro SDK può essere suddiviso in alcuni passaggi logici:

1. Configuration - Configuration() contiene le tue credenziali client.

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

2. Creazione del client API - ApiClient(config) crea un client a basso livello utilizzato dai servizi di livello superiore.

api_client = ApiClient(config)

3. Instanziazione dell’API di conversione - ConvertApi(api_client) fornisce l’accesso alle operazioni di conversione.

convert_api = ConvertApi(api_client)

4. Configurazione FileInfo - FileInfo() punta al file ODS di origine nello storage di GroupDocs.

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

5. Impostazioni di conversione - ConvertSettings() collega il file di origine, il formato di destinazione, il percorso di output e eventuali opzioni specifiche del formato.

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

6. Esegui conversione - convert_api.convert(settings) invia la richiesta e restituisce un ConversionResult contenente il percorso del file XLSX generato.

result = convert_api.convert(settings)

Ogni componente è mappato direttamente a un endpoint REST, consentendo di passare tra SDK e chiamate HTTP grezze senza modificare la logica complessiva.

Prerequisiti e configurazione per la conversione da ODS a XLSX

Prima di iniziare, assicurati di avere:

• Python 3.7 o versioni successive installato.
• Un account GroupDocs Cloud con client ID e client secret.
• Accesso allo storage GroupDocs dove risiederà il file ODS.

Installa l’SDK tramite pip:

pip install groupdocs-conversion-cloud

È possibile scaricare il pacchetto manualmente dalla pagina di rilascio. Dopo l’installazione, configura le tue credenziali come mostrato nell’esempio di codice.

Opzioni di conversione: Regolare le impostazioni ODS a XLSX

La classe XlsxConvertOptions consente di regolare finemente l’output. Nell’esempio utilizziamo le opzioni predefinite, ma è possibile abilitare funzionalità come la protezione con password:

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

Altre impostazioni utili (fare riferimento alla documentazione API) includono:

• page_range - Converti solo fogli specifici.
• preserve_formulas - Mantieni intatte le formule di Excel.
• include_gridlines - Mostra le linee della griglia nella cartella di lavoro generata.

Regola queste proprietà prima di assegnare l’oggetto delle opzioni a settings.options.

Conclusione

Questa guida ti ha guidato nella conversione da ODS a XLSX in Python utilizzando il GroupDocs.Conversion Cloud SDK for Python. Hai visto un esempio di codice completo, hai imparato come eseguire la stessa operazione con cURL e hai esplorato le opzioni di configurazione che ti aiutano a personalizzare la conversione secondo le tue esigenze. L’SDK è un prodotto commerciale; i dettagli dei prezzi sono disponibili nella pagina del prodotto e puoi ottenere una licenza temporanea per la valutazione dalla pagina della licenza temporanea. Inizia a integrare la conversione di fogli di calcolo nelle tue applicazioni oggi stesso e goditi un’elaborazione fluida, senza Office.

FAQs

• Come le migliori pratiche di conversione ODS in XLSX in Python migliorano l’affidabilità?
  Utilizza l’SDK cloud per evitare dipendenze locali da Office, trasmetti i file in streaming per mantenere basso l’uso della memoria e specifica sempre un percorso di output esplicito. L’SDK riprova automaticamente gli errori di rete transitori.

• Cosa dovrei considerare quando confronto le librerie di conversione ODS a XLSX in Python?
  GroupDocs.Conversion Cloud offre endpoint dedicati, ampio supporto di formati e funzionalità di sicurezza integrate, che molte librerie generiche non hanno. Consulta la pagina di confronto delle librerie per una matrice dettagliata delle funzionalità.

• Esiste un modo per monitorare le prestazioni della conversione da ODS a XLSX in Python?
  Abilita il logging SDK o utilizza l’intestazione X-RateLimit-Remaining dell’API per monitorare la latenza e il throughput delle richieste. Per grandi batch, considera la conversione asincrona per migliorare le prestazioni complessive.

• Posso eseguire la conversione da ODS a XLSX senza Microsoft Office installato?
  Sì. Il servizio cloud esegue la conversione interamente sui server di GroupDocs, quindi non è necessaria alcuna installazione di Office sulla tua macchina.

Leggi di più

• Conversione da CSV a HTML passo-passo in Python
• Tutorial passo-passo di conversione da PNG a PPTX in Python
• Tutorial di conversione da PDF a DOCX in Python: Fast Async