Изменение универсального дела

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

• Обновление данных существующего универсального дела;
• Изменение срока выполнения дела при изменении условий;
• Обновление заголовка и описания дела на основе новых данных;
• Изменение ответственного за дело при перераспределении задач;
• Добавление или изменение напоминаний о предстоящем деле;
• Изменение цветовой маркировки дела для визуального разделения;
• Обновление связи с родительским делом в таймлайне;
• Автоматическое обновление дел при изменении статуса сделки или лида;
• Массовое обновление дел по определённым критериям;
• Автоматизация обновления дел при интеграции с внешними системами.

ID дела для обновления: В данном поле указывается идентификатор дела, которое нужно обновить. Это обязательный параметр.

Как получить ID дела:
- Из результата активити (робота) "Добавление дела" (параметр new_id_todo);
- Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string);
- Из переменной, созданной в предыдущих шагах бизнес-процесса;
- Из поля документа, если дело связано с документом.



Тип сущности: В данном поле указывается новый тип сущности, к которой будет привязано дело. Это обязательный параметр. Выбирается из выпадающего списка.

Варианты выбора:
- Лид (L) - для привязки дела к лиду;
- Сделка (D) - для привязки дела к сделке;
- Контакт (C) - для привязки дела к контакту;
- Компания (CO) - для привязки дела к компании;
- Предложение (Q) - для привязки дела к предложению;
- Заказ (O) - для привязки дела к заказу;
- Счёт (SI) - для привязки дела к счету;
- СМАРТ: [название смарт-процесса] - для привязки дела к смарт-процессам (список формируется автоматически на основе настроек вашего портала).


ID сущности: В данном поле указывается новый идентификатор сущности CRM, к которой будет привязано дело. Это обязательный параметр.

Примеры:
- {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания);
- 123 - привязать дело к сущности с ID 123;
- {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота);
- {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива);
- {=Iterator:Value} - использовать ID для каждого элемента в итераторе.




Срок выполнения: В данном поле указывается новый срок выполнения дела (дата и время, до которого должно быть выполнено дело). Это обязательный параметр.


Описание дела: В данном поле указывается новое описание дела. Это необязательный параметр. Если не указано, описание останется без изменений.


Ответственный: В данном поле указывается новый ответственный за дело. Это необязательный параметр. Если не указан, ответственный останется без изменений.

Напоминания (минуты до дедлайна): В данном поле указывается новое время до дедлайна (в минутах), когда нужно отправить напоминание о предстоящем деле. Это необязательный параметр. Можно указать несколько значений через запятую для множественных напоминаний. Если не указано, напоминания останутся без изменений.



Цвет дела: В данном поле указывается новый цвет для визуальной маркировки дела в календаре и списке дел. Это необязательный параметр. Выбирается из выпадающего списка. Если не указан, цвет останется без изменений.

Варианты выбора:
- Жёлтый (0) - жёлтый цвет;
- Синий (1) - синий цвет;
- Бирюзовый (2) - бирюзовый цвет;
- Оранжевый (3) - оранжевый цвет;
- Зелёный (4) - зелёный цвет;
- Фиолетовый (5) - фиолетовый цвет;
- Серый (6) - серый цвет;
- Красный (7) - красный цвет.

Идентификатор дела в таймлайне, с которым можно связать создаваемое дело: В данном поле указывается новый ID родительского дела в таймлайне, с которым нужно связать дело. Это необязательный параметр. Если не указан, связь с родительским делом останется без изменений.



Делать отладочные сообщения в журнал БП:  в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

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