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