تكوين موفر البيانات OData v4 وأفضل الممارسات
ينطبق هذا الموضوع على Dynamics 365 Customer Engagement (on-premises). فيما يتعلق بإصدار Power Apps لهذا الموضوع، راجع: تكوين موفر بيانات OData v4
يصف هذا الموضوع كيفية تكوين موفر البيانات OData v4 بالإضافة إلى المتطلبات وأفضل الممارسات الموصى بها لاستخدام موفر البيانات OData v4 للاتصال بخدمة ويب OData v4.
أفضل ممارسات موفر البيانات OData v4
يتطلب مثيلك وجود معرّف سمة لكافة الكيانات. هذا المعرّف عبارة عن معرّف فريد ويجب أن تكون القيمة guid. يمكنك تعيين حقول المعرفات فقط إلى الحقول الخارجية باستخدام نوع البيانات EDM.Guid. لا يمكنك تعيين نوع البيانات EDM.Int32 إلى حقل نوع بيانات معرّف فريد.
يجب تعيين كيانات OData ذات خصائص خالية لكي تتطابق مع الحقل المعين في الكيان الظاهري. يجب أن يتم تعيين الحقل المعين لخاصية كيان OData ذات القيمة Nullable=False في سمة متطلبات الحقل الأعمال المطلوبة.
لاسترداد استعلامات متعددة، مثلاً عند تحميل البيانات إلى شبكة، يمكنك التحكم في حجم مجموعة البيانات المرتجعة من مصدر البيانات الخارجي باستخدام معلمات استعلام التحديد والتصفية.
إذا لم يتم تمكين تتبع المكون الإضافي، فيتعين على مسؤولي النظام تمكينه. بعد تمكينه، يتم التقاط كافة الأخطاء من نقطة نهاية OData في سجل تتبع المكون الإضافي. مزيد من المعلومات: مربع الحوار إعدادات النظام - علامة التبويب التخصيص
تعيين نوع بيانات
يسرد الجدول التالي تعيينات نوع البيانات نموذج بيانات كيان OData (EDM) مع نوع البيانات المناسب.
| نوع بيانات OData | نوع البيانات |
|---|---|
| Edm.Boolean | خياران |
| Edm.DateTime | التاريخ والوقت |
| Edm.DateTimeOffset | التاريخ والوقت |
| Edm.Decimal | عدد عشري أو عملة |
| Edm.Double | رقم الفاصلة العائمة |
| Edm.Guid | معرِّف فريد |
| Edm.Int32 | عدد صحيح |
| Edm.Int64 | عدد صحيح |
| Edm.String | سطر واحد من النص أو أسطر نص متعددة |
أنواع بيانات OData EDM غير المعتمدة لتعيينها مع الكيانات الظاهرية
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
إضافة مصدر بيانات باستخدام موفر البيانات OData v4
يوضح لك هذا الإجراء كيفية استخدام موفر البيانات OData الجاهز لاستخدامه كمصدر بيانات الكيان الظاهري.
انتقل إلى الإعدادات>الإدارة>مصادر بيانات الكيانات الظاهرية.
في شريط الأدوات الإجراءات، حدد جديد.
في مربع الحوار "تحديد موفر البيانات"، حدد من مصادر البيانات التالية، ثم حدد موافق.
موفر بيانات OData v4. تتضمن البيئة الخاصة بك موفر بيانات Odata v4 يمكن استخدامه للاتصال بمصادر البيانات التي تدعم مقياس Odata v4 المفتوح.
موفر بيانات مخصص. إذا قمت باستيراد مكون إضافي لاستخدامه كموفر بيانات، فسيظهر موفر البيانات هنا. مزيد من المعلومات: الشروع في العمل باستخدام الكيانات الافتراضية
في صفحة خصائص "مصدر بيانات جديد"، أكمل الحقول التالية، ثم قم بحفظ السجل.
الاسم. اكتب اسمًا يصف مصدر البيانات.
Uri. إذا كنت تستخدم موفر البيانات OData، فأدخل uri الخاص بخدمة ويب OData. على سبيل المثال، إذا كنت تستخدم موفر OData للاتصال بخدمة ويب مستضافة في Azure، فباستطاعة URI يمكن أن يبدو مماثلاً إلى
https://contosodataservice.azurewebsites.net/odata/المهلة بالثواني. أدخل عدد الثواني التي يجب خلالها انتظار استجابة من خدمة الويب قبل انتهاء مهلة طلب بيانات. على سبيل المثال، قم بإدخال 30 للانتظار لمدة ثلاثين ثانية كحد أقصى قبل حدوث المهلة.
وضع ترحيل الصفحات. حدد ما إذا كنت تريد استخدام الترحيل على جانب العميل أو الخادم للتحكم في كيفية ترحيل نتائج الاستعلام. القيمة الافتراضية هي ترحيل من جانب العميل. باستخدام الترحيل من جانب الخادم، يتحكم الخادم في كيفية ترحيل النتائج باستخدام المعلمة $skiptoken، التي تضاف إلى سلسلة الاستعلام. مزيد من المعلومات: تخطي الرمز المميز لخيار استعلام النظام ($skiptoken)
- إرجاع عدد مضمن. إرجاع إجمالي عدد السجلات في مجموعة النتائج. يتم استخدام هذا الإعداد لتمكين وظيفة الصفحة التالية عند إرجاع البيانات إلى شبكة. استخدم قيمة false إذا لم يكن لديك نقطة نهاية OData تدعم المعلمة OData $inclinecount. القيمة الافتراضية هي false.
معلمات الطلبات. بشكل اختياري، يمكنك إضافة معلمات رأس مخصص أو معلمات سلسلة استعلام يتم استخدامها للاتصال بخدمة الويب OData، مثل معلمات المصادقة إلى الخدمة الخارجية. حدد سلسلة الاستعلام للتبديل بين معلمة الرأس ومعلمة سلسلة الاستعلام وقيمتها. يمكن إضافة ما يصل لغاية 10 رؤوس أو سلاسل استعلام.
(راجع أيضًا)
إنشاء كيانات ظاهرية تحتوي على بيانات من مصدر بيانات خارجي وتحريرها
TechNet Blog: التفاعل مع البيانات من أنظمة خارجية باستخدام الكيانات الظاهرية الجديدة