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

إن الكيانات الظاهرية عبارة عن كيان مخصص في Dynamics 365 تتضمن حقولاً تحتوي على بيانات من مصدر بيانات خارجي. تظهر الكيانات الظاهرية في Dynamics 365 للمستخدمين كسجلات كيانات Dynamics 365 منتظمة، ولكنها تحتوي على بيانات مأخوذة من قاعدة بيانات خارجية، مثل قاعدة بيانات Azure SQL. تتوافر السجلات المستندة إلى الكيانات الظاهرية في كافة عملاء Dynamics 365، بما في ذلك تطبيقات العميل المطورة باستخدام Dynamics 365 SDK.

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

رسم تخطيطي للكيان الظاهري

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

  • باستطاعة المطورين تطبيق المكونات الإضافية لقراءة البيانات الخارجية باستخدام Dynamics 365 SDK وأداة تسجيل المكون الإضافي في Dynamics 365.

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

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

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

يتضمن Dynamics 365 موفر بيانات OData الذي يمكنك استخدامه للاتصال بخدمة ويب OData v4 التي تصل إلى البيانات الخارجية. يتوفر أيضًا موفر بيانات Azure Cosmos DB من AppSource.

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

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

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

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

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

  • لا تدعم الكيانات الظاهرية تعقب التغيير. وبالتالي، لا يمكنك استخدام السجلات التي تعتمد على كيان ظاهري لتشغيل العمليات التجارية أو مهام سير العمل، أو لاستخدامها لإجراء نسخ متماثل إلى قاعدة بيانات Azure SQL باستخدام خدمة تصدير البيانات.

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

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

  • لا تدعم الكيانات الظاهرية قوائم الانتظار أو إدارة المعرفة أو الاتفاقيات على مستوى الخدمة (SLA) أو الكشف عن التكرارات أو تعقب التغيير أو قدرة mobile offline.

  • لا تدعم الكيانات الظاهرية نموذج أمان Dynamics 365 على مستوى الصف. من المستحسن أن تقوم بتطبيق نموذج أمان خاص بك لمصدر البيانات الخارجي.

  • لا يمكنك تمكين أمان الحقل على حقل يحتوي على بيانات كيان ظاهري.

  • لا يمكن تمكينه لبحث الصلة.

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

  • لا يمكن استخدامه مع حلول مداخل ويب لمداخل Dynamics 365.

  • علاقات N:N بين الكيانات الظاهرية غير مدعومة.

  • يجب أن تكون مراجع المفاتيح الخارجية في Dynamics 365 عبارة عن معرفات عمومية فريدة (GUID).

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

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

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

  2. في شريط أدوات الإجراءات، انقر فوق جديد‏‎.

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

    • موفر بيانات OData. يتضمن Dynamics 365 موفر بيانات Odata v4 يمكن استخدامه للاتصال بمصادر البيانات التي تدعم مقياس Odata v4 المفتوح.

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

  4. في صفحة خصائص "مصدر بيانات جديد"، أكمل الحقول التالية، ثم قم بحفظ السجل.

    • الاسم. اكتب اسمًا يصف مصدر البيانات.

    • Uri. إذا كنت تستخدم موفر البيانات OData، فأدخل uri الخاص بخدمة ويب OData. على سبيل المثال، إذا كنت تستخدم موفر OData للاتصال بخدمة ويب مستضافة في Azure، فباستطاعة URI يمكن أن يبدو مماثلاً للتالي http://contosodataservice.azurewebsites.net/odata/.

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

    • معلمات الطلبات. بشكل اختياري، يمكنك إضافة معلمات رأس مخصص أو معلمات سلسلة استعلام يتم استخدامها للاتصال بخدمة الويب OData، مثل معلمات المصادقة إلى الخدمة الخارجية. انقر فوق سلسلة الاستعلام للتبديل بين معلمة الرأس ومعلمة سلسلة الاستعلام وقيمتها. يمكن إضافة ما يصل لغاية 10 رؤوس أو سلاسل استعلام.

    سجل مصدر بيانات الكيان الظاهري

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

ملاحظة

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

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

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

    ملاحظة

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

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

    خيار الكيان الظاهري في تعريف الكيان

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

    • الاسم الخارجي. إذا كنت تستخدم موفر البيانات OData، فأدخل اسم الكيان المستخدم كمرجع مفرد إلى الكيان الموجود في سلسلة XML لتعريف بيانات التعريف.

    • اسم المجموعة الخارجية. إذا كنت تستخدم موفر البيانات OData، فأدخل اسم الكيان المستخدم كمرجع جمع‬ إلى الكيان الموجود في سلسلة XML لتعريف بيانات التعريف.

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

    تعريف كيان ظاهري يستخدم موفر بيانات Azure Cosmos DB

    هام

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

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

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

    • سر مصدر البيانات. إذا كانت البيانات التي سيعرضها الحقل مشفرة أو إذا احتوى الحقل على بيانات حساسة، فعيّن سر مصدر البيانات إلى نعم.

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

    ملاحظة

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

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

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

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

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

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

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

(راجع أيضاً )

إنشاء الكيانات وتحريرها
إنشاء حقل وتحريره