Обновлено: 07.01.2025

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

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

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

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

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

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

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

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

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

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

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

Для вывода на печать многочисленных печатных форм в ЗУП 3.1 часто бывает необходимо использовать различные падежи имен существительных – фамилий, имен, отчеств, должностей, подразделений. Я расскажу о том, как склоняются представления объектов в ЗУП 3.1.

Что склоняется?

Есть 2 типа объектов, наименования которых склоняются различными механизмами в ЗУП 3.1:

1. ФИО физических лиц;
2. остальные объекты.

ФИО физических лиц склоняются самой программой. В ЗУП 3.1 существует собственный алгоритм, который превращает фамилии, имена и отчества из именительного падежа в любой другой падеж русского языка. При этом используется пол физического лица (мужской или женский).

Все остальные имена существительные (в частности, наименования должностей и подразделений) склоняются с помощью внешнего сервиса «Морфер».

Подключение сервиса находится в разделе «Администрирование – Интернет-поддержка и сервисы – Склонения представлений объектов».

Рис. 1. Подключение сервиса «Морфер»

Анонимного входа на сервис вполне достаточно для работы.

Как просклонять имя?

В карточке нового сотрудника после ввода фамилии, имени и отчества нажмите гиперссылку «Склонения» (см. рис. 2).

Рис. 2. Склонение фамилий, имен и отчеств сотрудников

Откроется окно с уже заполненными значениями по всем падежам. Останется только записать их, нажав кнопку «ОК».

ФИО физических лиц в падежных формах хранится в регистре сведений «Склонения представлений объектов».

Как это работает?

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

Если в регистре нет записи по искомому ФИО, то программа просклоняет его «на лету».

Рис. 3. Регистр сведений «Склонения представлений объектов»

Посмотрим на регистр сведений изнутри – из Конфигуратора.

Рис. 4. Регистр сведений «Склонения представлений объектов» - тип измерения «Объект»

Измерение «Объект» имеет тип «ОбъектСклонения» – это определяемый тип (см. рис. 5), в состав которого входят:

• Физические лица
• Должности
• Подразделения
• Позиции штатного расписания

Рис. 5. Состав определяемого типа «ОбъектСклонения»

Именно эти объекты конфигурации могут склоняться. В карточке каждого из них есть гиперссылка «Склонения», по нажатию на которую открывается форма со всеми падежами.

На рис. 6 видно, как просклонялось наименование должности «Ведущий инженер» при включенном сервисе «Морфер».

Рис. 6. Склонения элемента справочника «Должности»

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

Программный вызов функции склонения объектов

Функции склонения представлений объектов находятся в общем модуле «СклонениеПредставленийОбъектов».

Функция ПросклонятьФИО(ФИО, Падеж, Объект = Неопределено, Пол = Неопределено) Экспорт

Описание:
– Склоняет ФИО.
– Только для работы на ОС Windows..
.
Параметры:
ФИО - Строка - Строка, в которой содержится ФИО для склонения.
Падеж - Число - падеж, в который необходимо просклонять представление объекта.
1 - Именительный.
2 - Родительный.
3 - Дательный.
4 - Винительный.
5 - Творительный.
6 - Предложный.
Объект - ОбъектСклонения - Ссылка на объект, реквизит которого склоняется.
Пол - Число - Число - пол физического лица,
1 - мужской,
2 - женский.

Возвращаемое значение:
Строка - Результат склонения ФИО в падеже.

Пример вызова функции склонения ФИО сотрудника

Описание:
– Склоняет представление объекта.
– Только для работы на ОС Windows.

Параметры:
Представление - Строка - Строка, в которой содержится ФИО для склонения.
Падеж - Число - падеж, в который необходимо просклонять представление объекта.
1 - Именительный.
2 - Родительный.
3 - Дательный.
4 - Винительный.
5 - Творительный.
6 - Предложный.
Объект - ОбъектСклонения - Ссылка на объект, реквизит которого склоняется.

Обе функции после успешного выполнения и при заполненном параметре «Объект» записывают полученное значение в регистр сведений «СклоненияПредставленийОбъектов».

Несколько слов в заключение

Склонение представлений объектов – это часть БСП. Данный механизм встроен также и в другие типовые конфигурации, построенные на основе БСП – БП, КА, ERP и т.д.

Картинки и примеры взяты из демо-базы конфигурации «Зарплата и управление персоналом», редакция 3.1 (3.1.7.87). Платформа: 1С:Предприятие 8.3 (8.3.10.2699)

