שתף באמצעות


getFormContext (חומר עזר עבור API של לקוח)

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

תחביר

ExecutionContextObj.getFormContext()

ערך החזרה

סוג: אובייקט

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

דוגמה

הקוד לדוגמה הבא מדגים כיצד ניתן ליצור שיטה שמגדירה הודעה על עמודת טופס או תא רשת הניתן לעריכה, בהתאם למקום שבו רשמת את קובץ ה- Script (אירוע Column OnChange או אירוע OnChange הניתן לעריכה):

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.get('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be a form control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.get(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with '+'.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

הקשר ביצוע
הקשר טופס