إنشاء ملفات PST في بايثون

عندما يتعلق الأمر بإدارة البريد الإلكتروني، تلعب ملفات PST (جدول التخزين الشخصي) دورًا حيويًا في تخزين وتنظيم بيانات البريد الإلكتروني.

في هذا الدليل، سنستكشف كيفية إنشاء ملفات PST جديدة في بايثون باستخدام واجهة برمجة التطبيقات التقدمية. سنغطي إنشاء تخزين فارغ، وإضافة مجلدات ومجلدات فرعية، وإدماج المجلدات القياسية والعادية، وأخيرًا، إضافة رسائل البريد الإلكتروني وعناصر Outlook إلى ملف PST.

واجهة برمجة التطبيقات بايثون لإنشاء وملء ملفات PST

للاستفادة من ملفات التخزين بتنسيق PST في بايثون، سنستخدم Aspose.Email for Python. إنها واجهة برمجة تطبيقات قوية توفر للمطورين الأدوات للعمل مع تنسيقات البريد الإلكتروني، بما في ذلك ملفات PST، في تطبيقاتهم بايثون. مع Aspose.Email، يمكنك بسهولة إنشاء الرسائل الإلكترونية والتلاعب بها وإدارة ملفات التخزين، مما يجعلها أداة أساسية لمهام البريد الإلكتروني.

للاستفادة من قوة واجهة برمجة التطبيقات، يمكنك تنزيل DLL الخاصة بها أو تثبيتها من PyPI.

إنشاء ملف PST جديد

يمكن إنشاء ملف PST جديد بسهولة باستخدام طريقة PersonalStorage.create(). يوضح مقتطف الشيفرة التالي كيفية إنشاء ملف تخزين جديد يسمى “output.pst” باستخدام Aspose.Email:

  1. استيراد الوحدات اللازمة من Aspose.Email.
  2. تحديد المسار لملف PST الجديد.
  3. إنشاء ملف PST فارغ جديد باستخدام طريقة ‘PersonalStorage.create()’، وتمرير مسار الملف وتحديد التنسيق كـ Unicode. هذا ينشئ ملفًا فارغًا جاهزًا للتخصيص الإضافي، مثل إضافة مجلدات أو رسائل أو جهات اتصال.
pst_path = "output.pst"
pst = PersonalStorage.create(pst_path, PersonalStorage.UNICODE)
view raw create_new_pst.py hosted with ❤ by GitHub

ملاحظة: الحد الأدنى لملف PST هو 256 كيلوبايت، ويحتوي على مجلد الجذر ومجلد العناصر المحذوفة.

إضافة مجلدات ومجلدات فرعية

بمجرد أن نحصل على ملف تخزين فارغ جديد، تكون الخطوة التالية هي إضافة مجلدات ومجلدات فرعية لتنظيم بياناتنا بكفاءة. ضع في اعتبارك الأقسام الفرعية التالية وجرب نماذج الشيفرة التالية لتنفيذ المهمة.

إضافة مجلدات قياسية

من الممارسات الشائعة تضمين مجلدات قياسية مثل البريد الوارد، العناصر المرسلة، جهات الاتصال، أو التقويم عند العمل مع ملفات PST. تبسط Aspose.Email for Python المهمة من خلال توفير طرق سهلة الاستخدام. يوضح مقتطف الشيفرة التالي كيفية إضافة مجلدات قياسية إلى ملف تخزين باستخدام واجهة برمجة التطبيقات بايثون:

  1. إنشاء ملف PST جديد باستخدام طريقة PersonalStorage.create() كما هو موضح أعلاه.
  2. إنشاء مجلد بريد وارد قياسي باستخدام طريقة create_predefined_folder()، مع تمرير الاسم “Inbox” وتحديد النوع كـ StandardIpmFolder.INBOX. هذا يضمن أن يحتوي الملف على مجلد بريد وارد قياسي جاهز للاستخدام.
