Удаление привязки к CRM сущности

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

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

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

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 из итератора.

Важно: Если у дела только одна привязка, она не будет удалена (дело будет пропущено), так как дело всегда должно иметь хотя бы одну привязку к сущности CRM. ID таких дел будет возвращён в параметре skipped_activity_ids.



Тип сущности (для поиска дел): В данном поле выбирается тип сущности 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 дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности (для поиска дел)".


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

Варианты выбора:
- Универсальное дело (CRM_TODO);
- Встреча (CRM_MEETING);
- Звонок (VOXIMPLANT_CALL);
- Задача (старый формат) (TASKS);
- Задача (новый формат) (CRM_TASKS_TASK);
- Письмо (CRM_EMAIL);
- Обзвон (CALL_LIST);
- SMS (CRM_SMS);
- Сообщение в живую ленту (CRM_LF_MESSAGE);
- Комментарий в живую ленту (CRM_LF_COMMENT);
- Визит (VISIT_TRACKER);
- Дело через REST (конфигурируемое) (CONFIGURABLE_REST_APP);
- Слоты календаря (CRM_CALENDAR_SHARING);
- Доставка (CRM_DELIVERY);
- Документ подписания (CRM_SIGN_DOCUMENT);
- Дело через REST (устаревшее) (CRM_EXTERNAL_CHANNEL);
- Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION);
- Оплата (CRM_PAYMENT);
- Задание из бизнес-процесса (CRM_REQUEST);
- Комментарий к задаче (CRM_TASKS_TASK_COMMENT);
- Заполнение CRM-формы (CRM_WEBFORM);
- Чат открытой линии (IMOPENLINES_SESSION);
- Дело через REST приложение (REST_APP);
- Документ складского учета (STORE_DOCUMENT);
- Zoom-конференция (ZOOM);
- Подписание документа с сотрудниками (CRM_SIGN_B2E_DOCUMENT);
- Бронирование (CRM_BOOKING);
- Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW).

Примеры:
- Звонок - удалить привязки только у дел типа "Звонок";
- Письмо - удалить привязки только у дел типа "Письмо";
- Встреча - удалить привязки только у дел типа "Встреча".


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

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

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

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

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