كيفية إنشاء إضافات Office: من النموذج الأولي إلى الإضافة

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

سنغطي المسار بأكمله في هذا الدليل، من النموذج الأولي الأول إلى الحصول على إضافة جاهزة للاستخدام لبرامج Word وExcel وOutlook وتطبيقات Microsoft 365 الأخرىستتعرف على الأدوات المتاحة لك (Yeoman، Visual Studio، Agents Toolkit، Visual Studio Code Development Kit)، وكيفية تنظيم الملحق داخليًا، وكيفية اتصاله بواجهة برمجة تطبيقات Office، والخطوات التي يجب اتباعها لتشغيله وتصحيحه على كل من سطح المكتب والويب.

منصة إضافات Office: نقطة البداية

جميع إضافات Office الحديثة مبنية على منصة إضافات Office، وهي الأساس المشترك لبرامج Word وExcel وOutlook وPowerPoint وOneNote وProjectوهذا يعني أنه يتم إعادة استخدام نفس البنية في تطبيقات مختلفة، وأن العديد من أجزاء التطوير موحدة.

قبل كتابة سطر واحد من التعليمات البرمجية، من المفيد فهم بعض المفاهيم الأساسية: ما هي التطبيقات والمنصات المتوافقة، وما هي أنماط البرمجة التي توفرها واجهة برمجة تطبيقات جافا سكريبت الخاصة بـ Office، وكيف يتم تعريف بيان الوظيفة الإضافية، وكيف يتم تصميم الواجهة. (لوحات المهام، مربعات الحوار، علامات التبويب المخصصة، إلخ). دورة التطوير الكاملة هذه هي الإطار الذهني الذي ستستخدمه للانتقال من النموذج الأولي إلى الإضافة الفعلية.

كيف يتم إنشاء إضافات Office؟

لبدء مشروعك، لديك عدة مسارات رسمية، كل منها مصمم لملفات تعريف مختلفة للمطورين، ولكن جميعها لها هدف مشترك: قم بإنشاء حل إضافي قائم على HTML وCSS وJavaScript (أو TypeScript) يتكامل مع Officeالخيارات الرئيسية التي تقدمها مايكروسوفت حاليًا هي:

• مولد Yeoman لإضافات Office.
• Visual Studio (مع دعم خاص لإضافات Office).
• مجموعة أدوات وكلاء مايكروسوفت 365.
• مجموعة أدوات تطوير إضافات Office لبرنامج Visual Studio Code.

مولد Yeoman لإضافات Office

يُعد مولد Yeoman لبرامج Office مثاليًا إذا كنت مرتاحًا في بيئات الويب وبيئات سطر الأوامر. يقوم Yeoman بإنشاء مشروع Node.js كامل الوظائف لك يمكنك فتحه في Visual Studio Code أو أي محرر آخر.، مع وجود الهيكل الكامل (البيان، لوحة المهام، الأنماط والبرامج النصية) جاهزًا لبدء التخصيص.

باستخدام هذا المولد، يمكنك إنشاء إضافات لـ إكسل، ون نوت، أوتلوك، باوربوينت، بروجكت، وورد، بالإضافة إلى مشاريع وظائف إكسل المخصصة.عند إعداد المشروع، يمكنك اختيار قالب بسيط باستخدام HTML وCSS وJavaScript (أو TypeScript) أو بناء الهيكل باستخدام React، مع إمكانية الاختيار بين JavaScript وTypeScript حسب تفضيلاتك.

لبدء استخدام Yeoman، تحتاج إلى قم بتثبيت إصدار Node.js LTS على نظامك، ثم قم بتثبيت Yeoman والمولد الخاص بـ Office عالميًا باستخدام npm.يتم ذلك من خلال وحدة التحكم عن طريق تشغيل ما يلي:

npm install -g yo generator-office

بمجرد إعداد البيئة، ما عليك سوى جولة في الدليل المطلوب:

yo office

أثناء استخدام المعالج، سيُطلب منك تقديم معلومات مثل نوع المشروع (على سبيل المثال، مشروع جزء مهام الوظيفة الإضافية لـ Office)، نوع البرنامج النصي (جافا سكريبت أو تايب سكريبت)، و اسم الإضافة وتطبيق Office الذي يستهدفه (Word، Excel، Outlook، إلخ). بناءً على إجاباتك، سيقوم Yeoman بإنشاء مجلد المشروع، وتثبيت تبعيات Node اللازمة، وترك الإضافة جاهزة للتشغيل والاختبار.

