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

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

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

Как работает активити (робот):
- Активити (робот) позволяет привязать одно или несколько дел к указанной сущности CRM;
- Поддерживается два способа работы: указание конкретного ID дела или автоматический поиск дел по типу и ID сущности;
- Если указан ID дела, то другие параметры (тип сущности и ID сущности) не учитываются;
- Если ID дела не указан, активити (робот) автоматически найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности;
- Поддерживается привязка к стандартным сущностям (лид, сделка, контакт, компания, предложение, заказ, счёт) и смарт-процессам;
- Для массовой привязки (более 2 дел) используется batch-запрос для оптимизации производительности;
- Дело всегда должно иметь привязку к какой-то сущности, поэтому нельзя просто удалить привязку без создания новой.

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

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

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, которое будет привязано к сущности CRM. Это необязательный параметр, но если он указан, то другие параметры (тип сущности и ID сущности) не учитываются. Поддерживается множественное значение (можно указать несколько ID дел). Важно: Если указан ID дела, то параметры "Тип сущности" и "ID сущности" игнорируются. Используйте этот параметр для прямой привязки конкретного дела к сущности. Примеры: - {=Variable:ACTIVITY_ID} - привязать дело с ID из переменной предыдущего активити (робота); - 123 - привязать дело с ID 123; - 123, 456, 789 - привязать несколько дел одновременно (множественное значение); - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Iterator:Value} - привязать дело для каждого ID из итератора. Когда использовать: - Когда нужно привязать конкретное дело, ID которого известно; - Когда 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 дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "ID сущности".
ID сущности	В данном поле указывается идентификатор сущности CRM, к которой будет привязано дело. Это необязательный параметр, используется только если не указан "ID дела". Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Как работает в паре с "Тип сущности": - Если указаны оба параметра ("Тип сущности" и "ID сущности"), активити (робот) найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности, указанной в этих параметрах; - Если указан только "ID сущности" без "Типа сущности", активити (робот) завершится с ошибкой. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности".
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

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

Описание примера	Решение
Привязка конкретного дела к сделке по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается (игнорируется), ID сущности - не указывается (игнорируется). Примечание: при указании ID дела другие параметры не учитываются. Для привязки к сделке используйте активити (робот) с указанием ID дела и ID сделки в других параметрах активити (робота) или используйте другой способ привязки.
Привязка всех дел от лида к сделке при конвертации	Параметры: ID дела - не указывается, Тип сущности - D (Сделка), ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к указанной сделке.
Привязка дела к контакту после создания дела	Параметры: ID дела - {=A1988_22222_92566_99999:new_id_activity}, Тип сущности - не указывается, ID сущности - не указывается. Используется ID дела из активити (робота) "Создание своего дела в CRM". Дело будет привязано к контакту, указанному в параметрах активити (робота) привязки.
Привязка нескольких дел к компании одновременно	Параметры: ID дела - 123, 456, 789 (множественное значение), Тип сущности - не указывается, ID сущности - не указывается. Все три дела будут привязаны к компании, указанной в других параметрах активити (робота).
Привязка дел к смарт-процессу при изменении статуса	Параметры: ID дела - не указывается, Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к текущему элементу смарт-процесса, и привяжет их к новому элементу смарт-процесса.
Массовая привязка дел через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности - не указывается, ID сущности - не указывается. Для каждого ID дела из итератора будет выполнена привязка к сущности, указанной в других параметрах активити (робота).
Привязка дела к контакту при создании сделки	Параметры: ID дела - не указывается, Тип сущности - C (Контакт), ID сущности - {=Document:CONTACT_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к контакту, указанному в сделке.
Привязка дела к компании при работе с лидом	Параметры: ID дела - не указывается, Тип сущности - CO (Компания), ID сущности - {=Variable:COMPANY_ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к компании, ID которой указан в переменной.
Привязка дела к предложению при создании коммерческого предложения	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается, ID сущности - не указывается. Дело будет привязано к предложению, указанному в других параметрах активити (робота).
Привязка дел к счёту при выставлении счёта	Параметры: ID дела - не указывается, Тип сущности - SI (Счёт), ID сущности - {=Variable:INVOICE_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к созданному счёту.

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

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

Примеры использования возвращаемого параметра:
- Использовать в условиях для проверки успешности привязки дела;
- Передать результат в следующее активити (робот) для условной логики;
- Сохранить в переменную для логирования и отчётности;
- Использовать для уведомления пользователей об успешности операции.

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

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешной привязки дела необходимо указать один из вариантов:
- Вариант 1: Указать "ID дела" (в этом случае другие параметры игнорируются);
- Вариант 2: Указать "Тип сущности" и "ID сущности" (в этом случае активити (робот) найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности).

Привязка дел к сущностям:
Дело всегда должно иметь привязку к какой-то сущности. Это значит, что если вы хотите привязать дело к Лиду 2 вместо Лида 1, то сначала нужно привязать дело к Лиду 2, а потом удалить привязку к Лиду 1, и никак иначе. Нельзя просто удалить привязку без создания новой.

Множественные привязки:
Дело может иметь несколько привязок к разным типам сущностей одновременно. Например, дело может быть привязано и к сделке, и к контакту, и к компании одновременно.

Автоматический поиск дел:
Если не указан "ID дела", активити (робот) автоматически найдёт все дела, привязанные к сущности, указанной в параметрах "Тип сущности" и "ID сущности". Эти дела будут привязаны к новой сущности. Убедитесь, что указанная сущность существует и к ней действительно привязаны дела.

Массовая привязка:
При привязке более 2 дел активити (робот) автоматически использует batch-запрос для оптимизации производительности. Это позволяет эффективно обрабатывать большое количество дел.

Привязка к смарт-процессам:
Поддерживается привязка дел к смарт-процессам. Список доступных смарт-процессов формируется автоматически на основе настроек вашего портала. Выберите нужный смарт-процесс из выпадающего списка в поле "Тип сущности".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на привязку дел к сущностям CRM. Рекомендуется использовать пользователя с правами администратора системы.

Обработка ошибок:
Если не найдены дела для привязки (при использовании варианта с автоматическим поиском), активити (робот) завершится с ошибкой "Не найдены дела для привязки". Убедитесь, что к указанной сущности действительно привязаны дела, или используйте вариант с указанием конкретного "ID дела".

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

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