
دمج البريد هو تقنية ذكية لإنشاء مستندات مخصصة على نطاق واسع. سواء كانت فواتير أو تقارير أو شهادات، يمكنك استخدام نموذج واحد وملؤه بالبيانات من جدول بيانات. كل صف في ملف Excel الخاص بك يصبح وثيقة مخصصة. في هذه التدوينة، سنظهر لك كيفية تنفيذ دمج البريد من Excel باستخدام Python مع مكتبة Aspose.Cells.
تغطي هذه المقالة الموضوعات التالية:
- مكتبة بايثون إكسل لدمج البريد
- كيف يعمل دمج البريد في Aspose.Cells
- دليل خطوة بخطوة لدمج البريد في بايثون
- Full Python Code for Mail Merge using Excel
- موارد مجانية
مكتبة دمج البريد في إكسل بايثون
سنستخدم Aspose.Cells for Python via .NET لإجراء الدمج البريدي. يتيح لك إنشاء وقراءة والتلاعب بجداول بيانات Excel مباشرة من كود Python. مع الدعم لعلامات Smart، يسمح المكتبة بربط البيانات بسلاسة وأتمتة Excel.
لتثبيت Aspose.Cells for Python عبر .NET:
pip install aspose-cells
دمج البريد باستخدام Aspose.Cells for Python
على عكس Word، تستخدم Aspose.Cells علامات ذكية لأداء دمج البريد. علامات الذكية هي علامات خاصة في قوالب Excel يتم استبدالها بالبيانات الفعلية أثناء وقت التشغيل. يمكنك تعريف العلامات مثل:
&=DataSource.ColumnName
تقوم Aspose.Cells بمعالجة هذه العلامات صفًا بصف، وتستبدلها بقيم حقيقية من مصدر بياناتك، مثل قائمة من القواميس أو كائن يشبه DataTable.
قم بإعداد قالب Excel
إنشاء ملف (على سبيل المثال، Template.xlsx
) مع علامات ذكية:
الاسم | البريد الإلكتروني | المبلغ |
---|---|---|
&=Data.Name | &=Data.Email | &=Data.Amount |
دليل خطوة بخطوة لتنفيذ دمج البريد باستخدام بايثون
يقوم هذا القسم بتفصيل الإجراء لتنفيذ عملية دمج البريد باستخدام قوالب Excel و Aspose.Cells for Python عبر API .NET. تتضمن العملية تحميل دفتر العمل النموذجي، وربطه بمصدر بيانات، وتنفيذ معالجة Smart Marker، وحفظ الناتج.
الخطوة 1: تحميل مصنف القالب
للبدء، قم بإنشاء كائن Workbook
عن طريق تحميل ملف Excel الذي يحتوي على علامات ذكية محددة مسبقًا.
import aspose.cells as ac
workbook = ac.Workbook("Template.xlsx")
ملاحظة: يجب أن يحتوي القالب على علامات ذكية بتنسيق
&=Data.FieldName
.
الخطوة 2: إنشاء وتعبئة مصدر البيانات
قم بإنشاء DataTable
ليكون بمثابة مصدر البيانات. عرّف الأعمدة المطلوبة وأضف صفوف البيانات التي تتوافق مع العلامات الذكية في القالب.
table = ac.DataTable("Data")
table.columns.add("Name")
table.columns.add("Email")
table.columns.add("Amount")
table.rows.add(["Alice", "alice@example.com", 1000])
table.rows.add(["Bob", "bob@example.com", 1500])
يجب أن يتطابق اسم كل عمود في
DataTable
مع معرّفات العلامة المستخدمة في قالب Excel.
الخطوة 3: ربط البيانات بالدفتر
استخدم فئة WorkbookDesigner
لربط مصنف البيانات بمصدر البيانات. يتيح لك ذلك ملء العلامات الذكية تلقائيًا أثناء المعالجة.
designer = ac.WorkbookDesigner()
designer.workbook = workbook
designer.set_data_source(table)
الخطوة 4: معالجة العلامات الذكية
قم بتنفيذ استبدال العلامة الذكية عن طريق استدعاء طريقة process()
. ستقوم هذه الطريقة بالتكرار على مصدر البيانات وإدراج القيم في المواقع المقابلة في مصنف العمل.
designer.process()
الخطوة 5: احفظ المصنف المدمج
احفظ دفتر العمل المعالج على القرص بتنسيق Excel.
workbook.save("MergedOutput.xlsx")
(Optional) Export the Output as PDF
لإنشاء نسخة PDF من المصنف المدمج، قم بتكوين خيارات حفظ PDF وحدد SaveFormat.PDF
أثناء التصدير.
pdf_options = ac.PdfSaveOptions()
workbook.save("MergedOutput.pdf", ac.SaveFormat.PDF)
كود بايثون كامل لدمج البريد
يظهر المثال التالي العملية الكاملة لإنشاء دمج بريد من Excel باستخدام Aspose.Cells لبيثون.
import aspose.cells as ac
# Load template
workbook = ac.Workbook("Template.xlsx")
# Create data source
table = ac.DataTable("Data")
table.columns.add("Name")
table.columns.add("Email")
table.columns.add("Amount")
table.rows.add(["Alice", "alice@example.com", 1000])
table.rows.add(["Bob", "bob@example.com", 1500])
# Connect data source
designer = ac.WorkbookDesigner()
designer.workbook = workbook
designer.set_data_source(table)
designer.process()
# Save output
workbook.save("MergedOutput.xlsx")
# Export to PDF
pdf_options = ac.PdfSaveOptions()
workbook.save("MergedOutput.pdf", ac.SaveFormat.PDF)
تأكد من أن العلامات الذكية في قالب Excel تتطابق مع أسماء الأعمدة المعرفة في
DataTable
. على سبيل المثال،&=Data.Name
في القالب تتوافق مع عمود باسم\"Name\"
في مصدر البيانات.
تقوم هذه التنفيذ بأتمتة مهام إنشاء المستندات، مثل الفواتير والتقارير أو الشهادات دون الحاجة إلى تثبيت Microsoft Excel.
Output
يولد كل صف في مصدر البيانات صفًا مخصصًا جديدًا في ملف Excel حيث تم وضع العلامات الذكية.

دمج البريد من إكسل في بايثون - المخرجات
احصل على ترخيص مجاني
يمكنك request a free temporary license لتقييم القدرات الكاملة لـ Aspose.Cells for Python عبر .NET دون قيود التقييم.
ترخيص هذا يمكن من الاختبار غير المحدود لجميع ميزات واجهة برمجة التطبيقات، بما في ذلك دمج البريد، وتصدير PDF، والتعامل مع مجموعات البيانات الكبيرة.
دمج البريد في إكسل باستخدام بايثون: موارد مجانية
- وثائق Aspose.Cells بايثون
- أدوات Excel على الإنترنت
- مرجع واجهة برمجة تطبيقات Aspose.Cells
- الدروس والأدلة
استنتاج
دمج البريد من Excel باستخدام Python يسهل إنشاء المستندات على نطاق واسع. مع العلامات الذكية من Aspose.Cells، يمكنك أتمتة هذه العملية بسرعة في بضع سطور من التعليمات البرمجية. سواء كان ذلك لإرسال الفواتير، أو إنشاء الشهادات، أو توليد التقارير، توفر واجهة برمجة التطبيقات Python السيطرة الكاملة والمرونة.
تحتاج إلى مساعدة؟ انضم إلى منتدى الدعم المجاني.