إضافات Visual Studio لـ Office

إذا كنت تفضل تجربة أكثر كلاسيكية وبيئة تطوير متكاملة (IDE)، يتضمن Visual Studio قوالب لإنشاء وظائف إضافية لبرنامج Office لبرامج Excel و Outlook و Word و PowerPointفي هذه الحالة، يعد مشروع الإضافة جزءًا من حل Visual Studio ويعمل أيضًا مع HTML وCSS وJavaScript كتقنيات واجهة ومنطق.

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

مجموعة أدوات وكلاء Microsoft 365

خيار آخر مثير للاهتمام بشكل خاص إذا كنت ترغب في تجاوز الإضافة التقليدية هو مجموعة أدوات Microsoft 365 Agents، وهي مجموعة أدوات مصممة لإنشاء ملحقات Microsoft 365 بمعناها الواسعباستخدام هذا الحل، يمكنك تطوير ليس فقط إضافات Office، ولكن أيضًا أي نوع من الإضافات التي تتفاعل مع خدمات Microsoft 365.

باستخدام هذه الأدوات يصبح ذلك ممكناً أنشئ مشاريع إضافات Office باستخدام قوالب ومعالجات مصممة لعمليات التكامل المتقدمة.على سبيل المثال، السيناريوهات التي يشارك فيها الملحق الخاص بك في سير عمل أوسع أو يتفاعل مع خدمات سحابية أخرى داخل نظام 365 البيئي.

مجموعة تطوير الوظائف الإضافية لـ Office لـ Visual Studio Code

إذا كانت بيئة عملك المعتادة هي VS Code، فلديك إضافة رسمية متاحة: مجموعة أدوات تطوير إضافات Office، التي تتكامل مباشرة مع شريط أنشطة Visual Studio Codeباستخدام هذا الامتداد، يمكنك إنشاء مشاريع إضافية جديدة وتحميل الأمثلة بسرعة من المحرر نفسه.

بالنقر على الخيار المناسب داخل الإضافة، سيتم فتح معالج يقوم بإنشاء مشروع الملحق الخاص بك، ووضعه في مجلد العمل الذي اخترته، وفتحه في نافذة جديدة لبرنامج Visual Studio Code.ستحتوي هذه النافذة الجديدة بالفعل على هيكل المشروع، وعادةً ما تحتوي على مثال أساسي لجزء المهام لمساعدتك على فهم البنية.

ومن هناك يمكنك مراجعة الملفات الرئيسية مثل: ملف manifest.xml أو manifest.json في جذر المشروع (حيث يتم تكوين الملحق)والملفات التي تحدد جزء المهام: ./src/taskpane/taskpane.html لأغراض التقييم، ./src/taskpane/taskpane.css للأنماط و ./src/taskpane/taskpane.js بالنسبة للتعليمات البرمجية التي تستخدم واجهة برمجة تطبيقات Office.

الجزآن الأساسيان لملحق Office

يتكون كل ملحق حديث لبرنامج Office بشكل عام من جزأين رئيسيين: بيان يوضح كيفية تكامل الملحق مع Office وتطبيق ويب يحدد واجهة المستخدم والمنطق.

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

يستخدم تطبيق الويب واجهة برمجة تطبيقات جافا سكريبت الخاصة بـ Office للتفاعل مع المستند (أو رسالة البريد الإلكتروني، في حالة Outlook) الذي يتم تشغيل الوظيفة الإضافية فيهعلاوة على ذلك، ومثل أي تطبيق ويب، يمكنه المصادقة على الخدمات الخارجية، واستخدام واجهات برمجة تطبيقات REST، والعمل مع هوية المستخدم، وغير ذلك الكثير.

البيان: تكوين المكونات الإضافية وقدراتها

يحدد ملف البيان كل ما يحتاجه برنامج Office تقريبًا لمعرفته حول الحل الخاص بك، لذا فهو ملف بالغ الأهمية. يتضمن ذلك البيانات الوصفية (المعرف، الاسم، الوصف، الإصدار، اللغة الافتراضية) وكذلك قائمة تطبيقات Office التي يمكن تحميل الملحق عليها.

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

