# CUserTypeEntity

URL: https://chugunov.pro/api-bitrix/global/cusertypeentity/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс `\CUserTypeEntity`
Модуль: Глобальные классы.

## Описание

Выборка, удаление, добавление и обновление метаданных в таблице b_user_field.

create table b_user_field (
ID int(11) not null auto_increment,
ENTITY_ID varchar(50),
FIELD_NAME varchar(50),
USER_TYPE_ID varchar(50),
XML_ID varchar(255),
SORT int,
MULTIPLE char(1) not null default 'N',
MANDATORY char(1) not null default 'N',
SHOW_FILTER char(1) not null default 'N',
SHOW_IN_LIST char(1) not null default 'Y',
EDIT_IN_LIST char(1) not null default 'Y',
IS_SEARCHABLE char(1) not null default 'N',
SETTINGS text,
PRIMARY KEY (ID),
UNIQUE ux_user_type_entity(ENTITY_ID, FIELD_NAME)
)
------------------
ID
ENTITY_ID (пример: IBLOCK_SECTION, USER ....)
FIELD_NAME (пример: UF_EMAIL, UF_SOME_COUNTER ....)
SORT -- используется для проверки в указанном порядке
BASE_TYPE - String, Number, Integer, Enumeration, File, DateTime
USER_TYPE_ID
SETTINGS (blob) -- для хранения некоторых настроек, которые могут быть полезны для экземпляра поля
[некоторые базовые настройки, общие для всех типов: обязательное или нет и т.д.]
b_user_field

ID int(11) not null auto_increment

ENTITY_ID varchar(50)

FIELD_NAME varchar(20)

USER_TYPE_ID varchar(50)

XML_ID varchar(255)

SORT int

MULTIPLE char(1) not null default 'N'

MANDATORY char(1) not null default 'N'

SHOW_FILTER char(1) not null default 'N'

SHOW_IN_LIST char(1) not null default 'Y'

EDIT_IN_LIST char(1) not null default 'Y'

IS_SEARCHABLE char(1) not null default 'N'

SETTINGS text

PRIMARY KEY (ID),

UNIQUE ux_user_type_entity(ENTITY_ID, FIELD_NAME)

create table b_user_field_lang (
USER_FIELD_ID int(11) REFERENCES b_user_field(ID),
LANGUAGE_ID char(2),
EDIT_FORM_LABEL varchar(255),
LIST_COLUMN_LABEL varchar(255),
LIST_FILTER_LABEL varchar(255),
ERROR_MESSAGE varchar(255),
HELP_MESSAGE varchar(255),
PRIMARY KEY (USER_FIELD_ID, LANGUAGE_ID)
)
b_user_field_lang

USER_FIELD_ID int(11) REFERENCES b_user_field(ID)

LANGUAGE_ID char(2)

EDIT_FORM_LABEL varchar(255)

LIST_COLUMN_LABEL varchar(255)

LIST_FILTER_LABEL varchar(255)

ERROR_MESSAGE varchar(255)

HELP_MESSAGE varchar(255)

PRIMARY KEY (USER_FIELD_ID, LANGUAGE_ID)

Исходный файл: `source/main/classes/general/usertype.php:984`

## Методы (9)

- [`Add()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/add/) — Функция для добавления пользовательского свойства.
- [`CheckFields()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/checkfields/) — Функция для проверки значений метаданных пользовательских свойств.
- [`CreatePropertyTables()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/createpropertytables/)
- [`Delete()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/delete/) — Функция для удаления пользовательского свойства и всех его значений.
- [`DropEntity()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/dropentity/) — Функция для удаления ВСЕХ пользовательских свойств сущности.
- [`Fetch()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/fetch/) — Функция выборки.
- [`static GetByID()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/getbyid/) — Функция для выборки метаданных пользовательского свойства.
- [`static GetList()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/getlist/) — Функция для выборки метаданных пользовательских свойств.
- [`Update()`](https://chugunov.pro/api-bitrix/global/cusertypeentity/update/) — Функция для изменения метаданных пользовательского свойства.

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/CUserTypeEntity.html