- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
Создать подразделение
Результат формируется запросом к облачному API структуры компании.
Поля передаются в том виде, в каком их ожидает портал: обязательны название и привязка к родителю; сортировка и руководитель задаются по необходимости.
У пользователя, от имени которого выполняется запрос, должны быть права на изменение оргструктуры.
- Вы заполняете название и ID родительского подразделения, при необходимости — сортировку и руководителя;
- Выполняется создание отдела на портале;
- Возвращается числовой идентификатор нового подразделения и служебное сообщение об успехе или тексте ошибки.
| Название поля | Описание и примеры использования |
|---|---|
| Название |
Краткое имя нового отдела в дереве компании. Пример: Отдел сопровождения регионов |
| Родитель |
Числовой ID родительского подразделения; для корня дерева на многих порталах указывают 0 согласно настройкам. Пример: 3 |
| Сортировка |
Необязательное целое число для порядка среди отделов одного уровня. Пример: 100 |
| Руководитель |
Пользователь, который станет руководителем отдела; можно оставить пустым. Пример: user_12 |
На портале может быть только один корневой раздел: значение «Родитель» должно соответствовать правилам вашей оргструктуры.
| Описание примера | Решение |
|---|---|
| Создать отдел после одобрения заявки в смарт-процессе |
Название = {=Variable:DEPT_TITLE}, Родитель = {=Variable:PARENT_DEPT_ID}, Руководитель = {=Variable:HEAD_USER}. Сохраните new_department_id в переменную процесса. |
| Филиал с фиксированным родителем | Название = Копия {=Variable:TITLE}, Родитель = 5, Сортировка = 500. |
| Команда проекта с руководителем из поля документа | Название = Проектная группа {=Document:ID}, Родитель = {=Variable:ROOT_DEPT}, Руководитель = {=Document:ASSIGNED_BY_ID}. |
| Отдел без руководителя на первом этапе |
Название = Временный отдел, Родитель = 2. Поле Руководитель не заполняйте; назначьте руководителя отдельным шагом «Изменить подразделение». |
| Использовать порядок сортировки из переменной | Сортировка = {=Variable:SORT_ORDER}, Название = {=Variable:NAME}, Родитель = {=Variable:PARENT_ID}. |
| Запись ID в пользовательское поле лида | После шага передайте new_department_id в поле лида через «Изменить лид», если в карточке предусмотрено хранение ID отдела. |
| Разветвление по успешному созданию | Проверьте, что new_department_id больше нуля; иначе прочитайте s_error_logs и отправьте уведомление администратору. |
| Связка с поиском родителя | Сначала робот «Поиск подразделений» находит ID родителя, затем в этом активити Родитель = результат поиска первой строки. |
| Повтор при ошибке прав | Если в логе указано отказ в доступе, направьте процесс на согласование с HR и повторите шаг от имени администратора портала. |
| Логирование для аудита | Сохраняйте s_error_logs в комментарий заявки вместе с названием и {=System:Now} для последующей проверки. |
- ID нового подразделения — числовой идентификатор созданного подразделения;
- Сообщение об ошибке — служебная строка: при успехе отметка о создании; при ошибке запроса — код и описание ответа портала.
Важно о возвращаемых параметрах: при ошибке идентификатор может быть нулём, уточняйте причину по служебному полю перед дальнейшими шагами сценария.