Позволяет указать и источник, и получателя вручную, чтобы переносить или добавлять дела между любыми CRM-сущностями независимо от текущего документа.
Для кого и какую проблему решает
Робот полезен для администратора CRM, объединяющего контекст двух заранее выбранных карточек. Дела находятся в исходной карточке, а работа продолжается в другой. Робот добавляет выбранные связи дел получателю или переносит их, причём источник и получателя можно указать независимо от текущего документа.
Что делает и когда применять
Робот нужен для сценариев, где перенос дел не должен зависеть от той сущности, в которой сейчас выполняется бизнес-процесс.
Это самый универсальный вариант робота для случаев, когда процесс должен сам определить, откуда взять дела и куда их передать.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Укажите типы и ID обеих карточек. Режим add добавляет связь, move переносит её с исключением исходной. Для отдельных типов выключите обработку всех и выберите нужные типы дел; проверьте итог каждой операции.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Перенести или добавить дела между любыми сущностями». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Укажите типы и ID обеих карточек. Режим add добавляет связь, move переносит её с исключением исходной. Для отдельных типов выключите обработку всех и выберите нужные типы дел; проверьте итог каждой операции.
- Заполните Тип исходной сущности, ID исходной сущности, Тип целевой сущности, ID целевой сущности, Режим работы, Обрабатывать все типы дел. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип исходной сущности (sourceEntityTypeId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID исходной сущности (sourceEntityId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Тип целевой сущности (targetEntityTypeId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID целевой сущности (targetEntityId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Режим работы (actionMode) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Обрабатывать все типы дел (useAllTypes) |
Формат: да/нет. | Обязательно. Значение по умолчанию в настройках не задано |
Типы дел (activityTypes) |
Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип исходной сущности (
sourceEntityTypeId):1. - ID исходной сущности (
sourceEntityId):501. - Тип целевой сущности (
targetEntityTypeId):2. - ID целевой сущности (
targetEntityId):601. - Режим работы (
actionMode):add. - Обрабатывать все типы дел (
useAllTypes):Y.
В режиме add выбранные дела лида 501 становятся связаны со сделкой 601, при сохранении исходной связи. Количество совпавших и обработанных дел может отличаться от общего числа; ошибки возвращаются отдельно.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Тип исходной сущности (sourceEntityTypeId) |
целое число |
ID исходной сущности (sourceEntityId) |
целое число |
Тип целевой сущности (targetEntityTypeId) |
целое число |
ID целевой сущности (targetEntityId) |
целое число |
Общее количество дел (totalActivityCount) |
целое число |
Количество выбранных дел (matchedCount) |
целое число |
Количество обработанных дел (processedCount) |
целое число |
Количество новых привязок (bindCount) |
целое число |
Количество снятых привязок (unbindCount) |
целое число |
Количество ошибок (errorCount) |
целое число |
ID обработанных дел (processedActivityIds) |
строка, несколько значений |
ID пропущенных дел (skippedActivityIds) |
строка, несколько значений |
Ошибки обработки (errors) |
строка, несколько значений |
Режим выполнения (mode) |
строка |
Статус выполнения (status) |
да/нет |
Проверьте счётчики обработки, пропущенные ID и ошибки перед завершением миграции. Режим move выбирайте лишь когда исходную связь действительно нужно удалить; это не создание независимых копий содержимого дел.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.