Битрикс. Получить/обновить пользовательское свойство

birix.userfields.php

<?php
/**
 * Пример использования
 * SetUserField ("BLOG_RATING", $CommentID, "UF_RATING", $Rating);
 * echo "Рейтинг комментария: ".GetUserField ("BLOG_RATING", $CommentID, "UF_RATING");
 */


function SetUserField($entity_id, $value_id, $uf_id, $uf_value) { //запись значения

    return $GLOBALS["USER_FIELD_MANAGER"]->Update(
                                                $entity_id, 
                                                $value_id,
                                                Array ($uf_id => $uf_value)
                                            );
}
 
function GetUserField($entity_id, $value_id, $uf_id){ //считывание значения

    $arUF = $GLOBALS["USER_FIELD_MANAGER"]->GetUserFields ($entity_id, $value_id);
    return $arUF[$uf_id]["VALUE"];
}
 
// $entity_id - имя объекта (у нас "BLOG_RATING")
// $value_id - идентификатор элемента (вероятно, ID элемента, свойство которого мы сохраняем или получаем. в нашем случае, это ID комментария)
// $uf_id - имя пользовательского свойства (в нашем случае UF_RATING)
// $uf_value - значение, которое сохраняем