Стовпці в програмах на основі моделі (довідник із API клієнта)

Стовпці містять дані у формі або сітці програм на основі моделі. Скористайтеся колекцією formContext.data.entity.attributes або методом formContext.getAttribute ярлика, щоб отримати доступ до колекції стовпців. Докладні відомості про колекції див . в статті Колекції (довідник із API клієнта).

Щоб отримати доступ до стовпця в колекції, передайте методу ім'я (рядок) або значення індексу (число) стовпця як аргумент. Наприклад: formContext.getAttribute(arg). Якщо аргумент не вказано, метод повертає колекцію всіх атрибутів у формі.

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

У цій статті наведено відомості про методи, доступні для кожного типу стовпця.

Усі типи стовпців

Властивість елементів керування надає колекцію елементів керування, пов'язаних зі стовпцем.

Для всіх типів стовпців доступні такі методи:

Метод Опис
addOnChange Додає функцію, яка запускається під час події стовпця OnChange .
fireOnChange Активує подію стовпця OnChange .
getAttributeType Повертає тип стовпця.
отриматиформат Повертає формат стовпця.
getIsDirty Повертає, чи містить стовпець незбережені зміни.
getName Повертає логічне ім'я стовпця.
отриматипарент Повертає батьківський formContext.data.entity об'єкт.
getRequiredLevel Повертає, обов'язкове або рекомендоване значення стовпця.
getSubmitMode Повертає, коли дані стовпця надсилаються під час збереження.
getUserPrivilege Повертає права користувача на створення, читання або оновлення значення стовпця.
getValue Повертає значення даних стовпця.
isValid (Значення_ значення) Повертає, чи припустиме значення стовпця.
видалитиonChange Видалення функції з обробників подій стовпця OnChange .
setIsValid Установлює припустимість стовпця та повідомлення про помилку.
setRequiredLevel Установлює обов'язковість або рекомендацію значення стовпця перед збереженням.
setSubmitMode Визначає, чи надсилаються дані стовпця під час збереження.
установити значення Установлює значення даних стовпця.

Логічний тип стовпця

Крім методів, доступних для всіх типів стовпців, логічний тип стовпця надає такий метод:

Метод Опис
getInitialValue Повертає значення стовпця під час відкриття форми.

Тип стовпця підстановки

Крім методів, доступних для всіх типів стовпців, тип стовпця підстановки надає такий метод:

Метод Опис
getIsPartyList Повертає, чи дозволяє підстановка кілька записів як підстановка списку сторін.

Вибір і вибір типів стовпців

Окрім методів, доступних для всіх типів стовпців, типи стовпців вибору та вибору містять такі методи:

Метод Опис
getInitialValue Повертає значення стовпця під час відкриття форми.
getOption Повертає параметр, що відповідає вказаній категорії або значенню.
getOptions Повертає припустимі параметри стовпця.
getSelectedOption Повертає вибраний параметр або параметри.
getText Повертає текст вибраного параметра або параметрів.

Числовий тип стовпця (десятковий, подвійний, ціле число, гроші)

Наведені нижче методи доступні лише для десяткових, подвійних і цілих стовпців:

Метод Опис
getMax Повертає максимальне дозволене значення стовпця.
getMin Повертає мінімальне дозволене значення стовпця.
getPrecision Повертає кількість цифр, дозволених після десяткової коми.
setPrecision Установлює кількість цифр, дозволених після десяткової коми.

Тип стовпця рядка

Окрім методів, доступних для всіх типів стовпців, як описано вище, такий метод доступний лише для стовпця рядка :

Метод Опис
getMaxLength Повертає максимальну довжину рядка стовпця.

Загальні відомості про об'єктні моделі Xrm
Елементи керування (довідник із інтерфейсу API клієнта)

  • Востаннє оновлено: