userfieldconfig.update
Scope: userfieldconfig, scope модуля Права на выполнение: для всех
Описание и параметры
userfieldconfig.update({moduleId: string, id: number, field: {}})
Метод изменяет значение поля.
Параметры
Параметр | Описание | С версии |
---|---|---|
moduleId | Строковый идентификатор модуля. Обязательный. | |
id | Идентификатор настроек поля. Обязательный. | |
field | Список с полями настройки нового поля. Аналогично методу userfieldconfig.add, но:
|
Будьте внимательны при работе с вариантами значений для списков.
Возвращаемое значение и пример
Возвращаемое значение
Метод вернет такие же данные, как метод userfieldconfig.get на измененном поле.
Примеры
Обновление флагов и языковых фраз, без изменения вариантов значений
{ "moduleId": "rpa", "id": 170, "field": { "mandatory": "Y", "editFormLabel": { "ru": "Новое название поля" } } }
Пример удаление всех вариантов значений.
{ "moduleId": "rpa", "id": 170, "field": { "userTypeId": "enumeration", "enum": [ [""] ] } }
Пример частичного обновления вариантов значений.
{ "moduleId": "rpa", "id": 170, "field": { "userTypeId": "enumeration", "enum": [ { "id": 29, }, { "id": 30, "value": "Обновленное значение" }, { "value": "Новое значение" } ] } }
В этом примере:
- вариант значения с id=29 останется без изменений,
- у варианта с id=30 поменяется значение
- добавится новый вариант "Новое значение"
- все остальные варианты будут удалены
© «Битрикс», 2001-2024, «1С-Битрикс», 2024