إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توفر جداول Dataverse مجموعة مشتركة من الجداول التي تمتلكها جميع قواعد بيانات البيئة.
يحتوي مرجع جدول/كيان التطبيقات الممكنة في Dynamics 365 على الجداول الإضافية المطلوبة قبل أن تتمكن من تثبيت تطبيقات Dynamics 365 مثل Field Service.
تتم إضافة الجداول المدرجة هنا أو تعديلها عند تحديد تثبيت Dynamics 365 Field Service أثناء إضافة Dataverse إلى بيئة تقوم بإنشائها. قد تبدو مخططات الجدول بشكل مختلف، إذا كانت هناك تطبيقات أخرى مثبتة في بيئة Dataverse.
إشعار
تستثني هذه الوثائق المرجعية بعض الجداول الموجودة في بيئتك. على سبيل المثال، الجداول المخصصة للاستخدام الداخلي فقط والتي نعتبرها أقل صلة بمطوري Field Service. لا تنعكس التغييرات التي تطرأ على مخططات الجدول على الفور لأننا ننشئ هذه الوثائق في فترات زمنية معينة.
لقد أطلقنا هذه الوثائق المرجعية في فبراير 2025. قد تلاحظ التغييرات بشكل متكرر عندما نجمع الملاحظات الأولية ونعالجها.
لعرض المعلومات الحالية وغير المصفاة لجميع الجداول في بيئة Dataverse، استخدم مستعرض تعريف الجدول. مستعرض تعريف الجدول هو حل مدار موضح في استعراض تعريفات الجدول في بيئتك.
لا يشمل هذا المرجع سوى الجداول التي:
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 الشائعة المحددة في هذه المرجعات:
بالنسبة لهذه الوظائف والإجراءات ، وأي وظيفة إضافية مضافة ، يمكنك اكتشاف كيفية استخدامها من خلال:
- افحص مستند خدمة $metadata للحصول على تفاصيل حول المعلمات وقيم الإرجاع. راجع تعريفات الإجراءاتوتعريفات الوظائف للحصول على التفاصيل.
- استدعاء الإجراءات والوظائف. راجع استخدام إجراءات واجهة برمجة تطبيقات الويبواستخدام وظائف واجهة برمجة تطبيقات الويب للحصول على التفاصيل.
احداث
الأحداث هي رسائل موجودة حتى تتمكن من الاشتراك فيها. ما لم تقم بإضافة الحدث، يجب ألا تستدعي الرسالة، بل يجب عليك الاشتراك فيها فقط. يمكنك الاشتراك في الأحداث بعدة طرق مختلفة، على سبيل المثال:
- استخدم موصل Power Automate Dataverse باستخدام المشغل عند تنفيذ إجراء .
- قم بتسجيل مكون إضافي Dataverse للاستجابة للحدث.
- إرسال بيانات الحدث إلى Azure أو خطاف ويب باستخدام تكامل Dataverse Azure
الخصائص
يتضمن هذا القسم خصائص الكيان المحددة بدلا من جميعها. يتم تضمين فقط تلك الخصائص التي يتوقع أن تكون أكثر فائدة للمطورين. يمكن تغيير بعض قيم خصائص الكيان.
الأعمدة
يتم سرد الأعمدة في قسمين منفصلين: الأعمدة/السمات القابلة للكتابةوالأعمدة/السمات للقراءة فقط. الغرض من هذا الفصل هو التركيز على الأعمدة التي يمكن للمطور تعيينها عند إنشاء صفوف في جدول أو تحديثها. يساعد فهم هذه الأعمدة المطور على فهم ما يمكنه فعله بالجدول بخلاف مجرد استرداد القيم.
ترجع الأعمدة الموجودة في قسم الأعمدة/السمات القابلة للكتابة 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 |
البيانات المستخدمة من قبل التطبيقات المستندة إلى النموذج للتحكم في ما إذا كان يمكن الوصول إلى بيانات الجدول الثاني في واجهة المستخدم وكيفية الوصول إليها من هذا الجدول كجدول ثان |