جانب آخر يتم التحكم فيه من خلال البيان هو الصور المستخدمة في أيقونات الإضافة، وتخصيص العلامة التجارية، وأبعاد الحاوية (على سبيل المثال، حجم إضافة المحتوى أو الارتفاع المفضل لإضافة Outlook).

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

تطبيق الويب والتفاعل مع مستند Office

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

لكي يتفاعل تطبيق الويب مع المستند، فإنه يعتمد على واجهة برمجة تطبيقات جافا سكريبت الخاصة بـ Office، والتي يتم استيرادها عبر برنامج نصي مستضاف على شبكة توصيل المحتوى الرسمية (CDN).المسار النموذجي هو:

https://appsforoffice.microsoft.com/lib/1/hosted/office.js

في أي صفحة ويب خاصة بالملحق حيث تريد استخدام واجهة برمجة التطبيقات (API)، يجب عليك الإشارة إلى هذا الملف داخل علامة en el من مستند HTML، على سبيل المثال:

<head>...<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>...</head>

من هناك يمكنك استخدم الكائنات والأساليب التي يوفرها Office.js لقراءة المحتوى وتعديله، وعرض مربعات الحوار، واستخدام إعدادات العميل، وغير ذلك الكثير..

نموذجان لواجهة برمجة التطبيقات: خاص بالتطبيق وعامة

إن واجهة برمجة تطبيقات جافا سكريبت الخاصة بـ Office ليست كتلة واحدة متجانسة؛ بل هي منظمة في نموذجين متميزين بأهداف متكاملة. من جهة، لدينا واجهات برمجة التطبيقات الخاصة بالتطبيقات (مثل Excel وWord وما إلى ذلك)، ومن جهة أخرى، لدينا واجهات برمجة التطبيقات العامة التي تعمل على مضيفات متعددة..

ال توفر واجهات برمجة التطبيقات الخاصة بالتطبيقات كائنات ذات أنواع محددة بدقة تمثل كيانات فريدة لكل برنامج. (على سبيل المثال، الأوراق، والنطاقات، والجداول، والمخططات في برنامج Excel). تم تقديم هذا النموذج مع Office 2016 ويستخدم الوعود، مما يسمح يؤدي تجميع عمليات متعددة في مكالمة واحدة إلى تحسين الأداء، خاصة في Office على الويب..

وفي الوقت نفسه، تتيح واجهات برمجة التطبيقات الشائعة الوصول إلى أجزاء من التجربة المشتركة بين التطبيقات المختلفةتُدمج عناصر واجهة المستخدم، ومربعات الحوار، وإعدادات العميل، وحتى وظائف التفاعل مع Outlook أو PowerPoint أو Project، في نموذج واحد. في هذه الحالة، يكون النمط أكثر تقليدية، ويعتمد على ردود الاتصال، وعادةً ما يكون لا يُسمح إلا بعملية واحدة لكل طلبظهرت واجهات برمجة التطبيقات الشائعة هذه مع Office 2013 ولا تزال ذات صلة عندما تريد أن يعمل الملحق الخاص بك في أكبر عدد ممكن من التطبيقات.

مجموعة متطلبات واجهة برمجة التطبيقات

في عالم Office.js، يتم تجميع الوظائف في مجموعات تسمى مجموعات المتطلبات. مجموعة المتطلبات هي في الأساس مجموعة مُسماة من أعضاء واجهة برمجة التطبيقات التي تمثل إصدارًا معينًا أو مجموعة من القدرات..

توجد مجموعات مصممة خصيصًا لتطبيق معين، مثل ExcelApi 1.7، والذي لا يمكن استخدامه إلا في Excelوغيرها من الأمور ذات الطبيعة الشاملة، مثل DialogApi 1.1، والذي يستخدم للتعامل مع مربعات الحوار في أي تطبيق يدعمه..

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

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

استكشف واجهة برمجة التطبيقات (API) باستخدام Script Lab

إذا كنت ترغب في التجربة بسرعة دون الحاجة إلى إعداد مشروع كامل، فإن Script Lab في متناول يديك. Script Lab هو إضافة مجانية لبرنامج Office تتيح لك كتابة وتشغيل واختبار أجزاء من كود Office.js مباشرة من تطبيقات مثل Excel أو Word.

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

