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

Данное активити (робот) позволяет при знании ID задачи указать нужные поля для изменения.

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

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

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

Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.

ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Ограничение по количеству изменений:
Если вы планируете через интегратор произвести изменение более 100 сущностей, то нужно использовать наш модуль массовый БП "Массовый запуск Бизнес-процессов". Настройте бизнес-процесс на использование одной задачи где ID задачи будет браться из той сущности, из которой вы хотите произвести изменения. Потом зайдите в модуль "Массовый БП" отфильтруйте по типу сущности "Задача" и нужным вам параметрам и активируйте массовый запуск. Наше приложение равномерно распределит нагрузку.

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

Описание примера	Решение
Перенос крайнего срока задачи на следующий рабочий день	Параметры: ID задачи - {=Variable:TASK_ID}, Крайний срок - {{=workdateadd({=System:Now}, "1d")}}, Крайний срок должен всегда устанавливаться в рабочее время - да.
Изменение ответственного при перераспределении нагрузки	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор ответственного - {=Variable:NEW_RESPONSIBLE_ID}, Текст статуса - "Ответственный изменен".
Добавление соисполнителей при расширении команды	Параметры: ID задачи - {=Variable:TASK_ID}, Соисполнители - {=Variable:NEW_ACCOMPLICES}, Текст статуса - "Добавлены соисполнители".
Привязка задачи к нескольким CRM сущностям	Параметры: ID задачи - {=Variable:TASK_ID}, Привязать задачу к нескольким сущностям - "D_{=Document:ID}, L_{=Variable:LEAD_ID}", Текст статуса - "Задача привязана к сущностям".
Создание зависимости между задачами проекта	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор задачи для зависимости - "{=Variable:PARENT_TASK_ID}#3" (когда закончится родительская - начнется эта), Текст статуса - "Зависимость установлена".
Изменение приоритета задачи на "Важную" при критической ситуации	Параметры: ID задачи - {=Variable:TASK_ID}, Приоритет - 2, Название задачи - "СРОЧНО: {=Variable:ORIGINAL_TITLE}", Текст статуса - "Приоритет повышен".
Прикрепление отчетного файла к задаче	Параметры: ID задачи - {=Variable:TASK_ID}, Прикрепить файл к задаче - {=Variable:REPORT_FILE_ID}, Текст статуса - "Файл прикреплен".
Обновление плановых дат задачи при изменении графика проекта	Параметры: ID задачи - {=Variable:TASK_ID}, Дата начала - {=Variable:NEW_START_DATE}, Дата завершения - {=Variable:NEW_END_DATE}, Крайний срок - {=Variable:NEW_DEADLINE}, Текст статуса - "Даты обновлены".
Добавление тегов к задаче для фильтрации	Параметры: ID задачи - {=Variable:TASK_ID}, Теги - "проект, {=Document:TITLE}, важное", Текст статуса - "Теги добавлены".
Изменение постановщика задачи при смене руководителя	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор постановщика - {=Variable:NEW_MANAGER_ID}, Текст статуса - "Постановщик изменен".
Включение контроля выполнения задачи	Параметры: ID задачи - {=Variable:TASK_ID}, Флаг "Принять работу после завершения задачи" - да, Текст статуса - "Контроль включен".

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID задачи, которая редактировалась ({=Variable:i_updated_task_id}).

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

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