العمل مع المجلدات على خادم Exchange
قائمة جميع المجلدات من الخادم
توفر Aspose.Email API القدرة على الاتصال بـ Exchange Server وإدراج جميع المجلدات والمجلدات الفرعية. يمكنك أيضًا استرجاع جميع المجلدات الفرعية من كل مجلد بشكل متكرر. كما توفر القدرة على تعداد المجلدات مع التقسيم إلى صفحات من عميل Exchange باستخدام Exchange Web Service (EWS). يوضح هذا المقال كيفية استرجاع جميع المجلدات الفرعية من خادم Exchange واسترجاع المجلدات مع التقسيم إلى صفحات.
المقتطف البرمجي التالي يوضح لك كيفية سرد المجلدات من خادم Exchange.
احصل على معلومات نوع المجلد باستخدام EWS
الـ ExchangeFolderType المُعدد المقدم من ExchangeFolderInfo فئة يمكن استخدامها للحصول على معلومات حول نوع المجلد. كما هو موضح في عينة الكود أدناه.
قائمة المجلدات بدعم التقسيم إلى صفحات باستخدام EWS
يوضح المقتطف البرمجي التالي كيفية استخدام دعم التقسيم إلى صفحات مع EWS.
الوصول إلى مجلدات وصناديق البريد المخصصة أو الفرعية
IEWSClient يسمح للمطورين بالوصول إلى أي مجلد مخصص أو مجلد فرعي من صندوق البريد. الـ FolderExists() طريقة من IEWSClient يعيد URI لمجلد/مجلد فرعي مخصص محدد، والذي يمكن استخدامه بعد ذلك للوصول إلى المجلد الهدف. في المثال التالي، يتم الوصول إلى مجلد مخصص باسم "TestInbox"، تم إنشاؤه تحت INBOX، وعرض جميع الرسائل من هذا المجلد المخصص. لتنفيذ هذه المهمة، يتم اتباع الخطوات التالية:
- قم بتهيئة الـ IEWSClient كائن عن طريق توفير بيانات اعتماد صالحة.
- الوصول إلى صندوق البريد الافتراضي.
- الوصول إلى المجلد الأصلي، وهو INBOX في هذا المثال. يمكن أن يكون هذا المجلد الأصلي أيضاً مجلدًا مخصصًا.
- استخدام FolderExists() طريقة للبحث في المجلد الفرعي المخصص المحدد، على سبيل المثال، "TestInbox". ستعيد URI الخاص بـ "TestInbox".
- استخدم هذا الـ URI للوصول إلى جميع الرسائل في ذلك المجلد المخصص.
يوضح مقتطف الكود التالي كيفية الوصول إلى المجلدات المخصصة أو المجلدات الفرعية في صندوق البريد باستخدام EWS.
قائمة المجلدات العامة
يتيح Microsoft Exchange Server للمستخدمين إنشاء مجلدات عامة ونشر الرسائل فيها. للقيام بذلك عبر تطبيقك، استخدم EWSClient فئة للاتصال بخادم Exchange وقراءة وتنزيل الرسائل والمنشورات من المجلدات العامة. يوضح المقتطف البرمجي التالي كيفية قراءة جميع المجلدات العامة والفرعية، وقائمة وتنزيل أي رسائل توجد في هذه المجلدات. يعمل هذا المثال فقط مع Microsoft Exchange Server 2007 أو أحدث حيث لا يدعم الإصدارات الأقدم EWS.
مزامنة عناصر المجلد
واجهات برمجة تطبيقات Aspose.Email IEWSClient توفر ميزة مزامنة محتويات مجلد Exchange. الـ SyncFolder طريقة معروضة من قبل IEWSClient يمكن استخدام الفئة لمزامنة معلومات المجلد على مجلد محدد. يوضح المقتطف البرمجي التالي كيفية مزامنة معلومات مجلد Exchange.
استرجاع الأذونات لمجلدات Exchange
يتم تعيين أذونات للمستخدمين على المجلدات العامة في Exchange Server، مما يحدد مستوى الوصول للمستخدم إلى هذه المجلدات. توفر فئة ExchangeFolderPermission مجموعة من خصائص الأذونات لمجلدات Exchange مثل مستوى الإذن، وما إذا كان يمكنهم إنشاء عناصر، حذف عناصر، وأداء مهام أخرى حسب خصائص الإذن. يمكن استرداد الأذونات باستخدام GetFolderPermissions() طريقة من IEWSClient. يوضح هذا المقال طريقة استرجاع الأذونات المطبقة على مجلد عام لجميع المستخدمين الذين لديهم حق الوصول إلى المجلدات المشتركة.
لإجراء هذه المهمة:
- قم بتهيئة الـ IEWSClient.
- استخدم الـ ListPublicFolders للحصول على قائمة بجميع المجلدات العامة
- استرجاع الأذونات المرتبطة بمجلد باستخدام GetFolderPermissions() طريقة
يوضح مقتطف الكود التالي كيفية استخدام IEWSClient فئة لاسترداد الأذونات المطبقة على مجلد.
إنشاء المجلدات والمجلدات الفرعية
توفر Aspose.Email API القدرة على إنشاء مجلدات في صندوق بريد Exchange. الـ CreateFolder طريقة من IEWSClient يمكن استخدامها لهذا الغرض. لإنشاء مجلد في صندوق بريد خادم Exchange، يمكن اتباع الخطوات التالية.
- إنشاء نسخة من IEWSClient.
- اضبط set_UseSlashAsFolderSeparator خاصية حسب المتطلبات. إذا تم ضبطها على true، سيعتبر التطبيق "Slash" فاصلًا للمجلد وسيتم إنشاء المجلد الفرعي بعد الفاصل.
- استخدم الـ CreateFolder طريقة لإنشاء المجلد.
المقتبس البرمجي التالي يوضح لك كيفية إنشاء مجلدات ومجلدات فرعية.
نسخ مجلدات Exchange احتياطيًا إلى PST
غالبًا ما يرغب المستخدمون في أخذ نسخة احتياطية من جميع أو بعض مجلدات علبة البريد. توفر Aspose.Email القدرة على أخذ نسخة احتياطية من جميع أو مجلدات علبة بريد Exchange المحددة إلى ملف PST. لعمل نسخة احتياطية من مجلدات خادم Exchange، يمكن اتباع الخطوات التالية.
- إنشاء نسخة من IEWSClient.
- أضف معلومات المجلد المطلوبة إلى ExchangeFolderInfoCollection
- استخدام IEWSClient->Backup طريقة لتصدير محتويات المجلد إلى ملف PST
المقتبس البرمجي التالي يوضح لك كيفية نسخ مجلدات Exchange احتياطيًا إلى PST.