Что такое Vanessa Automation и Gherkin
Vanessa Automation – это инструмент тестирования прикладных решений на платформе 1С: Предприятие. Представляет набор обработок, схожи с «инструментами разработчика 1С», состоящая из фреймворков для удобного и гибкого тестирования конфигураций. Реализация написания тестов происходит полностью на языке Gherkin.
Gherkin - это человекочитаемый язык, который используется для описания поведения системы. Данный язык является отличным от языка программирования 1С, но при этом весьма простым и понятным, из-за чего его освоение не занимает много времени.
Первым делом необходимо скачать Vanessa Automation. Это open source программа, поэтому лежит в свободном доступе. На github лежит бесплатная и последняя версия ванессы. Важно так же знать, что автор данной обработки частенько преподносит в свою программу изменения.
Одним из подобных, недавних изменений стала полностью озвученная и интуитивно понятная документация, которая встроена сразу в обработку ванессы. Данная документация может нуждаться в дополнительной выгрузке файлов из сети интернет для своей работы.
После скачивания и распаковки файла запускаем сервер 1С Предприятие с параметром /TESTMANAGER. Если данный параметр не задан, то Ванесса просто не станет работать корректно и с большей вероятностью даже не запустится.
Тут же, подобно обычной обработке, необходимо открыть файл формата .epf, который был до этого распакован. После чего запустится интерфейс обработки. Сам по себе он интуитивно понятный. Даже если что-то вызывает вопросы, то хочу вас сразу порадовать, автор предусмотрительно записал множество обучающих роликов, который понятным языком объясняют весь функционал ванессы и ее настройки.
Сценарии в ванессе
Сценарии в ванессе имеют особое название по своему расширению, а именно фича файлы. Прежде, чем написать свою первую фичу, стоит обратить свое внимание на одну очень интересную вещь, а именно на папку, которая скачивается с файлом vanessa-automation.epf. Начнем с самого начала:
В папке .github находятся файлы, которые можно открыть с помощью блокнота. Здесь разработчик заботливо разместил шаблоны для отправки найденных в программе ошибок или же доработок, которые хотят внести пользователи. Данные файлы полностью описывают возможность сделать свой вклад в эту open source программу.
На файл папка docs стоит обратить особое внимание. Если вдруг что-то не запускается, не работает или же возникает какая-то проблема, то стоит сразу же залезть в папку FAQ. Здесь в разных файликах собраны многочисленные ответы на часто возникающие вопросы. Так как данных инструмент не имеет особой популярности и найти порой ответы на возникшие ошибки очень проблемно, данные файлы могут сократить вам часы поисков решения элементарных ошибок. В этом же файле docs располагаются и полезные файлы для разработчиков. Такие, как запуск vaness для мобильных версий или же параметры JSON файла, если вдруг появилась в нем нужда. Разработчик очень кропотливо расписал всевозможные вариации использования ванессы на разных платформах. Помимо инструкций и подсказок, здесь же можно найти файл changelog, который в подробностях описывает изменения вашей версии. Данная папка является рекомендуемой к ознакомлению, как и для новичков в Ванесса, так и для продвинутых пользователей.
Следующий файл — это папка example. Очень полезная папка для начинающих разработчиков 1С. Тут представлены примеры простых и сложных фич, которые можно открыть с помощью Ванессы и ознакомиться до того, как начнется запись вашего теста. Здесь же есть папка с уроком по созданию интерактивного помощника.
Папка feature по большей части предназначена для разработчиков. Она хранит внутри себя компоненты и функциональность продукта и автоматизированные сценарии проверки структурированные по подсистемам и объектам продукта. Данная папка по большей части пригодится для продвинутых разработчиков, которые хотят полностью потрогать весь функционал ванессы.
Далее папка lib. Предназначена для хранения внешних отчетов и обработок необходимых для работы продукта, разработанные в рамках создания продукта и не являющиеся сторонними разработками. Данная папка является целиком и полностью функциональной. Здесь хранятся файлы для того, чтобы ванесса могла корректно работать. Именно в эту папку не стоит лишний раз, без уверенности, вносить какие-либо изменения.
Также папкой, которая может привлечь наше внимание, является папка plugins. Внутри себя она содержит несколько внешних обработок, которые могут пригодиться разработчикам при работе с более продвинутым функционалом ванессы. Такими как например подключению ванессы прямиком к БД и получение запросов напрямую.
Если по какой-то причине вы работаете в закрытой системе без доступа к интернету. Скорее всего вы не сможете прослушать все видеоуроки по Ванессе. Но это совершенно не проблема. В папке training находятся как отдельные фича-файлы с уроками, так и блокнот с текстовым представлением всех видео уроков. Таким образом вы легком сможете ориентироваться в большом количестве инструкций. Эта папка так же рекомендуется к просмотру новичков.
Таким образом, подводя итог, мы поверхностно рассмотрели Ванессу как инструмент для написания автотестов, так и познакомились с ее внутренним строением.
