M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions m365con.net

MAPI

Concept

MAPI (Messaging Application Programming Interface) هي واجهة برمجة تطبيقات مراسلة ونموذج بيانات مملوكان لشركة Microsoft، وتقومان عليهما Exchange وOutlook، وما زالت بنى البيانات القديمة فيها تشكّل طريقة تطوير Exchange.

✦ CONCEPTMAPIM365.FM
Title graphic: MAPI (Concept)

Description

MAPI، وهي اختصار لعبارة Messaging Application Programming Interface، واجهة برمجة تطبيقات مراسلة ونموذج بيانات مملوكان لشركة Microsoft، وتقوم عليهما Exchange وOutlook. ما زالت بنى البيانات القديمة فيها تؤثر في طريقة عمل المطورين مع بيانات Exchange اليوم، حتى عندما يستخدمون واجهات أحدث للوصول إليها. يُستخدم المصطلح للإشارة إلى واجهة البرمجة نفسها، كما يُستخدم للإشارة إلى الطريقة التي يُنمذج بها محتوى صناديق البريد في طبقاتها الأساسية.

وفقًا لمرجع Microsoft Learn، فإن MAPI هي واجهة Microsoft Outlook Messaging API، وتوفر البنية الخاصة بالمراسلة في Outlook 2013 وOutlook 2016. وهي تزوّد المطورين بالواجهات والدوال وأنواع البيانات التي يستخدمونها لبناء تطبيقات المراسلة في Outlook. تستخدم التطبيقات والناقلات MAPI للعمل مع بيانات البريد الإلكتروني، ولإنشاء الرسائل والمجلدات التي تحتويها، ولتلقي الإشعارات عند تغيّر البيانات المرتبطة بـ MAPI. تنطبق صفحة المرجع على Outlook 2013 وOutlook 2016 فقط، ولا تسرد الواجهات أو الدوال الفردية أو أمثلة الشيفرة.

ينقسم مرجع Microsoft Learn إلى أربعة أجزاء: نظرة عامة للبدء، وتطبيقات نموذجية، وأدلة مفاهيمية لفهم MAPI والبرمجة بها، ومرجع لعناصر البرمجة فيها. وللمطورين الجدد في هذا المجال، تشير الصفحة إلى مقالة منفصلة حول اختيار الواجهة أو التقنية المناسبة لتطوير حلول Outlook. ويعكس هذا الإرشاد قرارًا شائعًا، إذ إن MAPI خيار من بين خيارات عدة، ويعتمد الاختيار على نوع الحل المراد بناؤه.

تبرز أهمية MAPI عمليًا عندما يلزم نقل الشيفرة القائمة إلى تقنيات أحدث. تتناول حلقة M365.FM بعنوان "Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]" هذا الموضوع. تشير الحلقة إلى أن بعض سير العمل يحتاج إلى عناية خاصة عند الانتقال من Exchange Web Services إلى Microsoft Graph، ولا سيما ما يتعلق بصناديق البريد المؤرشفة أو المجلدات العامة. كما تذكر أن إنشاء البريد من MIME الخام باستخدام الخصائص الموسعة في MAPI قد يستلزم إعادة التفكير في سير العمل، لأن هذا الأسلوب لا ينتقل كما هو. وتُدرج الدلالات المتقدمة للتغييرات الزمنية (delta) ضمن الفروق الأخرى بين EWS وGraph، والتي قد تتطلب إعادة العمل في أجزاء من الشيفرة.

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

بالنسبة إلى المسؤولين والمطورين، فإن النتيجة العملية هي أن معرفة MAPI تظل ذات صلة بقراءة شيفرة Exchange وOutlook القديمة، وبفهم كيفية بنية الرسائل والمجلدات والإشعارات، وبتقدير جهد الانتقال إلى Microsoft Graph. ولأن المصادر المتاحة تصف MAPI أساسًا في سياق Outlook 2013 وOutlook 2016 وفي سياق ترحيل EWS إلى Graph، ينبغي لأي شخص يخطط لعمل ما أن يتحقق من الدعم الحالي والمتطلبات في الوثائق الرسمية للسيناريو المحدد.

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept
WikipediaMAPI – Wikipedia en.wikipedia.org

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

ما هي MAPI؟ (AI)

MAPI (Messaging Application Programming Interface) هي واجهة برمجة تطبيقات مراسلة ونموذج بيانات مملوكان لشركة Microsoft، وتقوم عليهما Exchange وOutlook. يصفها Microsoft Learn بأنها توفر البنية الخاصة بالمراسلة في Outlook 2013 وOutlook 2016.

ماذا يمكن للتطبيقات أن تفعل باستخدام MAPI؟ (AI)

تستخدم التطبيقات والناقلات MAPI للعمل مع بيانات البريد الإلكتروني، ولإنشاء الرسائل والمجلدات التي تحتويها، ولتلقي الإشعارات عند تغيّر البيانات المرتبطة بـ MAPI.

لماذا تظهر MAPI في عمليات ترحيل Exchange Web Services إلى Microsoft Graph؟ (AI)

تذكر حلقة "Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]" أن إنشاء البريد من MIME الخام باستخدام الخصائص الموسعة في MAPI قد يستلزم إعادة التفكير في سير العمل عند الانتقال إلى Graph.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Sources

Maintained by Mirko Peters (Microsoft MVP) · Last updated: