Merge branch 'release/v5.6.0'

.github/CONTRIBUTING.md

@@ -95,7 +95,7 @@ git pull upstream develop
 ##### Выбор задачи и предварительная подготовка
 
 * реализуйте функционал или возьмите в работу какую-то задачу
-  * обратите внимание - некоторые задачи могут иметь награду [DONATIONS.md](./DONATIONS.md)
+  * обратите внимание - некоторые задачи могут иметь награду [DONATIONS.md](/DONATIONS.md)
 
 * На основании ветки develop создаем новую ветку с номером задачи или кратким описанием
   * Например, `feature/issue-9999`

F.A.Q.MD

@@ -8,6 +8,22 @@
 	* Решение описано по [ссылке](https://github.com/xDrivenDevelopment/precommit1c#%D0%94%D0%BB%D1%8F-%D0%BA%D0%BE%D1%80%D1%80%D0%B5%D0%BA%D1%82%D0%BD%D0%BE%D0%B9-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D0%BD%D0%B0-1%D0%A1-%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D0%B8-8392016-%D0%B8-%D1%81%D1%82%D0%B0%D1%80%D1%88%D0%B5)
 		* Кратко - Если хотите выключить этот механизм для всех баз - пропишите в файле conf.cfg строку: **DisableUnsafeActionProtection=.***
 
+1. При интерактивном запуске не загружаются и не выполняются фичи, открывается только форма `bddRunner`
+
+	Несколько вариантов:
+
+	* У Вас не задан список библиотек на закладке `Библиотеки`
+		* Сначала очистите список библиотек - например, кнопкой `Очистить`
+		* Далее Перезапустите `bddRunner`
+		* Автоматически подставится путь к системным библиотекам `Vanessa.ADD` - `$instrumentsRoot/features/libraries`
+		* новые настройки будут сохранены автоматически
+
+	* У Вас заданы неверные библиотеки
+		* например, используются библиотеки от нашего старого продукта `vanessa-behavior`
+		* тогда или примените решение выше с полной очисткой библиотек
+		* или добавьте системную библиотеку `$instrumentsRoot/features/libraries` в список библиотек
+		* и далее обязательно нажмите `Сохранить настройки`
+
 1. При пакетном запуске не загружаются и не выполняются фичи, открывается только форма `bddRunner`
 
 	* У Вас неверный/устаревший/ json-файл настроек, несовместимый формат со штатным json, например, что читает 1С :frowning:
@@ -162,11 +178,11 @@
 	* Выполнение скрипта в реализации шага вызывайте через Ванесса.ВыполнитьSikuliСкрипт().
 
 1. Как получить отчет Allure у себя на компьютере под Windows
-	* Надо скачать дистрибутив Allure [отсюда](https://github.com/allure-framework/allure1/releases)
+	* Надо скачать дистрибутив Allure [отсюда](https://github.com/allure-framework/allure2/releases/latest)
 	* Надо прописать в Path каталог где лежит allure.bat
 	* Для использования через командную строку можно использовать строки ниже
 		* Вызвать команду **call allure generate {каталог где лежат ваши xml в формате Allure}**
-		* Вызвать команду **call allure report open**
+		* Вызвать команду **call allure open**
 	* или установить флаг "Показать отчет Allure в браузере" на закладке `Сервис - отчет о запуске сценариев` и сохранить настройки
 		* в этом случае после выполнения тестов и формирования отчетов Allure BDDRunner самостоятельно выполнит обе команды и покажет отчет Allure в браузере
 	* или выполнить команду `Внешние инструменты - Отобразить отчет Allure в браузере`
@@ -214,3 +230,17 @@
 * `tools\vrunner.json` - путь к файлу настройки запуска, документированный в [readme.md](readme.md#файлы-настройкипрофиля-запуска-обработки)
 * а `ПутьКФиче` или `ПутьККаталогуФич` - прямые или относительные пути к конкретной фиче или каталогу с фичами
 
+23. Не удается выполнить шаги для выбора типа метаданного в форме "Выбор типа данных"
+
+	* В последних версиях `Vanessa.ADD` реализована автоматическая генерация правильных шагов выбора метаданного на основе записи действий пользователя.
+
+	* Важно использовать правильную последовательность шагов, например, вместо созданных на старых версиях `Vanessa.ADD`
+
+	```bsl
+	# И я нажимаю кнопку выбора у поля "Реквизит1"
+	Тогда открылось окно 'Выбор типа данных'
+	И В форме "Выбор типа данных" в таблице "" я перехожу к строке:
+		| ''       |
+		| 'Нужное метаданное' |
+	И В форме "Выбор типа данных" в ТЧ "" я выбираю текущую строку
+	```

doc/README.md

@@ -27,6 +27,12 @@
   * [КомандныйФайл](xdd/КомандныйФайл.MD)
   * [ПарсерКоманднойСтроки](xdd/ПарсерКоманднойСтроки.MD)
   * [ЗапросыИзБД](xdd/ЗапросыИзБД.MD)
-
+  * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
+  * Генераторы отчетов тестирования:
+    * [ГенераторОтчетаAllureXMLВерсия2](xdd/ГенераторыОтчетов.MD#генераторотчетаallurexmlверсия2)
+      * [(устаревший) ГенераторОтчетаAllureXML](xdd/ГенераторыОтчетов.MD#устаревший-генераторотчетаallurexml)
+    * [ГенераторОтчетаJUnitXML](xdd/ГенераторыОтчетов.MD#генераторотчетаjunitxml)
+    * [ГенераторОтчетаMXL](xdd/ГенераторыОтчетов.MD#генераторотчетаmxl)
+
 * [Дымовые тесты (тесты открытия всех форм)](../tests/smoke/readme.md)
 

doc/xdd/ГенераторыОтчетов.MD

@@ -0,0 +1,100 @@
+<a id="markdown-генераторы-отчетов-о-результатах-тестирования" name="генераторы-отчетов-о-результатах-тестирования"></a>
+# Генераторы отчетов о результатах тестирования
+
+<!-- TOC -->
+
+- [Генераторы отчетов о результатах тестирования](#генераторы-отчетов-о-результатах-тестирования)
+    - [ГенераторОтчетаJUnitXML](#генераторотчетаjunitxml)
+    - [ГенераторОтчетаAllureXMLВерсия2](#генераторотчетаallurexmlверсия2)
+    - [(устаревший) ГенераторОтчетаAllureXML](#устаревший-генераторотчетаallurexml)
+    - [ГенераторОтчетаMXL](#генераторотчетаmxl)
+    - [Использование при запуске](#использование-при-запуске)
+        - [Задание в json-файле настройки (лучший способ)](#задание-в-json-файле-настройки-лучший-способ)
+        - [Задание в строке запуска 1С (не рекомендуется)](#задание-в-строке-запуска-1с-не-рекомендуется)
+
+<!-- /TOC -->
+
+Плагины данных видов выполняют задачу формирования отчетов о результатах тестирования
+
+Для использования в интерактивном режиме и при запуске в режиме командной строки.
+
+Данные плагины полезно использовать на серверах сборок (серверы непрерывной интеграции, CI-серверы)
+
+<a id="markdown-генераторотчетаjunitxml" name="генераторотчетаjunitxml"></a>
+## ГенераторОтчетаJUnitXML
+
+Плагин формирует отчет в виде файла специального формата `JUNIT.xml (версии 4)`, который поддерживается в разных средах разработки и серверах сборки.
+
+Формируется 2-уровневая структура - контейнер тестов и сам тест.
+
+<a id="markdown-генераторотчетаallurexmlверсия2" name="генераторотчетаallurexmlверсия2"></a>
+## ГенераторОтчетаAllureXMLВерсия2
+
+Плагин формирует отчет в специальном xml-формате для фреймворка `Yandex.Allure (версии 2)`, который также поддерживается в разных средах разработки и серверах сборки.
+
+Формируется 3-уровневая структура - 2 уровня контейнеров тестов и сам тест.
+
+Далее результаты можно посмотреть в Allure 2 (если он установлен)
+
+Выполнение команды по очереди (allure уже должен быть прописан в PATH):
+
+- при условии генерации отчета в каталог `C:\myproject\allure`
+
+```cmd
+cd /d C:\myproject
+allure generate allure
+allure open
+```
+
+Пример вывода результатов с группировкой
+
+- Если для дымовых тестов включена группировка по метаданным в файле настроек - "СпособГруппировки":"ПоВидуМетаданных"
+
+  ![](/doc/images/results-Allure2.png)
+
+- Если для дымовых тестов включена группировка по виду метаданного в файле настроек - "СпособГруппировки":"ПоВидуОбъекта"
+
+  ![](/doc/images/results-Allure2-Group-by-Single-Metadata.png)
+
+<!-- ![](./doc/images/MakeAutoVideo.png) -->
+
+<a id="markdown-устаревший-генераторотчетаallurexml" name="устаревший-генераторотчетаallurexml"></a>
+## (устаревший) ГенераторОтчетаAllureXML
+
+Плагин формирует отчет в специальном xml-формате для фреймворка `Yandex.Allure (версии 1)`, который также поддерживается в разных средах разработки и серверах сборки.
+
+Формируется только устаревшая 2-уровневая структура - контейнер тестов и сам тест.
+
+Далее результаты можно посмотреть в Allure 2, как написано выше
+
+<a id="markdown-генераторотчетаmxl" name="генераторотчетаmxl"></a>
+## ГенераторОтчетаMXL
+
+Плагин формирует отчет в 1С-формате `mxl` - табличный документ.
+
+В основном, используется при интерактивной работе для немедленного показа результата тестированию пользователю, выполнявшему прогон тестов.
+
+<a id="markdown-использование-при-запуске" name="использование-при-запуске"></a>
+## Использование при запуске
+
+<a id="markdown-задание-в-json-файле-настройки-лучший-способ" name="задание-в-json-файле-настройки-лучший-способ"></a>
+### Задание в json-файле настройки (лучший способ)
+
+При использовании запуска тестов через [Vanessa-Runner](https://github.com/silverbulleters/vanessa-runner) в файле vrunner.json нужно указать использование плагинов следующим образом:
+
+```json
+"--reportsxunit": "ГенераторОтчетаJUnitXML{build/junit.xml};
+ГенераторОтчетаAllureXMLВерсия2{build/allure/allure.xml}"
+```
+
+<a id="markdown-задание-в-строке-запуска-1с-не-рекомендуется" name="задание-в-строке-запуска-1с-не-рекомендуется"></a>
+### Задание в строке запуска 1С (не рекомендуется)
+
+```cmd
+"C:\Program Files\1cv8\8.3.10.2580\bin\1cv8.exe" ENTERPRISE /F"D:\ibService" 
+/Nadmin /P1 /RunModeManagedApplication /Execute "C:\Program Files (x86)\OneScript\lib\add\xddTestRunner.epf"
+/C "xddRun ЗагрузчикКаталога ""D:\Tests"";
+xddReports ГенераторОтчетаJUnitXML{build/junit.xml};
+ГенераторОтчетаAllureXMLВерсия2{build/allure/allure.xml};
+xddShutdown;"
+```

doc/xdd/Запуск-тестов-из-командной-строки-и-получение-файлов-результатов.MD

@@ -1,3 +1,4 @@
+<a id="markdown-запуск-тестов-из-командной-строки-и-получение-результатов" name="запуск-тестов-из-командной-строки-и-получение-результатов"></a>
 # Запуск тестов из командной строки и получение результатов
 
 <!-- TOC -->
@@ -10,6 +11,7 @@
 
 <!-- /TOC -->
 
+<a id="markdown-пример-командной-строки-запуска-тестов" name="пример-командной-строки-запуска-тестов"></a>
 ## Пример командной строки запуска тестов
 
 ```cmd
@@ -32,6 +34,7 @@ xddShutdown;"
 
 Параметры отделяются друг от друга символом `;`
 
+<a id="markdown-параметры-запуска" name="параметры-запуска"></a>
 ## Параметры запуска
 
 1. `xddRun` *обязательно* - команда на загрузку и немедленное выполнение тестов. Следующими параметрами должен идти идентификатор загрузчика тестов и путь тестов для загрузчика. Идентификатор может быть нескольких видов:
@@ -45,6 +48,7 @@ xddShutdown;"
 1. `xddReportPath` *обязательно* - указывается путь к файлу отчета тестирования. 
 1. `xddShutdown` *рекомендуемый параметр при наличии команды `xddRun`* - завершать работу 1С после прогона тестов
 
+<a id="markdown-показ-отчета-в-формате-yandex-allure" name="показ-отчета-в-формате-yandex-allure"></a>
 ## Показ отчета в формате Yandex Allure
 
 За показа отчет в этом формате отвечает плагин "ГенераторОтчетаAllureXML"
@@ -65,12 +69,15 @@ xddShutdown;"
 1. Запуск тестирования через указанную командную строку
 1. Выполнение команды по очереди (allure уже должен быть прописан в PATH):
 
+- при условии генерации отчета в каталог `C:\myproject\allure`
+
 ```cmd
 cd /d C:\reports
-allure generate .
-allure report open
+allure generate --clean allure
+allure open
 ```
 
+<a id="markdown-запуск-тестов-на-build-серверах" name="запуск-тестов-на-build-серверах"></a>
 ## Запуск тестов на build-серверах
 
 Позволяет выгружать результаты тестов в формате junit

epf/bddRunner/bddRunner.xml

@@ -4688,6 +4688,44 @@
 					<ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>
 				</Properties>
 			</Attribute>
+			<Attribute uuid="345f8cc8-299e-44e8-b213-e75ea78eb2e4">
+				<Properties>
+					<Name>КоманднаяСтрокаРедактированияФичи</Name>
+					<Synonym>
+						<v8:item>
+							<v8:lang>ru</v8:lang>
+							<v8:content>Командная строка редактирования фичи</v8:content>
+						</v8:item>
+					</Synonym>
+					<Comment/>
+					<Type>
+						<v8:Type>xs:string</v8:Type>
+						<v8:StringQualifiers>
+							<v8:Length>0</v8:Length>
+							<v8:AllowedLength>Variable</v8:AllowedLength>
+						</v8:StringQualifiers>
+					</Type>
+					<PasswordMode>false</PasswordMode>
+					<Format/>
+					<EditFormat/>
+					<ToolTip/>
+					<MarkNegatives>false</MarkNegatives>
+					<Mask/>
+					<MultiLine>false</MultiLine>
+					<ExtendedEdit>false</ExtendedEdit>
+					<MinValue xsi:nil="true"/>
+					<MaxValue xsi:nil="true"/>
+					<FillChecking>DontCheck</FillChecking>
+					<ChoiceFoldersAndItems>Items</ChoiceFoldersAndItems>
+					<ChoiceParameterLinks/>
+					<ChoiceParameters/>
+					<QuickChoice>Auto</QuickChoice>
+					<CreateOnInput>Auto</CreateOnInput>
+					<ChoiceForm/>
+					<LinkByType/>
+					<ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>
+				</Properties>
+			</Attribute>
 			<Form>Форма</Form>
 			<Form>УправляемаяФорма</Form>
 			<Form>ВыборИзвестногоШага</Form>