Возвращает последний документ по выбранному шаблону для текущей сущности.
Для кого и какую проблему решает
Робот полезен для менеджера, работающего с последним документом нужного шаблона в текущей карточке. Процесс знает текущую карточку, но нужно отличить последний договор от актов и приложений. Робот использует контекст документа и фильтр шаблона, возвращая нужную последнюю редакцию.
Что делает и когда применять
Робот помогает работать с документами конкретного шаблона, когда в одной сущности используется несколько видов документов.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Проверьте, где запущено действие, и укажите ID существующего шаблона. Подстановка ID текущей карточки не требуется: он определяется контекстом процесса.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Последний документ выбранного шаблона в текущей сущности». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Проверьте, где запущено действие, и укажите ID существующего шаблона. Подстановка ID текущей карточки не требуется: он определяется контекстом процесса.
- Заполните ID шаблона документа. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID шаблона документа (templateId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID шаблона документа (
templateId):21.
Из документов текущей карточки рассматриваются только созданные по шаблону 21. Наличие более нового документа другого вида не меняет выбор. При отсутствии подходящей редакции нужен отдельный разбор или создание документа.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID документа (documentId) |
целое число |
Номер документа (number) |
строка |
Название документа (title) |
строка |
Ссылка на скачивание (downloadUrl) |
строка |
ID шаблона (templateId) |
целое число |
Статус выполнения (status) |
да/нет |
Используйте номер и название для сверки сотрудником, ID для последующего действия. Перед отправкой проверьте, что именно эта редакция нужна и её файл доступен.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.