Vanessa, улучшаем инструкции

В прошлой статье я рассказывал том, что Vanessa Automation умеет делать видеоинструкции.

Сейчас хочу показать, как сделать эти инструкции более приятными для восприятия.

Если вы попробуете сделать инструкцию из фичи, созданной с помощью кликера, то получите постоянные "И" в начале фразы и подробное/излишнее описание каждого из выполняемых действий.

Сценарий: Создание товара
	Когда в панели функций я выбираю 'Поставщики'
	Тогда открылось окно 'Поставщики'
	И я нажимаю на кнопку с именем 'ФормаСоздать'
	Тогда открылось окно 'Поставщики (создание)'
	И в поле 'Наименование' я ввожу текст 'Поставщик 2'
	И я нажимаю на кнопку 'Записать и закрыть'
	И я жду закрытия окна 'Поставщики (создание) *' в течение 20 секунд

Для того, чтобы улучшить видеоинструкцию, есть несколько возможностей:

1. Произнести произвольный текст.
2. Объединить несколько шагов для автоинструкции (тестирование пройдет по всем шагам, а фраза будет произнесена только одна).
3. Создать видеофрагмент из картинки и текста.
4. Вставить произвольный видеоролик в начало или конец видеоинструкции.
5. Выделить фрагмент на форме рамкой или указать на него стрелкой.
6. Исключить часть сценария из видеоинструкции.

7. Использовать несколько разных голосов и языков в видеоинструкции.

Теперь посмотрим, как это делается.

1. Добавление произвольного текста.

Для того, чтобы в видеоинструкцию можно было вставить произвольный текст, в фичу надо добавить шаг "Дано текст субтитров", и в кавычках указать произносимый текст. Это может быть как просто текст, так и диалог нескольких персонажей.

Дано текст субтитров "Привет, я Ванесса."
@AmazonTTS: voice = Ewa
Дано текст субтитров "Что нового у тебя появилось?"
Дано текст субтитров "Вышла новая версия  - один два ноль двадцать восемь"
@YandexTTS: voice = oksana; emotion = good
Дано текст субтитров "Я взрослею и теперь умею больше!"

В момент озвучки картинкой будет текущее состояние рабочего стола.

2. Объединение нескольких шагов.

В настройках Vanessa Automation необходимо установить признак "Группа шагов как шаг":

А в тексте фичи без всяких команд пишем текст, который будет произнесен, группируемые шаги пишем с отступом относительно этого текста. 

Дано текст субтитров "Привет, я Ванесса."
@AmazonTTS: voice = Maxim; lang = ru-RU
Дано текст субтитров "Мне надо создать нового поставщика, поможешь?"
	
Конечно, смотри, это очень просто, открываем форму поставщиков и добавляем новый элемент.	
	@YandexTTS: voice = oksana; emotion=evil
	Когда в панели функций я выбираю 'Поставщики'
	Тогда открылось окно 'Поставщики'
	И Пауза 1
	И я нажимаю на кнопку с именем 'ФормаСоздать'
	И Пауза 2
	Тогда открылось окно 'Поставщики (создание)'
	И в поле 'Наименование' я ввожу текст 'Поставщик 2'
	И Пауза 1
	И я нажимаю на кнопку 'Записать и закрыть'
	И я жду закрытия окна 'Поставщики (создание) *' в течение 5 секунд

@AmazonTTS: voice = Maxim; lang = ru-RU
Дано текст субтитров "Спасибо, Ванесса"

При группировке нескольких шагов, в связи с особенностью формирования автоинструкций, настройки голоса надо указать перед первым из группируемых шагов:

(@YandexTTS: voice = oksana; emotion=evil в примере) 

3. Создание видеофрагмента из картинки и текста

Видеофрагмент из картинки и текста можно создать, используя шаги "видеовставка картинки" или "видеовставка".

И видеовставка картинки "Ванесса" "Привет, я Ванесса"
@YandexTTS: voice = Ermil
И видеовставка "Я могу говорить несколькими голосами"
@AmazonTTS: voice = Kimberly; lang = en-US
и видеовставка картинки "Ванесса" "And also use multiple languages"

В шаге "видеовставка картинки" первый параметр "Ванесса" – это имя файла в каталоге проекта с расширением png, который будет показан на время звучания фразы.

4. Добавление ролика в начало или конец инструкции.

Для добавления ролика в начало и в конец автоинструкции необходимо перейти в настройки автоинструкций, и на вкладке "Дополнительно" выбрать эти видео ролики.

5. Выделение объекта на форме рамкой или указание на него стрелкой

Для выделения объектов на экране используются шаги:

• Я рисую рамку вокруг картинки "ИмяКартинки1";
• Я рисую стрелку от "ИмяКартинки2" до "ИмяКартинки3".

При выполнении данных шагов используется SikuliX сервер. Vanessa Automation берет из папки проекта файл ИмяКартики1.png и ищет такой же фрагмент на экране, если нашла, то обводит его рамкой. Для использования данного функционала необходимо установить сервисные утилиты из проекта UItoolsFor1C.

