Vanessa 1c с чего начать

Обновлено: 04.07.2024

В апреле разработчики представили новую версию инструмента тестирования и автодокументирования прикладных решений на платформе «1С:Предприятие» Vanessa-Automation: 1.2.023.

Основные изменения в этой версии:

  • возможность посмотреть и отредактировать переменные контекста;
  • возможность сбора дополнительной информации при множестве кликов, необходимой для перевода сценариев на другие языки;
  • возможность кешировать файлы Text to speech;
  • возможность кешировать видеовставки.

Как появилась система

В версии платформы «1С:Предприятие 8.3.2» появилась возможность автоматического тестирования, которое заключается во взаимодействии двух, особым образом запущенных клиентских приложений. Новая опция настраивалась в меню из режима конфигуратора или с ключом при запуске клиента.

Штатное использование этого механизма оказалось трудоемким, возникла необходимость в автоматизации тестирования. Поэтому на основе платформенного механизма появилось несколько проектов, один из которых – Vanessa-Automation. Система позволяет автоматизировать тестирование со стороны действий пользователя и записать инструкции по изменениям функционала.

Как работает система

Запустив программу для записи, мы производим некие действия, которые записываются в так называемый сценарий. Запустив выполнение сценария, мы можем отследить, отвечает ли поведение системы запланированным в сценарии действиям или нет: отклонения фиксируются, поэтому можно отследить, на каком этапе что-то пошло не так.

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

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

Подключаться для тестирования можно и к нескольким клиентам разных конфигураций, отрабатывая один и тот же тест. Это удобно для замера производительности в разных документах, а также для отладки обмена между базами. Также из удобных функций – возможность получить имена элементов формы, заголовки, дерево элементов с учетом созданных программно из режима «1С: Предприятие» , что удобно для QA-инженеров, которым неудобно заходить в конфигуратор и разбирать формы там.

Вышел новый релиз инструмента тестирования прикладных решений на платформе «1С:Предприятие» Vanessa Automation 1.2.028. Получил развитие механизм автодокументирования с помощью видеоинструкций – эта возможность находит все больше сторонников.

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

Новые возможности автоинструкций

Новый релиз позволяет записывать видеоинструкции с несколькими голосами: о функциональности решения 1С теперь можно рассказать в форме диалога.

«Ролевые игры» с Vanessa Automation

Для разных шагов одного сценария можно одновременно использовать несколько голосовых движков (например, Yandex и Amazon) – если комментарии к инструкции нужны сразу на нескольких языках, не придется жертвовать качеством из-за некорректного произношения в голосовом движке.

Указывайте предварительный и заключительный (Intro и Outro) видеофайлы для автоинструкций – автоматическая склейка нескольких видеофайлов будет полезной, если вы хотите сделать для инструкции свое вступление/заключение.

Создавайте видеовставки на основе произвольных изображений с помощью шага « И видеовставка картинки "ИмяКартинки" "Текст диктора" » – теперь видеоинструкции можно записывать не только из 1С.

Финальный слайд для итогового видео отключается интерактивно – из командного режима такая возможность была уже давно, теперь она реализована и в интерфейсе обработки.

Реализован шаг « И я рисую рамку вокруг картинки» – так удобнее акцентировать внимание на деталях инструкции.

Доступен новый механизм передвижения мышки на экране к элементам формы.

Новые шаги и команды

При написании сценариев часто возникает ситуация, когда надо быстро отредактировать часть шагов сразу после того, как они были «накликаны».

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

Новые команды для выделенных строк

Из строки дерева шагов можно перейти к определению в дереве известных шагов по комбинации клавиш Ctrl+I. Это позволит быстро найти описание шага, плюс посмотреть, какие шаги выполняют похожие действия.

Новый шаг, позволяющий сохранить скриншот по указанному пути, упрощает отладку при написании сценария.

Появилась возможность автоподстановки значений переменных в таблицах Gherkin – ранее автоподстановка переменных была только в шагах.

Vanessa Automation + СППР

В СППР 2.0 появилась возможность встраивать Vanessa Automation в качестве фреймворка автоматизированного тестирования. Это позволяет связывать сценарии тестирования с метаданными, ошибками, ответственными и функциями системы.


Новая функциональность СППР

Перед использованием совместно с Vanessa Automation, СППР нужно настроить:

  • включить функциональную опцию «Использовать сценарии тестирования»;
  • указать в персональных настройках каталог для данных тестирования и путь к обработке Vanessa Automation;
  • настроить базу данных для запуска тестов;
  • создать сценарии тестирования и… запустить их на выполнение.

Как начать работу с Vanessa Automation

Для тех, кто хочет узнать о новых возможностях СППР больше, фирма «1С» провела вебинар «Автоматизированное тестирование в СППР 2.0». В нем рассказано о работе СППР в связке с Vanessa Automation.


Установить релиз 1.2.028 можно двумя способами:

если у вас используется пакетный менеджер, входящий в поставку OneScript, то через командную строку:
opm install vanessa-automation

либо скачать архив в релизах проекта на GitHub и развернуть в каталог по любому удобному пути.


Проект Vanessa Automation открыт как для разработки, так и для использования.


Фирма «1С» начала публикацию сценариев для автотестирования релизов 1С:ERP на Vanessa Automation.

Информацию об этом на своей странице facebook опубликовал Алексей Кислов, руководитель подразделения «Развитие практик ERP» фирмы «1С».

Выложенные сценарии тестирования дадут возможность фирмам, внедряющим 1С:ERP, тестировать на проектах свои «допиленные» конфигурации.

Состав дистрибутива

