Версия 1.0.0.1
Оглавление
- Конфигурация "Конструктор заполнения объектов"
БСП - "Библиотека специальных подсистем" компании 1С
Конфигурация - конфигурация "Конструктор заполнения объектов"
Конструктор заполнения - подсистема "Конструктор заполнения объектов" из Конфигурации
Правило заполнения - объект справочника "Правила заполнения (кзо)" входящий в состав конфигурации "Конструктор заполнения объектов"
Правило проверки - объект справочника "Правила проверки заполнения (кзо)" входящий в состав конфигурации "Конструктор заполнения объектов"
ПВХ - План видов характеристик - вид объекта метаданных 1С:Предприятие
Для установки конфигурации требуется:
- Выполнить сравнение и объединение Основной конфигурации 1С с файлом
1Cv8.cfиз поставки Конфигурации. - Требуется снять все пометки объектов к объединению
- Выбрать в меню "Действия" пункт "Установить по подсистемам файла"
- Выбрать в меню "Действия" пункт "Установить по подсистемам основной конфигурации"
- Выбрать только одну подсистему
кзоКонструкторЗаполненияОбъектов - Нажать кнопку "Выполнить"
После установки Конфигурации требуется настроить объекты с которыми будет работать Конструктор заполнения, для этого нужно найти следующие определяемые типы и установить в них объекты базы данных:
кзоОбъектыДляЗаполнения- объекты для механизма "Правила заполнения"кзоОбъектыПроверкиЗаполнения- объекты для механизма "Правила проверки заполнения"кзоОбъектыСобытийФорм- объекты для механизма "События элементов форм"
Для корректного обновления конфигурации "Конструктор заполнения" нужно добавить подсистему в БСП, для этого добавить в методе ПодсистемыКонфигурацииПереопределяемый.ПриДобавленииПодсистем() следущий код:
// КонструкторЗаполненияОбъектов.Интеграция
МодулиПодсистем.Добавить("кзоОбновлениеИнформационнойБазы");
// Конец КонструкторЗаполненияОбъектов.ИнтеграцияДля возможности использования Правил заполнения с видом события "Заполнение" при нажатии на кнопку заполнить, требуется подключить команду "Заполнить" к БСП.
Для этого требуется в процедуру БСП ПодключаемыеКомандыПереопределяемый.ПриОпределенииКомандПодключенныхКОбъекту() добавить вызов метода создающего команду "Заполнить" на формах:
// КонструкторЗаполненияОбъектов.Интеграция
кзоИнтеграция.ДобавитьКомандуЗаполнить(Источники, Команды);
// Конец КонструкторЗаполненияОбъектов.ИнтеграцияДля возможности использования Правил заполнения с видом события "Событие элемента формы", требуется добавить код Конструктора заполнения в модуль используемой формы через расширение или напрямую в модуль формы.
Требуется добавить следующий блок кода в концец события формы ПриСозданииНаСервере:
// КонструкторЗаполнения.ПодключаемыеКоманды
кзоИнтеграция.ПриСозданииНаСервере(ЭтаФорма);
// Конец КонструкторЗаполнения.ПодключаемыеКомандыТребуется разместить следующий код Конструктора заполнения в модуле формы.
#Область КонструкторЗаполненияОбъектов
// КонструкторЗаполненияОбъектов.Интеграция
&НаКлиенте
Функция кзоПолучитьДанныеФормы() Экспорт
Возврат кзоПолучитьДанныеФормыНаСервере();
КонецФункции
&НаСервере
Функция кзоПолучитьДанныеФормыНаСервере()
Возврат кзоИнтеграция.СоздатьДанныеФормы(ЭтаФорма);
КонецФункции
&НаСервере
Процедура кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика)
кзоИнтеграция.ВыполнитьОбработчик(ЭтаФорма, СтруктураОбработчика);
КонецПроцедуры
#Область ПодключаемыеОбработчики
&НаКлиенте
Процедура кзоПодключаемый_ПриИзменении(Элемент)
ИмяЭлемента = Элемент.Имя;
ИмяСобытия = "ПриИзменении";
СтруктураОбработчика = кзоИнтеграцияКлиентСервер.НайтиОбработчикВКешеФормы(ЭтаФорма, ИмяЭлемента, ИмяСобытия);
Если СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ВместоТиповогоОбработчика")
ИЛИ НЕ ЗначениеЗаполнено(СтруктураОбработчика.ТиповойОбработчик)
Тогда
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
ИначеЕсли СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ПередТиповымОбработчиком") Тогда
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
Выполнить(СтруктураОбработчика.ТиповойОбработчик);
ИначеЕсли СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ПослеТиповогоОбработчика") Тогда
Выполнить(СтруктураОбработчика.ТиповойОбработчик);
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
КонецЕсли;
КонецПроцедуры
&НаКлиенте
Процедура кзоПодключаемый_Команда(Команда)
ИмяЭлемента = Команда.Имя;
ИмяСобытия = "Команда";
СтруктураОбработчика = кзоИнтеграцияКлиентСервер.НайтиОбработчикВКешеФормы(ЭтаФорма, ИмяЭлемента, ИмяСобытия);
Если СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ВместоТиповогоОбработчика")
ИЛИ НЕ ЗначениеЗаполнено(СтруктураОбработчика.ТиповойОбработчик)
Тогда
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
ИначеЕсли СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ПередТиповымОбработчиком") Тогда
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
Выполнить(СтруктураОбработчика.ТиповойОбработчик);
ИначеЕсли СтруктураОбработчика.МоментВыполнения = ПредопределенноеЗначение("Перечисление.кзоМоментыВыполненияПодключаемыхОбработчиков.ПослеТиповогоОбработчика") Тогда
Выполнить(СтруктураОбработчика.ТиповойОбработчик);
кзоПодключаемый_ОбработчикНаСервере(СтруктураОбработчика);
КонецЕсли;
КонецПроцедуры
#КонецОбласти
// Конец КонструкторЗаполненияОбъектов.Интеграция
#КонецОбластиПравила заполнения используются для автоматизации заполнения объектов, упрощения и ускорения работы пользователей. Основным объектом механизма является справочник "Правила заполнения (кзо)", объект конфигурации кзоПравилаЗаполнения.
Механизм включает в себя следующие объекты конфигурации показанные на схеме ниже. Основным объектом механизма является справочник "Правила заполнения (кзо)", объект конфигурации Спраовочник.кзоПравилаЗаполнения.
@startuml
'>>> библиотека 1ce-icons-for-plantuml (ext)
!define v8_PUML https://raw.githubusercontent.com/plastinin/1ce-icons-for-plantuml/extended/dist/
!include v8_PUML/common.puml
!include v8_PUML/v8_AccRg.puml
!include v8_PUML/v8_Document.puml
!include v8_PUML/v8_Catalog.puml
!include v8_PUML/v8_InfoRg.puml
!include v8_PUML/v8_ChartsOfCharacteristicTypes.puml
!include v8_PUML/v8_DefinedTypes.puml
!include v8_PUML/v8_Enum.puml
'<<<
_Справочник(Пользователи, "Пользователи") {
}
_Справочник(ГруппыПользователей, "Группы пользователей") {
--Состав--
Пользователь
}
_Справочник(ИдентификаторыОбъектовМетаданных, "Идентификаторы объектов метаданных") {
}
_Справочник(кзоПравилаЗаполнения, "Правила заполнения") {
+ОбъектМетаданных
+ВидСобытия
+СобытиеЭлементаФормы
+Настройки.Отбор
--ГруппыПользователей--
+Группа
--Пользователи--
+Пользователь
--Заполнение--
+ИмяРеквизита
+Значение
}
_Справочник(кзоСобытияЭлементовФорм, "События элементов форм") {
+ОбъектМетаданных
+ИмяФормы
+ИмяЭлемента
+ИмяСобытия
+МоментВыполнения
}
_Перечисление(кзоВидыСобытийПравилЗаполнения, "Вид события правил заполнения") {
+СозданиеНового
+Заполнение
+СобытиеЭлементаФормы
}
_Перечисление(кзоМоментыВыполненияПодключаемыхОбработчиков, "Моменты выполнения подключаемых обработчиков") {
+ПередТиповымОбработчиком
+ВместоТиповогоОбработчика
+ПослеТиповогоОбработчика
}
Пользователи --> ГруппыПользователей
Пользователи --> кзоПравилаЗаполнения
ГруппыПользователей --> кзоПравилаЗаполнения
ИдентификаторыОбъектовМетаданных --> кзоПравилаЗаполнения
кзоВидыСобытийПравилЗаполнения --> кзоПравилаЗаполнения
кзоСобытияЭлементовФорм --> кзоПравилаЗаполнения
ИдентификаторыОбъектовМетаданных --> кзоСобытияЭлементовФорм
кзоМоментыВыполненияПодключаемыхОбработчиков --> кзоСобытияЭлементовФорм
@enduml@startuml
left to right direction
collections Events as "1. Событие объекта"
rectangle RulesSelection as "2. Подбор правил \nзаполнения"
rectangle RelesFiltering as "3. Фильтрация \nправил"
rectangle ObjectFilling as "4. Заполнение \nобъекта"
circle Finish as "Завершение"
Events ==> RulesSelection
RulesSelection ==> RelesFiltering
RelesFiltering ==> ObjectFilling
ObjectFilling ==> Finish
@endumlПодробное описание этапов процесса:
Это стартовая точка для запуска процесса заполнения. Все события делятся на три основных вида:
- При создании нового
- Заполнение
- Событие элемента формы
На схеме ниже показана классификация событий и механизмы реализации.
@startuml
skinparam collections {
fontsize 15
}
skinparam file {
fontsize 12
}
skinparam rectangle {
roundCorner 20
bordercolor none
backgroundcolor LightSteelBlue
}
' First level
collections Events as "События"
' Second level
rectangle EventType as "Вид событий" {
file OnCreate as "При создании нового"
file Filling as "Заполнение"
file InterfaceEvent as "Событие элемента формы"
}
Events --> OnCreate
Events --> Filling
Events --> InterfaceEvent
' Third level
file OnCreateNew as "При создании нового"
note bottom
Реализовано через подписку
на событие `ПриЗаполнении`
end note
file OnCopy as "При копировании"
note bottom
Реализовано через подписку
на событие `ПриКопировании`
end note
OnCreate --> OnCreateNew
OnCreate --> OnCopy
file OnFillByBase as "При заполнении на основании"
note bottom
Реализовано через подписку
на событие `ПриЗаполнении`
end note
file OnButtonFillClick as "При нажатии на кнопку 'Заполнить'"
note bottom
Реализовано с помощью подключаемой
команды БСП на форме объекта
end note
Filling --> OnFillByBase
Filling --> OnButtonFillClick
file FormElementEvent as "Событие элементов форм"
note bottom
Реализовано через механизм
Событие элемента формы
end note
InterfaceEvent --> FormElementEvent
@endumlМеханизмы Подключаемых команд БСП и Событий элемента формы более подробно описаны в соответствующих разделах.
Правила выбираются запросом из справочника кзоПравилаЗаполнения по следующим критериям:
- Активность
- Соответствие даты события периоду Правила
- Вид события
- Объект метаданных - соответствует типу заполняемого объекта
- Пользователь
- Группа пользователей
Для дополнительного уточнения объектов, которые нужно обрабатывать используется механизм фильтрации объектов на базе СКД. Отборы для фильтрации можно указывать только для видов событий:
- Заполнение
- Событие элемента формы
Для остальных видов событий данный этап не выполняется.
В результате фильтрации отбрасываются правила, по которым объект заполнения не удовлетворяет отборам правила.
Этап заполнения состоит из шагов:
-
Правила сортируются по приоритету указанному в справочнике.
-
Заполнение значений реквизитов объекта выбранных в таблице "Заполнение" Правила.
-
В безопасном режиме выполняется программный код указанный в Правиле.
После интеграции Конструктора заполнения в подключаемые команды БСП при открытии формы объекта будет отрабатывать метод кзоИнтеграция.ДобавитьКомандуЗаполнить(), который является отправной точкой входа для вывода команды "Заполнить" на форму.
Последовательность действий программы при добавлении команды:
- Проверка типа объекта, объект должен находиться в определяемом типе
кзоОбъектыДляЗаполнения - Поиск наличия Правил заполнения по объекту
- Добавление команды на форму
Обработчик размещенной команды "Заполнить" запускает стандартный механизм Правила заполнения.
После интеграции Конструктора заполнения в формы объектов для этих объектов появляется возможность создавать элементы справочника "События элементов форм (кзо)" (объект конфигурации Справочник.кзоСобытияЭлементовФорм)
Элемент справочника имеет следующие реквизиты:
- Объект метаданных - тип объекта конфигурации. Список выбора объектов метаданных формируется из определяемого типа Конфигурации
кзоОбъектыСобытийФорм. - Форма - имя формы объекта конфигурации. В список выбора добавляются только основные формы объектов (Форма элемента, Форма документа...). Если в модуль формы не добавлены методы интеграции, форма не доступна для выбора.
- Элемент - имя элемента управления формы. В список выбора добавляются только элементы с типами:
КнопкаФормы,ПолеФормы(привязанное к реквизиту объект формы), прочие элементы будут не доступны. - Событие - имя события выбранного элемента формы. Список событий заполняется, если для элемента доступны события:
ПриИзменении,Команда, остальные события игнорируются. В поле "Типовой обработчик" устанавливается обработчик выбранного события, если он предусмотрен в конфигурации. - Момент выполнения - определяет последовательность выполнения Типового обработчика и переопределяемого обработчика события.
ВНИМАНИЕ! Для устранения дублирования в справочнике запрещено создавать обработчики с одинаковыми реквизитами: Объект метаданных, Имя формы, Имя элемента, Имя события.Для получения информации о реквизитах и элементах выбранной формы программа вызывает экспортную функцию кзоПолучитьДанныеФормы() добавленную в модуль в формы в процессе интеграции, это стартовая точка процесса подмены типовых обработчиков, показанная на схеме ниже.
@startuml
left to right direction
actor User as "Пользователь"
rectangle FormEvent as "Событие формы\n<b>ПриСозданииНаСервере</b>"
file module as "Конструктор заполнения" {
rectangle EventSelection as "Подбор\nсобытий\nэлементов\nформы"
rectangle EventChanging as "Переопределение\nобработчиков\nсобытий"
}
circle ActionListening as "Ожидание\nдействий\nпользователя"
User --> FormEvent : "открывает\nформу"
FormEvent --> EventSelection
EventSelection --> EventChanging
EventChanging --> ActionListening
@endumlПосле открытия формы пользователем программа ожидает вызов переопределенного обработчика и выполняет действия по алгоритму ниже.
@startuml
start
:Событие элемента формы\n<b>Переопределенный обработчик</b>;
switch (Момент выполнения?)
case (Перед типовым\nобработчиком)
:Заполнение объекта;
:Типовой обработчик;
case (Вместо типового\nобработчика)
:Заполнение объекта;
case (После типового\nобработчика)
:Типовой обработчик;
:Заполнение объекта;
endswitch
stop
@endumlПравила проверки служат для контроля правильности заполнения объекта пользователем и отображения ошибок в заполнении. Основным объектом механизма является справочник "Правила проверки заполнения (кзо)", объект конфигурации кзоПравилаПроверкиЗаполнения.
Реквизиты вкладки "Основное":
- Активно и период действия - интервал работы правила.
- Объект метаданных - тип объекта конфигурации. Список выбора объектов метаданных формируется из определяемого типа Конфигурации
кзоОбъектыСобытийФорм. - Таблица объекта - имя таблицы выбранного объекта
- Только для новых объектов - если установлен флаг, то проверка заполнения будет производиться только для новых элементов справочников, ПВХ, и для всех документов.
На вкладке "Проверка заполнения" заполняются указываются реквизиты и их значения, которые нужно проверять при проверке.
На вкладке "Отбор объектов" заполняются правила отбора объектов обрабатываемых правилом, если объект не соответствует отбору, то он пропускается, правило для него не будет применяться.
На вкладке "Пользователи" заполняются пользователи и группы пользователей для которых будет применяться правило.
Основные объекты Конфигурации участвующие в работе Правил проверки изображены на диаграмме ниже.
'>>> библиотека 1ce-icons-for-plantuml (ext)
!define v8_PUML https://raw.githubusercontent.com/plastinin/1ce-icons-for-plantuml/extended/dist/
!include v8_PUML/common.puml
!include v8_PUML/v8_AccRg.puml
!include v8_PUML/v8_Document.puml
!include v8_PUML/v8_Catalog.puml
!include v8_PUML/v8_InfoRg.puml
!include v8_PUML/v8_ChartsOfCharacteristicTypes.puml
!include v8_PUML/v8_DefinedTypes.puml
!include v8_PUML/v8_Enum.puml
'<<<
_Справочник(ГруппыПользователей, "Группы пользователей") {
--Состав--
+Пользователь
}
_Справочник(ИдентификаторыОбъектовМетаданных, "Идентификаторы объектов метаданных") {
}
_Справочник(кзоПравилаПроверкиЗаполнения, "Правила проверки заполнения (кзо)") {
+ОбъектМетаданных
+ИмяТаблицы
+Настройки.Отбор
--ГруппыПользователей--
+Группа
--Пользователи--
+Пользователь
}
_Справочник(Пользователи, "Пользователи") {
}
Пользователи --> ГруппыПользователей
кзоПравилаПроверкиЗаполнения --> ИдентификаторыОбъектовМетаданных
Пользователи --> кзоПравилаПроверкиЗаполнения
ГруппыПользователей --> кзоПравилаПроверкиЗаполнения@startuml
left to right direction
collections Events as "Событие\n<b>ОбработкаПроверкиЗаполнения</b>"
rectangle RulesSelection as "1. Подбор правил \nпроверки"
rectangle RelesFiltering as "2. Фильтрация \nправил СКД"
rectangle ObjectFilling as "3. Проверка\nзаполнения"
rectangle ErrorAnalising as "4. Анализ и\nотображение ошибок"
circle Finish as "Завершение"
Events ==> RulesSelection
RulesSelection ==> RelesFiltering
RelesFiltering ==> ObjectFilling
ObjectFilling ==> ErrorAnalising
ErrorAnalising ==> Finish
@endumlФильтрация объектов СКД - универсальный механизм применяемый для отбора неподходящих объектов конфигурации к которым не нужно применять правила. Фильтрация выполняется в соответствии с настройками отборов схемы компоновки данных.
В ходе фильтрации отбрасываются объекты которые не соответствуют выбранным отборам СКД.
В конфигурации добавлена роль Администратор (кзо), которая дает права на полный доступ и управление подсистемой Конструктора заполнения. Пользователи не обладающие этой ролью не получат доступ к подсистеме, но подсистема будет работать в соответствии с текущими настройками: будут заполняться объекты и производиться проверки.
Конфигурация предоставляет обработку выгрузки / загрузки правил (далее Обработка) между информационными базами или внутри одной базы. Данная обработка позволяет организовать процесс создания и отладки Правил на тестовой базе данных и выгрузку отлаженных Правил в рабочую базу данных.
Обработка работает в двух режимах: выгрузки и загрузки. Переключение осуществляется через подменю "Режим"
Последовательность шагов:
- Выбрать Имя файла в который будут выгружены правила.
- Самостоятельно заполнить список правил к выгрузке или воспользоваться кнопкой Заполнить. Кнопка Заполнить получает все элементы справочников "Правила заполнения (кзо)" и "Правила проверки заполнения (кзо)", которые без пометки на удаление и имеют флаг "Активно".
- Нажать кнопку Выгрузить
Вместе с Правилами заполнения выгружаются также указанные в них События элементов форм для поддержания ссылочной целостности.
Последовательность шагов:
- Выбрать Имя файла правил для загрузки.
- Установить переключатель Загружать не активными, если требуется дополнительная проверка загружаемого правила перед активацией.
- Нажать кнопку Загрузить
После загрузки ссылки на загруженные правила будут показаны в таблице правил.