Изменение дела

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

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

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

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

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

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, данные которого нужно изменить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - изменить дело с ID из переменной предыдущего активити (робота); - 123 - изменить дело с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - изменить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - изменить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если ID дела не указан или указан неверно, активити (робот) завершится с ошибкой "Не указано ID дела".
Все доступные поля дела	Активити (робот) автоматически получает список всех доступных полей дела из CRM вашего портала и создаёт для каждого поля параметр, который можно заполнить для изменения значения. Это необязательные параметры. Доступные поля зависят от настроек вашего портала. Основные поля, которые обычно доступны: - Тема (SUBJECT) - тема дела; - Описание (DESCRIPTION) - описание дела; - Ответственный (RESPONSIBLE_ID) - ответственный за дело; - Дата начала (START_TIME) - дата и время начала дела; - Дата завершения (END_TIME) - дата и время завершения дела; - Выполнено (COMPLETED) - статус выполнения дела (Y/N); - Приоритет (PRIORITY) - приоритет дела; - Тип сущности (OWNER_TYPE_ID) - тип сущности, к которой привязано дело; - ID сущности (OWNER_ID) - ID сущности, к которой привязано дело; - И другие поля в зависимости от настроек портала. Примеры использования: - SUBJECT - "Новая тема дела" - изменить тему дела; - DESCRIPTION - "Обновлённое описание" - изменить описание дела; - COMPLETED - Y - отметить дело как выполненное; - RESPONSIBLE_ID - {=User:ID} - изменить ответственного на текущего пользователя; - START_TIME - ={{=dateadd({=System:Now}, "1d")}} - изменить дату начала на завтра; - OWNER_TYPE_ID - 2 - изменить тип сущности на "Сделка"; - OWNER_ID - {=Variable:DEAL_ID} - изменить ID сущности на значение из переменной. Типы полей: - Строка (string) - для текстовых полей; - Число (integer, double) - для числовых полей; - Дата/Время (datetime) - для полей с датой и временем; - Булево значение (boolean) - для полей с значениями Y/N; - Пользователь (user) - для полей с пользователями; - Тип сущности (crm_enum_ownertype) - для выбора типа сущности из списка. Важно: Не все поля дела доступны для изменения. Некоторые поля являются системными и не могут быть изменены (например, ID, PROVIDER_ID, PROVIDER_TYPE_ID). Список доступных полей формируется автоматически при установке активити (робота) на основе настроек вашего портала.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

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

Описание примера	Решение
Отметить дело как выполненное	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y. Активити (робот) отметит дело с указанным ID как выполненное.
Изменить ответственного за дело	Параметры: ID дела - {=Variable:ACTIVITY_ID}, RESPONSIBLE_ID - {=Document:ASSIGNED_BY_ID}. Активити (робот) изменит ответственного за дело на ответственного из текущей сущности.
Обновить тему и описание дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Обновлённая тема", DESCRIPTION - "Обновлённое описание дела". Активити (робот) обновит тему и описание дела.
Изменить даты начала и завершения дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, START_TIME - ={{=dateadd({=System:Now}, "1d")}}, END_TIME - ={{=dateadd({=System:Now}, "2d")}}. Активити (робот) изменит дату начала на завтра, а дату завершения - на послезавтра.
Изменить приоритет дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, PRIORITY - 3. Активити (робот) изменит приоритет дела на высокий (3).
Изменить тип сущности и ID сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, OWNER_TYPE_ID - 2, OWNER_ID - {=Variable:DEAL_ID}. Активити (робот) изменит привязку дела на сделку с указанным ID.
Массовое обновление дел через итератор	Параметры: ID дела - {=Iterator:Value}, COMPLETED - Y. Для каждого ID дела из итератора активити (робот) отметит дело как выполненное. Полезно для массовой обработки.
Обновление дела после выполнения условия	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y, SUBJECT - "Выполнено: " & {=Variable:ACTIVITY_SUBJECT}. Используйте в условии: если условие выполнено, то обновить дело через данное активити (робот).
Автоматическое обновление дела при изменении статуса сделки	Параметры: ID дела - {=Variable:DEAL_ACTIVITY_ID}, SUBJECT - "Сделка переведена в статус '{=Document:STAGE_ID}'", DESCRIPTION - "Статус сделки изменён. Новый статус: {=Document:STAGE_ID}". Используйте в бизнес-процессе сделки: при переводе сделки в новый статус автоматически обновить связанное дело.
Изменение нескольких полей одновременно	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Новая тема", DESCRIPTION - "Новое описание", RESPONSIBLE_ID - {=User:ID}, COMPLETED - N, PRIORITY - 1, START_TIME - {=System:NowLocal}, END_TIME - ={{=dateadd({=System:Now}, "1d")}}. Активити (робот) обновит все указанные поля дела за один запрос.

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

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

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

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

Доступные поля:
Активити (робот) автоматически получает список всех доступных полей дела из CRM вашего портала. Список полей формируется при установке активити (робота) на основе настроек вашего портала. Некоторые поля могут быть недоступны для изменения в зависимости от прав доступа пользователя, указанного в поле "Запускать от имени".

Недоступные для изменения поля:
Некоторые поля являются системными и не могут быть изменены через активити (робот). К таким полям относятся: ID, PROVIDER_ID, PROVIDER_TYPE_ID, PROVIDER_GROUP_ID, PROVIDER_DATA, RESULT_STATUS, RESULT_STREAM, RESULT_SOURCE_ID, RESULT_VALUE, RESULT_SUM, RESULT_CURRENCY_ID, RESULT_MARK, WEBDAV_ELEMENTS. Эти поля исключаются из списка доступных параметров при установке активити (робота).

Работа с полем "Ответственный":
Поле "Ответственный" (RESPONSIBLE_ID) обрабатывается специальным образом. Если указан пользователь, активити (робот) автоматически преобразует его в формат, необходимый для API Битрикс24. Можно указывать пользователя в различных форматах: [U1], user_1, {=User:ID}, {=Document:ASSIGNED_BY_ID} и т.д.

Работа с полем "Тип сущности":
Поле "Тип сущности" (OWNER_TYPE_ID) доступно для изменения и представляет собой выпадающий список с вариантами: Лид (1), Сделка (2), Контакт (3), Компания (4). При изменении типа сущности рекомендуется также изменить ID сущности (OWNER_ID) для корректной привязки дела к новой сущности.

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

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

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

Производительность:
Изменение дела требует выполнения запроса к REST API Битрикс24. При работе с большим количеством дел через итератор учитывайте ограничения по количеству запросов к API. Используйте параметр "Делать отладочные сообщения в журнал БП" только при необходимости для уменьшения нагрузки на систему.

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

Изменение дела