Merge branch 'release/5.0.0.124'

# Conflicts:
#	lib/video/работасвидео/РаботаСВидео.xml
#	lib/video/работасвидео/РаботаСВидео/Forms/Форма.xml
#	lib/video/работасвидео/РаботаСВидео/Forms/Форма/Ext/Form.xml
#	lib/video/работасвидео/РаботаСВидео/Forms/Форма/Ext/Form/Module.bsl

.gitattributes

@@ -1,3 +1,18 @@
-renames.txt eol=crlf
-*.bsl eol=crlf
-Form.bin binary
+* text=auto
+*.htm text eol=crlf
+*.html text eol=crlf
+renames.txt text eol=crlf
+*.bsl  text eol=crlf
+*.xml  text eol=crlf
+*.feature text
+*.md text
+*.json text
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.os text eol=crlf
+*.sh text eol=lf
+*.groovy text eol=lf
+Form.bin binary
+*.bin binary
+*.png binary
+*.ico binary

.github/CONTRIBUTING.md

@@ -132,31 +132,32 @@ opm run init
 
 если вы методолог или архитектор
 
-* ознакомтесь с порядком участия в архитектурных обсуждениях http://vanessa.services/docs/advanced/arch-team
-* создайте обсуждение https://github.com/silverbulleters/vanessa-services/issues
+* сделайте свой первый `pull-request`, в том числе в документацию
+* создайте обсуждение https://github.com/silverbulleters/add/issues с описанием противоречия
 * участвуйте, обосновывайте, приводите примеры
 * используйте ТРИЗ для построения непротиворечивых решений
 
-### Спонсорство по задаче
+### Enterprise-поддержка
 
 если вы бизнесмен или менеджер
 
-* выдайте награду за любую из задач - нажав кнопку **"Post a bounty on it"**
-* ждите когда кто-нибудь из контрибьюторов выполнить задачу через `pull-request`
-* после проверки качества Ваша награда будет передана автоматически с помощью сервиса https://www.bountysource.com/teams/silverbulleters/issues контрибьютору
+* обратитесь по адресу `[email protected]`
+* заключите контракт на Enterprise-поддержку с гарантией по SLA и c контролем NPS
+* публикуйте любые запросы на доработку и консультацию - они будут выполнены или по ним будет выдан ответ в первом приоритете
+  * на данный момент за последние год мы поддерживаем следующие медианы: время реакции - 24 минуты, время решения - 23 часа
 
 # BSD v3 License
 
-Наша лицензия поощряет коллективное участие в разработке всего стэка продуктов `Vanessa Stack`, однако не поощряет использование брендов (с) `SilverBulleters`, `vanessa-stack`, `vanessa-behavior` и остальных для развития своих неофициальных имплементаций.
+Наша лицензия поощряет коллективное участие в разработке всего стэка продуктов `Vanessa Stack`, однако не поощряет использование брендов (с) `SilverBulleters`, `vanessa-stack`, `vanessa-behavior`, `vanessa-add` и остальных для развития своих неофициальных имплементаций.
+
 Поэтому:
 
-* используйте, дорабатывайте через концепцию `fork` и `pull-request` официальный продукт `silverbulleters/vanessa-behavior`
+* используйте, дорабатывайте через концепцию `fork` и `pull-request` официальный продукт `silverbulleters/add`
 * если вы хотите создать свой продукт на основе `vanessa-behavior`, это разрешено и не противоречит лицензии `BSD v3`
-* однако, если вы хотите использовать для рекламирования и продвижения своего продукта бренды ``"SilverBulleters"`` или ``"Vanessa Behavior"``, вам необходимо получить у нас разрешение на это, написав на адрес `[email protected]` или создать `Issue` на `GitHub`
+* однако, если вы хотите использовать для рекламирования и продвижения своего продукта бренды ``"SilverBulleters"``, ``"Vanessa Behavior"`` или ``"Vanessa ADD"``, вам необходимо получить у нас разрешение на это, написав на адрес `[email protected]` или создать `Issue` на `GitHub`
 
 Поэтому интернет-маркетологов просим быть осторожней при использовании символики `Vanessa` и `SilverBulleters`
 
-
 # CLA - лицензия на коллективное участие
 
 Мы придерживаемся https://cla.github.com/agreement
@@ -167,4 +168,4 @@ opm run init
 * используйте чат Gitter для того чтобы задать вопрос https://gitter.im/silverbulleters
 * запишитесь на практические занятия по правильной разработке 1С
 
