Изменение задачи

Активити (робот) "Изменение задачи" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

Автоматическое изменение параметров задачи (название, описание, сроки, приоритет);
Переназначение ответственного или добавление соисполнителей;
Изменение сроков выполнения задачи на основе событий в CRM;
Привязка задачи к сущностям CRM (сделки, лиды, контакты, компании);
Обновление статуса и приоритета задачи автоматически;
Добавление тегов и файлов к существующим задачам;
Управление зависимостями между задачами;
Привязка задачи к рабочим группам и проектам.

Как работает активити (робот):
- Активити (робот) позволяет изменить любые поля существующей задачи по её ID;
- Можно изменить одно или несколько полей одновременно;
- Поддерживается работа с датами, пользователями, CRM-сущностями;
- Активити автоматически обрабатывает форматы пользователей (user_ID, [ID]);
- При изменении крайнего срока автоматически сдвигаются зависимые задачи на диаграмме Ганта.

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

Название поля	Описание и примеры использования
ID задачи	Обязательный параметр. ID задачи, которую необходимо изменить. Примеры: - `{=Variable:TASK_ID}` - из переменной; - `123456` - конкретный ID задачи.
Название задачи	Поле позволяет указать новое название задачи. Примеры: - `{=Variable:TASK_TITLE}`; - `Задача №{=Document:ID}`. Рекомендуем использовать модель именования: Задача №1, Задача №2 и т.д.
Описание задачи	В этом поле указывается что необходимо сделать в рамках задачи. Пример: `{=Variable:TASK_DESCRIPTION}` Рекомендуем заполнять описание максимально подробно.
Дата начала	Дата начала задачи. Есть возможность выбора формата даты. Примеры: - `{=Variable:START_DATE}`; - `{{=dateadd({=System:Now}, "1d")}}` - завтра.
Дата завершения	Дата окончания задачи. Примеры: - `{=Variable:END_DATE}`; - `{{=dateadd({=System:Now}, "7d")}}` - через 7 дней.
Крайний срок	Крайний срок задачи. Пример: `{{=dateadd({=System:Now}, "5d")}}` ВАЖНО! Изменение крайнего срока ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Приоритет	Позволяет установить приоритетность задачи. Значения: - `1` - обычная; - `2` - важная (отмечается огоньком).
Идентификатор ответственного	ID сотрудника, который должен выполнить задачу. Форматы: `{=Document:ASSIGNED_BY_ID}`, `[1]`, `user_1`.
Идентификатор постановщика	ID сотрудника, который будет принимать задачу. Форматы: `{=User:ID}`, `[1]`, `user_1`. ВАЖНО! Постановщик получает уведомления по каждому изменению задачи.
Соисполнители	ID сотрудников, участвующих в работе. Можно указать несколько ID через запятую или массив. Пример: `{=Variable:ACCOMPLICES}`
Наблюдатели	ID сотрудников, наблюдающих за задачей. Получают уведомления об изменениях. Пример: `{=Variable:AUDITORS}`
Теги	Теги задач для фильтрации и поиска. Можно указать несколько как массив. Пример: `{=Variable:TAGS}` Теги - идентификаторы для уточнения категории, описания, поиска данных.
Флаг "Разрешить ответственному менять крайний срок"	Позволяет ответственному передвигать сроки выполнения. Варианты: да/нет.
Флаг "Привязать к текущей сущности CRM"	Привязка задачи к сущности из которой запускается БП. Варианты: да/нет.
Привязать задачу к нескольким сущностям	Позволяет привязать задачу к нескольким CRM-сущностям. Обозначения: - `L_` - Лид; - `D_` - Сделка; - `C_` - Контакт; - `CO_` - Компания; - `SI_` - Счёт; - `Q_` - Предложение; - `T84_` - Смарт-процесс (символьный код). Пример: `L_123, D_456, C_789`
Коды смарт-процессов	Позволяет выбрать символьный код для СП. Для каждого СП код уникален. Если добавляете новый СП, нужно переустановить активити.
Флаг "Принять работу после завершения задачи"	Потребует от постановщика принять задачу после завершения. Отображается "Ожидает контроля".
Идентификатор родительской задачи	ID родительской задачи для создания вложенных задач. Пример: `{=Variable:PARENT_TASK_ID}`
Идентификатор рабочей группы	Привязка задачи к группе (проекту) для разделения в отчетах. Пример: `{=Variable:GROUP_ID}`
Плановые трудозатраты (в секундах)	Запланированное время на выполнение. Указывается в секундах. Пример: для 2 часов укажите `7200` (26060).
Идентификатор задачи для зависимости	ID задачи для привязки зависимости. Формат: `id#тип`. Пример: `123456#1, 985#2, 737#1` Типы зависимостей: - `1` - Когда начнётся указанная - начнётся эта; - `2` - Когда начнётся указанная - закончится эта; - `3` - Когда закончится указанная - начнётся эта; - `4` - Когда закончится указанная - закончится эта; - `11-14` - обратные зависимости. Изменить привязку можно только после ручного удаления связи.
Статус задачи	Позволяет выбрать из списка новый статус задачи. Статусы: - Задача выполняется (пользователь нажал начать выполнение); - Условно завершена (пользователь закрыл задачу и ждет согласования от постановщика); - Задача выполнена (пользователь завершил выполнение задачи); - Задача отложена (пользователь нажал отложить); - Закрывает задачу требующую контроля; - Задачу не принял контроллер Возобновить после завершения; REST Api Б24 запрещает переводить задачу в статус "Задача выполняется (пользователь нажал начать выполнение)". При попытке перевести задачу в этот статус вы будете получать ошибку "error_api: tasks.task.start"
Прикрепить файл к задаче	ID файлов с облачного диска. Можно указать несколько через запятую. Пример: `{=Variable:FILE_IDS}` или `123, 456, 789`
Крайний срок в рабочее время	Автоматически увеличивает сроки в рамках рабочих дней. Воскресенье - на понедельник.

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

№	Сценарий	Параметр	Значение
1	Изменить название	Название задачи	`Новое название задачи`
2	Сменить ответственного	Идентификатор ответственного	`user_25`
3	Продлить срок на 7 дней	Крайний срок	`{{=dateadd({=System:Now}, "7d")}}`
4	Установить высокий приоритет	Приоритет	`2`
5	Добавить соисполнителей	Соисполнители	`user_10, user_15, user_20`
6	Привязать к сделке	Привязать к сущностям	`D_{=Document:ID}`
7	Добавить теги	Теги	`срочно, важно`
8	Привязать к группе	Идентификатор рабочей группы	`{=Variable:GROUP_ID}`
9	Установить трудозатраты 4 часа	Плановые трудозатраты	`14400`
10	Обновить описание	Описание задачи	`Обновлено: {=System:Date}`

Возвращаемые параметры для данного активити:

ID изменённой задачи (task_id) - числовой идентификатор изменённой задачи;
Успех операции (success) - результат выполнения (Y/N);
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Изменение крайнего срока может повлиять на зависимые задачи в диаграмме Ганта;
- Постановщик получает уведомления о каждом изменении задачи;
- При добавлении нового смарт-процесса требуется переустановка активити;
- Пользователь должен иметь права на изменение указанной задачи.

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

Изменение задачи