تعقب تبعيات مكونات الحلول

تتكون الحلول من مكونات الحلول. تستخدم منطقة الحلول في Microsoft Dataverse لإنشاء مكونات حلول أو إضافتها. يمكنك تنفيذ هذه الإجراءات برمجيًا باستخدام رسالة AddSolutionComponentRequest أو أي رسائل يمكنها إنشاء مكونات الحلول أو تحديثها والتي تتضمن المعلمة SolutionUniqueName.

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

يوضح هذا الموضوع أنواع مكونات الحلول التي يمكنك تضمينها في الحلول وكيفية اعتمادها على بعضها.

كل مكونات الحلول

توجد القائمة الكاملة لأنواع مكونات الحلول المتوفرة في مجموعة الخيارات العمومية في componenttype بالنظام. يتوفر نطاق القيم المدعومة لهذه الخاصية عن طريق تضمين الملف OptionSets.cs أو OptionSets.vb في مشروعك. ولكن العديد من أنواع مكونات الحلول المدرجة مخصصة للاستخدام الداخلي فقط ولا توفر القائمة معلومات حول العلاقات بين مكونات الحلول.

تبعيات مكونات الحلول

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

يتعقب إطار عمل الحلول تبعيات مكونات الحلول تلقائيًا. وتحسب كل عملية في مكون حل أي تبعيات للمكونات الأخرى في النظام تلقائيًا. تُستخدم معلومات التبعية للاحتفاظ بتكامل النظام ومنع العمليات التي قد تؤدي إلى حالة غير متناسقة.

ونتيجة لتعقب التبعية يتم فرض السلوكيات التالية:

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

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

توجد ثلاثة أنواع لتبعيات مكونات الحلول:

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

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

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

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

مكونات الحلول الشائعة

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

‏‏أشرطة التطبيق
الكيان
‏‏تقرير
قالب مقال
ملف تعريف أمان الأعمدة
خطوة معالجة رسالة SDK
دور الاتصال
قالب دمج البريد
‏‏دور الأمان
قالب العقد
مجموعة الخيارات
نقطة نهاية الخدمة
لوحة معلومات أو نموذج كيان
تجميع المكونات الإضافية
مخطط الموقع
قالب البريد الإلكتروني
العملية
مورد ويب

أشرطة التطبيقات (RibbonCustomization)

تخصيصات الشريط الخاصة بشريط التطبيق وقوالب أشرطة الجدول. لا تتضمن أشرطة التطبيقات تعريفات الأشرطة على مستوى الجدول أو النموذج.

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

قالب المقال (KBArticleTemplate)

قالب يحتوي على السمات القياسية للمقال. ‎يوجد دائمًا اعتماد داخلي بين قالب المقالة وجدول KbArticle.

دور الاتصال (ConnectionRole)

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

قالب العقد (ContractTemplate)

قالب يحتوي على السمات القياسية للعقد. هناك دائمًا اعتماد داخلي بين قالب العقد وجدول العقد.

نموذج الكيان أو لوحة المعلومات (SystemForm)

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

‏‏قالب البريد الإلكتروني (EmailTemplate)

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

الكيان (الكيان)

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

ملف تعريف أمان العمود (FieldSecurityProfile)

ملف التعريف الذي يحدد مستوى الوصول إلى السمات المؤمنة.

قالب دمج البريد (MailMergeTemplate)

قالب يتضمن السمات القياسية لمستند دمج البريد. يحتوي قالب دمج البريد على اعتماد منشور على الجدول المرتبط به.

مجموعة الخيارات (OptionSet)

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

تجميع المكوِّن الإضافي (PluginAssembly)

تجميع يحتوي على نوع مكوّن إضافي واحد أو أكثر. يتم تسجيل المكونات الإضافية للأحداث المرتبطة عادةً بجدول. يؤدي هذا إلى إنشاء تبعية منشورة.

العملية (سير العمل)

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

التقرير (التقرير)

ملخص البيانات في تخطيط سهل للقراءة. نشر التقرير اعتماديات على أي جدول أو بيانات سمة مدرجة في التقرير. ويجب أيضًا إقران كل تقرير بفئة تقرير لإنشاء تبعية داخلية في مكون حل يطلق عليه الفئة المرتبطة بالتقرير (ReportCategory). يمكن تكوين التقارير لتكون تقارير فرعية مما يؤدي إلى إنشاء اعتماد منشور مع التقرير الرئيسي.

خطوة معالجة رسالة SDK (SDKMessageProcessingStep)

مرحلة في مسار التنفيذ يتم تنفيذها من خلال مكوِّن إضافي.

دور الأمان (الدور)

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

إشعار

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

نقطة نهاية الخدمة (ServiceEndpoint)

نقطة نهاية الخدمة التي يمكن الاتصال بها.

مخطط الموقع (SiteMap)

بيانات XML المستخدمة للتحكم في جزء التنقل الخاص بالتطبيق. قد يتم ربط خريطة الموقع لعرض مورد ويب HTML أو قد يستخدم رمز في خريطة الموقع مورد ويب للصور. عند استخدام توجيه $webresource: لإنشاء هذه الاقترانات يتم إنشاء تبعية منشورة. مزيد من المعلومات: توجيه $webresource

مورد الويب (WebResource)

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