added description for predefined elements

firstBitSportivnaya · Nov 18, 2024 · 4568496 · 4568496
1 parent 5e7dae0
commit 4568496
Show file tree

Hide file tree

Showing 4 changed files with 23 additions and 2 deletions.
diff --git a/docs/ПредопределенныеЗначения.md b/docs/ПредопределенныеЗначения.md
@@ -19,6 +19,25 @@
 КонецПроцедуры
 ```
 
+## Уникальность предопределенных элементов
+
+Для обеспечения целостности данных и управления предопределёнными значениями реализован механизм контроля изменений. Он основан на вычислении хеша с использованием алгоритма **MD5**, учёте пометки на удаление, ручных изменений и проверке уникальности идентификаторов.
+
+### Основные этапы проверки
+1. **Первоначальная проверка уникальности идентификаторов:**
+    - На этапе инициализации идентификаторы всех элементов проверяются на уникальность.
+    - Если обнаружены коллизии (дублирующиеся идентификаторы), будет выдано сообщение об ошибке, и такие элементы будут пропущены.
+2. **Хеш и состояние элемента:**
+    - Хеш вычисляется для каждого элемента и сохраняется в регистре **состояний предопределённых элементов**.
+    - Если элемент изменяется в пользовательском режиме, устанавливается флаг **ручное изменение:**
+      - Такой элемент исключается из проверки хеша при последующих обновлениях.
+3. **Обработка элементов с пометкой на удаление:**
+    - Если элемент помечен на удаление и его хеш отличается от нового:
+      - Значения элемента обновляются данными из кода.
+      - Пометка на удаление автоматически снимается.
+    - Если элемент не помечен на удаление и его хеш отличается от нового:
+      - Формируется уведомление о конфликте для дальнейшего разрешения.
+
 ## Автоматическое создание новых элементов
 
 Для автоматизации процесса заполнения предопределенных элементов необходимо модифицировать/добавить в расширение общий модуль **``ОбщегоНазначенияПереопределяемый``**. В процедуре **``ПриДобавленииСерверныхОповещений``** требуется добавить новое серверное оповещение.

diff --git a/src/cf/CommonModules/пбп_ОбновлениеИнформационнойБазыПБП/Ext/Module.bsl b/src/cf/CommonModules/пбп_ОбновлениеИнформационнойБазыПБП/Ext/Module.bsl
@@ -74,7 +74,7 @@
 Процедура ПриДобавленииПодсистемы(Описание) Экспорт
 
 	Описание.Имя = "ПроектнаяБиблиотекаПодсистем";
-	Описание.Версия = "1.0.4.12";
+	Описание.Версия = "1.0.4.13";
 
 	// Требуется библиотека стандартных подсистем.
 	Описание.ТребуемыеПодсистемы.Добавить("СтандартныеПодсистемы");

diff --git a/src/cf/Configuration.xml b/src/cf/Configuration.xml
@@ -57,7 +57,7 @@
 				<xr:Item xsi:type="xr:MDObjectRef">Role.ИнтерактивноеОткрытиеВнешнихОтчетовИОбработок</xr:Item>
 			</DefaultRoles>
 			<Vendor>Первый БИТ</Vendor>
-			<Version>1.0.4.12</Version>
+			<Version>1.0.4.13</Version>
 			<UpdateCatalogAddress/>
 			<IncludeHelpInContents>false</IncludeHelpInContents>
 			<UseManagedFormInOrdinaryApplication>false</UseManagedFormInOrdinaryApplication>

diff --git a/src/cf/Subsystems/пбп_ОбщегоНазначения.xml b/src/cf/Subsystems/пбп_ОбщегоНазначения.xml
@@ -61,6 +61,8 @@
 				<xr:Item xsi:type="xr:MDObjectRef">CommonModule.пбп_ФайловаяСистемаКлиент</xr:Item>
 				<xr:Item xsi:type="xr:MDObjectRef">CommonModule.пбп_ФайловаяСистемаКлиентПереадресация</xr:Item>
 				<xr:Item xsi:type="xr:MDObjectRef">CommonModule.пбп_ФайловаяСистемаСлужебныйКлиент</xr:Item>
+				<xr:Item xsi:type="xr:MDObjectRef">CommonModule.пбп_СерверныеОповещения</xr:Item>
+				<xr:Item xsi:type="xr:MDObjectRef">CommonModule.пбп_СерверныеОповещенияСлужебный</xr:Item>
 			</Content>
 		</Properties>
 		<ChildObjects/>