Estrazione del testo grezzo da cartelle di lavoro Excel è una necessità frequente quando si costruiscono pipeline di dati o si generano report semplici. Se hai bisogno di sapere come convertire Excel Workbook in testo in Python, il GroupDocs.Conversion Cloud SDK for Python lo rende semplice. Questa guida ti accompagna nell’installazione dell’SDK, nel caricamento di una cartella di lavoro, nella configurazione delle opzioni di conversione e nel recupero del risultato plain TXT. Alla fine avrai uno script riutilizzabile e un set di comandi cURL per l’automazione basata su REST.

Prima di iniziare: requisiti e installazione

Prima di iniziare, assicurati di avere quanto segue:

  • Python 3.7 o versioni successive installati sulla tua macchina.
  • Un account attivo di GroupDocs Cloud (client ID e client secret).
  • Accesso di rete ai endpoint di GroupDocs Cloud.

Installa l’SDK tramite pip:

pip install groupdocs-conversion-cloud

Puoi anche scaricare l’ultimo pacchetto dalla pagina di rilascio ufficiale. Dopo l’installazione, imposta le tue credenziali come variabili d’ambiente o sostituisci i segnaposto nel codice in seguito. Con l’SDK pronto, sei pronto per avviare il processo di conversione.

Costruirlo passo dopo passo: come convertire una cartella di lavoro Excel in testo con Python

Passo 1: Configura le credenziali

Innanzitutto, crea un oggetto Configuration e fornisci il tuo client ID e secret. Questo oggetto è utilizzato da tutte le chiamate API successive.

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

La classe Configuration è documentata nella riferimento API.

Passo 2: Carica cartella di lavoro Excel

Carica il file Excel locale su GroupDocs Cloud storage. Questo passaggio è facoltativo se il tuo file è già nel 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)

L’UploadFileApi gestisce i trasferimenti di file; consulta la sua documentazione per ulteriori dettagli.

Passo 3: Definisci le opzioni di conversione

Crea un oggetto TxtConvertOptions per specificare eventuali parametri opzionali, come l’intervallo di pagine. Quindi crea l’oggetto ConvertSettings che collega tutto insieme.

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

La classe TxtConvertOptions consente di perfezionare la conversione; fare riferimento alla documentazione ufficiale per tutti i campi disponibili.

Passo 4: Esegui la conversione

Chiama il metodo convert di ConvertApi con le impostazioni preparate. La risposta contiene un URL per scaricare il file convertito.

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}")

Se la chiamata ha successo, riceverai un link di download diretto per il file TXT.

Passo 5: Recupera il risultato

Utilizza l’URL del passaggio precedente per scaricare il file di testo semplice nel tuo ambiente locale, oppure elabora ulteriormente il file nella tua applicazione.

Suggerimento: È possibile automatizzare il download con una semplice chiamata requests.get(), gestendo l’autenticazione tramite lo stesso token di accesso usato per la richiesta di conversione.

Con questi passaggi, ora hai un flusso di lavoro completo per come convertire un workbook Excel in testo in Python utilizzando la libreria GroupDocs.

Conversione del Testo della Cartella di Lavoro Excel - Esempio di Codice Completo

Il seguente esempio dimostra l’implementazione completa dall’inizio alla fine.

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()

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 correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione da Excel a Testo usando cURL e l’API REST

Se preferisci un approccio REST puro, la stessa conversione può essere eseguita con comandi cURL.

  1. Ottieni un token di accesso
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. Carica il file Excel di origine
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. Avvia la conversione in 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. Scarica il file TXT convertito
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Questi comandi illustrano l’intero ciclo di vita dall’autenticazione al download. Per parametri aggiuntivi e gestione degli errori, consultare il riferimento API.

Configurazione delle impostazioni di conversione per Excel

L’SDK offre diverse opzioni per personalizzare l’output. Di seguito sono riportate le impostazioni più utili per la conversione da Excel‑to‑TXT:

  • Numero di pagina - Inizia la conversione da un foglio o pagina specifici.
    txt_options.page_number = 1
  • Conteggio pagine - Limita il numero di fogli/pagine da convertire.
    txt_options.page_count = 2
  • Percorso di output - Definisci il nome e la posizione del file TXT risultante nello storage cloud.
    convert_settings.output_path = "output/sample.txt"

Altre opzioni avanzate come encoding o preserveFormatting sono disponibili nella documentazione API; esplorale per soddisfare i tuoi requisiti esatti.

Considerazioni finali

La conversione di una cartella di lavoro Excel in testo semplice in Python è ora un processo semplice e ripetibile grazie al GroupDocs.Conversion Cloud SDK for Python. L’SDK gestisce l’autenticazione, l’archiviazione dei file e la conversione in background, permettendoti di concentrarti sulla logica di business. Ricorda di esaminare le opzioni di licenza nella pagina dei prezzi e di ottenere una licenza temporanea per la valutazione prima di passare alla produzione. Con il codice e gli esempi cURL forniti, puoi integrare la conversione da Excel‑to‑TXT in qualsiasi flusso di lavoro o microservizio basato su Python.

Domande comuni

  • Qual è il modo più semplice per convertire una cartella di lavoro Excel in testo in Python?
    Usa il GroupDocs.Conversion Cloud SDK for Python. Astrae le chiamate REST e fornisce un’API Pythonica pulita per caricare, convertire e scaricare i file.

  • Posso convertire solo fogli o pagine specifici di una cartella di lavoro Excel?
    Sì. Imposta page_number e page_count sull’oggetto TxtConvertOptions per mirare a fogli particolari. Consulta il riferimento API per tutti i dettagli.

  • Ho bisogno di un account GroupDocs per usare l’SDK?
    È necessario un account GroupDocs Cloud valido con ID client e segreto. È possibile creare un account sul portale GroupDocs e ottenere le credenziali dalla dashboard.

  • Esiste un limite di dimensione del file per la conversione da Excel a TXT?
    Il servizio cloud supporta file fino a 200 MB per la conversione. I file più grandi dovrebbero essere suddivisi o elaborati in blocchi prima del caricamento.

Ulteriori letture