Изменить подразделение

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

Передаются только те поля, которые нужно изменить: пустые параметры не отправляются и не затирают существующие значения на портале.
Обязательно указывается числовой ID изменяемого отдела и хотя бы одно поле для обновления.

Как работает активити (робот):
- Вы указываете ID подразделения и набор полей для правки;
- Формируется запрос обновления в структуре компании;
- Возвращается признак успешного выполнения и служебное сообщение.

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

Обычно процесс сначала получает ID отдела из переменной или из робота поиска, затем подставляет новые значения из полей сущности или утверждённых констант сценария.

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

Название поля	Описание и примеры использования
ID подразделения	Числовой идентификатор изменяемого отдела. Пример: 14
Название	Новое имя; если оставить пустым, название не меняется. Пример: Отдел продаж B2B
Родитель	Новый ID родителя; укажите число для переноса ветки. Пример: 7
Сортировка	Новое значение порядка отображения среди соседей. Пример: 20
Руководитель	Пользователь-руководитель; заполните для назначения или смены. Пример: user_4

Если не передать ни одного поля кроме ID, активити завершится ошибкой «не указано поле для изменения».
Операции с иерархией должны соответствовать правилам портала (например, недопустимые родители).

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

Описание примера	Решение
Только переименование	ID подразделения = {=Variable:DEPT_ID}, Название = {=Variable:NEW_NAME}. Остальные поля пустые.
Перенос под другой родительский отдел	ID подразделения = 9, Родитель = {=Variable:TARGET_PARENT_ID}.
Смена руководителя по итогам голосования	ID подразделения = {=Variable:DEPT_ID}, Руководитель = {=Variable:ELECTED_HEAD}.
Обновление сортировки после ревизии структуры	ID подразделения = {=Document:UF_DEPT_REF}, Сортировка = {=Variable:NEW_SORT}.
Комплексное обновление из одной формы	Заполните все поля значениями переменных процесса: Название, Родитель, Сортировка, Руководитель.
Проверка успеха перед уведомлением	Если значение параметра "Успешное обновление" = Y, отправьте чат-уведомление; если N — прочитайте данные из параметра "Сообщение об ошибке".
Связка со списком отделов	ID возьмите из первого элемента результата робота «Поиск подразделений» при фильтре по названию.
Отложенная смена названия	ID = {=Variable:DEPT_ID}, Название = Копия {=Variable:TITLE}. Используйте дату в тексте через шаблон переменной.
Исключение лишних изменений	Не передавайте поле Родитель, если перенос не требуется — так вы не затронете иерархию случайно.
Аудит изменений	Записывайте в таймлайн сущности строку из параметра "Сообщение об ошибке" и {=User:ID} исполнителя шага.

Возвращаемые параметры данного активити:
- Успешное обновление — Y при успешном ответе портала, N при ошибке;
- Сообщение об ошибке — техническое сообщение с кодом успеха или текстом ошибки API.

Важно о возвращаемых параметрах: при N проверьте права пользователя и корректность ID отдела перед повтором.

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

Изменить подразделение