Доброго времени суток!
Официальная документация не то, чтобы неполна — объём её просто мизерный.
Официальный форум битрикса мёртв чуть менее, чем полностью — поэтому спрашиваю здесь.
Две задачи по работе с ролями:
1) получить список ролей залогиненного пользователя, установить одну вполне конкретную роль, если она не установлена
2) получить список всех пользователей, имеющих эту роль
Если хотя бы намекнёте, в каких классах/методах это лежит — буду благодарен. Конкретный код уж как-нибудь сам напишу.