IT-Medved · pull · Aug 27, 2021 · Sep 27, 2021 · Sep 29, 2021 · Sep 29, 2021
diff --git a/.gitignore b/.gitignore
@@ -4,3 +4,6 @@ bdd-log.xml
 exec.log
 .vscode/
 /tests.xml
+/oscript_modules
+/reports/
+/coverage/
diff --git a/COPYRIGHT b/COPYRIGHT
@@ -0,0 +1,17 @@
+//©///////////////////////////////////////////////////////////////////////////©//
+//
+//  Copyright 2014-2024 BIA-Technologies Limited Liability Company
+//
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+//
+//©///////////////////////////////////////////////////////////////////////////©//
diff --git a/Jenkinsfile b/Jenkinsfile
@@ -0,0 +1,2 @@
+@Library(['jenkins-lib-core', 'jenkins-lib-oscript']) _
+opmPipeline()
diff --git a/README.md b/README.md
@@ -29,30 +29,36 @@
 - для выполнения установки в конкретный репозиторий необходимо выполнить команду `precommit4onec install repo_name`
 - для выполнения установки во все репозитории каталога необходимо выполнить команду `precommit4onec install folder_reps -r`
 - если каталог исходных файлов в репозитории отличается от стандартного "src" (например, когда исходные файлы в формате EDT), необходимо явно указать его с помощью дополнительного параметра `-source-dir "configuration"`
+
+Для корректного отображения путей с кириллицей прекоммит установит настройку Git `core.quotePath` для локального репозитория.
 
 После этого, при каждом коммите будет выполняться обработка файлов.
 
 В комплекте присутствуют следующие сценарии обработки файлов:
 
+- `ВставкаКопирайтов` - добавляет текст копирайта в файлы модулей. [См. подробнее](/docs/ВставкаКопирайтов.md)
 - `ДобавлениеПробеловПередКлючевымиСловами` - добавляет отсутствующие пробелы перед ключевыми словами в файлах модулей. На данный момент обрабатывается только ключевое слово `Экспорт`.
-- `ДобавлениеТестовВРасширение` - добавляет отсутствующие сценарии в расширение с unit-тестами. [См. подробнее](/docs/ДобавлениеТестовВРасширение.md)
 - `ЗапретИспользованияПерейти` - проверяет модуль на использование методов `Перейти`.
 - `ИсправлениеНеКаноническогоНаписания` - исправляет неканоничное написание ключевых слов в модулях.
 - `КорректировкаXMLФорм` - исправляет дубли индексов элементов в файлах описаний форм (могут образоваться при объединениях). Поддерживаются как файлы в формате выгрузки конфигуратора (`Form.xml`), так и в формате EDT (`Form.form`).
 - `ОбработкаЮнитТестов` - обновляет метод-загрузчик сценариев в общих модулях расширения с unit-тестами (по умолчанию отключен).
 - `ОтключениеПолнотекстовогоПоиска` - отключает полнотекстовый поиск в файлах описаний метаданных. [См. подробнее](/docs/ОтключениеПолнотекстовогоПоиска.md)
+- `ОтключениеРазрешенияИзменятьФорму` - снимает флаг `РазрешеноИзменятьФорму` в описаниях форм. [См. подробнее](/docs/ОтключениеРазрешенияИзменятьФорму.md)
 - `ПроверкаДублейПроцедурИФункций` - проверяет уникальность названий процедур и функций в модулях.
 - `ПроверкаКорректностиИнструкцийПрепроцессора` - проверяет корректность написания инструкций препроцессора в модулях.
 - `ПроверкаКорректностиОбластей` - проверяет корректность "скобок" областей в модулях (парность и последовательность).
 - `ПроверкаНецензурныхСлов` - проверяет наличие нецензурных слов в модулях. [См. подробнее](/docs/ПроверкаНецензурныхСлов.md)
 - `РазборОбычныхФормНаИсходники` - раскладывает файлы обычных форм (`Form.bin`) на исходные файлы с помощью инструмента `v8unpack`.
-- `РазборОтчетОбработокРасширений` - раскладывает средствами платформы файлы внешних отчетов, обработок и расширений на исходные файлы. [См. подробнее](/docs/РазборОтчетОбработокРасширений.md)
-- `СинхронизацияОбъектовМетаданныхИФайлов` - анализирует наличие файлов и объектов конфигурации. Поддерживается только файл описания конфигурации в формате выгрузки конфигуратора (`Configuration.xml`).
-- `СортировкаДереваМетаданных` - упорядочивает объекты метаданных верхнего уровня по алфавиту в файле описания конфигурации (кроме подсистем). Поддерживается как файл в формате выгрузки конфигуратора (`Configuration.xml`), так и в формате EDT (`Configuration.mdo`).
+- `РазборОтчетовОбработокРасширений` - раскладывает средствами платформы файлы внешних отчетов, обработок и расширений на исходные файлы. [См. подробнее](/docs/РазборОтчетОбработокРасширений.md)
+- `СинхронизацияОбъектовМетаданныхИФайлов` - анализирует наличие файлов и объектов конфигурации. Поддерживается как файл в формате выгрузки конфигуратора (`Configuration.xml`), так и в формате EDT (`Configuration.mdo`).
+- `СортировкаПравРолей` - упорядочивает по имени объекты в файле описания прав роли.
+- `СортировкаСостава` - сортирует описания состава конфигурации и некоторых объектов метаданных. [См. подробнее](/docs/СортировкаСостава.md)
 - `УдалениеДублейМетаданных` - удаляет дубли объектов метаданных в файле описания конфигурации (могут образоваться при объединениях). Поддерживается как файл в формате выгрузки конфигуратора (`Configuration.xml`), так и в формате EDT (`Configuration.mdo`)..
 - `УдалениеЛишнихКонцевыхПробелов` - удаляет лишние пробелы и табы в конце не пустых строк в файлах модулей.
 - `УдалениеЛишнихПустыхСтрок` - удаляет лишние пустые строки в модулях (лишними считаются 2 и более идущих подряд пустых строк).
 
