Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Добавить новое пользовательское поле userfieldconfig.add». Вы узнаете экспертные методики работы с добавить новое и научитесь избегать типичных ошибок начинающих разработчиков.

Добавить новое пользовательское поле userfieldconfig.add

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

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

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

Подробное описание и принципы работы добавить новое

userfieldconfig.add({moduleId: string, field: {}})

Метод добавит новое пользовательского поле.

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

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

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

Метод вернет такие же данные, как метод userfieldconfig.get на только что созданном поле.

Примеры

Пример простого запроса. Этого запроса достаточно для создания поля типа «строка».

{
    "moduleId": "rpa",
    "field": {
        "entityId": "RPA_1",
        "fieldName": "UF_RPA_1_NEW_REST_STRING",
        "userTypeId": "string",
    }
}

Создание поля типа «список»

{
    "moduleId": "rpa",
    "field": {
        "entityId": "RPA_1",
        "fieldName": "UF_RPA_1_NEW_REST_STRING",
        "userTypeId": "enumeration"
    }
}

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

[*ключ_индекс]: Добавляйте в поиск только нужные поля. На построение индекса уходит время при изменении каждого значения поля, что может существенно замедлить работы при большом количестве таких полей.