Поделиться через


getFormContext (справочник по API клиента)

Возвращает ссылку на форму или элемент формы в зависимости от того, где был вызван метод.

Синтаксис

ExecutionContextObj.getFormContext()

Возвращаемое значение

Тип: Объект

Описание. Возвращает ссылку на форму или элемент формы, например редактируемую сетку в зависимости от того, где был вызван метод. Этот метод позволяет создавать общие обработчики событий, которые могут работать с формой или элементом в форме в зависимости от того, где он вызывается.

Example

В следующем примере кода показано, как создать метод, который задает уведомление в столбце формы или редактируемой ячейке сетки в зависимости от того, где вы зарегистрировали скрипт (событие 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');
    }
}

Контекст выполнения
Контекст формы