inbox_folder = pst.create_predefined_folder("Inbox", PersonalStorage.StandardIpmFolder.INBOX)
view raw add_standard_folders.py hosted with ❤ by GitHub

يمكن إضافة مجلدات قياسية مثل العناصر المحذوفة، التقويم، جهات الاتصال، السجل، الملاحظات، المهام، مشكلات المزامنة، رسائل البريد المزعج، خلاصة RSS بسهولة إلى ملف PST جديد:

مجلدات قياسية

إضافة مجلدات عادية

بالإضافة إلى المجلدات القياسية مثل البريد الوارد والعناصر المرسلة، يسمح Aspose.Email for Python بإنشاء مجلدات مخصصة أو عادية داخل ملفات PST. إنها توفر مرونة في تنظيم وتصنيف بيانات البريد الإلكتروني وفقًا لمتطلبات محددة. يوضح نموذج الشيفرة التالي كيفية إضافة مجلدات عادية باستخدام Aspose.Email:

  1. إنشاء تخزين جديد باستخدام طريقة PersonalStorage.create().
  2. استخدام طريقة add_sub_folder() لإنشاء مجلد مخصص يسمى “SomeFolder” داخل المجلد الجذر لملف PST.
  3. إنشاء مجلد فرعي يسمى “SubFolder” داخل “SomeFolder”، مما يوفر هيكلًا هرميًا لتنظيم بيانات البريد الإلكتروني بفعالية.

بعد إنشاء المجلد المخصص، يمكنك استخدام طريقة ‘add_sub_folder()’ مرة أخرى لإنشاء مجلدات فرعية بداخله. قدم الاسم المرغوب للمجلد الفرعي كمعامل للطريقة.

# Create a PST file
with PersonalStorage.create("sample.pst", FileFormatVersion.UNICODE) as pst:
# Create a custom folder
some_folder = pst.root_folder.add_sub_folder("SomeFolder")
# Create a subfolder to the custom folder
sub_folder = some_folder.add_sub_folder("SubFolder")
view raw add_regular_folders.py hosted with ❤ by GitHub

من خلال دمج المجلدات العادية في ملفات PST، يمكن للمطورين تخصيص بنية تخزين البريد الإلكتروني لتناسب احتياجات التطبيق المحددة.

إضافة رسائل البريد الإلكتروني وعناصر Outlook

مع وجود الهيكل في مكانه، يمكننا الآن ملء ملف PST لدينا بالرسائل الإلكترونية وغيرها من عناصر Outlook. يتضمن ذلك إنشاء رسائل البريد الإلكتروني، المواعيد، جهات الاتصال، المهام، وأكثر، وإضافتها إلى المجلدات المناسبة داخل الملف. دعونا نأخذ في الاعتبار بعض الأمثلة.

إضافة رسائل بريد إلكتروني جديدة

يظهر نموذج الشيفرة أدناه كيفية إضافة رسالة بريد إلكتروني جديدة إلى مجلد “البريد الوارد” داخل ملف PST. يتضمن الرمز الخطوات التالية:

  1. إنشاء تخزين جديد يسمى “sample.pst” بتنسيق Unicode باستخدام طريقة PersonalStorage.create().
  2. الوصول إلى مجلد “البريد الوارد” داخل ملف التخزين باستخدام طريقة get_sub_folder().
  3. إنشاء رسالة بريد إلكتروني جديدة باستخدام منشئ MapiMessage()، مع تحديد المرسل، المستلم، الموضوع، ونص الرسالة.
  4. إضافة الرسالة التي تم إنشاؤها حديثًا إلى مجلد “البريد الوارد” داخل ملف PST باستخدام طريقة add_message().
# Create a PST file
with PersonalStorage.create("sample.pst", FileFormatVersion.UNICODE) as pst:
# Access the folder to add items
inbox_folder = pst.root_folder.get_sub_folder("Inbox")
# Create a new message
message = MapiMessage("from@example.com", "to@example.com", "Subject", "Body")
# Add the message to the Inbox folder
inbox_folder.add_message(message)
view raw add_new_emails.py hosted with ❤ by GitHub

