Как исправить ошибки и корректно использовать функцию ПолучитьСклоненияСтроки в 1С

← На главную

С выходом платформы 1С:Предприятие 8.3.13 разработчики получили долгожданный встроенный инструмент для склонения слов и фраз — функцию ПолучитьСклоненияСтроки. Она избавила нас от необходимости подключать внешние компоненты вроде Namedecl.dll или использовать самописные алгоритмы для склонения ФИО и должностей. Однако, как показывает практика и обсуждения на форумах, работа этого механизма в ранних версиях (8.3.13–8.3.17) сопровождалась критическими ошибками, включая аварийное завершение работы сервера. В этой статье мы подробно разберем все известные проблемы данной функции и найдем способы их решения.

Анализируем критическую ошибку: «Неисправимая ошибка на сервере»

Одной из самых серьезных проблем, с которой столкнулись программисты, стало падение сеанса при попытке просклонять определенные сочетания слов. Проанализируем ситуацию на конкретном примере. При передаче в функцию строки "Яц Михаил Александрович" в версиях платформы ниже 8.3.15.1914 сеанс 1С мгновенно закрывается с сообщением о неисправимой ошибке. Это происходит из-за внутреннего сбоя в лингвистическом модуле, который не может корректно обработать короткие или нестандартные фамилии.

Решение проблемы: Данная ошибка официально признана разработчиками 1С (ID: 10214652). Единственным надежным способом устранения этого «вылета» является обновление платформы. Стабильная работа функции наблюдается в версиях 8.3.16.1224, 8.3.17.1851 и всех последующих ветках 8.3.18+. Если в вашей организации используется старый релиз платформы, мы настоятельно рекомендуем выполнить обновление серверной и клиентской части.

Разбираем ошибку «Непарные скобки или кавычки»

Часто при работе с адресами или наименованиями контрагентов (например, "Обособленное подразделение Космическая, 15/1") функция возвращает исключение: «Словосочетание содержит непарные скобки или кавычки». Выясним причину: парсер платформы воспринимает знаки препинания (запятые, косую черту, точки) как структурные разделители. Если алгоритм не может однозначно определить границы слов из-за этих символов, выполнение прерывается.

Рассмотрим, как можно обойти это ограничение программно. Мы рекомендуем перед передачей данных в функцию выполнять предварительную очистку строки от символов, которые могут «запутать» парсер. Посмотрим на пример кода:


Функция БезопасноеСклонение(Знач ВходнаяСтрока, Падеж)
    // Убираем символы, вызывающие ошибки парсера
    СтрокаДляОбработки = СтрЗаменить(ВходнаяСтрока, "/", " ");
    СтрокаДляОбработки = СтрЗаменить(СтрокаДляОбработки, ",", "");
    СтрокаДляОбработки = СтрЗаменить(СтрокаДляОбработки, "(", "");
    СтрокаДляОбработки = СтрЗаменить(СтрокаДляОбработки, ")", "");
    
    Попытка
        Результат = ПолучитьСклоненияСтроки(СтрокаДляОбработки, , "ПД=" + Падеж);
        Возврат Результат[0];
    Исключение
        // Если ошибка всё равно возникла, возвращаем исходную строку
        Возврат ВходнаяСтрока;
    КонецПопытки;
КонецФункции

Проблема омонимии: почему «листы» превращаются в «листья»

Еще одна интересная особенность встроенного механизма — работа с омонимами. Разберем пример со словом "лист" в техническом контексте (например, количество листов в приложении к документу). При использовании ПолучитьСклоненияСтрокиПоЧислу в предложном падеже система может выдать результат: «на трех листьях» вместо «на трех листах».

Это происходит потому, что лингвистический модуль по умолчанию отдает приоритет биологическому значению слова (листва дерева). Поскольку в платформе нет возможности указать контекст использования слова, нам придется корректировать такие случаи вручную или использовать более сложные форматные строки. Проанализируем, как можно решить эту задачу:

Ручная подмена: Создайте таблицу соответствий для проблемных слов, которые часто встречаются в вашей предметной области.
Склонение по частям: Склоняйте только число, а существительное добавляйте из заранее подготовленного списка окончаний.

Использование сервиса «Морфер» как альтернативы

В типовых конфигурациях, таких как «Бухгалтерия предприятия 3.0» или «Зарплата и управление персоналом 3.1», реализован механизм обхода встроенных ошибок платформы через использование внешнего сервиса Морфер. Рассмотрим, как это работает. В конфигурации существует константа ИспользоватьСервисСклоненияМорфер. Если она включена, система отправляет запрос к API облачного сервиса, который гораздо точнее справляется со сложными фамилиями, должностями и адресами.

Важный нюанс: Для работы этого механизма серверу 1С требуется доступ в интернет. Если доступ ограничен или превышен лимит бесплатных запросов к сервису, система автоматически откатится к использованию встроенной функции ПолучитьСклоненияСтроки. Это объясняет, почему ошибки склонения могут появляться эпизодически.

Особенности работы на серверах под управлением Linux

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

В системе должна быть установлена локаль ru_RU.UTF-8. Проверить это можно командой locale -a в терминале Linux.
Убедитесь, что установлена библиотека libicu (версия зависит от релиза платформы). Без нее механизмы анализа текста в 1С работать не будут.
Проверьте права доступа к временным папкам (/tmp), так как платформа может распаковывать туда словари при первом вызове функции.

Практические советы по оптимизации

Функция ПолучитьСклоненияСтроки является ресурсоемкой, так как требует обращения к внутренним словарям и проведения сложного морфологического анализа. Если вам нужно просклонять список из тысяч сотрудников, это может существенно замедлить формирование отчета. Рассмотрим лучшие практики оптимизации:

Кэширование результатов: Не вызывайте склонение для одного и того же сотрудника или должности многократно. Создайте в системе РегистрСведений (например, «КэшСклонений»), где будете хранить уже полученные результаты. Перед вызовом функции всегда проверяйте наличие значения в кэше.

Склонение ФИО по частям: Для повышения точности рекомендуется передавать в функцию не цельную строку, а структуру. Используйте параметр ОписаниеСтроки, в котором явно указаны Фамилия, Имя и Отчество. Это исключит ситуацию, когда редкая фамилия ошибочно принимается за название предмета или должности.

Посмотрим на пример правильного вызова для ФИО:


ОписаниеФИО = Новый Структура;
ОписаниеФИО.Вставить("Фамилия", "Яц");
ОписаниеФИО.Вставить("Имя",     "Михаил");
ОписаниеФИО.Вставить("Отчество", "Александрович");

Результат = ПолучитьСклоненияСтроки(ОписаниеФИО, , "ПД=Дательный");
// В актуальных версиях платформы это отработает корректно

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