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

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

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

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

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

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

Название поля	Описание и примеры использования
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). Примеры: - Звонок - удалить привязки только у дел типа "Звонок"; - Письмо - удалить привязки только у дел типа "Письмо"; - Встреча - удалить привязки только у дел типа "Встреча". Когда использовать: - Когда нужно удалить привязки только у определённого типа дел; - Для фильтрации дел перед массовым удалением привязок; - Для более точного контроля над процессом удаления привязок.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

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

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

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

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

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

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

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

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

Ограничение на удаление последней привязки:
Дело всегда должно иметь хотя бы одну привязку к сущности CRM. Это значит, что если у дела только одна привязка, она не будет удалена. Такое дело будет пропущено, и его ID будет возвращён в параметре skipped_activity_ids. Это ограничение установлено API Битрикс24 и не может быть обойдено.

Процесс замены привязки:
Если вы хотите привязать дело к Лиду 2 вместо Лида 1, то сначала нужно привязать дело к Лиду 2 через активити (робот) "Привязка дела", а потом удалить привязку к Лиду 1 через это активити (робот), и никак иначе. Нельзя просто удалить привязку без создания новой.

Множественные привязки:
Дело может иметь несколько привязок к разным типам сущностей одновременно. При удалении привязок удаляются все привязки у найденных дел (кроме одной, если она единственная).

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

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

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

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

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

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

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

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