Aspose.Cells FOSS
Python
دليل المطور
Features

تصدير تنسيق جداول البيانات لـ Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() تتعامل الدالة مع خط أنابيب الإخراج الكامل — XLSX، CSV، TSV، Markdown، أو JSON — مع الحفاظ على قيم الخلايا والصيغ دون الحاجة إلى Microsoft Office.

الإعداد والتثبيت 

pip install aspose-cells-foss

استيراد الفئات الأساسية:

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

تنسيقات الإخراج المدعومة

التنسيقثابت SaveFormatملاحظات
XLSXSaveFormat.XLSXالتنسيق الافتراضي؛ يحافظ على الأنماط، الصيغ، والرسوم البيانية
CSVSaveFormat.CSVمفصول بفواصل؛ الورقة الأولى فقط بشكل افتراضي
TSVSaveFormat.TSVقيم مفصولة بعلامات تبويب
MarkdownSaveFormat.MARKDOWNينشئ جداول Markdown قياسية
JSONSaveFormat.JSONتمثيل JSON منظم لبيانات الورقة

مهم: Aspose.Cells FOSS يفعل ليس يدعم تصدير إلى PDF، HTML، PNG، TIFF، DOCX، أو PPTX. هذه متاحة في النسخة التجارية aspose-cells-python فقط في الحزمة.

استخدام الأمثلة

حفظ كـ XLSX

الصيغة الافتراضية عند الحفظ باستخدام .xlsx امتداد:

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

حفظ كـ 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)

حفظ كـ Markdown

تصدير البيانات الجدولية كجداول Markdown — مفيد للتوثيق وإنشاء ملفات 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")

الناتج هو جدول Markdown قياسي:

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

Markdown مع خيارات

استخدم MarkdownSaveOptions للتحكم الدقيق:

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 إلى سلسلة (في الذاكرة)

إنشاء سلسلة Markdown دون كتابة إلى القرص:

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)

حفظ إلى JSON

تصدير بيانات دفتر العمل كـ JSON منظم لأنابيب 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)

تحميل CSV وحفظه كـ XLSX 

from aspose.cells_foss import Workbook, SaveFormat

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

نصائح وممارسات أفضل

تصدير Markdown

  • استخدم MarkdownHandler.save_markdown_to_string(wb) لحالات الاستخدام في الذاكرة مثل استجابات API.

تصدير CSV

  • يكتب تصدير CSV ورقة العمل الأولى افتراضيًا.
  • يتم اقتباس الأحرف الخاصة (الفواصل، أسطر جديدة) في قيم الخلايا تلقائيًا.

تصدير JSON

  • يستخدم تصدير JSON عناوين الخلايا كمفاتيح. مناسب لتبادل البيانات؛ تُخزن الصيغ المعقدة كعبارات نصية.

المشكلات الشائعة والحلول

مشكلةالحل
ModuleNotFoundError: No module named 'aspose.cells_foss'تشغيل pip install aspose-cells-foss وتأكد من أن البيئة الافتراضية نشطة
AttributeError على SaveFormat.PDFتصدير PDF غير موجود في مكتبة FOSS؛ استخدم SaveFormat.MARKDOWN أو SaveFormat.XLSX بدلاً من ذلك
إخراج Markdown فارغتأكد من أن خلية واحدة على الأقل في الورقة تحتوي على قيمة قبل الحفظ
مشكلات الترميز في Markdownاستخدم MarkdownHandler.save_markdown_to_string() لإخراج سلسلة في الذاكرة مع تحكم كامل في الترميز

الأسئلة المعتادة

ما هي صيغ الإخراج التي يدعمها Aspose.Cells FOSS؟? XLSX، CSV، TSV، Markdown، و JSON.

هل يمكنني التحويل إلى PDF؟? لا. تصدير PDF يتطلب النسخة التجارية aspose-cells-python الحزمة. Aspose.Cells تصديرات FOSS تقتصر فقط على XLSX، CSV، TSV، Markdown، و JSON.

هل يمكنني تحميل ملف XLSX موجود وإعادة حفظه كـ Markdown؟? نعم. Workbook("existing.xlsx") يقوم بتحميل الملف، و workbook.save_as_markdown("output.md") يصدره.

هل يتم دعم إخراج Markdown القائم على التدفق؟? نعم. استخدم MarkdownHandler.save_markdown_to_string(workbook) للحصول على Markdown كسلسلة Python دون أي عمليات إدخال/إخراج للملف.

ما إصدارات Python المدعومة؟? Python 3.7 وما بعده.

هذا أيضا

 العربية