تُعد هذه الأداة مفيدة بشكل خاص في مرحلة النموذج الأولي، لأن يتيح لك ذلك التحقق بسرعة مما إذا كانت واجهة برمجة التطبيقات (API) تفعل ما تحتاجه، ومعرفة كيفية عملها في Office على الويب أو سطح المكتب، وتعديل منطقك قبل دمجها في المشروع الحقيقي..

قم بتوسيع واجهة مستخدم Office باستخدام الإضافة الخاصة بك

من أهم مزايا إضافات Office قدرتها على قم بتوسيع واجهة المستخدم وتفاعل مع التجربة الأصلية لبرامج Word أو Excel أو Outlook.يعتمد هذا الامتداد لواجهة المستخدم بشكل أساسي على أوامر المكونات الإضافية وحاويات HTML مثل أجزاء المهام والمكونات الإضافية للمحتوى ومربعات الحوار.

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

من ناحية أخرى، فإن حاويات HTML (لوحات المهام، ومكونات المحتوى الإضافية، ومربعات الحوار) هي "المساحة" التي يتم فيها عرض واجهة تطبيق الويب الخاص بك. يأتي محتوى كل حاوية من صفحة ويب مستضافة على خادمك، والتي يمكنها استخدام واجهة برمجة تطبيقات Office، واستدعاء الخدمات الخارجية، ومصادقة المستخدمين، وتنفيذ أي منطق نموذجي لتطبيق ويب حديث..

في الواقع العملي، قد يكون لديك، على سبيل المثال، زر على الشريط يفتح جزء المهام على يمين المستند، بالإضافة إلى مربع حوار منبثق ومكون إضافي للمحتوى مضمن مباشرة في سطح المستنديتم تنسيق كل هذا باستخدام JavaScript و Office.js.

أنشئ مشاريع إضافية في Visual Studio Code باستخدام مجموعة أدوات التطوير

عند العمل مع مجموعة أدوات تطوير Office Add-In في Visual Studio Code، يكون سير العمل النموذجي بسيطًا إلى حد ما. أولاً، عليك استيفاء المتطلبات الأساسية (Node.js، تثبيت الإضافة، ربط Office بـ Microsoft 365). وبعد ذلك يمكنك تشغيل معالج إنشاء المشروع من أيقونة المجموعة في شريط الأنشطة.

بعد اختيار خيار إنشاء إضافة جديدة، سيُطلب منك الاختيار نوع المشروع واسمه ومجلد العملبمجرد تأكيد هذه المعلومات، يقوم الملحق تلقائيًا بإنشاء المشروع، وتثبيت التبعيات اللازمة، وفتح الحل في نافذة ثانية لبرنامج Visual Studio Code (يُنصح بإغلاق النافذة الأولى لتجنب الارتباك).

ستجد دائمًا بعض الملفات الرئيسية داخل المشروع: ملف البيان (manifest.xml أو manifest.json) في الدليل الجذر وملفات لوحة المهام في مجلد src/taskpaneيحدد ملف HTML بنية اللوحة، ويتحكم ملف CSS في المظهر المرئي، ويحتوي ملف JavaScript على استدعاءات واجهة برمجة تطبيقات Office.js التي تربط الواجهة بتطبيق عميل Office.

تشغيل وإيقاف المعاينة باستخدام مجموعة أدوات التطوير

لاختبار الملحق من VS Code، يتم استخدام مجموعة أدوات التطوير نفسها. ما عليك سوى تحديد رمز الامتداد، واختيار خيار "معاينة وظيفة Office الإضافية (F5)"، ثم تحديد التطبيق المستهدف.على سبيل المثال "Excel Desktop (Edge Chromium)" أو "Word Desktop (Edge Chromium)".

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

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

إذا حدث خطأ ما أثناء تشغيل الملحق، فإن الشيء المعتاد فعله هو التحقق من الطرفية المدمجة في VS Code. إذا استمرت المشاكل، يُنصح بإغلاق جميع مثيلات Office المفتوحة وإيقاف أي خوادم لمجموعات تطوير البرامج القديمة قبل إعادة تشغيل المعاينة.بالنسبة للمشاكل الأكثر تعقيدًا، تتوفر وثائق استكشاف الأخطاء وإصلاحها، وفي النهاية، يمكنك دائمًا فتح مشكلة على GitHub للحصول على المساعدة.

