Работа с пользователями
Разрешение Пользователи (user)
Описание
Методы работы с пользователями Битрикс24 позволяют приглашать новых пользователей, изменять данные существующих пользователей и выбирать пользователей при помощи условий. Приложения, которые используют эти методы в своих сценариях, должны обеспечивать максимальную безопасность пользовательских данных и получать только ту информацию о пользователях, которая действительно необходима для работы приложения.
Чтобы гарантировать пользователям безопасность их персональной информации, существует несколько уровней доступа через методы работы с пользователями:
- Ограниченные версии доступа:
- user_brief, который позволяет получать базовую информацию о пользователях, без их контактных данных и пользовательских полей. Этот скоуп необходим и достаточен для сценариев, в которых требуется отобразить ФИО пользователя в интерфейсе приложения.
- user_basic, который позволяет получать не только базовую информацию, но и контактные данные пользователей Битрикс24. Этот скоуп нужен для сценариев, связанных с совершением звонков, или отправкой e-mail сообщений при помощи вашего приложения.
- Полные версии доступа:
- user, который позволяет получить все стандартные поля, а кроме того, делает доступной возможность приглашения новых пользователей и изменение данных существующих пользователей.
- user.userfield, который открывает доступ к методам для работы с пользовательскими полями пользователей (расширяет перечень доступных полей в методах чтения, доступных в скоупах выше) для получения, добавления, изменения и удаления пользовательских полей.
Внимание! Это максимальный уровень доступа к персональной информации, запрашивать его нужно очень ответственно.
Ограниченные версии скоупа user
В этих скоупах нельзя добавлять/обновлять пользователей: не доступны методы user.add и user.update. Во всех остальных методах получения информации о пользователе доступны только эти поля (с версии Rest 21.600.0):
| user_basic | user_brief |
|---|---|
|
|
* Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.
Полная версия скоупа user
В полной версии доступны поля (с версии Rest 21.600.0):
| user |
|---|
|
* Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.
Методы
| Метод | Описание |
|---|---|
| user.fields | Получение списка названий полей пользователя. |
| user.current | Получение информации о текущем пользователе. |
| user.add | Приглашает пользователя. |
| user.update | Обновляет данные пользователя. |
| user.get | Получение фильтрованного списка пользователей. |
| user.search | Получение списка пользователей с ускоренным поиском по персональным данным. |
Сообщение не промодерировано, возможны ошибки и неточности.
| ||
сейчас можно фильтровать по отделу поле (UF_DEPARTMENT) | ||
Сообщение не промодерировано, возможны ошибки и неточности.
|
|
У встроенных роботов есть волшебный CBPHelper::ExtractUsers
А как внешним приложениям работать с этим? |
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
|
Как получить список пользователей по коду группы или отдела?
Из настроек робота, например, прилетает group_dr*** и нужно добавить задачу с соисполнителями из отдела с подотделами. Варианты отправить group_dr***, dr*** или DR*** не работают. Метода для получения списка пользователей по такому коду нет, хотя бизнес-процессы, например, с ними работают, т.е. где-то внутри он определённо есть. |
© «Битрикс», 2001-2023, «1С-Битрикс», 2023
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.