Дистрибутив, содержащий сценарии для автоматизированного тестирования 1C:ERP версии 2.5.4.102, доступен для скачивания пользователям 1C:ERP и фирмам-партнерам в сервисе «1C:Обновление программ» портала 1С.

Сам дистрибутив тестов для 1C:ERP пока что содержит небольшое количество файлов – это библиотека шагов, инструкция по запуску тестирования, один feature-файл для тестирования и выгрузка демо-базы 1С:ERP 2.5.4.102, но не содержит саму обработку Vanessa Automation (её можно скачать отдельно из репозитория на GitHub):


Как настроить и запустить сценарий тестирования в своей проектной базе 1С:ERP

  1. Создаем клиент тестирования из приложенного к архиву dt-файла конфигурации 1С:ERP 2.5.4.102 (База А: Это ваша проектная база ERP).
  2. Создаем менеджер тестирования (База Б: Любая другая база, запущенная с ключом /TestManager).
  3. Запускаем в Базе Б обработку Vanessa Automation (её можно скачать отдельно из репозитория на GitHub).
  4. Добавляем путь к поставляемой библиотеке шагов на вкладке «Библиотеки» и нажимаем кнопку «Сохранить настройки»:



  1. На вкладке «Клиенты тестирования» задаем параметры запуска основной тестируемой базы (указываем доступ для профиля «Администратор»):




  1. Открываем приложенный к дистрибутиву feature-файл:






Всего текущий тест «Производство с планированием по материальным и производственным ресурсам УП 2_5_4_102 платформа 8_3_16_1148» содержит 4 сценария, каждый из которых можно запускать по отдельности:


Как начать применять сценарии тестирования

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

Но теперь, поскольку сама фирма «1С» начала публиковать сценарии для тестирования своего флагманского продукта 1C:ERP, начать тестировать свои доработки на базе выложенных сценариев стало гораздо проще.

В прошлом релизе во фреймворк Vanessa Automation 1.2.029 была встроена внешняя компонента для снятия скриншотов 1cWinCtrl, которая не требует установки на компьютер внешних инструментов для перехвата изображений.


Возможность использовать компоненту указывается в настройках на закладке «Сервис».


В новом релизе Vanessa Automation 1.2.030 разработчики добавили возможность управления размером и положением окна тест-клиента (чтобы не приходилось редактировать изображения в автоматически сформированных инструкциях). Задать настройки можно на вкладке «Работа с UI» при подключенном тест-клиенте.


В окне настройки реализовано задание положения (координаты X и Y) окна тест-клиента, установка для него наиболее часто используемых размеров, а также произвольного размера с указанием ширины и высоты – W и H.

Использование встроенной компоненты позволит сделать ваши HTML-инструкции, построенные в результате автодокументирования, более компактными.

Добавление к отчету Allure данных журнала регистрации

Если в процессе тестирования «падает сценарий», проанализировать причины стало проще. Теперь в отчете Allure к упавшему сценарию помимо скриншота можно приложить журнал регистрации в формате xlsx.


В вывод журнала регистрации попадут только данные с момента начала выполнения сценария.

Прочие доработки и улучшения

По мере развития фреймворка его возможности становятся более предсказуемыми. В частности:

  • в параметрах тест-клиента по умолчанию «Путь к инфобазе» заполняется значением СтрокаСоединенияИнформационнойБазы();
  • при загрузке настроек VBParams в таблицу тест-клиентов добавляются только отсутствующие по именам клиенты, а те, которые совпадают по имени, замещаются (клиенты в таблице объединяются с клиентами в файле настроек);
  • поиск исполняемого файла внешних редакторов VSCode и Notepad++ производится по пути из PATH;
  • возвращена поддержка указания относительных путей в настройках VBParams через параметр $workspaceRoot (используется наравне с «./»);
  • реализована интерактивная проверка на задвоение имен сценариев в разных фичах (в виде команды «Проверить дублирование сценариев» в меню «Еще») и другие улучшения.

В текущем релизе увеличено покрытие кода фреймворка – написано 100 новых тестов для проверки работы Vanessa Automation.

Произведен рефакторинг кодовой базы – почищен и систематизирован код, уменьшено дублирование.

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

Систематизированы feature-файлы по тестированию проекта – в каждом feature-файле проставлены теги системы StoryMapper, чтобы упорядочить информацию о прохождении тестов по функциональным блокам и визуализировать наполнение этих блоков тестовыми сценариями (авторы сервиса обещают, что функциональность StoryMapper будет доступна разработчикам опенсорсных проектов бесплатно).

Поддерживается работа браузерного расширения ff-for1c-ext (на уровне альфа-версии), которое в совокупности с расширением конфигурации VA_Browser реализует новый подход к созданию автоинструкций для веб-клиента (автоподсветка активного элемента, определение координат, рисование на форме произвольных изображений с помощью HTML и т.д.).

Как установить и использовать Vanessa Automation

Функциональность Vanessa Automation можно использовать в полном варианте (в виде каталога инструментов) и в варианте Single (как единую обработку, но без поддержки обычных форм). Vanessa Automation Single удобно использовать в составе расширений, встраивать в свою конфигурацию и т.д. Также вариант поставки «Single» удобен для тех, кто использует Vanessa Automation только для написания сценариев и не планирует её дорабатывать.

Установить релиз 1.2.030 можно двумя способами:

если у вас используется пакетный менеджер, входящий в поставку OneScript, то через командную строку:
opm install vanessa-automation (или opm install vanessa-automation-single)

либо скачать архив в релизах проекта на GitHub и развернуть в каталог по любому удобному пути.

Проект Vanessa Automation открыт как для разработки, так и для использования.

Читайте также: