مرجع جدول/كيان Dataverse

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

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

  • EntityMetadata.IsPrivate يساوي false

    يستثني هذا الشرط الجداول التي لا تحتوي على حالات استخدام خارجية.

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

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

لعرض معلومات حول جميع الجداول في بيئتك، راجع استعراض تعريفات الجداول في البيئة الخاصة بك.

مرجع جدول منتجات Dynamics 365

تستخدم منتجات Dynamics 365 Dataverse. عند إنشاء بيئة لمنتجات Dynamics 365، تحتوي البيئة على مجموعة مشتركة من الجداول لجميع منتجات Dynamics 365. راجع مرجع جدول/كيان التطبيقات الممكنة Dynamics 365.

يمكن لكل منتج Dynamics 365 محدد إضافة المزيد من الجداول. يعرض الجدول التالي مرجع الجدول لمنتجات Dynamics 365 معينة:

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

الخصائص

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

الأعمدة

يتم سرد الأعمدة في قسمين منفصلين:

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

خيارات عمود الاختيار

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

العلاقات

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

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

إشعار

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

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

يتضمن خصائص الفئة التاليةOneToManyRelationshipMetadata:

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

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

يتضمن خصائص الفئة التاليةOneToManyRelationshipMetadata:

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

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

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

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

الخاصية الوصف
IntersectEntityName الاسم المنطقي للجدول المتقاطع الذي يدعم هذه العلاقة من متعدد إلى متعدد.
IsCustomizable ما إذا كان يمكنك تغيير خصائص العلاقة.
SchemaName اسم مخطط العلاقة.
IntersectAttribute (Entity1IntersectAttribute أو Entity2IntersectAttribute) اسم العمود في جدول التقاطع الذي يعد المفتاح الأساسي للسجلات من هذا النوع.
NavigationPropertyName (Entity1NavigationPropertyName أو Entity2NavigationPropertyName) اسم خاصية التنقل ذات قيمة المجموعة لواجهة برمجة تطبيقات الويب لهذه العلاقة.
مزيد من المعلومات: خصائص التنقل في واجهة برمجة تطبيقات الويب
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration أو Entity2AssociatedMenuConfiguration) البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الجدول الثاني في واجهة المستخدم من هذا الجدول وكيفية ذلك.

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

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