إضافة عناصر Outlook

يتيح لك نموذج الشيفرة التالي إضافة جهة اتصال إلى ملف PST جديد كمثال. يوضح العملية لإنشاء ملف تخزين شخصي جديد، وإضافة مجلد جهات الاتصال القياسي إليه، وتحميل جهة اتصال من ملف VCF، وإضافة جهة الاتصال إلى مجلد جهات الاتصال. يتضمن الرمز الخطوات التالية:

  1. إنشاء تخزين جديد يسمى “sample.pst” بتنسيق Unicode باستخدام طريقة PersonalStorage.create().
  2. إنشاء مجلد قياسي يسمى “جهات الاتصال الخاصة بي” داخل ملف التخزين باستخدام طريقة create_predefined_folder()، مع تحديد النوع كـ StandardIpmFolder.Contacts.
  3. تحميل جهة اتصال من ملف VCF (vCard) باستخدام طريقة from_v_card(). تقوم هذه الطريقة بتحليل ملف VCF وإنشاء كائن MapiContact يمثل معلومات جهة الاتصال.
  4. إضافة جهة الاتصال إلى مجلد “جهات الاتصال الخاصة بي” داخل ملف PST باستخدام طريقة add_mapi_message_item().
# Create a PST file
with PersonalStorage.create("sample.pst", FileFormatVersion.UNICODE) as pst:
# Create a standard folder (Contacts)
contacts_folder = pst.create_predefined_folder("My Contacts", StandardIpmFolder.CONTACTS)
# Load a contact from vcf file
contact = MapiContact.from_v_card("Contact.vcf")
# Add the contact to the folder
contacts_folder.add_mapi_message_item(contact)
view raw add_outlook_items.py hosted with ❤ by GitHub

الخاتمة

في هذه الدورة، استكشفنا كيفية إنشاء ملفات PST جديدة في بايثون باستخدام واجهة برمجة التطبيقات التقدمية المقدمة من Aspose.Email. لقد غطينا جوانب مختلفة، بما في ذلك إنشاء تخزين PST فارغ، وإضافة مجلدات ومجلدات فرعية، وإدماج المجلدات القياسية والعادية، وإضافة رسائل البريد الإلكتروني وعناصر Outlook إلى ملف التخزين.

مع Aspose.Email for Python عبر .NET، يصبح إنشاء ملفات PST برمجيًا مهمة بسيطة. جربها في مشاريع بايثون الخاصة بك وقم بتبسيط سير العمل المتعلق بالبريد الإلكتروني اليوم!

بعيدًا عن ذلك، تقدم المكتبة مجموعة واسعة من الميزات لإنشاء، استخراج، تحليل، تحويل، والتلاعب بالبريد الإلكتروني المدعوم بواسطة وثائق شاملة وأمثلة الشيفرة لتبسيط عملية التكامل، مما يجعل من السهل على المطورين تنفيذ حلول تتعلق بالبريد الإلكتروني داخل تطبيقاتهم .NET.

بالإضافة إلى واجهة برمجة التطبيقات المتقدمة، يمكنك الحصول على وصول مستمر إلى موارد مجانية:

  • منتدى الدعم - مجتمع ضخم للحصول على إجابات لجميع أسئلتك
  • مدونة - معلومات لا تقدر بثمن حول الميزات الحديثة
  • وثائق - دورات، أمثلة شيفرة، وأفضل الممارسات مع الوصول إلى مراجع واجهة برمجة التطبيقات
  • تطبيقات مجانية apps لعرض أو تحويل، دمج أو تحليل رسائل البريد الإلكتروني، تحليل الرؤوس، إضافة علامة مائية، وأكثر

تضمن Aspose.Email أن يكون لدى المطورين الموارد اللازمة للتنقل في أي تحديات وتعظيم إمكانيات واجهة برمجة التطبيقات داخل تطبيقاتهم.

انظر أيضًا