Робот ставит переданное значение в нужный падеж. Нужен там, где текст собирается из полей CRM: «Уважаемый Иванову Ивану» вместо «Уважаемый Иванов Иван».
Приложение не добавляет своей страницы в портал. После установки робот появляется в конструкторе автоматизации CRM:
| Поле | Что указать |
|---|---|
| Значение | Текст для склонения. Обычно подставляется поле сделки —
например {{Контакт: Имя}}. Обязательное поле. |
| Тип значения |
ФИО — фамилия, имя, отчество или их часть. Географическое название — город, страна, область. Существительное — должность, название товара, произвольное слово. Число прописью (сколько?) — количественное числительное: «пятьсот шестьдесят семь». Число прописью (который?) — порядковое числительное: «девятьсот шестьдесят первый». Сумма прописью — денежная сумма: «одна тысяча двести тридцать четыре рубля пятьдесят копеек». |
| Падеж | Один из шести. Чаще всего нужен родительный («для кого») или дательный («кому»). |
| Регистр букв | Что сделать с регистром уже склонённого значения. По умолчанию
«Как есть» — робот его не трогает. Первая заглавная — заглавной становится первая буква строки, остальные приводятся к строчным: «генеральному директору» → «Генеральному директору». Вариант для начала предложения. Строчные — всё значение строчными: когда результат встаёт в середину фразы. Заглавные — всё значение заглавными: для шапок документов и заголовков. Регистр меняется последним, уже после склонения, поэтому на его качество не влияет. Работает для любого типа значения, включая числа и суммы прописью. «Как есть» означает, что регистр не меняет робот. Типы «ФИО» и «Географическое название» библиотека всё равно приводит к виду «Иванов», «Нижний Новгород» — для имён и названий это часть склонения. Должности и произвольные слова склоняйте типом «Существительное»: там регистр сохраняется. |
| Род или пол | Для ФИО — пол: мужской, женский или автоопределение по имени (умолчание).
Указывайте вручную, если имя редкое или иностранное и автоопределение
ошибается. Для чисел — грамматический род: мужской, женский или средний, в зависимости от того, к какому слову относится число. Средний род без автоопределения — по умолчанию используется мужской. Для сумм поле не используется: род валюты библиотека знает сама. |
| Одушевлённость | Только для типа «Существительное». Различие видно в винительном падеже: «вижу генерального директора», но «вижу новый холодильник». В остальных пяти падежах поле ни на что не влияет, поэтому по умолчанию стоит «Неодушевлённое». Автоматически это не определяется: по написанию слова одушевлённость не выводится. |
| Валюта | Только для типа «Сумма прописью». По умолчанию «Определить из значения» —
денежные поля Битрикса приходят в виде 1000|RUB, и код
валюты робот берёт прямо оттуда, выбирать ничего не нужно. Если в поле
передано число без кода валюты, робот считает сумму рублёвой и ничего
об этом не сообщает. Выбирайте валюту вручную, когда сумма не в рублях,
а кода в значении нет. |
| Формат суммы | Только для типа «Сумма прописью». По умолчанию «Полностью словами». Всего пять вариантов: полностью словами, цифрами с расшифровкой, бухгалтерский, словами с дублированием и кратко — расшифровка каждого с примером есть прямо в списке выбора поля. |
| Результат | Значение |
|---|---|
| Результат | Склонённая строка. Подставляйте её в следующих шагах автоматизации — в письме, задаче, уведомлении. |
| Успешно | Y или N. При N
в поле «Результат» лежит исходное значение без изменений, а причина записана
в журнал бизнес-процесса. |
| Значение | Тип | Падеж | Результат |
|---|---|---|---|
| Иванов Иван Иванович | ФИО | Дательный | Иванову Ивану Ивановичу |
| Базанов Иосиф Валерьянович | ФИО | Родительный | Базанова Иосифа Валерьяновича |
| Москва | Географическое | Винительный | Москву |
| поле | Существительное | Родительный | поля |
| генеральный директор | Существительное | Дательный | генеральному директору |
| генеральный директор | Существительное, одушевлённое | Винительный | генерального директора |
| генеральный директор | Существительное, регистр «Первая заглавная» | Дательный | Генеральному директору |
| Иванов Иван | ФИО, регистр «Заглавные» | Родительный | ИВАНОВА ИВАНА |
| 567 | Число (сколько?) | Родительный | пятисот шестидесяти семи |
| 21 | Число (сколько?), женский род | Именительный | двадцать одна |
| 961 | Число (который?) | Именительный | девятьсот шестьдесят первый |
| 1234.50 | Сумма | Именительный | одна тысяча двести тридцать четыре рубля пятьдесят копеек |
1000|RUB, и робот читает код валюты прямо из значения — тогда
выбирать ничего не нужно. Если же в поле передано число без кода валюты, робот
считает сумму рублёвой: сумма в долларах станет «рублями», и ошибки при этом
не будет. Выбирайте валюту в настройках вручную, когда сумма не в рублях, а
кода в значении нет.
| Симптом | Что проверить |
|---|---|
| Робота нет в списке | Приложение устанавливает только администратор портала. Проверьте, что установка завершилась успешно, и переоткройте конструктор роботов. |
| Робот отработал, но значение не изменилось | Посмотрите «Успешно». Если N — причина в журнале
бизнес-процесса. Частая причина: пустое значение на входе или
несклоняемое слово. |
| Каждое слово вернулось с заглавной буквы | Выбран тип «ФИО» или «Географическое название» — для них библиотека приводит каждое слово к виду «Иванов», это часть склонения имени, а не работа поля «Регистр букв». Должности, товары и произвольные слова склоняйте типом «Существительное»: «Исполнительный директор» → «Исполнительного директора», а не «Исполнительного Директора». |
| Слово склонилось почти правильно, но с ошибкой в середине | Там же: проверьте тип значения. «Старший менеджер» типом «ФИО» даёт «Старшого Менеджера» — библиотека разбирает первое слово как фамилию, а второе как имя. Типом «Существительное» получается «Старшего менеджера». |
| Сделка встала на стадии с роботом | Обратитесь к администратору: нужно проверить журнал приложения на стороне сервера. Робот спроектирован так, чтобы всегда отвечать, поэтому зависание означает, что ответ не дошёл до портала. Причина записывается в журнал рядом с самим запросом — обычно это истёкший токен, превышенный лимит запросов или уже завершившийся шаг процесса. |
Склонение, а также запись чисел и сумм прописью выполняет открытая библиотека morphos — морфологическая библиотека для русского языка на PHP. Приложение выбирает нужный её алгоритм по типу значения и возвращает результат в бизнес-процесс.
Автор библиотеки — Сергей Ванюшин (wapmorgan), лицензия MIT.
| Что | Где |
|---|---|
| Исходный код | github.com/wapmorgan/morphos |
| Пакет Composer | wapmorgan/morphos |
| Сайт проекта | morphos.io |