userfieldtype.add
Scope: в зависимости от места встройки Права на выполнение: для всех
Регистрация нового типа пользовательских полей. Метод возвращает true или ошибку с описанием причины.
Параметры
Параметр | Тип | Описание | Ограничения |
---|---|---|---|
USER_TYPE_ID | Строка | Строковой код типа. Обязательный параметр. |
|
HANDLER | URL | Адрес обработчика пользовательского типа. Обязательный параметр. | Должен быть
|
TITLE | Строка | Текстовое название типа. Будет выводиться в административном интерфейсе настройки пользовательских полей. | |
DESCRIPTION | Строка | Текстовое описание типа. Будет выводиться в административном интерфейсе настройки пользовательских полей. | |
OPTIONS | Многомерный массив | Дополнительные настройки. На данный момент доступен один ключ: height - указывает высоту пользовательского поля по умолчанию в пикселях. По умолчанию - 0 При указании значения 0 - будет использована высота стандартная для отображения данной встройки. . Применится любое положительное значение. |
Примеры
Пример вызова
BX24.callMethod( 'userfieldtype.add', { USER_TYPE_ID: 'test', HANDLER: 'https://www.myapplication.com/handler/', TITLE: 'Test type', DESCRIPTION: 'Test userfield type for documentation' } );
Пример запроса
POST https://sometestportal.bitrix24.com/rest/userfieldtype.add HTTP/1.1 USER_TYPE_ID=test&HANDLER=https%3A%2F%2Fwww.myapplication.com%2Fhandler%2F&TITLE=Test+type&DESCRIPTION=Test+userfield+type+for+documentation&auth=63t6r4z9cugaciaxocrh2r47zlodp12y HTTP/1.1 200 OK { "result": true }
Пример с использованием параметра OPTIONS:
CRest::call( 'userfieldtype.add', [ 'USER_TYPE_ID' => 'custom_type', 'HANDLER' => 'https://example.com/field.php', 'TITLE' => 'title', 'OPTIONS' => [ 'height' => 60, ], ] );
Сообщение не промодерировано, возможны ошибки и неточности.
|
Где нормальная документация?
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
Если при создании вы получили ошибку {"error":"ERROR_CORE","error_description":"Unable to set placement handler: Handler already binded"} но при этом вы знаете что на данный hendler нет типов полей то ошибка скорее всего в том что USER_TYPE_ID с вашим значение занят другим приложением добавьте как предложено выше в начале поля идентификатор вашего приложения 'rest_№Приложения_custom_type'
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
Этот метод используется только через "
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
После создания поля данные в ключе 'USER_TYPE_ID' => 'custom_type' приобретает значение 'rest_№Приложения_custom_type'. При регистрации нового поля необходимо указывать userTypeId в формате 'rest_№Приложения_custom_type' иначе будет ошибка.
|
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.