EWS

الوظيفة

اختبار Exchange Web Services

التنبيهات

Error code, Response code, Connection time, Login time, Mails total, Mails unread, Calender Items, Contacts, Found mails, Run time

توفر خدمات Exchange Web Services (EWS) الوظائف اللازمة لتمكين تطبيقات العملاء من التواصل مع خادم Exchange. تتيح EWS الوصول إلى معظم البيانات نفسها المتوفرة من خلال Microsoft OfficeOutlook. ويمكن لعملاء EWS دمج بيانات Outlook في تطبيقات خط الأعمال (LOB). كما يوفر بروتوكول SOAP إطار عمل المراسلة للرسائل المرسلة بين تطبيق العميل وخادم Exchange، ويتم إرسال رسائل SOAP عبر HTTP.

تفاصيل EWS

معاملات EWS

المعامل

الوصف

Account

تحديد نوع الاتصال، والاختيار بين Plain Text أو SSL/TLS

Username

اسم المستخدم للمصادقة

Password

كلمة المرور للمصادقة

Folder name

البحث في مجلد آخر غير صندوق الوارد

Common

إظهار الشجرة الجذرية

Send mail

إرسال بريد إلكتروني بتنسيق HTML (From = Account)

List mails

سرد عناصر البريد / البحث عنها

Calendar

سرد عناصر التقويم / البحث عنها

Contacts

سرد جهات الاتصال / البحث عنها

في حال تحديد أوامر تقوم بإنشاء قوائم، يتم إنشاء ملف وإرساله إلى واجهة المستخدم

المعاملات الاختيارية

قيم EWS وحدود التنبيه

القيمة / حد التنبيه

الوصف

Connection time

الوقت المستغرق للاتصال بالخادم البعيد (بالملي ثانية)

Login time

الوقت المستغرق لنقل البيانات من الخادم البعيد (بالملي ثانية)

Mails Total

إجمالي عدد رسائل البريد

Mails unread

عدد رسائل البريد غير المقروءة

Calendar items

إجمالي عدد إدخالات التقويم في حال تفعيل معامل القائمة

Contacs

إجمالي عدد جهات الاتصال في حال تفعيل معامل القائمة

Found mails

عدد رسائل البريد التي تم العثور عليها بناءً على معامل البحث

Found calendar items

عدد عناصر التقويم التي تم العثور عليها بناءً على معامل البحث

Found contacts

عدد جهات الاتصال التي تم العثور عليها بناءً على معامل البحث

Response code

رموز استجابة EWS

 0 = OK
-1 = خطأ عام
6 = معامل مفقود
11 = فشل التنفيذ
12 = خطأ Python
13 = انتهاء المهلة
14 = غير مصرح به
15 = خطأ SOAP
16 = خطأ حد المعدل
17 = خطأ النقل
18 = خطأ SSL/TLS
30 = خطأ صندوق البريد
31 = لم يتم العثور على البريد
32 = تعذر إرسال البريد
41 = لم يتم العثور على عنصر التقويم
51 = لم يتم العثور على جهة الاتصال

Run time

الوقت المستغرق لإكمال المهمة (بالثواني)

Error code

رمز خطأ المهمة العام (راجع قسم رموز أخطاء المهام)

Output

في حال سرد العناصر أو البحث عنها، يتم إنشاء ملف نصي وإرساله إلى واجهة المستخدم

أمثلة

البحث عن رسائل بريد محددة

سيقوم التكوين التالي بحساب رسائل البريد التي يحتوي موضوعها على "Teststring" فقط:

تم العثور على 3 رسائل بريد بموضوع مطابق:

البحث عن رسائل البريد وكتابة ملف النتائج

البحث عن رسائل بريد محددة وكتابة ملف نتائج:

يتم عرض سطر إضافي يحتوي على ملف الإخراج. يمكن فتح الملف في المتصفح أو استخدامه لمزيد من المعالجة على خادم SKOOR Server:

سرد رسائل البريد في ملف النتائج

إذا لزم الأمر، يمكن سرد أقدم أو أحدث رسائل البريد في ملف الإخراج. ويمكن تكوين عدد الرسائل المدرجة في الحقل المجاور للقائمة المنسدلة List mails (1 إذا تُرك فارغًا). ويتم سرد رسائل البريد التي تم العثور عليها بواسطة تكوين Search for بشكل منفصل في الملف نفسه.

مثال على ملف الإخراج

يحتوي الملف على ترويسة متبوعة بأقسام وفقًا للتكوين المحدد في إعدادات المهمة. يحتوي ملف المثال التالي على قسم واحد يضم أحدث عشر رسائل بريد، وقسم آخر يضم رسائل البريد التي تم العثور عليها بواسطة تكوين Search for. يبدأ كلا القسمين بحالة المهمة:

2018-10-25 14:18:35
Device: mail.company.com
Account: user@company.com
User: user
Name of inbox:  Posteingang
OK: Mail list (max 10 newest entries) of 'Posteingang':
      Sender                                	Received                  	Subject
    1 Worker, Mat					        	2018-10-25 11:32:11+00:00 	Just a test
    2 Example, Max 			                 	2018-10-25 09:55:51+00:00 	Reporting
    3 Test, Pat		                        	2018-10-25 05:27:18+00:00 	Weekly Meeting
	...
   10 Example, Max			                	2018-10-22 08:49:00+00:00 	Question
OK: Mails searched for 'Teststring' in 'Posteingang':
      Sender                                	Received                  	Subject
    1 Test, Pat				                 	2018-10-23 09:26:10+00:00 	Teststring
    2 Example, Max				            	2018-10-18 09:12:15+00:00 	Question about Teststring
    3 Test, Pat					            	2018-10-18 09:12:14+00:00 	Information: Teststring