Удаление дела

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

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

Как работает активити (робот):
- Активити (робот) поддерживает несколько режимов работы: удаление по ID дела, по типу сущности и ID сущности, по типу провайдера, по ответственному;
- Если указан ID дела, все остальные параметры игнорируются (приоритет у ID дела);
- Поддерживается множественный выбор ID дел для массового удаления;
- Можно фильтровать дела по типу провайдера (звонок, письмо, встреча, задача и т.д.);
- Поддерживается работа со смарт-процессами (автоматически определяются и добавляются в список);
- Активити (робот) возвращает ID удалённых дел для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (crm.activity.delete).

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

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

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела или несколько идентификаторов дел, которые нужно удалить. Это необязательный параметр, поддерживается множественный выбор. Если указан, то все остальные параметры игнорируются (приоритет у ID дела). Примеры: - {=Variable:ACTIVITY_ID} - удалить дело с ID из переменной предыдущего активити (робота); - 123 - удалить дело с ID 123; - {=A1988_22222_92566_99999:search_results_array} - использовать массив ID дел из результата активити (робота) "Поиск дел"; - {=Iterator:Value} - удалить дело для каждого ID из итератора; - 123, 456, 789 - удалить несколько дел с указанными ID (множественный выбор). Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если указан параметр "ID дела", то все остальные параметры (Тип сущности, ID сущности, Тип дела, Ответственный за дело) игнорируются. Активити (робот) будет удалять только указанные дела.
Ответственный за дело	В данном поле указывается сотрудник, дела которого нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Если указан, то будут удалены только дела указанного ответственного. Примеры: - {=Document:ASSIGNED_BY_ID} - удалить дела ответственного из текущей сущности; - {=User:ID} - удалить дела текущего пользователя; - [U1] - удалить дела пользователя с ID 1; - user_25 - удалить дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации дел по ответственному при удалении по типу сущности; - Для удаления всех дел конкретного сотрудника, связанных с определённой сущностью; - Для очистки дел при смене ответственного. Важно: Этот параметр работает только если не указан параметр "ID дела". Если указан "ID дела", этот параметр игнорируется. Для задач (OWNER_TYPE_ID = 3) фильтр по ответственному не применяется.
Тип сущности	В данном поле указывается тип сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для удаления дел, привязанных к лидам; - Сделка (D) - для удаления дел, привязанных к сделкам; - Контакт (C) - для удаления дел, привязанных к контактам; - Компания (CO) - для удаления дел, привязанных к компаниям; - Предложение (Q) - для удаления дел, привязанных к предложениям; - Заказ (O) - для удаления дел, привязанных к заказам; - Счёт (SI) - для удаления дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для удаления дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - удалить все дела, привязанные к сделкам; - Контакт (C) - удалить все дела, привязанные к контактам; - СМАРТ: Заявки - удалить все дела, привязанные к смарт-процессу "Заявки". Когда использовать: - Для массового удаления дел по типу сущности; - Для очистки дел при удалении сущности; - Для фильтрации дел перед удалением по другим критериям.
ID сущности	В данном поле указывается идентификатор сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID дела". Примеры: - {=Document:ID} - удалить дела текущей сущности из документа (сделка, лид, контакт, компания); - 123 - удалить дела сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для удаления всех дел конкретной сущности; - Для очистки дел при удалении или изменении сущности; - Для удаления дел при завершении работы с сущностью.
Тип дела (провайдера)	В данном поле указывается тип дела (провайдера), который нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Выбирается из выпадающего списка. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок"; - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры использования: - Звонок - удалить только дела типа "Звонок"; - Письмо - удалить только дела типа "Письмо"; - Встреча - удалить только дела типа "Встреча". Когда использовать: - Для фильтрации дел по типу при удалении по сущности; - Для удаления только определённого типа дел; - Для очистки дел конкретного типа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

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

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

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

Возвращаемые параметры данного активити (робота):
- ID удаленного дела (ret_activity_id) - строка с ID удалённых дел, разделёнными запятыми (например, "123,456,789"). Если удалено одно дело, возвращается одно значение. Если удалено несколько дел, возвращается строка с ID, разделёнными запятыми. Используется для проверки успешности удаления и для дальнейшей обработки в бизнес-процессе.

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

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

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

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

Работа с множественными ID:
Параметр "ID дела" поддерживает множественный выбор. Можно указать несколько ID через запятую или использовать массив из переменной. Все указанные дела будут удалены за один запуск активити (робота). При большом количестве дел (более одного) используется batch-обработка для оптимизации производительности.

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

Фильтрация по ответственному:
Параметр "Ответственный за дело" позволяет фильтровать дела по ответственному сотруднику. Это полезно, когда нужно удалить только дела конкретного сотрудника. Фильтр применяется только при удалении по типу сущности и ID сущности. Для задач (OWNER_TYPE_ID = 3) фильтр по ответственному не применяется.

Работа со смарт-процессами:
Активити (робот) автоматически определяет смарт-процессы, доступные на вашем портале, и добавляет их в список типов сущностей. Список формируется автоматически на основе настроек портала.

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

Обработка ошибок:
Если дело с указанным ID не существует или уже удалено, активити (робот) пропустит его и продолжит обработку остальных дел. Ошибки не прерывают выполнение активити (робота). Параметр ret_activity_id будет содержать только ID успешно удалённых дел.

Использование в итераторе:
Для массового удаления большого количества дел рекомендуется использовать итератор. Это позволит обработать все дела последовательно и избежать ограничений пакетной обработки.

Безопасность:
Удаление дел - необратимая операция. Убедитесь, что вы действительно хотите удалить указанные дела перед запуском активити (робота). Рекомендуется сначала использовать активити (робот) "Поиск дел" для проверки, какие дела будут удалены.

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

Удаление дела