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

Активити (робот) «Получить сведения о выбранном подразделении для чатов» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно по одному подразделению оргструктуры получить краткое название, полное название и список идентификаторов руководителей для уведомлений, задач или записи в поля сущности.

Результат формируется запросом к REST-методу im.department.get.
В поле ID подразделения допускается только одно числовое значение без перечисления через запятую.
Расширенный набор данных пользователей в запрос не передаётся (режим как у других роботов подразделений).

Как работает активити (робот):
- Вы указываете один ID подразделения;
- Активити запрашивает карточку подразделения и извлекает название, полное имя и список ID руководителей;
- При успехе возвращаются строки Название, Полное название (структура подчинения подразделения) и множественное поле ID руководителя;
- Если ID не указан, указано несколько значений, подразделение не найдено или ответ API с ошибкой, активити завершится с ошибкой или вернёт пустые поля в зависимости от ситуации.

Сценарий работы активити бизнес-процесса

Типичная цепочка: получить из переменной или поля документа один ID отдела, вызвать активити, записать значение параметров "Название" в комментарий, "ID руководителя" — в задачу или согласование.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID подразделения	Один числовой идентификатор подразделения. Строка «5» или «12» допустима; перечисление «3,7» недопустимо. Пример: 8

При нескольких числах через запятую активити завершится с ошибкой «Допустимо только одно подразделение».
При пустом поле — «Не указан ID подразделения».
Состав полей ответа зависит от настроек чатов и оргструктуры на портале.

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

Описание примера	Решение
Подставить название отдела в тему задачи	ID подразделения = {=Variable:DEPT_ID}. В следующем шаге используйте возвращаемый параметр "Название" в тексте «Копия {=Variable:TITLE}».
Записать полный путь отдела в комментарий	ID подразделения = 14. В комментарий выведите параметр "Полное название" из результата активити.
Назначить задачу руководителю отдела	Возьмите первый элемент из "ID руководителя" или используйте множественное поле в шаге, где допускается несколько ответственных.
Сверить отдел сделки с карточкой оргструктуры	ID подразделения = {=Document:UF_DEPARTMENT} при условии, что в поле один числовой ID. Сравните параметр "Название" с ожидаемым текстом во вложенном условии.
Передать ID руководителей в переменную процесса	Сохраните параметр "ID руководителя" в множественную переменную типа пользователь или число для последующей рассылки.
Проверка непустого названия перед записью в поле CRM	После шага проверьте, что параметр "Название" не пустой; иначе не перезаписывайте поле сделки или запросите ID у оператора.
Ошибка запроса и альтернативная ветка	При сбое запроса служебное поле параметра "Сообщение об ошибке" содержит префикс ошибки и текст; настройте условие по пустыми параметрами "Название" и "Полное название" при необходимости.
Фиксация названия в лиде	ID подразделения из переменной {=Variable:SELECTED_DEPT}. Запишите параметр "Название" в пользовательское поле лида текстом.
Один ответственный из списка руководителей	Если в "ID руководителя" несколько значений, используйте первое значение во вложенном выражении или отдельном роботе выбора.
Проверка перед вложенным роботом по отделам	Сначала убедитесь, что {=Variable:DEPT_ID} не пустой и не содержит запятую; затем передайте его в поле ID подразделения.

Возвращаемые параметры данного активити:
- Название — краткое название подразделения из ответа API;
- Полное название — полное наименование подразделения, включая подразделение которому оно подчинено;
- ID руководителя — список числовых ID пользователей-руководителей (может быть пустым);
- Сообщение об ошибке — служебное сообщение: при успехе отметка о выполнении; при ошибке запроса — префикс и описание ответа сервера.
Важно о возвращаемых параметрах: при ошибке запроса название и полное имя могут быть пустыми, список руководителей — пустым массивом; подробности смотрите в параметре "Сообщение об ошибке".
При отсутствии подразделения процесс уйдёт в ветку ошибки активити.

Ваша корзина пуста

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