الأعمدة في التطبيقات المستندة إلى النموذج (مرجع واجهة برمجة تطبيقات العميل)

تحتوي الأعمدة على بيانات في نموذج التطبيقات المستندة إلى النموذج أو الشبكات. formContext.data.entity.attributes استخدم المجموعة أو أسلوب الاختصار formContext.getAttribute للوصول إلى مجموعة من الأعمدة. لمزيد من المعلومات حول المجموعات، راجع المجموعات (مرجع واجهة برمجة تطبيقات العميل).

للوصول إلى عمود داخل المجموعة، مرر إما اسم (سلسلة) أو قيمة الفهرس (رقم) العمود كوسيطة إلى الأسلوب . على سبيل المثال: formContext.getAttribute(arg). إذا لم تحدد وسيطة، يقوم الأسلوب بإرجاع مجموعة من جميع السمات في النموذج.

يتم تصنيف الأعمدة حسب النوع. استخدم أسلوب getAttributeType لتحديد نوع العمود. تتوفر أساليب معينة للأعمدة فقط لبعض أنواع الأعمدة.

توفر هذه المقالة معلومات حول الأساليب المتوفرة لكل نوع عمود.

كافة أنواع الأعمدة

توفر خاصية عناصر التحكم مجموعة من عناصر التحكم المقترنة بالعمود.

تتوفر الأساليب التالية لجميع أنواع الأعمدة:

الطريقة Description
addOnChange إضافة دالة للتشغيل عند حدوث حدث العمود OnChange .
fireOnChange تشغيل حدث العمود OnChange .
getAttributeType إرجاع نوع العمود.
getFormat إرجاع تنسيق العمود.
getIsDirty إرجاع ما إذا كان العمود يحتوي على تغييرات غير محفوظة.
getName إرجاع الاسم المنطقي للعمود.
getParent إرجاع الكائن الأصل formContext.data.entity .
getRequiredLevel إرجاع ما إذا كانت قيمة العمود مطلوبة أو مستحسنة.
getSubmitMode إرجاع عند إرسال بيانات العمود عند الحفظ.
getUserPrivilege إرجاع امتيازات المستخدم لإنشاء قيمة العمود أو قراءتها أو تحديثها.
getValue إرجاع قيمة بيانات العمود.
isValid إرجاع ما إذا كانت قيمة العمود صالحة.
removeOnChange إزالة دالة من معالجات أحداث العمود OnChange .
setIsValid تعيين صلاحية العمود ورسالة خطأ.
setRequiredLevel تعيين ما إذا كانت قيمة العمود مطلوبة أو مستحسنة قبل الحفظ.
setSubmitMode تعيين ما إذا كانت بيانات العمود يتم إرسالها عند الحفظ.
setValue تعيين قيمة بيانات العمود.

نوع العمود المنطقي

بالإضافة إلى الأساليب المتوفرة لجميع أنواع الأعمدة، يوفر نوع العمود المنطقي الطريقة التالية:

الطريقة Description
getInitialValue إرجاع قيمة العمود عند فتح النموذج.

نوع عمود البحث

بالإضافة إلى الأساليب المتوفرة لجميع أنواع الأعمدة، يوفر نوع عمود البحث الأسلوب التالي:

الطريقة Description
getIsPartyList إرجاع ما إذا كان البحث يسمح بسجلات متعددة كتبحث في قائمة الأطراف.

الاختيارات وأنواع أعمدة الاختيار

بالإضافة إلى الأساليب المتوفرة لجميع أنواع الأعمدة، توفر الخيارات وأنواع أعمدة الاختيار الأساليب التالية:

الطريقة Description
getInitialValue إرجاع قيمة العمود عند فتح النموذج.
getOption إرجاع الخيار المطابق لتسمية أو قيمة محددة.
getOptions إرجاع الخيارات الصالحة للعمود.
getSelectedOption إرجاع الخيار أو الخيارات المحددة.
getText إرجاع نص الخيار أو الخيارات المحددة.

نوع عمود الرقم (عشري، مزدوج، عدد صحيح، أموال)

تتوفر الأساليب التالية فقط للأعمدة العشريةوالمزدوجةوالعدد الصحيح :

الطريقة Description
getMax إرجاع القيمة القصوى المسموح بها للعمود.
getMin إرجاع الحد الأدنى للقيمة المسموح بها للعمود.
الحصول على الاستيعاب إرجاع عدد الأرقام المسموح بها بعد الفاصلة العشرية.
تعيين الاستيعاب تعيين عدد الأرقام المسموح بها بعد الفاصلة العشرية.

نوع عمود السلسلة

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

الطريقة Description
getMaxLength إرجاع الحد الأقصى لطول السلسلة للعمود.

فهم نموذج كائن Xrm
عناصر التحكم (مرجع واجهة برمجة تطبيقات العميل)