עמודות ביישומים מונחי-מודל (חומר עזר עבור API של לקוח)

עמודות מכילות נתונים בטופס או ברשתות של יישומים מונחי-מודל. השתמש באוסף formContext.data.entity.attributes או בפעולת formContext.getAttribute השירות של קיצור הדרך כדי לגשת לאוסף של עמודות. לקבלת מידע נוסף אודות אוספים, ראה אוספים (חומר עזר עבור API של לקוח).

כדי לגשת לעמודה בתוך האוסף, העברת השם (מחרוזת) או ערך האינדקס (מספר) של העמודה כארגומנט לפעולת השירות. לדוגמה: formContext.getAttribute(arg). אם לא תציין ארגומנט, פעולת השירות תחזיר אוסף של כל התכונות בטופס.

עמודות מחולקות לקטגוריות לפי סוג. השתמש בפעולת השירות getAttributeType כדי לקבוע את סוג העמודה. שיטות עמודה מסוימות זמינות רק עבור סוגים ספציפיים של עמודות.

מאמר זה מספק מידע אודות השיטות הזמינות עבור כל סוג עמודה.

כל סוגי העמודות

מאפיין הפקדים מספק אוסף של פקדים המשויכים לעמודה.

השיטות הבאות זמינות עבור כל סוגי העמודות:

שיטה תיאור
addOnChange הוספת פונקציה להפעלה כאשר מתרחש האירוע של OnChange העמודה.
fireOnChange מפעיל את האירוע של OnChange העמודה.
getAttributeType הפונקציה מחזירה את סוג העמודה.
קבלעיצוב הפונקציה מחזירה את תבנית העמודה.
getIsDirty הפונקציה מחזירה אם העמודה כוללת שינויים שלא נשמרו.
שם הגהה הפונקציה מחזירה את השם הלוגי של העמודה.
קבלהסבתא החזרת אובייקט formContext.data.entity האב.
קבלדרישותרמה מחזירה אם ערך עמודה נדרש או מומלץ.
getSubmitMode מחזירה כאשר נתוני העמודה נשלחים בעת שמירה.
getUserPrivilege הפונקציה מחזירה את הרשאות המשתמש כדי ליצור, לקרוא או לעדכן את ערך העמודה.
getValue הפונקציה מחזירה את ערך הנתונים של העמודה.
isValid מחזירה אם ערך העמודה חוקי.
removeOnChange הסרת פונקציה מהמטפלים באירועים OnChange של העמודה.
setIsValid הגדרת תוקף העמודה והודעת שגיאה.
setRequiredLevel קובע אם ערך עמודה נדרש או מומלץ לפני השמירה.
setSubmitMode קובע אם נתוני העמודה נשלחים בעת שמירה.
ערך ערכה הגדרת ערך הנתונים של העמודה.

סוג עמודה בוליאני

בנוסף לשיטות הזמינות עבור כל סוגי העמודות, סוג העמודה הבוליאנית מספק את השיטה הבאה:

שיטה תיאור
getInitialValue הפונקציה מחזירה את ערך העמודה כאשר הטופס נפתח.

סוג עמודת בדיקת מידע

בנוסף לשיטות הזמינות עבור כל סוגי העמודות, סוג עמודת בדיקת המידע מספק את השיטה הבאה:

שיטה תיאור
getIsPartyList הפונקציה מחזירה אם בדיקת המידע מאפשרת רשומות מרובות כבדיקת מידע של רשימת ספקים.

אפשרויות וסוגי עמודות בחירה

בנוסף לשיטות הזמינות עבור כל סוגי העמודות, האפשרויות וסוגי עמודותהבחירה מספקים את השיטות הבאות:

שיטה תיאור
getInitialValue הפונקציה מחזירה את ערך העמודה כאשר הטופס נפתח.
קבל אפשרויות החזרת האפשרות התואמת לתווית או לערך שצוינו.
קבל אפשרויות הפונקציה מחזירה את האפשרויות החוקית של העמודה.
getSelectedOption החזרת האפשרות או האפשרויות שנבחרו.
getText החזרת הטקסט של האפשרות או האפשרויות שנבחרו.

סוג עמודת מספר (עשרוני, כפול, מספר שלם, כסף)

השיטות הבאות זמינות רק עבור עמודות עשרוניות, כפולותועמודות מספר שלם :

שיטה תיאור
getMax החזרת הערך המרבי המותר בעמודה.
קבל דקות החזרת הערך המינימלי המותר של העמודה.
קבל את ההפחתה החזרת מספר הספרות המותר לאחר הנקודה העשרונית.
setPrecision הגדרת מספר הספרות המותר לאחר הנקודה העשרונית.

סוג עמודת מחרוזת

בנוסף לשיטות הזמינות עבור כל סוגי העמודות כפי שהוסבר קודם לכן, השיטה הבאה זמינה רק עבור עמודת המחרוזת :

שיטה תיאור
קבלמקסימוםנגת החזרת אורך המחרוזת המרבי של העמודה.

הבנת מודל האובייקטים של Xrm
פקדים (חומר עזר עבור API של לקוח)