Чтобы документация к фреймворку тестирования всегда была актуальна, ее сборка теперь контролируется процессом выпуска нового релиза. Помимо интерактивных уроков, доступны видео и текстовые инструкции. А для красивого оформления автоинструкций в формате HTML появились новые шаги.
И автоинструкции – это далеко не все новинки релиза. В обзоре расскажем о поддержке новых типов клиента тестирования, шагах по взаимодействию с браузером и многих других возможностях фреймворка.
«Справка – это тоже тест»: автодокументация в видео и текстовом формате
Встроенная в фреймворк справка теперь содержит не только интерактивные уроки, которые можно запустить непосредственно в интерфейсе, но и ссылки на видео и текстовые варианты каждого урока.
В последнем релизе – 140 уроков, разделенных по главам и по группам. Каждый сценарий документации теперь собирается в разных форматах (видео, PDF и MD), а из списка интерактивных уроков появилась возможность быстрого перехода к нужному ролику или файлу в браузере.
Причем, для каждого релиза Vanessa Automation будет открыта ссылка на свое видео. Это стало возможным благодаря тому, что видеоуроки для каждого релиза теперь собираются автоматически и публикуются на YouTube в отдельный канал.
Канал последнего релиза Vanessa Automation 1.2.040, автоматически собранный в плейлисты согласно главам интерактивной справки, можно изучать и отдельно, без привязки к фреймворку. Такой же канал с инструкциями есть и для англоязычных пользователей Vanessa.
А для желающих ознакомиться с полным вариантом текстовой документации к релизу, опубликован единый pdf со структурированным перечнем всех уроков (1905 страниц).
Составом гиперссылок в списке уроков можно управлять с помощью настроек на закладке «Сервис – Обучение – Варианты документации».
Уроки в разных форматах. Как найти урок по элементу формы
Полноценные HTML-инструкции с поддержкой заголовков, гиперссылок и CSS
До текущей версии возможности создания текстовых инструкций как в формате markdown, так и в формате HTML были ограничены.
Хотя было очевидно, что возможность автоматически обновлять текстовые описания с одновременным тестированием новой функциональности будет востребована. Не хватало только достойного оформления для получившегося результата.
Теперь для формирования HTML-инструкций в настройках фреймворка можно указать путь к файлу стилей, который будет применен к HTML-результату.
Также появились специальные шаги, позволяющие при создании текстовых инструкций:
- Указывать заголовки разного уровня.
- Устанавливать нумерованное и ненумерованное оглавление с возможностью переходить по ссылкам внутри документа.
- Добавлять якорь на разделы документа.
- Вставлять произвольные картинки из файловой системы и из внешнего ресурса.
- Вставлять в нужных местах разрыв страницы.
- Добавлять произвольный HTML-текст.
А для переопределения основного стиля можно задавать оформление с помощью шага
И я добавляю стили в автоинструкцию
Кроме этого, в текстовых инструкциях теперь можно использовать группы шагов – по аналогии с тем, как это происходило в видеоинструкциях.
И появилась возможность отображать в редакторе сценариев картинки – через указание как URL, так и пути к файлу на диске.
Для этого можно использовать специальный синтаксис:
// image: height=<Высота> src=<URL или путь к картинке на диске>
Новые возможности позволят сделать сценарии более наглядными
Новые типы клиента тестирования – обычное приложение и автономный мобильный клиент
Появилась возможность выполнять тесты для автономного мобильного клиента. Для этого в таблицу клиентов тестирования нужно добавить путь подключения к мобильному устройству и указать соответствующие настройки.
При тестировании автономного мобильного клиента нужно учитывать те же ограничения, что и для обычного мобильного клиента:
- В базе менеджера тестирования не должно быть пользователей. Следовательно, чтобы работала VA, надо прописать в файле C:\Program Files\1cv8\conf\conf.cfg строку DisableUnsafeActionProtection=.*
- Порт тестирования должен быть 1538.
- Само устройство должно быть подключено к компьютеру по adb. При желании можно использовать эмулятор мобильного устройства
Также появился новый тип клиента тестирования «Обычное приложение» – с его помощью можно выполнять тестирование приложений на обычных формах с помощью шагов UI Automation. В частности, в релизе 1.2.040 для UI Automation появились новые шаги:
И я делаю двойной клик по элементу формы 'ЭтотСеанс' 'Имя' 'Тип' UI AutomationИ я делаю клик по элементу формы 'PID' 'Заголовок' 'Тип' правой кнопкой UI AutomationИ я перемещаю курсор к элементу формы 'PID' 'Имя' 'Тип' UI Automation
Новые возможности взаимодействия с браузером
В новом релизе появилось 35 новых шагов, которые позволяют взаимодействовать с браузером через веб-сокет – такие, как:
И я запускаю браузерИ я активизирую вкладку браузера с заголовком "Заголовок"И я активизирую текущее окно браузераИ я открываю ссылку в браузере "Ссылка"И в странице браузера для элемента "ID" я устанавливаю текст поля "ТекстПоля"И я закрываю все вкладки браузераИ я выполняю код Javascript в странице браузера- И другие шаги с возможностью кликов левой и правой кнопкой мыши, скроллом страницы, эффектами анимации, рисования, размытия и т.д.
Чтобы взаимодействовать из сценария напрямую с браузером, нужно в разделе «Настройка клиентов тестирования» задать команду запуска.
И на закладке «Автоинструкции» установить флаг «Использовать браузер + web socket».
Прямая работа с браузером
Детали ошибки: новые возможности
Для шагов проверки равенства в деталях ошибки теперь выводится шаблон сравнения двух строк. Такая генерация шаблона, например, помогает находить проблемы с неразрывными пробелами, чтобы быстрее понять, как их исправить.
В примере пользователь ожидал получить «Моя организация 1», а в реальности было «Моя организация 2». Система предлагает шаблон «Моя организация *»
Также появилась возможность обновления текстовых полей по деталям ошибки.
Прочее
При создании нового сценария появилась возможность использовать собственный шаблон новой фичи (путь к шаблону новой фичи указывается в настройках системных каталогов на закладке Основные).
Как начать применять автоматизированное тестирование
На Инфостарте опубликован ряд статей, помогающих освоить автоматизированное тестирование с помощью Vanessa Automation.
Функциональность Vanessa Automation можно использовать в полном варианте (в виде каталога инструментов) и в варианте Single (как единую обработку, но без поддержки обычных форм).
Установить релиз Vanessa Automation 1.2.040 можно двумя способами:
- если у вас используется пакетный менеджер, входящий в поставку OneScript, то через командную строку:
opm install vanessa-automation (или opm install vanessa-automation-single) - либо скачать архив в релизах проекта на GitHub и развернуть в каталог по любому удобному пути.
Проект Vanessa Automation открыт как для разработки, так и для использования.