Робот «Конвертировать сумму в текст» legacy-робот для старых сценариев, где сумма и валюта передаются одной строкой. Для новых процессов используйте робот «Сумма прописью» с отдельными полями суммы, валюты и языка.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру документов и администратору, который получает сумму вместе с кодом валюты одной строкой и подставляет её словесную запись в текст.
Для печатной формы нужно согласовать цифры и текст суммы. Этот робот распознаёт числовую часть и поддерживаемый код валюты из одного поля. Он не определяет валюту сделки и не выполняет обмен валют.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Сумма с валютой (input_text) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- В input_text передайте сумму и код, например
125.50 RUB. Между тысячами допустимы пробелы, дробный разделитель точка или запятая. - Используйте поддерживаемый код валюты; не заменяйте его произвольным названием или значком. Для русской записи рублей подойдёт RUB.
- Подготовьте окончательную денежную сумму до преобразования. Действие не является точным расчётом платежа и не задаёт отдельное правило округления для процесса.
- Полученный result_text вставьте в шаблон отдельным действием и сверяйте с числовым полем. При пустом результате проверьте формат суммы и валюту.
Учебный пример и ожидаемый результат
input_text=125.50 RUB. Ожидается «Сто двадцать пять рублей, 50 копеек». При целой сумме 125 RUB дробная часть не выводится отдельными 00 копейками. Не смешивайте эту форму с другим роботом «Сумма прописью», у которого сумма, валюта и язык задаются отдельно.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Текстовое представление суммы» (
result_text).
Возвращается result_text, готовая строка для подстановки. Поле статуса объявлено в схеме, однако не стоит заменять проверку итогового текста одним предположением о заполненном результате. При нераспознанной записи текст отсутствует.
Проверяйте завершение действия и наличие result_text перед записью в документ. Отдельного выходного поля пояснения ошибки нет. Не подставляйте пустой результат вместо обязательной суммы прописью.
Ограничения и разбор ошибок
Вход объединяет число и код валюты. Пробелы в числовой части удаляются, запятая заменяется точкой. При ошибке распознавания result_text отсутствует. Текст формируется на русском; отдельного языка и исходного курса в настройках нет.
Для финансовых расчётов с точными десятичными правилами используйте предварительный расчёт и проверку. Не добавляйте к входу комментарии и несколько разных сумм. Робот не создаёт документ и не подтверждает юридическую корректность формулировки.