-```(c) SilverBulleter, LLC - последнее обновление: 07.09.2017```
+```(c) SilverBulleter, LLC - последнее обновление: 06.11.2017```

.gitignore

@@ -1,9 +1,23 @@
 crowdin.yaml
 .vscode
 build/*
+.forbuild/*
 .sonar/*
 .sonarl int/*
 log.txt
 env.json
 oscript_modules/
 *.ospx
+*.epf
+ConfigDumpInfo.xml
+ServiceBases/
+tools/Allure/
+tools/HTML/
+tools/jUnit/
+tools/Markdown/
+tools/ScreenShotsTest/
+*.zip
+*.7z
+*.tar.gz
+*.tar.bz2
+*.tar

F.A.Q.MD

@@ -5,7 +5,7 @@
 2. Как запустить фичу из поставки VB у себя в базе?
 	* Большинство фич, которые идут в поставке VB, требуют, чтобы их запускали в специальной служебной базе.
 	* Надо собрать служебную базу. Для этого надо загрузить CF из (**.\vanessa-behavoir\lib\CF\83**) 
-	* Надо руками в базе установить константу **Путь к  Vanessa Behavior** - это полный путь к обработке **bddRunner.epf** включая имя файла
+	* Надо руками в базе установить константу **Путь к  Vanessa Behavior** - это полный путь к обработке **vanessa-behavior.epf** включая имя файла
 	* Надо открыть в базе VB
 	* Надо указать тег исключение **IgnoreOnCIMainBuild** (список исключаемых тегов)
 	* Для ОФ надо ещё указать тег **IgnoreOnOFBuilds**
@@ -22,23 +22,77 @@
 	* В секции контекст надо добавить шаг **И Я закрыл все окна клиентского приложения**. А ещё лучше создать экспортный сценарий и в него добавить этот шаг. А в секции Контекст вызывать экспортный сценарий.
 6. Как проверять поведение системы под разными ролями?
 	* Надо запустить несколько TestClient на разных портах и переключаться между ними.
-7. На CI сервере скриншот формируется, но вместо изображения чёрный экран. Как настроит сервер CI?
+7. Как сохранять скриншоты при ошибках сценариев?
+
+	Интерактивная настройка:
+		+ Закладка `Сервис`
+		+ далее `Автоинструкции`
+		+ поле `Консольная команда создания скриншотов`
+		  + после строки команды вставляется имя файла и в таком виде команда запускается!
+
+	Можно устанавливать 
+	+ как `NirCMD`
+	+ http://www.nirsoft.net/utils/nircmd.zip
+		+ команда `nircmd savescreenshot `
+
+	+ так и `IrfanView`
+		+ команда `"C:\Program Files (x86)\IrfanView\i_view32.exe" /capture=1 /convert=`
+
+	+ Важно только устанавливать 32-разрядные версии !!
+
+	Примеры json-файла настройки фиксации скриншотов
+		для `NirCMD`:
+
+```json
+	"ДелатьСкриншотПриВозникновенииОшибки": true,
+	"СниматьСкриншотКаждогоОкна1С": true,
+	"КаталогOutputСкриншоты": "$workspaceRoot/build/out/ScreenShots",
+	"КомандаСделатьСкриншот": "nircmd savescreenshot "
+```
+
+	или для `IrfanView`:
+
+```json
+	"ДелатьСкриншотПриВозникновенииОшибки": true,
+	"СниматьСкриншотКаждогоОкна1С": true,
+	"КаталогOutputСкриншоты": "$workspaceRoot/build/out/ScreenShots",
+	"КомандаСделатьСкриншот": '"C:\Program Files (x86)\IrfanView\i_view32.exe" /capture=1 /convert='
+```
+
+8. На CI сервере скриншот формируется, но вместо изображения чёрный экран. Как настроит сервер CI?
 	* Запускать джоб Jenkins в режиме сервиса нельзя. На CI надо настроить автовход под какой либо учётной записью и в автозагрузку надо поместить команду запуска джоба Jenkins.
 	* Нельзя использовать для доступа к CI RDP. Вообще. Надо использовать другой софт для удаленного доступа к нему, например TightVNC. RDP полностью гасит видеокарту (виртуальную или настоящую) при отключении.
 	* Надо посмотреть схему энерго сбережения в панели управления, там может стоять отключение дисплея через пару минут. Это надо выключить.
-8. Почему у меня не работает тэг @tree
-	* Возможно вы используете вместо символов табуляции - пробелы. Проверьте. Должны быть именно **Табы**.
-9. Как поставить брейкпоинт во внешней обработке.
+9. Почему у меня не работает тэг @tree
+	* Для работы тега @tree надо использовать либо только табы, либо только пробелы. В пределах одной  фичи нельзя в отступах строк использовать и пробелы и Табы.
+10. Как поставить брейкпоинт во внешней обработке.
 	* Надо закрыть сеанс TestManager.
 	* Надо открыть сеанс TestManager.
 	* Надо открыть через меню файл/открыть обработку, в которой стоит брейкпоинт.
 	* Только после пункта 3 надо открыть Vanessa-Behavior.
 	* Теперь остановка на брейкпоните во внешнией обработке будет работать. Но до первого изменений кода в ней. Если изменили код, то надо повторить все действия с начала.
-10. Я подключаюсь по RDP к серверу. И фича выполняется нормально, но если свернуть окно RPD, то возникает ошибка.
+11. Я подключаюсь по RDP к серверу. И фича выполняется нормально, но если свернуть окно RPD, то возникает ошибка.
 	* Это связано с особенностью платформы 1С. Некоторые методы платформы (кнопконажималки) не работают, когда погашена видеокарта (а RDP клиент её гасит, когда вы его сворачиваете). Поэтому не надо использовать RDP для доступа к CI (или другим) серверам, когда вы хотите использовать кнопконажималку.
-11. Я вызвал метод Ванесса.ЗапретитьВыполнениеШагов(), затем я подключаю свой таймер, и мне надо сделать, чтобы шаг упал.
+12. Я вызвал метод Ванесса.ЗапретитьВыполнениеШагов(), затем я подключаю свой таймер, и мне надо сделать, чтобы шаг упал.
 	* в этом случае вместо вызова исключения надо сделать Ванесса.ПродолжитьВыполнениеШагов(Истина)
-12. Появляется ошибка, в которой есть текст: "Неизвестный идентификатор формы". Это означает, что есть два или более epf файла, у которых совпадает поле **Имя** (это которое находится около Синонима и Комментария).
-13. Если вы используете версию платформы 8.3.9.2033 или новее, тогда может появиться окно **Предупреждение безопасности**. 
+13. Появляется ошибка, в которой есть текст: "Неизвестный идентификатор формы". Это означает, что есть два или более epf файла, у которых совпадает поле **Имя** (это которое находится около Синонима и Комментария).
+14. Если вы используете версию платформы 8.3.9.2033 или новее, тогда может появиться окно **Предупреждение безопасности**. 
 	* Подробно этот механизм описан [здесь](http://its.1c.ru/db/v838doc#bookmark:dev:TI000001871).
-	* Если хотите выключить этот механизм для всех баз - пропишите в файле conf.cfg строку: **DisableUnsafeActionProtection=.***
+	* Если хотите выключить этот механизм для всех баз - пропишите в файле conf.cfg строку: **DisableUnsafeActionProtection=.***
+15. Как использовать Sikuli-скрипты. 
+	* Установите SikuliX согласно инструкции http://sikulix.com/quickstart/;
+	* Ознакомьтесь с http://sikulix-2014.readthedocs.io/en/latest/faq/010-command-line.html;
+	* Укажите через path путь к каталогу с runsikulix(.cmd);
+	* Разрабатывайте свои Sikuli-скрипты с помощью SikuiliX IDE (http://sikulix-2014.readthedocs.io/en/latest/index.html) либо используйте имеющиеся;
+	* Выполнение скрипта в реализации шага вызывайте через Ванесса.ВыполнитьSikuliСкрипт().
+16. Как получить отчет Allure у себя на компьютере под Windows
+	* Надо скачать дистрибутив Allure [отсюда](https://github.com/allure-framework/allure1/releases) 
+	* Надо прописать в Path каталог где лежит allure.bat
+	* Вызвать команду **call allure generate {каталог где лежат ваши xml в формате Allure}**
+	* Вызвать команду **call allure report open**
+17. Как при возникновении ошибки на CI получить скриншоты всех окон 1С?
+	* Пока эта фича работает только под Windows.
+	* Надо в json файле, в котором указываются параметры запуска Vanessa-Behavior, указать строку: `"СниматьСкриншотКаждогоОкна1С": "Истина"`
+	* Надо установить на CI сервер java 8 (если у вас Jenkins - то скорее всего она у вас уже есть)
+	* Надо установить SikuliX версии 1.1 или выше. Брать [отсюда](https://launchpad.net/sikuli/sikulix/1.1.1). Там надо скачать sikulixsetup-1.1.1.jar.
+	* Надо чтобы файл runsikulix.cmd был прописан в переменной PATH.