إنشاء كيان ظاهرية مع بيانات من مصدر بيانات خارجي أو تحريره

ينطبق هذا الموضوع على Dynamics 365 Customer Engagement (on-premises). فيما يتعلق بإصدار Power Apps لهذا الموضوع، راجع: إنشاء كيانات ظاهرية تحتوي على بيانات من مصدر بيانات خارجي وتحريرها

الكيان الظاهري هو كيان مخصص في Dynamics 365 Customer Engagement (on-premises) والذي يوجد به حقول تحتوي على البيانات من مصدر بيانات خارجي. تظهر الكيانات الظاهرية في تطبيقك للمستخدمين كسجلات كيانات عادية، ولكنها تحتوي على بيانات مأخوذة من قاعدة بيانات خارجية، مثل قاعدة بيانات Azure SQL. تتوافر السجلات المستندة إلى الكيانات الظاهرية في كافة العملاء، بما في ذلك العملاء المخصصون المطورون باستخدام خدمات ويب Dynamics 365 Customer Engagement.

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

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

يتضمن Dynamics 365 Customer Engagement (on-premises) موفر بيانات OData الذي يمكنك استخدامه للاتصال بخدمة ويب OData v4 التي تصل إلى البيانات الخارجية.

بدلاً من ذلك، باستطاعة المطورين إنشاء موفري بيانات تابعين لهم. يتم تثبيت موفري البيانات في بيئة كحل. مزيد من المعلومات: الشروع في العمل باستخدام الكيانات الافتراضية

فوائد الكيان الظاهري

• يمكن للمطورين تنفيذ المكونات الإضافية لقراءة البيانات الخارجية أو تحديثها أو حذفها باستخدام خدمات ويب Dynamics 365 Customer Engagement وأداة تسجيل الوظيفة الإضافية Customer Engagement.

• يستخدم مخصصو النظام تطبيق Dynamics 365 Customer Engagement (on-premises) لتكوين سجل مصدر البيانات وإنشاء كيانات ظاهرية يتم استخدامها للوصول إلى بيانات خارجية من دون كتابة أي تعليمات برمجية.

• يتعامل المستخدمون النهائيون مع السجلات التي تم إنشاؤها بواسطة الكيان الظاهري لعرض البيانات في الحقول، والشبكات ونتائج البحث، والتقارير المستندة إلى Fetch XML ولوحات المعلومات.

إضافة مصدر بيانات لاستخدامه للكيانات الظاهرية

يقوم المطورون بإنشاء مكون إضافي مخصص لاستخدامه كموفر بيانات للكيان الظاهري. بدلاً من ذلك، يمكنك استخدام "موفر البيانات" v4 OData المتوفر. مزيد من المعلومات: تكوين موفر البيانات OData v4 والمتطلبات وأفضل الممارسات

1. انتقل إلى الإعدادات>الإعدادات>مصادر بيانات الكيان الظاهري.

2. في شريط الأدوات الإجراءات، حدد جديد.

3. في مربع الحوار "تحديد موفر البيانات"، حدد من مصادر البيانات التالية، ثم حدد موافق.

   • موفر بيانات مخصص. إذا قمت باستيراد مكون إضافي لاستخدامه كموفر بيانات، فسيظهر موفر البيانات هنا. مزيد من المعلومات: الشروع في العمل باستخدام الكيانات الافتراضية

   • موفر بيانات OData v4. Dynamics 365 Customer Engagement (on-premises)يتضمن أي موفر بيانات OData يمكن استخدامه مع خدمات ويب v4 OData. مزيد من المعلومات: تكوين موفر البيانات OData v4 والمتطلبات وأفضل الممارسات

إضافة حقل مؤمن إلى مصدر بيانات

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

‏‫ملاحظة‬

تتوفر سمة "سر مصدر البيانات" فقط بالنسبة للحقول التي تمت إضافتها إلى نموذج مصدر البيانات.

إنشاء كيان ظاهري

يمكنك إنشاء كيان ظاهري مثل أي كيان آخر في Customer Engagement بالإضافة إلى بعض السمات الإضافية الموضحة هنا.

‏‫ملاحظة‬

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

1. انتقل إلى الإعدادات‏‎>التخصيصات‏‎>تخصيص النظام.

2. في مستكشف الحلول، قم بإنشاء كيان جديد. لإجراء ذلك، حدد الكيانات في جزء التنقل الأيمن، ثم حدد جديد.

3. في علامة التبويب عام في تعريف الكيان، حدد كيان ظاهري، ثم في القائمة المنسدلة مصدر البيانات، حدد مصدر البيانات الذي تريده.

   

