Проверить обязательный состав команды проекта

Робот «Проверить обязательный состав команды проекта». Показывает, все ли обязательные сотрудники входят в группу с нужными ролями.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Для владельца проекта и координатора обязательных ролей команды. Выявляет отсутствующего участника или неверную роль до запуска работ, не требуя ручного сравнения списков.

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
ID группы или проекта	Целое число	Обязательное; значение по умолчанию не задано
Обязательные участники и роли (JSON)	Текст	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Укажите ID группы или проекта.
2. Подготовьте массив обязательных сотрудников с ключами userId и role.
3. Используйте роли A: владелец, E: модератор, K: участник, any: любая действующая роль.
4. Например, передайте [{"userId":21,"role":"A"},{"userId":22,"role":"any"}].
5. Ветвите процесс по подтверждению обязательного состава. Отсутствующих и несовпадения ролей передайте владельцу для исправления.

Учебный пример и ожидаемый результат

В проекте владелец 21 и участник 22. При ожидании владельца 21 и любой действующей роли 22 состав полный. Дополнительный участник 23 не мешает положительному результату. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• Обязательный состав подтверждён: да/нет (Y/N).
• Отсутствующие сотрудники: сотрудник, список.
• Несовпадения ролей в формате JSON: строка.
• Дополнительные участники: сотрудник, список.

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Непринятое приглашение не считается участием. Дополнительные сотрудники показываются отдельно и не делают состав неполным. Робот только проверяет и не добавляет участников, не меняет роли и не проверяет их рабочее время.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Обязательные участники и роли (JSON)

[
  {
    "userId": 21,
    "role": "A"
  },
  {
    "userId": 22,
    "role": "any"
  }
]

Массив до 1000 требований к команде, ID не повторяются. В каждом объекте обязательны положительный числовой userId и строковый role: A владелец, E модератор, K участник, any любая действующая роль. ID берите из согласованного состава команды. Пример требует владельца 21 и участия 22 в любой действующей роли. [] допустим как отсутствие обязательных сотрудников: комплектность будет положительной, а фактические участники дополнительными. Это не карта ID→роль, используемая другим роботом изменения состава; не подменяйте форму объектом {}.