Vanessa Automation 1C: что это и как применять на практике

Vanessa Automation — это открытый инструмент автоматизированного тестирования прикладных решений на платформе 1С:Предприятие. Проект распространяется бесплатно, развивается сообществом и используется командами разработки для проверки типовых и доработанных конфигураций: от «Управления торговлей» до самописных учётных систем. Инструмент позволяет описывать поведение системы на понятном языке сценариев и воспроизводить действия пользователя без ручных кликов.

Основная идея — сценарии тестирования пишутся на языке Gherkin, близком к обычной деловой речи. Строка вида «И я создаю документ Реализация товаров» читается и бухгалтером, и разработчиком, а Vanessa Automation превращает её в реальные действия в клиентском приложении 1С. За счёт этого тесты становятся одновременно исполняемой документацией.

Инструмент реализован как внешняя обработка (.epf), поэтому не требует изменения конфигурации и подходит даже для баз на полной поддержке. Это существенно снижает порог входа: достаточно скачать дистрибутив, открыть обработку в режиме предприятия и подготовить первый сценарий.

Для чего используется Vanessa Automation в проектах 1С

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

Второе применение — приёмочное тестирование доработок. Аналитик описывает ожидаемое поведение в виде feature-файла, разработчик реализует функциональность, а сценарий подтверждает, что результат соответствует постановке. Это снимает споры «работает / не работает» между заказчиком и исполнителем.

Третий сценарий — подготовка демонстрационных данных и обучающих материалов. Vanessa Automation умеет записывать видео выполнения сценария с автоматическим закадровым текстом, что используется для создания инструкций пользователям без ручного монтажа роликов.

Как устроен инструмент: компоненты и принцип работы

В основе лежат два процесса. Первый — менеджер тестирования, обработка Vanessa Automation, которая читает feature-файлы, управляет запуском и собирает отчёты. Второй — клиент тестирования, отдельный сеанс 1С, в котором фреймворк через механизм тестирования платформы воспроизводит действия: открывает формы, заполняет поля, нажимает кнопки.

Сценарии хранятся в текстовых файлах с расширением .feature. Каждый файл содержит структуру «Функционал — Сценарий — Шаги», где шаги начинаются со слов «Дано», «Когда», «Тогда». Библиотека готовых шагов Vanessa Automation покрывает типовые действия: создание документов, проверку значений полей, работу с табличными частями, вызов отчётов.

Как установить и подготовить к первому запуску

Установка сводится к загрузке дистрибумента из репозитория проекта и открытию обработки в режиме 1С:Предприятие. Для работы клиента тестирования потребуется, чтобы в конфигураторе был разрешён запуск внешних обработок и включён механизм тестирования — соответствующий параметр указывается в командной строке запуска сеанса либо настраивается через флаг отладки.

Перед началом работы подготовьте отдельную копию информационной базы. Тесты создают и проводят документы, меняют справочники, и выполнять их в рабочей базе недопустимо. Также убедитесь, что версия платформы поддерживает автоматизированное тестирование — механизм доступен в актуальных релизах 1С:Предприятие 8.3.

1. 1
   Скачайте дистрибутив Vanessa Automation из официального репозитория проекта
2. 2
   Создайте копию рабочей базы или чистую тестовую базу с демоданными
3. 3
   Откройте обработку Vanessa Automation в режиме 1С:Предприятие
4. 4
   Настройте подключение клиента тестирования (порт, параметры запуска)
5. 5
   Загрузите пример feature-файла из поставки и выполните его
6. 6
   Проверьте отчёт о прохождении шагов и скриншоты ошибок

Как написать первый сценарий на Gherkin

Начните с простого бизнес-процесса, который легко проверить вручную, — например, создания и проведения документа. Определите исходные данные (какие справочники должны существовать), действие (что делает пользователь) и контрольную точку (какое значение или состояние должно получиться).

Используйте шаги из встроенной библиотеки Vanessa Automation — их список доступен прямо в обработке на закладке «Библиотека шагов». Собственные шаги пишите только тогда, когда готовых не хватает: каждый самописный шаг — это код, который тоже нужно поддерживать.

# language: ru
Функционал: Проверка создания документа

Сценарий: Создание и проведение приходной накладной
	Дано Я открыл основную форму списка документа "ПриходнаяНакладная"
	Когда я нажимаю на кнопку с именем 'ФормаСоздать'
	И в поле с именем 'Номенклатура' я ввожу текст 'Тестовый товар'
	И я нажимаю на кнопку с именем 'ФормаПровести'
	Тогда не появилось окно предупреждения системы

После написания сценария прогоните его несколько раз подряд. Стабильный тест проходит одинаково при повторных запусках; если результат «плавает», причина обычно в зависимости от данных прошлых прогонов или в ожиданиях открытия форм — добавьте шаги паузы или очистку данных в начале сценария.

Запуск тестов и анализ результатов

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

Для командной работы тесты подключают к CI-контуру: сборка конфигурации, развёртывание тестовой базы, запуск Vanessa Automation через командную строку, публикация отчёта в формате Allure или jUnit. Это позволяет видеть динамику падений по сборкам и находить доработку, которая сломала сценарий.

Типичные ошибки и ограничения инструмента

Самая частая ошибка новичков — привязка шагов к текущим данным конкретной базы: «проверить, что контрагент Иванов существует». После обновления тестовой базы такой сценарий падает. Правильный подход — сценарий сам создаёт нужные данные в секции «Дано» либо использует подготовленный эталонный набор.

Вторая ошибка — попытка автоматизировать всё подряд. Проверка печатных форм с точностью до пикселя или сложных интеграционных обменов через UI требует непропорциональных усилий. Такие участки разумнее покрывать модульными тестами или ручным контролем.

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

Альтернативы Vanessa Automation

Выбор инструмента зависит от задачи и зрелости команды. Для модульного тестирования кода есть xUnitFor1C, для нагрузочных проверок — специализированные решения и Тест-центр из КИП. Vanessa Automation занимает нишу именно поведенческого UI-тестирования с читаемыми сценариями.

Частые вопросы о Vanessa Automation