ID элемента смарт-процесса из сделки
Возвращает ID элемента смарт-процесса, связанного со сделкой.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для администратора процессов, связывающего продажи с исполнением в смарт-процессе. Из сделки нужно перейти к связанному проекту или заявке смарт-процесса, но одинаковые названия затрудняют поиск. Робот читает существующую связь сделки с выбранным типом смарт-процесса.
Что делает и когда применять
Робот пригодится, когда нужно найти элемент смарт-процесса, связанный с текущей сделкой, чтобы продолжить процесс уже в нем.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Подготовьте ID сделки и тип нужного смарт-процесса. Убедитесь, что такая связь уже существует: робот её читает, а не создаёт новый элемент по условиям сделки.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «ID элемента смарт-процесса из сделки». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Подготовьте ID сделки и тип нужного смарт-процесса. Убедитесь, что такая связь уже существует: робот её читает, а не создаёт новый элемент по условиям сделки.
- Заполните ID сделки, ID смарт-процесса. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID сделки (dealId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID смарт-процесса (smartId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID сделки (
dealId):501. - ID смарт-процесса (
smartId):170.
Если сделка 501 связана с элементом 901 типа 170, результатом станет ID элемента 901. Название типа и ID отдельного элемента не взаимозаменяемы.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID элемента (elementSmartId) |
целое число |
Статус (status) |
строка |
Ошибка (error) |
строка |
Подставьте «ID элемента» в действие смарт-процесса вместе с тем же типом. При отсутствии связи направьте сценарий на проверку привязок, не создавая повторный элемент без отдельного решения.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.