Столбцы в приложениях на основе моделей (справочник по клиентскому API)

Столбцы содержат данные в форме или сетках приложений на основе модели. formContext.data.entity.attributes Используйте коллекцию или formContext.getAttribute метод ярлыка для доступа к коллекции столбцов. Дополнительные сведения о коллекциях см. в разделе "Коллекции" (справочник по КЛИЕНТСКОму API).

Чтобы получить доступ к столбцу в коллекции, передайте имя (строку) или значение индекса (число) столбца в качестве аргумента в метод. Например: formContext.getAttribute(arg). Если аргумент не указан, метод возвращает коллекцию всех атрибутов в форме.

Столбцы классифицируются по типу. Используйте метод getAttributeType , чтобы определить тип столбца. Некоторые методы столбцов доступны только для определенных типов столбцов.

В этой статье содержатся сведения о методах, доступных для каждого типа столбца.

Все типы столбцов

Свойство элементов управления предоставляет коллекцию элементов управления , связанных с столбцом.

Для всех типов столбцов доступны следующие методы:

Method	Description
addOnChange	Добавляет функцию для запуска при возникновении события столбца OnChange .
fireOnChange	Активирует событие столбца OnChange .
getAttributeType	Возвращает тип столбца.
getFormat	Возвращает формат столбца.
getIsDirty	Возвращает значение, имеет ли столбец несохраненные изменения.
getName	Возвращает логическое имя столбца.
getParent	Возвращает родительский formContext.data.entity объект.
getRequiredLevel	Возвращает значение столбца, необходимое или рекомендуемое.
getSubmitMode	Возвращает, когда данные столбца передаются при сохранении.
getUserPrivilege	Возвращает привилегии пользователя для создания, чтения или обновления значения столбца.
getValue	Возвращает значение данных столбца.
isValid	Возвращает допустимо ли значение столбца.
removeOnChange	Удаляет функцию из обработчиков событий столбца OnChange .
setIsValid	Задает допустимость столбца и сообщение об ошибке.
setRequiredLevel	Задает, требуется ли значение столбца или рекомендуется перед сохранением.
setSubmitMode	Задает, передаются ли данные столбца при сохранении.
setValue	Задает значение данных столбца.

Логический тип столбца

Помимо методов, доступных для всех типов столбцов, логический тип столбца предоставляет следующий метод:

Method	Description
getInitialValue	Возвращает значение столбца при открытии формы.

Тип столбца подстановки

Помимо методов, доступных для всех типов столбцов, тип столбца подстановки предоставляет следующий метод:

Method	Description
getIsPartyList	Возвращает значение, разрешающее поиск нескольких записей в качестве стороннего списка.

Выбор и выбор типов столбцов

Помимо методов, доступных для всех типов столбцов, типы столбцов выбора ивыбора предоставляют следующие методы:

Method	Description
getInitialValue	Возвращает значение столбца при открытии формы.
getOption	Возвращает параметр, соответствующий указанной метки или значению.
getOptions	Возвращает допустимые параметры столбца.
getSelectedOption	Возвращает выбранный параметр или параметры.
getText	Возвращает текст выбранного параметра или параметров.

Тип столбца чисел (десятичное, двойное, целое число, деньги)

Следующие методы доступны только для десятичных, двойных и целых столбцов:

Method	Description
getMax	Возвращает максимально допустимое значение столбца.
getMin	Возвращает минимально допустимое значение столбца.
getPrecision	Возвращает число цифр, разрешенных после десятичной запятой.
setPrecision	Задает число цифр, разрешенных после десятичной запятой.

Тип строкового столбца

Помимо методов, доступных для всех типов столбцов, как описано ранее, следующий метод доступен только для строкового столбца:

Method	Description
getMaxLength	Возвращает максимальную длину строки столбца.

Связанные статьи

Общие сведения об объектной модели Xrm
Элементы управления (справочник по клиентскому API)