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


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 клиента)