Aspose.Cells FOSS
Python
Guida per sviluppatori
Features

Esportazione del formato foglio di calcolo per Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() la chiamata gestisce l’intera pipeline di output — XLSX, CSV, TSV, Markdown o JSON — preservando i valori delle celle e le formule senza richiedere Microsoft Office.

Installazione e configurazione 

pip install aspose-cells-foss

Importa le classi principali:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Formati di output supportati

FormatoCostante SaveFormatNote
XLSXSaveFormat.XLSXFormato predefinito; preserva stili, formule, grafici
CSVSaveFormat.CSVSeparato da virgole; solo il primo foglio per impostazione predefinita
TSVSaveFormat.TSVValori separati da tabulazione
MarkdownSaveFormat.MARKDOWNGenera tabelle Markdown standard
JSONSaveFormat.JSONRappresentazione JSON strutturata dei dati del foglio

Importante: Aspose.Cells FOSS fa non supporta l’esportazione in PDF, HTML, PNG, TIFF, DOCX o PPTX. Queste sono disponibili nella versione commerciale aspose-cells-python solo del pacchetto.

Esempi d’uso

Salva in XLSX

Il formato predefinito quando si salva con un .xlsx estensione:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Salva in CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Salva in Markdown

Esporta dati tabulari come tabelle Markdown — utile per la documentazione e la generazione di README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

L’output è una tabella Markdown standard:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown con opzioni

Usa MarkdownSaveOptions per un controllo dettagliato:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown a stringa (in memoria)

Genera una stringa Markdown senza scrivere su disco:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Salva in JSON

Esporta i dati della cartella di lavoro come JSON strutturato per pipeline API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

Carica un CSV e Salva come XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Suggerimenti e migliori pratiche

Esportazione Markdown

  • Usa MarkdownHandler.save_markdown_to_string(wb) per casi d’uso in memoria, come le risposte API.

Esportazione CSV

  • L’esportazione CSV scrive per impostazione predefinita il primo foglio di lavoro.
  • I caratteri speciali (virgole, a capo) nei valori delle celle sono automaticamente racchiusi tra virgolette.

Esportazione JSON

  • L’esportazione JSON utilizza gli indirizzi delle celle come chiavi. Adatta per lo scambio di dati; le formule complesse sono memorizzate come le loro espressioni stringa.

Problemi comuni e soluzioni

ProblemaRisoluzione
ModuleNotFoundError: No module named 'aspose.cells_foss'Esegui pip install aspose-cells-foss e conferma che l’ambiente virtuale sia attivo
AttributeError su SaveFormat.PDFL’esportazione PDF non è nella libreria FOSS; usa SaveFormat.MARKDOWN oppure SaveFormat.XLSX invece
Output Markdown vuotoAssicurati che almeno una cella nel foglio contenga un valore prima di salvare
Problemi di codifica in MarkdownUsa MarkdownHandler.save_markdown_to_string() per l’output di stringhe in memoria con pieno controllo della codifica

Domande frequenti

Quali formati di output supporta Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown e JSON.

Posso convertire in PDF? No. L’esportazione PDF richiede il pacchetto commerciale aspose-cells-python pacchetto. Aspose.Cells FOSS esporta solo in XLSX, CSV, TSV, Markdown e JSON.

Posso caricare un XLSX esistente e risalvarlo come Markdown? Sì. Workbook("existing.xlsx") carica il file e workbook.save_as_markdown("output.md") lo esporta.

È supportata l’output Markdown basato su stream? Sì. Usa MarkdownHandler.save_markdown_to_string(workbook) per ottenere il Markdown come stringa Python senza alcuna I/O su file.

Quali versioni di Python sono supportate? Python 3.7 e successive.

Vedi anche

 Italiano