Для работы с ней необходима БСП 3.0.1.355, на других версиях не тестировалась.

При загрузке обработки в конфигурацию, необходимо перенести все процедуры и функции из модуля объекта в модуль менеджера.

Специальные предложения

Просмотры 3223

Загрузки 3

Рейтинг 1

Создание 08.04.19 12:35

Обновление 08.04.19 12:35

№ Публикации 1039952

Конфигурация Конфигурации 1cv8

Операционная система Не имеет значения

Страна Россия

Вид учета Не имеет значения

Доступ к файлу Абонемент ($m)

Код открыт Да

См. также

Модуль обмена с QIWI Промо

Компании, которые используют систему моментальных платежей QIWI, ценят ее за удобство по скорости выплат и для платежей по запросу. Но такие переводы сложны для учета, а при большом объеме проводимых операций отнимают много времени и превращаются в дополнительную головную боль. Мы сотрудничали с компаниями, которые отправляют большое количество платеже на QIWI, и часто слышали боль бухгалтеров о том, как им сложно работать с такими переводами. Поэтому мы автоматизировали выплаты через QIWI в 1С и создали модуль интеграции 1С c API QIWI Wallet и QIWI TopUp.

5 стартмани

25.05.2020 8219 0 Neti 10

Расширение конфигурации для Web-доступа к 1С (1С в роли back-end)

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

1 стартмани

01.04.2021 8851 11 SaschaG 4

Работа с картами в 1С на примере бесплатной библиотеки Leaflet

Разработка функционала отображения и выбора пунктов доставки на карте прямо в 1С с помощью бесплатной библиотеки Leaflet. Тестирование производилось на платформе 8.3.15.1534 на тонком клиенте.

1 стартмани

31.03.2021 10499 31 Parsec1C 11

1 стартмани

24.03.2021 7138 13 ltfriend 12

BIM: взаимодействие с платформой Autodesk Forge Промо

Предлагаемый пример демонстрирует широкие возможности для взаимодействия «1С:Предприятие» с платформой Autodesk Forge и позволяет вам получить базовые представления о применения технологий информационного моделирования в строительстве. Поддерживаются все версии платформы от 8.3.12 и выше до 8.3.18.

Например, на входе:

ведущий инженер-программист III категории

И.	ведущий инженер-программист III категории	ведущие инженеры-программисты III категории
Р.	ведущего инженера-программиста III категории	ведущих инженеров-программистов III категории
Д.	ведущему инженеру-программисту III категории	ведущим инженерам-программистам III категории
В.	ведущего инженера-программиста III категории	ведущих инженеров-программистов III категории
Т.	ведущим инженером-программистом III категории	ведущими инженерами-программистами III категории
П.	о ведущем инженере-программисте III категории	о ведущих инженерах-программистах III категории

Род: мужской

Число поддерживаемых типов слово сочетаний не ограничено фамилиями и должностями. Программа умеет склонять также названия подразделений, юридических лиц, географические названия и многое другое. Высокое качество склонения обеспечивается использованием словарей, в частности, «Словаря имен собственных» Ф.Л. Агеенко на 38 000 единиц. За 9 лет работы над «Морфером» было составлено более 27 000 примеров склонения для русского и более 11 000 для украинского языка. База примеров постоянно пополняется и используется для контроля качества продукта.

Веб-сервис также реализует функцию прописи чисел и денежных сумм в произвольном падеже, позволяющую формировать такие фразы как: «в течение 7 (Семи) календарных дней» («21 календарного дня»), «в размере 1000 (Одной тысячи) рублей» («десяти тысяч рублей») и т.п. Склонение единицы измерения также осуществляется автоматически. Нет необходимости указывать заранее все падежные формы ("рубль", "рубля", "рублей").

Быстрый старт: склонение должности

Программа для склонения должности будет выглядеть так:

Для украинского языка функция склонения называется СклонятьУкраинский:

Украинская версия пока лучше всего справляется с фамилиями, именами и отчествами. Работа над другими типами словосочетаний ведется.

Для улучшения качества склонения можно передавать признаки.

На данный момент доступны след. признаки: name, feminine, masculine, neuter, animate, inanimate, common, plural.

Функция построения прописи числа в любом падеже

Функция ПрописьРусский (ПрописьУкраинский) решает две родственные задачи: получение прописи числа (тысяча сто двадцать пять) и согласование единицы измерения с предшествующим числом (1 попугай, 2 попугая, 5 попугаев). Пример:

Функция принимает два аргумента:

n – целое положительное число.

