מדריך למפתחים

Aspose.Cells FOSS for Python היא ספרייה חינמית וקוד פתוח לעיבוד גיליונות אלקטרוניים בתכנות. בין אם אתה בונה צינורות נתונים, יוצר דוחות אוטומטיים, מייצא תוצאות למידת מכונה ל‑Excel, או ממיר חוברות עבודה ל‑Markdown לצורכי תיעוד, Aspose.Cells FOSS מספקת API מקיפה המכסה כל שכבה של מניפולציית גיליונות אלקטרוניים ללא צורך ב‑Microsoft Office.

תכונות מרכזיות

פעולות חוברת עבודה וגליון עבודה

צור חוברות עבודה חדשות מאפס או פתח קבצי XLSX או CSV קיימים. נווט במבנה Workbook → Worksheets → Cells → Cell עם API נקי ופייתוני. הוסף, שנה שם והסר גליונות עבודה באמצעות workbook.add_worksheet(name) ו-workbook.remove_worksheet(index_or_name). גש לתאים בודדים לפי כתובת (ws.cells["A1"]), הגדר ערכים ישירות, ועבור על טווחים מאוכלסים.

עיצוב ועיצוב תאים

החל עיצוב מדויק על תאים בודדים. שלוט במשפחת הגופנים, בגודל, בצבע, בעיצוב מודגש, בנטוי, בקו תחתי ובקו חוצה באמצעות המחלקה Font. הגדר מילוי רקע באמצעות cell.style.fill.set_solid_fill("FFRRGGBB"). הצבעים מבוטאים כמחרוזות הקסדצימליות באורך 8 תווים בפורמט AARRGGBB ללא קידומת # (למשל, "FFFF0000" עבור אדום אטום).

יצירת גרפים והדמיה

הוסף גרפים מסוג עמודות, קו, בר ופאי לגיליונות עבודה באמצעות שיטות ייעודיות כגון ws.charts.add_bar(top_row, left_col, bottom_row, right_col) ו-ws.charts.add_line(...). הגדר את כותרת הגרף כמחרוזת (chart.title = "My Chart"), הגדר נתוני קטגוריה ברמת הגרף (chart.category_data = "A2:A6"), והוסף סדרות בשם (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

תמיכת נוסחאות

הזינו נוסחאות תואמות ל‑Excel על‑ידי הגדרת cell.formula = "=SUM(A1:A5)" או בניית Cell(None, "=SUM(A1:A5)") והקצאתה לאוסף התאים.

ייצוא מרובה פורמטים

ייצא חוברות עבודה ל‑XLSX, CSV, TSV, Markdown ו‑JSON באמצעות קריאה אחת של workbook.save(path). השתמש בקבועים של SaveFormat לשליטה מפורשת: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. השתמש ב‑MarkdownSaveOptions לפלט Markdown מדויק (יישור, רמת כותרת, אינדקס גיליון עבודה). השתמש ב‑MarkdownHandler.save_markdown_to_string(wb) ליצירת Markdown בזיכרון. ראה את דוגמאות פורמט ייצוא לקבלת קוד מוכן לשימוש ואת פתרון בעיות ייצוא לקבלת טיפים ושאלות נפוצות.

הערה: Aspose.Cells FOSS מייצא ל‑XLSX, CSV, TSV, Markdown ו‑JSON. ייצוא ל‑PDF, HTML, PNG, TIFF, DOCX ו‑PPTX אינו חלק מספריית ה‑FOSS.

מערכת תוספים

החבילה האופציונלית markitdown-aspose-cells-plugin משולבת עם ספריית MarkItDown של מיקרוסופט כדי להוסיף תמיכה בקריאת XLSX. התקן אותה באמצעות pip install markitdown-aspose-cells-plugin והשתמש בה באופן שקוף דרך ה-API של MarkItDown.

התחלה

התקנה 

pip install aspose-cells-foss

שלום עולם 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

ייצא ל‑Markdown 

from aspose.cells_foss import Workbook, Cell

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
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

צור תרשים עמודות 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

עיצוב תאים 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

מדריכים זמינים

  • Spreadsheet Format Export — ייצוא חוברות עבודה בין XLSX, CSV, TSV, Markdown, ו-JSON.
  • Formula Calculation — הזנת והערכת נוסחאות תואמות Excel באופן תכנותי.
  • Spreadsheet Operations — יצירת חוברת עבודה, מניפולציית תאים, פעולות על טווחים, ועיצוב.
  • Getting Started — התקנה, דרישות מערכת, והחוברת הראשונה שלך.

ראה גם

 עברית