Обновлено: 25.04.2022

Внешний компонент "Склонение ФИО" (Native API)

Внешний компонент предназначен для склонения сочетаний фамилий, имен и отчеств на русском языке. Компонент может быть использован в конфигурациях "1С:Предприятия 8".

Компонент предоставляет прикладному разработчику метод Просклонять (Decline), который производит склонение ФИО, представленного в виде строки, в требуемом падеже.

Описание метода "Просклонять"

Просклонять(ФИО, Падеж, Пол)

Параметры
ФИО (обязательный), тип - строка.
Параметр должен содержать фамилию, имя и отчество в именительном падеже единственного числа. Строка должна состоять только из букв русского алфавита, пробелов и дефисов. Фамилия, имя и отчество должны разделяться пробелами. Внутри фамилии, имени и отчества пробелов быть не должно.
Допустимы следующие сочетания фамилии, имени и отчества: ФИО, ИОФ, ИО, ИФ, ФИ, Ф, И, О. Двойные и тройные имена и фамилии должны писаться через дефис, например: Попов-Левин, Анна-Роза-Мария. Имена и отчества должны быть полными.

Падеж (обязательный), тип - число.
Падеж, в который необходимо поставить ФИО. Падеж задается числом и может принимать следующие значения:

Значение	Падеж
1	Именительный
2	Родительный
3	Дательный
4	Винительный
5	Творительный
6	Предложный

Пол (необязательный), тип - число.
Возможные значения: 0 – авто, 1 - мужской, 2 – женский.
Данный параметр предназначен для разрешения возможных неоднозначностей, например, имя Карен Акопян может принадлежать и мужчине, и женщине и в зависимости от этого склоняться или не склоняться. В остальных случаях рекомендуется опускать этот параметр или использовать значение 0 ("авто"), т. к. неправильное указание пола может повлиять на правильность склонения.

Возвращаемое значение
Функция возвращает результат склонения, тип - строка.
Строка, содержащая исходное ФИО в заданном падеже. В случае ошибки во входных данных компонент использует интерфейс IErrorLog для передачи сообщений об ошибках "1С:Предприятию". При этом сообщение об ошибке выводится в окно сообщений.

Пример использования внешнего компонента в среде "1С:Предприятия 8"

Приведенный ниже фрагмент кода на встроенном языке "1С:Предприятия 8" устанавливает, подключает компонент и, используя метод компонента Просклонять, получает форму родительного падежа для ФИО "Иванов Иван Иванович".

Копировать в буфер обмена

УстановитьВнешнююКомпоненту("ОбщийМакет.Макет");
Попытка
    // Подключаем внешнюю компоненту
    ПодключитьВнешнююКомпоненту("ОбщийМакет.Макет", "NameDecl",ТипВнешнейКомпоненты.Native ) 
    Объект = Новый(""AddIn.NameDecl.CNameDecl");
Исключение
    // Не удалось выполнить операции с внешней компонентой
    Сообщить("Не удалось подключить внешнюю компоненту по причине: " + ОписаниеОшибки()); 
КонецПопытки;
 
// Определяем ФИО, которые нужно просклонять
СтрокаФИО = "Иванов Иван Иванович"; 
// Задаем требуемый падеж
Падеж = 2;  

// Получаем результат склонения
РезультатСклонения = Объект.Просклонять(СтрокаФИО, Падеж);

Внешний компонент находится в каталоге \1CITS\EXE\APPEXTCOMP.

ВЫ МОЖЕТЕ ПРЯМО СЕЙЧАС СКОПИРОВАТЬ ВНЕШНИЙ КОМПОНЕНТ
НА ЖЕСТКИЙ ДИСК ВАШЕГО КОМПЬЮТЕРА

Копировать