unit – единица измерения – слово или словосочетание в именительном падеже единственного числа: «рубль», «доллар США», «календарный день», «новое письмо» и т.п. Если слово употребляется только во множественном числе, то указывается форма именительного падежа множественного числа: «сутки», «брюки», «ножницы».

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

Комбинировать имеет смысл только соответствующие падежные формы n и unit – именительный с именительным, родительный с родительным и т.д. Например, для получения фразы "в размере N рублей (долларов, евро. )", берем родительный падеж (Р): в размере + двухсот тридцати пяти + рублей.

Склонение прилагательных по родам

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

Авторизация

Для получения доступа к тегам род, откуда, куда, где, а так же снять ограничение на кол-во запросов в сутки, нужно купить подписку на сайте Морфер.Авторизация("ваш токен");

Обработка ошибок

В данном случае ошибка возникла из-за того, что склоняемая строка не содержит ни одного русского слова. Другой возможный случай – когда склоняемая строка содержит количественное числительное («тридцать три коровы»). Такие словосочетания программа не обрабатывает, выдается ошибка.

Совместимость и устранение неполадок

Модуль выпускается в двух вариантах для 8.3.16 и 8.2. Версии отличаются только тем, что версия 8.3.16 использует встроенный десериализатор JSON.

Оперативное исправление ошибок склонения

Склонение как языковой феномен изобилует неоднозначностями, особенно в области имен собственных. В городе Москва или в городе Москве? В республике Корея или в республике Корее? В Тушино или в Тушине? Обладатели «диковинных» фамилий часто не любят, чтобы их склоняли. Скажем, если у человека фамилия Груздь, он будет требовать, чтобы его фамилию не склоняли, часто вопреки правилам русского языка и всеобщему мнению. Но если он ваш начальник, то неизвестно еще, кто останется Груздём, если вы позволите себе просклонять его в договоре.

Не секрет, что алгоритм автоматического склонения тоже может ошибаться – не знать какого-либо слова или запутаться в сложной синтаксической структуре. Что делать, если машина склоняет не так, как надо, а документ должен быть на столе у начальника через 10 минут? Хорошо, если система позволяет вручную исправлять документ после его выдачи. Но исправлять фамилию начальника в каждом приказе тоже не дело. Традиционное решение этой проблемы (если руки дойдут до его реализации) – хранение падежных форм в таблице-справочнике, которая заполняется вручную.

Установка веб-сервиса в вашей локальной сети

Многие пользователи веб-сервиса высказывали желание иметь «такой же сервис, только у себя», т.е. иметь возможность развернуть веб-сервис в своей локальной сети. Это решило бы проблему с использованием веб-сервиса на рабочих местах, где нет доступа к Интернету, а также проблему с законом «О защите персональных данных», требующим обеспечения конфиденциальности таких данных.

В ответ на эти пожелания был создан вариант веб-сервиса, допускающий установку на сервере в локальной сети предприятия или непосредственно на машине пользователя, если пользователь один. Новый продукт получил название «Морфер.Сервер». Он реализует те же функции, что и общедоступный веб-сервис, включая функцию поддержания пользовательского словаря, и работает в сотни раз быстрее из-за того, что локальная сеть быстрее Интернета.

Для переключения с «глобального» на «локальный» сервис достаточно изменить код следующим образом:

Здесь comp001 – это сетевое имя компьютера, где установлен веб-сервис. Во второй строчке изменять ничего не нужно.

* Количество плюсов и минусов дано на момент публикации.

В «Морфере» учтены многие пожелания к системам подобного рода, а именно:

Кроме того, отличительными особенностями «Морфера» являются:

1. Простой API: склонение всех типов словосочетаний производится одной функцией. Нет необходимости указывать тип словосочетания (ФИО, должность, подразделение. )
2. Не требуется указание пола. Наоборот, программа автоматически определяет и выдает грамматический род словосочетания, по которому однозначно определяется пол лица.
3. Высокое качество склонения, достигаемое использованием комбинированного подхода – алгоритмы для кодирования правил и словари для учета исключений. «Морфер» вобрал в себя несколько многотысячных словарей, годы кропотливой работы, учета замечаний и пожеланий пользователей.

Жду новых ваших пожеланий и замечаний. Именно они мотивируют меня развивать продукт дальше.

Читайте также:

  
• 1с получить данные из табличного документа
  
• 1с комплексная автоматизация чем отличается от упп
  
• Программа для построения 3д моделей молекул органических веществ
  
• Как обрезать картинку по контуру в paint без белого фона
  
• Опен офис эксель сортировка