Так как Vanessa Automation ищет текст на форме как картинку, то у этого механизма есть ограничение:

 если на форме есть две одинаковые фразы, то система выделит ту, которую найдет первой )) 

Дано текст субтитров "Привет, я Ванесса."
@YandexTTS: ermil
Дано текст субтитров "Ванесса, покажи как ты выделяешь элементы на экране"

Для этого мне необходимо, чтобы был сохранен файл с изображением, после этого я беру фломастер и рисую рамку вокруг этой картинки на экране.	
	И я рисую рамку вокруг картинки "Поставщики"
		|'Цвет'          | 'Красный'        |
		|'Длительность'  | '5000'           |

@YandexTTS: ermil 
Дано текст субтитров "А как получаются стрелки?"

Так же как и для рамки я ищу на экране изображения из файлов, сохраненных в каталоге проектов. И рисую стрелку от первого изображения ко второму
	Затем я рисую стрелку от "Админ" до "Поставщики"
		|'Цвет'          | 'Зеленый'        |
		|'Длительность'  | '3000'           |
		|'ТочкаКуда'     | 'СерединаПраво'  |
		|'Толщина'  	 | '5'           	|
		
Первый параметр можно оставить пустым - тогда стрелка пойдет от центра экрана 
	Затем я рисую стрелку от "" до "Поставщики"
		|'Цвет'          | 'Зеленый'        |
		|'Длительность'  | '2000'           |
		|'ТочкаКуда'     | 'СерединаНиз'    |
		|'Толщина'  	 | '10'           	|
		
@YandexTTS: ermil 
Дано текст субтитров "Спасибо, буду использовать."

6. Исключение части сценария.

Для исключения части сценарии из видеоинструкции перед шагом указываем:

#[autodoc.ignorestep]

@YandexTTS: oksana,good
Дано текст субтитров "В результате что-то получилось"
#[autodoc.ignorestep]
И Я закрываю окно 'Мои настройки'
@YandexTTS: jane,good
Дано текст субтитров "Продолжнение инструкции"

7. Использование нескольких голосов.

В последней версии Vanessa Automation в видеоинструкции можно в одном сценарии использовать озвучку как от Yandex, так и от Amazon. У Yandex можно выбирать голос и интонацию, у Amazon - голос и язык.

Параметры задаются в следующем виде:

•  @YandexTTS: voice = zahar; emotion = good 
•  @AmazonTTS: voice = maxim; lang = en-US

Только при этом надо не забыть настроить и Amazon и Yandex.

У Amazon есть большое количество голосов и языков. Для более естественного звучания рекомендуется выбирать язык и голос согласно таблице в описании Amazon Polly

В результате использования вышеперечисленного функционала у вас может получиться инструкция, в которой:

• Не будет постоянного "И".
• Используется несколько голосов.
• Есть вставки из картинок или видео, которые не формируются в тестируемой системе, но которые могут помочь в ее восприятии.

Все это избыточно для синтетического тестирования, которое проводят программисты для проверки функционирования системы.

Но, если вы ведете разработку через поведение (BDD), значит у вас есть сценарии, которые реализуют бизнес-логику.

Это сценарии, написанные не программистами, а людьми, которые умеют и любят общаться с пользователями. Именно такие сценарии можно конвертировать в инструкции. 

Небольшим бонусом, функционал Vanessa Automation можно использовать не только для тестирования:

@yandextts: voice= oksana; emotion = good
Дано текст субтитров "Привет, я Ванесса."
@yandextts: voice= oksana; emotion = good
Дано текст субтитров "Я много тэстировала, и немного устала, давай учить английский!"
@yandextts: voice= zahar; emotion = neutral
Дано текст субтитров "Может лучше французский? Он мелодичнее."
@yandextts: voice= oksana; emotion = good
Дано текст субтитров "Зачем выбирать, можем использовать оба"
Дано текст субтитров "Итак, начинаем. "
И видеовставка "стол"
@Amazontts: voice= Brian; lang = en-GB
И видеовставка "a table"
@Amazontts: voice= Mathieu; lang =fr-FR
И видеовставка "la table"
И видеовставка "стул"
@Amazontts: voice= Brian; lang = en-GB
И видеовставка "a chair"
@Amazontts: voice= Mathieu; lang =fr-FR
И видеовставка "une chaise"
И видеовставка "поставь стул к столу"
@Amazontts: voice= Brian; lang = en-GB
И видеовставка "put a chair by the table"
@Amazontts: voice= Mathieu; lang =fr-FR
И видеовставка "mettre la chaise à la table"
Дано текст субтитров "Что-то я проголодалась. Всем пока."
@Amazontts: voice= Mathieu; lang =fr-FR
Дано текст субтитров "Oh, ces femmes..."

Если вы считаете, что в Vanessa Automation чего-то не хватает, то всегда можете присоединиться к проекту и реализовать нужную вам функциональность Vanessa Automation.