Получение значений пользовательского поля типа «Список»: CUserFieldEnum

При работе с пользовательскими полями (UF_*) типа «Список» в базе данных хранится только ID выбранного варианта.

Но часто в коде нужно получить сам текст значения, его XML_ID или вывести все доступные варианты для фильтра.

Для этого используется класс CUserFieldEnum.

Задача: Получить все значения списка для поля UF_GENDER

Чтобы получить значения, нужно знать ID самого поля (FIELD_ID) или его название.

Проще всего искать по названию.

Находим ID поля по его коду:

$rsEnum = CUserTypeEntity::GetList([], ["ENTITY_ID" => "USER", "FIELD_NAME" => "UF_GENDER"]); 
$arField = $rsEnum->Fetch();
 $fieldId = $arField['ID'];

Получаем значения списка:

$rsEnum = CUserFieldEnum::GetList( [], // Сортировка (не работает в этом методе) [ "USER_FIELD_ID" => $fieldId, // ID поля (обязательно или FIELD_NAME в старых версиях) ] ); $enumValues = []; 
while ($arEnum = $rsEnum->Fetch()) { // $arEnum содержит: ID, VALUE, XML_ID, SORT, DEF (по умолчанию) 
$enumValues[$arEnum['ID']] = $arEnum['VALUE'];
 echo "ID: {$arEnum['ID']} - Значение: {$arEnum['VALUE']} (XML_ID: {$arEnum['XML_ID']})<br>"; }

Получение конкретного значения по ID

Если у вас есть ID значения (например, из $arResult[‘UF_GENDER’]), получить его текст можно так:

$enumId = 15; // ID выбранного варианта
$rsEnum = CUserFieldEnum::GetList([], ["ID" => $enumId]);
if ($arEnum = $rsEnum->Fetch()) {
    echo "Выбран пол: " . $arEnum["VALUE"];
}

Важно: Метод GetList у CUserFieldEnum не поддерживает сортировку первым параметром (всегда передавайте пустой массив []). Сортировка значений всегда происходит по полю SORT внутри самого свойства.

Вывод:
Класс CUserFieldEnum — единственный способ добраться до метаданных списочных свойств (текст, XML_ID, сортировка).

Используйте его для построения фильтров или расшифровки значений в профиле пользователя или разделах.

CUserFieldEnum, GetList, пользовательское поле список, UF_ поле, значения списка битрикс, UserTypeEntity.