ID сделок у элемента смарт-процесса

Возвращает список ID сделок, связанных с элементом смарт-процесса.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для координатора, который ведёт несколько сделок в одном элементе смарт-процесса. В закупке, проекте или заявке связаны несколько сделок, и их нельзя надёжно найти по общему названию. Робот читает связи выбранного элемента и возвращает список ID сделок.

Что делает и когда применять

Робот пригодится, когда нужно найти все сделки, связанные с текущим элементом смарт-процесса.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Запускайте действие в нужном смарт-процессе. При пустом необязательном ID используется текущий элемент; для явного выбора укажите ID элемента того же контекста.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «ID сделок у элемента смарт-процесса». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Запускайте действие в нужном смарт-процессе. При пустом необязательном ID используется текущий элемент; для явного выбора укажите ID элемента того же контекста.
3. Заполните ID элемента. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
ID элемента (elementId)	Формат: целое число.	Необязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID элемента (elementId): 901.

Если учебный элемент 901 связан со сделками 501 и 502, они вернутся списком. Отдельно выдаётся ID последней сделки; бизнес-правило выбора основного заказа нужно определить в процессе самостоятельно.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID сделок (dealsId)	целое число, несколько значений
ID последней сделки (lastDealId)	целое число
Статус (status)	строка
Ошибка (error)	строка

Передайте «ID сделок» в цикл обработки или используйте «ID последней сделки» только когда это соответствует вашей задаче. При отсутствии связей сначала разберите причину, прежде чем изменять другую карточку.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.