مشاركة عبر


مرجع جدول/مرجع كيان التطبيقات الممكنة في Dynamics 365

توفر جداول Dataverse مجموعة مشتركة من الجداول التي تمتلكها جميع قواعد بيانات البيئة. تتم إضافة الجداول المدرجة هنا أو تعديلها عند تحديد تمكين تطبيقات Dynamics 365؟ أثناء إضافة Dataverse إلى بيئة تقوم بإنشائها.

عندما يكون لديك التراخيص اللازمة، يمكنك تثبيت منتجات Dynamics 365 التي قد تضيف المزيد من الجداول أو تخصيص جداول Dynamics 365 أو Dataverse الموجودة.

يسرد هذا الجدول منتجات Dynamics 365 الأخرى التي تعتمد على هذا المرجع:

وثائق المنتج مرجع جدول المنتج
مبيعات مرجع جدول المبيعات/الكيان
الخدمة الميدانية مرجع جدول/كيان Field Service
خدمة العملاء مرجع جدول/كيان خدمة العملاء

لا يشمل هذا المرجع سوى الجداول التي:

  • IsPrivate يساوي false

  • IsIntersect يساوي false أو IsIntersect يساوي true ويحتوي الجدول على أكثر من 4 أعمدة.

    • تحتوي معظم الجداول المتقاطعة على الأعمدة الأربعة اللازمة فقط لدعم علاقة متعدد إلى متعدد. إنها ليست مفيدة. الجداول المتقاطعة التي تحتوي على أكثر من أربعة أعمدة أكثر إثارة للاهتمام.

الرسائل

تنطبق الرسائل الموجودة في هذه القائمة على الكيان. على سبيل المثال، تدعم الجداول المملوكة للمستخدم ، AssignGrantAccessو ، ModifyAccessو RevokeAccess و الرسائل بينما لا تفعل الجداول المملوكة للمؤسسة.

SDK ل .NET

عند استخدام SDK ل .NET، يمكنك عادة استدعاء فئة الطلب المقابلة التي ستنتمي إلى مساحات الأسماء Microsoft.Crm.Sdk.Messages أو Microsoft.Xrm.Sdk.Messages . تحتوي هذه الفئات على أسماء تتضمن البادئة Request المضافة إلى اسم الرسالة.

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

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

عند استخدام واجهة برمجة تطبيقات الويب، يمكنك العثور على وظائف وإجراءات Dataverse OData الشائعة المحددة في هذه المرجعات:

بالنسبة لهذه الوظائف والإجراءات ، وأي وظيفة إضافية مضافة ، يمكنك اكتشاف كيفية استخدامها من خلال:

  1. افحص مستند خدمة $metadata للحصول على تفاصيل حول المعلمات وقيم الإرجاع. راجع تعريفات الإجراءاتوتعريفات الوظائف للحصول على التفاصيل.
  2. استدعاء الإجراءات والوظائف. راجع استخدام إجراءات واجهة برمجة تطبيقات الويبواستخدام وظائف واجهة برمجة تطبيقات الويب للحصول على التفاصيل.

احداث

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

الخصائص

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

الأعمدة

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

ترجع الأعمدة الموجودة في قسم الأعمدة/السمات القابلة للكتابة true لخصائصIsValidForCreate أو IsValidForUpdate ، (عادة كلاهما). إذا كانت أي من هذه الخصائص ترجع خطأ ، الإشارة إلى ذلك.

تقوم الأعمدة/السمات للقراءة فقط دائما بإرجاع false لخصائص IsValidForCreateوIsValidForUpdate.

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

العلاقات

تتضمن فئة EntityMetadata ثلاث خصائص لتمثيل العلاقات:

الخاصية النوع الوصف
OneToManyالعلاقات OneToManyRelationshipMetadata[] يحصل على مجموعة من العلاقات الفردية إلى متعددة للكيان.
العديد من العلاقات OneToManyRelationshipMetadata[] يحصل على مجموعة من علاقات متعدد إلى واحد للكيان.
العديد من العلاقات بيانات تعريف العلاقة المتعددة[] يحصل على مجموعة من علاقات متعدد إلى متعدد للكيان.

إشعار

من المهم أن تضع في اعتبارك أنه بينما يسرد كل جدول تلك العلاقات التي تنطبق عليه، تتم مشاركة كل علاقة بواسطة كلا الجدولين. العلاقات موجودة بين الجداول. في حين أن العلاقاتTo-Many الواحد موجودة ، فإن العلاقات من متعدد إلى واحد هي مجرد عرض لعلاقةTo-Many واحد من جدول المراجع.

