Внешний компонент предназначен для склонения сочетаний фамилий, имен и отчеств на русском языке. Компонент может быть использован в конфигурациях "1С:Предприятия 7.7" и "1С:Предприятия 8".
Компонент предоставляет прикладному разработчику метод Просклонять (Decline), который производит склонение ФИО, представленного в виде строки, в требуемом падеже.
Просклонять(ФИО, Падеж, Пол)
Параметры
ФИО (обязательный), тип - строка.
Параметр должен содержать фамилию, имя и отчество в именительном падеже единственного числа. Строка должна состоять только из букв русского алфавита, пробелов и дефисов. Фамилия, имя и отчество должны разделяться пробелами. Внутри фамилии, имени и отчества пробелов быть не должно.
Допустимы следующие сочетания фамилии, имени и отчества: ФИО, ИОФ, ИО, ИФ, ФИ, Ф, И, О. Двойные и тройные имена и фамилии должны писаться через дефис, например: Попов-Левин, Анна-Роза-Мария. Имена и отчества должны быть полными.
Падеж (обязательный), тип - число.
Падеж, в который необходимо поставить ФИО. Падеж задается числом и может принимать следующие значения:
| Значение | Падеж |
|---|---|
| 1 | Именительный |
| 2 | Родительный |
| 3 | Дательный |
| 4 | Винительный |
| 5 | Творительный |
| 6 | Предложный |
Пол (необязательный), тип - число.
Возможные значения: 0 – авто, 1 - мужской, 2 – женский.
Данный параметр предназначен для разрешения возможных неоднозначностей, например, имя Карен Акопян может принадлежать и мужчине, и женщине и в зависимости от этого склоняться или не склоняться. В остальных случаях рекомендуется опускать этот параметр или использовать значение 0 ("авто"), т. к. неправильное указание пола может повлиять на правильность склонения.
Возвращаемое значение
Функция возвращает результат склонения, тип - строка.
Строка, содержащая исходное ФИО в заданном падеже. В случае ошибки во входных данных компонент использует интерфейс IErrorLog для передачи сообщений об ошибках "1С:Предприятию". При этом сообщение об ошибке выводится в окно сообщений.
Приведенный ниже фрагмент кода на встроенном языке "1С:Предприятия 8.0" загружает компонент и, используя метод компонента Просклонять, получает форму родительного падежа для ФИО "Иванов Иван Иванович".
Копировать в буфер обмена// Определяем имя внешней компоненты Компонента = "NameDecl.dll"; Попытка // Загружаем внешнюю компоненту ЗагрузитьВнешнююКомпоненту(Компонента); Объект = Новый("AddIn.NameDeclension"); Исключение // Не удалось выполнить операции с внешней компонентой Сообщить("Не удалось загрузить внешнюю компоненту по причине: " + ОписаниеОшибки()); КонецПопытки; // Определяем ФИО, которые нужно просклонять СтрокаФИО = "Иванов Иван Иванович"; // Задаем требуемый падеж Падеж = 2; // Получаем результат склонения РезультатСклонения = Объект.Просклонять(СтрокаФИО, Падеж);
Внешний компонент находится в каталоге \1CITS\EXE\APPEXTCOMP.
ВЫ МОЖЕТЕ ПРЯМО СЕЙЧАС СКОПИРОВАТЬ ВНЕШНИЙ КОМПОНЕНТ
НА ЖЕСТКИЙ ДИСК ВАШЕГО КОМПЬЮТЕРА