Привязка дела

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

• Привязка дела к дополнительным сущностям CRM (сделка, лид, контакт, компания);
• Связывание дела с несколькими сущностями одновременно;
• Автоматическая привязка дел к смарт-процессам;
• Создание связей между делами и различными типами сущностей в процессе работы;
• Привязка дел к сущностям на основе данных из предыдущих активити (роботов);
• Массовая привязка дел к сущностям через итератор;
• Автоматизация создания связей при обработке заявок и обращений;
• Привязка дел к сущностям при интеграции с внешними системами;
• Создание дополнительных связей для аналитики и отчётности;
• Привязка дел к сущностям при изменении статусов и этапов работы.

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


Примеры:
- {=Variable:ACTIVITY_ID} - привязать дело с ID из переменной предыдущего активити (робота);
- 123 - привязать дело с ID 123;
- 123, 456, 789 - привязать несколько дел одновременно (множественное значение);
- {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM";
- {=Iterator:Value} - привязать дело для каждого ID из итератора.

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

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

Примеры:
- D - привязать дело к сделке;
- C - привязать дело к контакту;
- CO - привязать дело к компании;
- СМАРТ: Заявки - привязать дело к смарт-процессу "Заявки".

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

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

Как работает в паре с "Тип сущности":
- Если указаны оба параметра ("Тип сущности" и "ID сущности"), активити (робот) найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности, указанной в этих параметрах;
- Если указан только "ID сущности" без "Типа сущности", активити (робот) завершится с ошибкой.



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

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

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

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

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

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

Возвращаемые параметры данного активити (робота):
- Результат выполнения (return_execution) - строка, указывающая результат выполнения активити (робота). Возможные значения: Y (успешно) или N (ошибка).