Поиск подразделений

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

Результат формируется запросом к REST-методу department.get.
Названия полей в форме активити подставляются из справочника полей подразделений портала.
При большом числе совпадений ответ может приходить порциями; активити собирает все найденные записи и извлекает из них поле ID.

- Активити передаёт непустые значения в метод поиска и обрабатывает структуру ответа, в том числе когда записей больше пятидесяти;
- При успехе возвращаются массив ID, строка через запятую, первый и последний ID в выборке;
- Если фильтр пуст, подразделения не найдены или список ID пуст, активити завершится с ошибкой или признаком неуспеха в зависимости от ситуации.


Типичная цепочка: задать условие поиска, получить массив числовых ID подразделений или те же ID в одной строке через запятую (строка), проверить параметр "успешного выполнения задачи" и количество найденных элементов.
Затем передать найденные ID в другие роботы или переменные процесса.

Название поля	Описание и примеры использования
ID	Числовой идентификатор подразделения для точного поиска. Пример: 42 Поле необязательное, но вместе с остальными должно участвовать в заполнении хотя бы одного критерия фильтра.
Название	Строка для поиска по наименованию подразделения (как настроено в полях портала). Пример: Отдел продаж
Родитель	Идентификатор вышестоящего подразделения в иерархии. Пример: 10
Руководитель	Пользователь-руководитель (поле типа пользователь в форме робота). Указывается как сотрудник из структуры портала. Пример: выбор пользователя из списка в конструкторе бизнес-процесса.

Описание примера	Решение
Найти подразделение по точному ID	ID = 15, остальные поля пустые. Используйте параметр "Результат поиска (массив для итератора)" для одной записи или проверьте количество найденных ID.
Фильтр по родительскому отделу	Родитель = 3, Название пустое. Дочерние подразделения попадут в массив числовых ID.
Поиск по названию филиала	Название = Москва, остальные поля по необходимости. Сверьте количество найденных ID с ожидаемым числом отделов.
Все отделы, где руководитель — конкретный сотрудник	Руководитель = выбранный пользователь, ID и Название не заданы. Результат — список ID из массива числовых ID подразделений.
Передать первый найденный ID в переменную	После шага возьмите набор найденных ID из параметра "Результат поиска (строка)" для подстановки в поле следующего действия.
Сравнить с отделом из сделки	ID = {=Document:UF_DEPARTMENT} при условии, что в поле сделки хранится один числовой ID подразделения.
Строка ID для внешней системы	Используйте найденные ID из параметра "Результат поиска (строка)" как единую строку с перечислением через запятую для вебхука.
Остановить сценарий, если ничего не найдено	Настройте ветку ошибки после активити или проверку параметра "Успех выполнения операции" = N в условии.
Комбинация: родитель и часть названия	Родитель = 7, Название = Логистика. Уточняет выборку внутри ветки оргструктуры.
Последний ID в отсортированном списке результатов	После успешного поиска используйте параметр "Последний результат поиска", если порядок в ответе соответствует логике выборки портала.