Внешний компонент предназначен для склонения сочетаний фамилий, имен и отчеств на русском языке. Компонент может быть использован в конфигурациях "1С:Предприятия 7.7" и " 1С:Предприятия 8".
Компонент предоставляет прикладному разработчику метод Просклонять ( Decline ) , который производит склонение ФИО, представленного в виде строки, в требуемом падеже.
Описание метода "Просклонять"
Просклонять(ФИО, Падеж, Пол)
Параметры
ФИО (обязательный), тип — строка .
Параметр должен содержать фамилию , имя и отчество в именительном падеже единственного числа. Строка должна состоять только из букв русского алфавита, пробелов и дефисов. Фамилия, имя и отчество должны разделяться пробелами. Внутри фамилии, имени и отчества пробелов быть не должно.
Допустимы следующие сочетания фамилии, имени и отчества: ФИО, ИОФ, ИО, ИФ, ФИ, Ф, И, О. Двойные и тройные имена и фамилии должны писаться через дефис, например: Попов-Левин , Анна-Роза-Мария . Имена и отчества должны быть полными.
Падеж (обязательный), тип — число.
Падеж, в который необходимо поставить ФИО. Падеж задается числом и может принимать следующие значения:
| Значение | Падеж |
|---|---|
| 1 | Именительный |
| 2 | Родительный |
| 3 | Дательный |
| 4 | Винительный |
| 5 | Творительный |
| 6 | Предложный |
Пол ( необязательный), тип — число.
Возможные значения : 0 – авто, 1 — мужской, 2 – женский.
Данный параметр предназначен для разрешения возможных неоднозначностей, например, имя Карен Акопян может принадлежать и мужчине, и женщине и в зависимости от этого склоняться или не склоняться. В остальных случаях рекомендуется опускать этот параметр или использовать значение 0 ("авто"), т. к. неправильное указание пола может повлиять на правильность склонения.
Возвращаемое значение
Функция возвращает результат склонения, тип — строка.
Строка, содержащая исходное ФИО в заданном падеже. В случае ошибки во входных данных компонент использует интерфейс IErrorLog для передачи сообщений об ошибках "1С:Предприятию". При этом сообщение об ошибке выводится в окно сообщений.
Пример использования внешнего компонента в среде "1С:Предприятия 8.0"
Приведенный ниже фрагмент кода на встроенном языке "1С:Предприятия 8.0" загружает компонент и, используя метод компонента Просклонять , получает форму родительного падежа для ФИО "Иванов Иван Иванович".
Внешний компонент находится в каталоге 1CITSEXEAPPEXTCOMP.
При работе в 1С пользователь сталкивается с вопросом склонения фамилии или должности сотрудника в печатных формах документов, то есть с ситуацией, когда надо выполнить склонение фамилий по падежам.
Для склонения ФИО в программах 1С предусмотрена внешняя компонента – NameDecl.dll, в которой содержится функция склонения. Ее можно взять на диске ИТС и, скопировав в папку с установленной платформой 1С – bin, зарегистрировать ее в операционной системе. Выполняется данная процедура при помощи команды resvr32 NameDecl.dll (под учетной записью администратора). Для этого необходимо вызвать команду «Выполнить» через кнопку «Пуск», воспользовавшись поиском или сочетание клавиш Windows + R.
Рис.1 Окно поиска. Поиск команды «Выполнить»
В появившемся окне вводим команду resvr32.exe и указываем путь к подключаемой библиотеке, используя кнопку «Обзор».
Рис.2 Окно команды «Выполнить»
После нажатия «Ок» появится сообщение о том, что библиотека успешно зарегистрирована.
Рис.3 Окно сообщения
Для данной библиотеки необходимо использовать 32-битную платформу 1С клиент-серверного режима.
Описание метода склонения в 1С
Просклонять (ФИО, Падеж, Пол) по параметрам:
- ФИО (обязательный), тип – строка
- Падеж (обязательный), тип – число
Падеж, в который необходимо поставить ФИО, задается числом от 1 до 6.
Потребность в склонении фамилий, имен, отчеств, улиц, городов, должностей, званий и всего прочего возникает регулярно. И для решения этой задачи существуют проверенные и зарекомендовавшие себя способы. С выходом платформы 8.3.13 к этим способам добавился еще один — склонение средствами платформы, и именно этот способ видится наиболее правильным и удобным. Этот и прочие, достойные упоминания (по моему субъективному мнению), способы будут рассмотрены ниже.
Внешняя компонента
Начнем с самого, вероятно, популярно на сегодняшний день способа — внешняя компонента «Склонение ФИО». Эта компонента существует в двух вариантах: по технологии COM и по технологии Native API. Вариант выполненный по технологии Native API современнее и предпочтительнее.
При скачивании с сайта ИТС мы получаем архив который содержит файл «NAMEDECL.DLL» и файл «NameDecl.zip». Первый файл — это компонента по технологии COM, а второй файл — это архив содержащий компоненту по технологии Native API (он так и используется в архиве).
Компоненту выполненную по технологии COM сначала нужно зарегистрировать, командой «regsvr32» от имени администратора:
Регистрация внешней компоненты