4. في "تعريف الكيان"، أكمل الحقول المطلوبة التالية.

   • الاسم الخارجي. أدخل اسم الجدول في مصدر البيانات الخارجية التي تم تعيين هذا الكيان لها.

   • اسم المجموعة الخارجية. أدخل اسم الجمع للجدول في مصدر البيانات الخارجية التي تم تعيين هذا الكيان لها.

     فيما يلي مثال عن كيان ظاهري يسمى فيلم يستخدم موفر بيانات Azure Cosmos DB للوصول إلى ملفات المستندات.

   

   مهم

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

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

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

   • الاسم الخارجي. هذا الاسم هو عادةً الاسم الفريد لتعريف البيانات التي تريد عرضها في الحقل.

   ‏‫ملاحظة‬

   إذا كان نوع الحقل الذي أنشأته OptionSet، فستتوفر الحقول الإضافية التالية.

   • اسم النوع الخارجي. يتم تعيين هذه الخاصية إلى الاسم الخارجي لمجموعة القيم في الخدمة الخارجية لمجموعة الخيارات. بشكل عام، قد يكون ذلك عبارة عن تعداد أو اسم لفئة قيمة السلسلة. يمكن استخدام "اسم النوع الخارجي" عندما يكون اسم مؤهل بالكامل مطلوبًا. على سبيل المثال، كما في اسم النوع مع OData حيث تحتاج المعلمات في الاستعلام إلى اسم مؤهل بالكامل، مثل [اسم النوع].[القيمة].
   • القيمة الخارجية. يتم تعيين هذه الخاصية إلى القيمة المطابقة في مصدر البيانات الخارجي لعنصر مجموعة الخيارات. يتم استخدام هذه القيمة التي يتم إدخالها لتحديد عنصر مجموعة الخيارات التي سيتم عرضها في التطبيق.

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

6. حدد حفظ وإغلاق على صفحة خصائص الحقل.

7. في شريط أدوات مستكشف الحلول، حدد حفظ.

8. في شريط أدوات مستكشف الحلول، حدد نشر.

9. أغلق مستكشف الحلول.

أمور يجب مراعاتها عند استخدام الكيانات الظاهرية

تخضع الكيانات الظاهرية لهذه القيود.

• جميع الكيانات الظاهرية للقراءة فقط.

• لا يمكن تحويل الكيانات الموجودة إلى كيانات ظاهرية.

• بشكل افتراضي، تحتوي الكيانات الافتراضة على حقل الاسم والمعرف فقط. لا توجد حقول مُدارة بأنظمة أخرى مدعومة، كحالة أو تم الإنشاء في/تم التعديل.

• لا تدعم الكيانات الافتراضية الحقول المخصصة باستخدام أنواع البيانات العملة أو الصورة أو العميل.  

• لا تدعم الكيانات الظاهرية التدقيق.

• لا يمكن استخدام حقول الكيان الظاهري في حقول القيمة المحتسبة أو الحقول المحسوبة.  

• يتعذر على كيان ظاهري أن يكون نوع نشاط للكيان.

• لا يمكن تمكين العديد من الميزات التي تؤثر على صفوف جدول الكيان مع الكيانات الظاهرية. تشمل الأمثلة الصفوف، وإدارة المعرفة، واتفاقيات مستوى الخدمة، والكشف عن التكرارات، وتغيير التعقب، وإمكانية Mobile Offline، وأمان الحقل، وبحث الصلة، والمداخل لحلول مداخل الويب لـ Dynamics 365 Customer Engagement (on-premises) وعلاقات متعدد إلى متعدد‬ N:N بين الكيانات الافتراضية.

• الكيانات الظاهرية مملوكة للمؤسسة ولا تدعم مفاهيم أمان Common Data Service for Apps على مستوى الصف. من المستحسن أن تقوم بتطبيق نموذج أمان خاص بك لمصدر البيانات الخارجي.

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

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

• لا تدعم الكيانات الظاهرية تعقب التغييرات ولا يمكن مزامنتها باستخدام ميزة Customer Engagement للتطبيقات، مثل خدمة تصدير البيانات.

• لا يتم دعم سير إجراءات العمل بالكيانات الظاهرية. مزيد من المعلومات: تلقي خطأ غير متوقع عند تنشيط المستخدم لأحد مجموعات سير إجراءات العمل

تلقي خطأ غير متوقع عند تنشيط المستخدم لأحد مجموعات سير إجراءات العمل

عندما محاولة المستخدم تنشيط أحد مجموعات سير إجراءات العمل، فقد يتلقى رسالة "خطأ غير متوقع". يتم عرض إدخال السجل التالي عند عرض ملف السجل.

ErrorCode: 0x80040216 الرسالة: System.Web.HttpUnhandledException: تم طرح استثناء من النوع 'System.Web.HttpUnhandledException'. ---> Microsoft.Crm.CrmException: لا يمكن تمكين سير إجراءات العمل للكيان الظاهري

تحدث هذه المشكلة لأن الكيانات الظاهرية لا تدعم سير إجراءات العمل.

(راجع أيضًا)

متطلبات موفر بيانات OData v4 وأفضل الممارسات
إنشاء الكيانات وتحريرها
إنشاء الحقول وتحريرها