علاقات متعدد إلى واحد

يشمل هذه OneToManyRelationship الخصائص:

الخاصية الوصف
ReferencedEntity الاسم المنطقي للجدول ذي الصلة.
ReferencedAttribute الاسم المنطقي للمفتاح الأساسي للجدول ذي الصلة.
ReferencingEntity الاسم المنطقي للجدول ذي الصلة الذي يحتوي على عمود البحث.
ReferencingAttribute الاسم المنطقي لعمود البحث في الجدول ذي الصلة الذي يحتوي على مرجع إلى المفتاح الأساسي للجدول الأساسي.
IsHierarchical ما إذا كانت العلاقة تمثل علاقة هرمية ذاتية المرجعية
CascadeConfiguration البيانات التي تصف العمليات التي يتم إجراؤها على الكيان الأصلي والتي سيتم نقلها إلى الكيانات ذات الصلة.
مزيد من المعلومات: تكوين تتالي

علاقات واحد إلى متعدد

يشمل هذه OneToManyRelationship الخصائص:

الخاصية الوصف
ReferencingEntity الاسم المنطقي للجدول ذي الصلة.
ReferencingAttribute الاسم المنطقي للعمود في الجدول ذي الصلة الذي يحتوي على مرجع إلى المفتاح الأساسي للجدول الأساسي.
IsCustomizable ما إذا كان يمكن تغيير خصائص العلاقة.
ReferencedEntityNavigationPropertyName اسم خاصية التنقل ذات قيمة المجموعة لواجهة برمجة تطبيقات الويب لهذه العلاقة.
مزيد من المعلومات: خصائص التنقل في واجهة برمجة تطبيقات الويب
AssociatedMenuConfiguration البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الكيان ذات الصلة في واجهة المستخدم من الكيان الأساسي وكيفية ذلك.

علاقات متعدد إلى متعدد

تتضمن كل علاقة متعدد إلى متعدد Entity1LogicalNameوEntity2LogicalName. بالنسبة لهذه الوثائق، يتم توفير تفاصيل العلاقة في سياق الجدول الحالي. سواء كان الأمر Entity1 مهما أم Entity2 لا.

لكل علاقة متعدد إلى متعدد ، يتم تضمين الخصائص التالية:

الخاصية الوصف
IntersectEntityName الاسم المنطقي للجدول المتقاطع الذي يدعم هذه العلاقة من متعدد إلى متعدد.
يمكنك استخدام هذه القيمة عند ضم أعمدة الجدول باستخدام FetchXml
IsCustomizable ما إذا كان يمكن تغيير خصائص العلاقة.
SchemaName اسم مخطط العلاقة.
IntersectAttribute اسم العمود في جدول التقاطع الذي يعد المفتاح الأساسي للسجلات من هذا النوع.
NavigationPropertyName اسم خاصية التنقل ذات قيمة المجموعة لواجهة برمجة تطبيقات الويب لهذه العلاقة.
مزيد من المعلومات: خصائص التنقل في واجهة برمجة تطبيقات الويب
AssociatedMenuConfiguration البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الجدول الثاني في واجهة المستخدم من هذا الجدول وكيفية ذلك.

في الحالة النادرة التي تكون فيها علاقة متعدد إلى متعدد ذاتية المرجعية، مثل دور الاتصال (ConnectionRole) connectionroleassociation_association، Entity1 أو Entity2 مسبقة للخاصية.

الخاصية القيمة‬
Entity1IntersectAttribute اسم العمود في جدول التقاطع الذي يعد المفتاح الأساسي للسجلات من هذا النوع كجدول أول.
Entity2IntersectAttribute اسم العمود في الجدول المتقاطع الذي يعد المفتاح الأساسي للسجلات من هذا النوع كجدول ثان.
Entity1NavigationPropertyName اسم خاصية التنقل ذات قيمة مجموعة واجهة برمجة تطبيقات الويب لهذه العلاقة كجدول أول.
Entity2NavigationPropertyName اسم خاصية التنقل ذات قيمة مجموعة واجهة برمجة تطبيقات الويب لهذه العلاقة كجدول ثان.
Entity1AssociatedMenuConfiguration البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الجدول الثاني في واجهة المستخدم وكيفية الوصول إليها من هذا الجدول كجدول أول.
Entity2AssociatedMenuConfiguration البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الجدول الثاني في واجهة المستخدم وكيفية الوصول إليها من هذا الجدول كجدول ثان