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


setValue (довідник із API клієнта)

Установлює значення даних для стовпця.

Підтримувані типи стовпців

Увесь

Синтаксис

formContext.getAttribute(arg).setValue(value)

Параметри

Залежить від типу стовпця.

Тип стовпця Тип параметрів
boolean логічний
дата й час Дата

У уніфікованому інтерфейсі значення дат вважаються UTC.
У застарілому веб-клієнті значення дат вважаються в часовому поясі користувача.
десятковий Число
подвійне значення Число
Цілий Число
lookup Масив Масив об'єктів підстановки.

Деякі підстановки, відомі як "partylist" підстановки, дають змогу пов'язати кілька записів підстановки, наприклад стовпець Кому: для запису таблиці електронної пошти. Таким чином, усі значення даних підстановки використовують масив об'єктів підстановки, навіть якщо стовпець підстановки не підтримує кілька посилань на запис, які потрібно додати.

Кожна підстановка має такі властивості:
- entityType: String. Ім'я таблиці, що відображається в підстановці.
- id: String: string representation of the GUID value for the record displayed in the lookup. Значення має відповідати такому формату: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX}
- ім'я: рядок: текст, який представляє запис, який відображатиметься в підстановці.
Пам'ятка Рядок
гроші Число
вибір Число
рядок Рядок
Пам'ятка Рядок
гроші Число
вибір, вибір Число

Метод getOptions повертає значення параметра як рядки. Щоб використовувати ці значення для встановлення значення вибраного стовпця, слід використовувати parseInt , щоб перетворити їх на числа. Припустимі параметри коду стану (причина стану) залежать від поточного коду стану запису. Стовпець statecode (Status) не можна встановити в сценаріях форм. Щоб зрозуміти, які значення коду стану припустимі, див. визначення стовпців. Для настроюваних таблиць використовуйте браузер визначення таблиць. Нарешті, також розглянемо будь-які переходи настроюваного стану, застосовані до стовпця. Додаткові відомості: Визначення переходів причини стану для інциденту або настроюваних таблиць.
Рядок Рядок

Стовпець String із форматом електронної пошти вимагає, щоб рядок відобраив припустиму адресу електронної пошти.

Нотатка

Оновлення стовпця за допомогою setValue не призведе до запуску обробників подій OnChange . Якщо потрібно запустити обробники подій OnChange , скористайтеся fireOnChange на додачу до setValue.

Пов'язана стаття

getValue (довідник з API клієнта)