إنشاء إضافة باستخدام Yeoman: من "مرحباً بالعالم" إلى شيء أكثر تعقيداً

عند استخدام Yeoman لإنشاء إضافة، فإن العملية العملية تتبع تسلسلًا واضحًا إلى حد ما. بعد تثبيت Node.js و Yeoman ومولد Office، تقوم بتشغيل الأمر `yo office`، والإجابة على بعض الأسئلة، وستحصل على مجلد يحتوي على مشروع قابل للتنفيذ..

في مثال برنامج وورد النموذجي، يمكنك اختيار مشروع جزء المهام الإضافي لـ Office باستخدام JavaScript، قم بتسميته "My Office Add-in" وحدد Word كتطبيق العميل.سيقوم المولد بإنشاء الهيكل الأساسي للمكون الإضافي وتشغيل عملية تثبيت npm الأولية لتجهيز التبعيات.

لاستكشاف ما تم إنشاؤه، ما عليك سوى الوصول إلى مجلد المشروع و افتح الملفات الرئيسية: ملف البيان (manifest.xml أو manifest.json)، وملف HTML الخاص بلوحة المهام، وملف CSS الخاص بها، وبرنامج JavaScript النصي الذي يحتوي على استدعاءات Office.jsيتضمن المثال عادةً إجراءً بسيطًا، مثل كتابة "Hello, world" في المستند أو تغيير نمط بعض النصوص.

يتم التنفيذ من سطر الأوامر. في الدليل الجذر للمشروع، يمكنك تشغيل `npm start` لبدء تشغيل الخادم المحلي وفتح برنامج Word مع تحميل الإضافة.إذا كنت ترغب في تجربته في Office على الويب، فهناك أيضًا صيغة أمر تتضمن عنوان URL لمستند في OneDrive أو SharePoint:

npm run start -- web --document {url}

إذا لم يظهر جزء مهام الإضافة تلقائيًا عند فتح برنامج Word، يمكنك فتح مستند جديد، والانتقال إلى علامة التبويب الرئيسية، والنقر فوق زر "إظهار جزء المهام" في الإضافة الخاصة بك.تحتوي اللوحة عادةً على رابط أو زر "تشغيل" يقوم بتشغيل وظائف المثال (على سبيل المثال، إدراج "Hello, world" باللون الأزرق).

عندما تريد إيقاف الخادم المحلي وإلغاء تثبيت الملحق، يمكنك استخدام أمر npm stop، الذي يقوم بإيقاف تشغيل الخادم، وفي الحالة المعتادة، يقوم بإزالة الملحق المسجل لتلك الجلسة.إذا قمت بتحميله يدويًا كإضافة محلية في Office على الويب، فسيتعين عليك اتباع إجراء الإزالة اليدوية من واجهة Office نفسها.

في بعض الأحيان، قد تفشل عملية التثبيت التلقائي للتبعيات التي يقوم بها Yeoman (npm install). إذا واجهت أخطاء عند تشغيل npm start، فإن أسهل شيء يمكنك فعله هو الانتقال إلى مجلد المشروع وتشغيل npm install بنفسك لحل أي وحدات مفقودة.من الطبيعي أن تظهر بعض التحذيرات أثناء التثبيت؛ وفي معظم الحالات لا تمنع هذه التحذيرات كل شيء من العمل.

إذا كنت ترغب في ضبط إصدارات الحزم بدقة وتنظيف التبعيات القديمة، يمكنك استخدام أداة npm-check-updates (ncu) للتحقق من التبعيات وتحديثها بشكل جماعيسيكون التسلسل هو تثبيت ncu عالميًا، وتشغيل ncu -u في جذر المشروع، وأخيرًا تشغيل npm install مرة أخرى.

أول إضافة لبرنامج Outlook مع Yeoman

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

عملية الإنشاء باستخدام Yeoman تشبه إلى حد كبير عملية الإنشاء باستخدام Word. قم بتثبيت Node.js و Yeoman ومولد Office، ثم قم بتشغيل Office، واختر Outlook هذه المرة كتطبيق العميل.مرة أخرى، عليك اختيار مشروع من نوع لوحة المهام، وتحديد اسم الملحق، وتحديد نوع البيان الذي تريد استخدامه (على سبيل المثال، "بيان موحد لـ Microsoft 365" أو "بيان خاص بالملحقات فقط" حسب السيناريو الخاص بك).