+При использовании таск-трекеров может возникнуть необходимость указывать номер задачи в каждом комментарии коммита. Специально для этой задачи реализована функциональность проверки комментария коммита на соответствие маске. [См. подробнее](/docs/ПроверкаСообщенияКоммита.md)
+
 ## Изменение настроек
 
 precommit4onec может читать настройки своей работы из специального конфигурационного файла.
@@ -67,7 +73,7 @@ precommit4onec может читать настройки своей работ
 
 Также можно настроить различное поведение для различных каталогов репозитория, для работы с подкаталогами (проектами) используется ключ `-child-path`.
 Настройки проектов полностью переопределяют базовые настройки. Например если в основной настройке указаны `ОтключенныеСценарии`,
-а для проекта `configuration\` они не заполнены, то для каталога `configuration` будут выполнены все сценарии.
+а для проекта `configuration\` они не заполнены, то для каталога `configuration\` будут выполнены все сценарии.
 
 Конфигурирование дает возможности:
 
@@ -103,6 +109,10 @@ precommit4onec может читать настройки своей работ
 }
 ```
 
+## Принудительное выполнение для группы файлов
+
+Команда `exec-rules` предназначена для запуска выбранных сценариев в указанном репозитории. [См. подробнее](/docs/КомандаВыполнитьСценарии.md)
+
 ## Расширение функциональности
 
 Для создания нового сценария обработки файлов необходимо воспользоваться шаблоном, находящимся в каталоге `СценарииОбработки` скрипта.

diff --git a/build-configuration.json b/build-configuration.json
@@ -0,0 +1,11 @@
+{
+  "sonarqube" : true,
+  "test" : true,
+  "coverage" : true,
+  "build" : true,
+  "publish" : {
+    "enable" : true,
+    "stableBranch" : "release/.*",
+    "develop" : true
+  }
+}
diff --git a/docs/img/GitExtensions_Interface.png b/docs/img/GitExtensions_Interface.png
diff --git a/docs/img/GitExtensions_Settings.png b/docs/img/GitExtensions_Settings.png
diff --git a/docs/img/GitExtensions_StagedFiles.png b/docs/img/GitExtensions_StagedFiles.png
diff --git a/docs/ВставкаКопирайтов.md b/docs/ВставкаКопирайтов.md
@@ -0,0 +1,27 @@
+# Сценарий `ВставкаКопирайтов`
+
+Добавляет текст копирайта в файлы модулей при его отсутствии или несоответствии эталону.
+
+Эталонный текст копирайта должен находиться в файле в каталоге репозитория. Относительный путь и имя файла задаются в настройке "ПутьКФайлуКопирайта" конфигурационного файла `v8config.json`. Значение по-умолчанию: "COPYRIGHT".
+Если этот файл неактуален (год в тексте не соответствует текущему), сценарий исправит его.
+
+Чтобы модуль не обрабатывался, он должен содержать исключаемый тег, определяемый в настройке "ИсключаемыеТеги". По-умолчанию игнорируются модули, содержащие тег "// IMPORT".
+
+Если в каталоге репозитория имеется файл ParentConfigurations.bin с данными о настройках поддержки, модули, относящиеся к объектам основной поставки, не будут обрабатываться. Это позволит избежать ложного срабатыватывания механизма сравнения конфигураций на дважды измененные объекты. В конфигурационный файл `v8config.json` добавлена настройка "ИгнорироватьМодулиОбъектовПоставки", по-умолчанию установленная в значение `true`. Переключение в значение `false` позволит обрабатывать все файлы.
+
+Пример заполнения конфигурационного файла:
+```JSON
+{
+    "Precommt4onecСценарии": {
+        "НастройкиСценариев": {
+            "ВставкаКопирайтов": {
+                "ИгнорироватьМодулиОбъектовПоставки": true,
+                "ПутьКФайлуКопирайта": "COPYRIGHT",
+                "ИсключаемыеТеги": [
+                    "// IMPORT"
+                ]
+            }
+        }
+    }
+}
+```
diff --git a/docs/ДобавлениеТестовВРасширение.md b/docs/ДобавлениеТестовВРасширение.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		@Library(['jenkins-lib-core', 'jenkins-lib-oscript']) _
		opmPipeline()