Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Изменить значение пользовательского поля userfieldconfig.update», проанализируем лучшие практики и покажем, как правильно использовать изменить значение в реальных задачах.

Изменить значение пользовательского поля userfieldconfig.update

Тут может не хватать некоторых данных — дополним в ближайшее время

• не указана обязательность параметров
• отсутствует ответ в случае ошибки
• нет примеров на др. языках

> Scope: userfieldconfig, scope модуля
>
> Кто может выполнять метод: любой пользователь

userfieldconfig.update({moduleId: string, id: number, field: {}})

Метод изменяет значение поля.

Входящие параметры и конфигурация метода

Будьте внимательны при работе с вариантами значений для списков.

Возвращаемое значение и пример

Метод вернет такие же данные, как метод 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,
                "value": "Старое значение"
            },
            {
                "id": 30,
                "value": "Обновленное значение"
            },
            {
                "value": "Новое значение"
            }
        ]    
    }
}

В этом примере:

• Вариант значения с id=29 останется без изменений
• У варианта с id=30 поменяется значение
• Добавится новый вариант «Новое значение»
• Все остальные варианты будут удалены. Если передавать в запросе только id варианта без значения value — вариант будет удален

• [](../../../../../tutorials/crm/how-to-add-crm-objects/how-to-add-precision-to-user-field)