سيقوم المولد بإعداد مشروع لك مع بيانه (JSON أو XML)، و HTML الخاص بجزء المهام، والأنماط، و JavaScript الذي يستخدم واجهة برمجة تطبيقات Office للوصول إلى الرسالة المحددة. يُظهر المثال الأساسي عادةً خاصية واحدة على الأقل من خصائص البريد الإلكتروني، مثل الموضوع، في جزء المهام نفسه..

npm start

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

• في Outlook على الويب و Outlook الجديد لنظام التشغيل Windows، يمكنك الوصول إليه عادةً من شريط إجراءات الرسائل، في قائمة التطبيقات.
• في برنامج Outlook الكلاسيكي لنظام التشغيل Windows، يظهر الزر عادةً في علامة التبويب الرئيسية أو الرسالة في الشريط.
• في برنامج Outlook لنظام التشغيل Mac، سترى اسم الوظيفة الإضافية في الشريط؛ قد تحتاج إلى توسيع قائمة النقاط الثلاث للعثور عليها.

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

لإيقاف الخادم المحلي وإلغاء تثبيت الملحق، يمكنك استخدم الأمر `npm stop` في وحدة التحكم، والذي سيؤدي إلى إيقاف تشغيل الخادم وتنظيف سجل الإضافات إذا تم تثبيته باستخدام الأمر `npm start`.إذا قمت بتحميل الإضافة يدويًا، فسيتعين عليك اتباع عملية الإزالة اليدوية في تطبيق Outlook المقابل.

تنطبق نفس نصائح استكشاف الأخطاء وإصلاحها هنا: إذا فشل تثبيت npm في البداية، فقم بتشغيله يدويًا، وتجاهل التحذيرات غير الحرجة، واستخدم npm-check-updates إذا كنت ترغب في تحديث التبعيات بطريقة مضبوطة.بالإضافة إلى ذلك، تتضمن الوثائق الرسمية أمثلة برمجية أكثر تفصيلاً، مثل إضافة "Hello World" الخاصة ببرنامج Word أو دروس تعليمية أكثر تقدماً لبرنامج Outlook.

كيفية العثور على الوظيفة الإضافية واستخدامها داخل Office

بمجرد تثبيت الملحق الخاص بك أو تحميله إلى حساب Microsoft 365 الخاص بك، فإن الخطوة التالية هي تحديد موقعه داخل التطبيق. أول شيء يجب فعله هو التأكد من تسجيل دخولك إلى Office باستخدام الحساب الصحيح.لأن العديد من الإضافات مرتبطة بالمستخدم أو بالاشتراك.

في تطبيقات مثل Word أو Excel أو PowerPoint، يكون المسار القياسي هو الذهاب إلى القائمة. إدراج > الوظائف الإضافية الخاصة بي، حيث يتم عرض مربع "الوظائف الإضافية لـ Office".ومن هناك يمكنك البحث عن الإضافة الخاصة بك بالاسم؛ إذا لم تظهر في البداية، فتحقق من أنك قمت بتسجيل الدخول بشكل صحيح واضغط على زر التحديث لإعادة تحميل القائمة.

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

مع هذه النظرة العامة الشاملة، أصبح لديك الآن رؤية كاملة للعملية: بدءًا من اختيار الأدوات (Yeoman، أو Visual Studio، أو Agents Toolkit، أو VS Code Kit)، مرورًا بالبنية الداخلية للملحق (ملف البيان بالإضافة إلى تطبيق الويب)، وصولًا إلى التفاعل مع Office باستخدام Office.js، ومجموعات المتطلبات، وScript Lab، بالإضافة إلى سير العمل العملي لاختبار الملحقات وتصحيح أخطائها وتشغيلها في Word أو Excel أو Outlook، سواء على سطح المكتب أو على الويب؛ مع ترسيخ هذه الأسس بقوة، حوّل نموذجًا أوليًا بسيطًا إلى إضافة جاهزة للإنتاج لبرنامج Office يصبح المسار أكثر وضوحاً وأسهل في التعامل معه. شارك هذه المعلومات وسيتعرف الآخرون على المصطلح.