setValue (справочник по КЛИЕНТСКОму API)

Задает значение данных для столбца.

Поддерживаемые типы столбцов

All

Синтаксис

formContext.getAttribute(arg).setValue(value)

Параметры

Зависит от типа столбца.

Тип столбца Тип параметров
булевый Boolean
datetime Дата

В едином интерфейсе значения даты считаются UTC.
В устаревшем веб-клиенте предполагается, что значения дат находятся в часовом поясе пользователя.
десятичная система Число
двойной Число
Целое число Число
lookup Массив Массив объектов подстановки.

Некоторые подстановки, известные как "партийный список", позволяют связать несколько записей в подстановке, например столбец "To" для записи таблицы электронной почты. Поэтому все значения данных подстановки используют массив объектов подстановки, даже если столбец подстановки не поддерживает несколько ссылок на запись для добавления.

У каждого подстановки есть следующие свойства:
- entityType: String. Имя таблицы, отображаемой в подстановке.
- идентификатор: Строка: строковое представление значения GUID для записи, отображаемой в подстановке. Значение должно соответствовать следующему формату: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXX}
- имя: Строка: текст, представляющий запись, отображаемую в подстановке.
записка строка
деньги Число
choice Число
струна строка
записка строка
деньги Число
выбор, выбор Число

Метод getOptions возвращает значения параметров в виде строк. Чтобы преобразовать их в числа, необходимо использовать синтаксический анализ , прежде чем использовать эти значения для задания значения столбца выбора. Допустимые параметры кода состояния (причина состояния) зависят от текущего кода состояния записи. Столбец statecode (Status) не может быть задан в скриптах форм. Чтобы понять, какие значения кода состояния допустимы, ознакомьтесь с определениями столбцов. Для пользовательских таблиц используйте браузер определений таблиц. Наконец, также рассмотрим любые пользовательские переходы состояния, примененные к столбцу. Дополнительные сведения: определение причин состояния для таблиц Case или настраиваемых таблиц.
String строка

Для столбца String с форматом электронной почты требуется, чтобы строка представляла допустимый адрес электронной почты.

Замечание

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

Связанная статья

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