Vanessa 1c с чего начать
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Open with Desktop
- View raw
- Copy raw contents Copy raw contents
Copy raw contents
Copy raw contents
Автоматизация повседневных операций 1С разработчика
Автоматизация повседневных операций 1С разработчика
Консольное приложение проекта oscript.io для автоматизации различных операции для работы с cf/cfe/epf файлами, а также автоматизация запуска сценариев поведения (BDD) и тестов из фреймворка Vanessa-ADD.
Предназначено для организации разработки 1С в режиме, когда работа в git идет напрямую с исходниками или работаем через хранилище 1С.
Позволяет обеспечить единообразный запуск команд "локально" и на серверах сборки CI-CD
используйте пакетный менеджер opm из стандартной поставки дистрибутива oscript.io
при установке будет создан исполняемый файл vrunner в каталоге bin интерпретатора oscript .
После чего доступно выполнение команд через командную строку vrunner
Ключ help покажет справку по параметрам.
или внутри батника (ВАЖНО) через call
Основной принцип - запустили bat файл с настроенными командами и получили результат.
С помощью команды init-project можно создать структуру проекта следующими командами:
Команда клонирует шаблон vanessa-bootstrap и предложит для установки три библиотеки для проекта:
Примеры создания проекта
1. Создание проекта по указанному шаблону
--template cсылка на шаблон, из которого будет клонироваться проект.
При использовании ключа --template клонируется указанный шаблон, считываются пакеты из env файла шаблона, если пакеты не заданы предлагаются библиотеки по умолчанию.
2. Создание проекта по файлу настроек
Добавлены следующие настройки:
Для установки пакетов gitrules и precommit1c последовательно выполняются указанные команды.
При использовании ключа --settings считываются пакеты из указанного файла env, если пакеты не заданы предлагаются библиотеки по умолчанию.
3. Сборка обработок при создании проекта
Вы можете объединить несколько команд в файл cmd / bat и указать его как пакет:
В данном примере будут собраны обработки при создании проекта. Содержимое файла compileEpf.cmd :
Сборка обработок и конфигураций
Для сборки обработок необходимо иметь установленный oscript в переменной PATH и платформу выше 8.3.8
В командной строке нужно перейти в каталог с проектом и выполнить tools\compile_epf.bat , по окончанию в каталоге build\epf должны появиться обработки. Вся разработка в конфигураторе делается в каталоге build, по окончанию доработок запускаем tools\decompile_epf.bat
Обязательно наличие установленного v8unpack версии не ниже 3.0.38 в переменной PATH.
Примеры настройки и вызова
1. Создание ИБ из последней конфигурации хранилища 1С, обновление в режиме Предприятия и первоначальное заполнение ИБ
2. Вызов модульных тестов через Vanessa-ADD (TDD)
запуск vrunner xunit tests --settings tools/vrunner.json
- или внутри батника
- call vrunner xunit --settings tools/vrunner.json
Формат файла настройки (в примере xUnitParams.json) для тестов смотрите в справке Vanessа-ADD
Подсказка из командной строки
3. Вызов проверки поведения через Vanessa-ADD (BDD)
запуск vrunner vanessa --settings tools/vrunner.json
- или внутри батника
- call vrunner vanessa --settings tools/vrunner.json
Формат файлов настройки и других параметров запуска BDD смотрите в справке Vanessа-ADD
Подсказка из командной строки
4. Переопределение аргументов запуска
В случае необходимости переопределения параметров запуска используется схема приоритетов.
Приоритет в порядке возрастания (от минимального до максимального приоритета)
- env.json (в корне проекта)
- --settings ../env.json (указание файла настроек вручную)
- RUNNER_* (из переменных окружения)
- --* (ключи командной строки)
- На первоначальном этапе читаются настройки из файла настроек, указанного в ключе команды --settings tools/vrunner.json
- Потом, если настройка есть в переменной окружения, тогда берем из неe.
- Если же настройка есть, как в файле json, так и в переменной окружения и непосредственно в командной строке, то берем настройку из командной строки.
Переопределение переменной окружения
Допустим, в файле vrunner.json указана настройка
а нам для определенного случая надо переопределить имя пользователя, тогда можно установить переменную: set RUNNER_DBUSER=Иванов и в данный параметр будет передано значение Иванов
Очистка значения после установки
в данном случае установлено полностью пустое значение и имя пользователя будет взято из tools/vrunner.json, если оно там есть.
Установка пустого значения:
Если необходимо установить в поле пустое значение, тогда указываем кавычки и в параметр --db-user будет установлена пустая строка.
Переопределение через параметры командной строки.
Любое указание параметра в командной строке имеет наивысший приоритет.
При указании значений параметров внутри строки с параметром можно использовать шаблонные переменные. Список таких переменных:
- workspaceRoot - означает каталог текущего проекта
- runnerRoot - означает каталог установки Vanessa-Runner
- addRoot - означает каталог установки библиотеки Vanessa-ADD
Вывод отладочной информации
Управление выводом логов выполняется с помощью типовой для oscript-library настройки логирования через пакет logos.
Основной лог vanessa-runner имеет название oscript.app.vanessa-runner .
Включение всех отладочных логов:
Включит отладочный лог только для библиотеки cmdline, которая анализирует параметры командной строки.
Дополнительные обработки для режима 1С:Предприятие
В папке epf есть несколько обработок, позволяющих упростить развертывание/тестирование для конфигураций, основанных на БСП.
Основной пример (см. ниже пример вызова) - это передача через параметры /C команды "ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы" и одновременная передача через /Execute "ЗакрытьПредприятие.epf" .
При запуске с такими ключами подключается обработчик ожидания, который проверяет наличие формы с заголовком обновления и при окончании обновления завершает 1С:Предприятие. Данное действие необходимо для полного обновления информационной базы 1С:Предприятия, пока действует блокировка на фоновые задачи и запуск пользователей.
также выполняется отключение запроса при завершении работы программы для БСП-конфигураций
ЗагрузитьРасширение позволяет подключать расширение в режиме предприятия и получать результат ошибки. Предназначено для подключения в конфигурациях, основанных на БСП. В параметрах /C передается путь к расширению и путь к файлу лога подключения.
ЗагрузитьВнешниеОбработки позволяет загрузить все внешние обработки и подключить в справочник "Дополнительные отчеты и обработки", т.к. их очень много то первым параметром идет каталог, вторым параметром путь к файлу лога. Все обработки обновляются согласно версиям.
СозданиеПользователей позволяет создать первого пользователя-администратора, если в ИБ еще не существует пользователей. Администратор назначается роль ПолныеПрава , если она существует в ИБ.
также выполняется отключение запроса при завершении работы программы для БСП-конфигураций
код запуска для создания пользователя с именем Администратор
Дополнительная настройка различных команд
Настройка синтаксической проверки
Для управления режима синтаксической проверки рекомендуется использовать json-файл настройки. Для его использования нужно
Я расскажу об инструменте, который из сценария, написанного на Gherkin (есть такой язык сценариев), делает инструкцию, а точнее — актуальную документацию (Living documentation).
Чтобы вас не томить — сразу покажу результат моих (и не только) трудов.
Я расскажу вам как из сценария, написанного ниже, сделать вот такой вот ролик одним кликом. Замечу, что сценарии можно писать не только на русском языке, но и на других языках.Не секрет — документация со временем устаревает, а поддерживать её в актуальном состоянии затратно, да и “ломает”. Документация уже есть, но постоянно надо что-то дополнять, менять скрины и т.п. Тут из ниоткуда выныривают бородатые дядьки и уверяют, что есть волшебный способ сделать всю вашу разработку по крутому (все эти ваши модные TDD/BDD/и т.д.), с помощью которого весь ваш код пишется сам, сам себя тестирует и документирует.
И вот, движимые ленью и верой в светлое будущее, программисты 1С решили реализовать этот концепт. Я буду показывать как это работает на примере инструмента Vanessa-Automation.
Забыл сказать (на самом деле, конечно не забыл, а сознательно оттягивал :-) — этот инструмент для 1С. Моя цель рассказать вам об инструменте, дополняющем 1С. Да, такие инструменты есть, даже больше — они выложены на github и активно развиваются. Позволю себе небольшое отступление. Многие знают, что сейчас есть много фреймворков для JavaScript, то есть живут настоящим, но почему-то многие в отношения 1С живут прошлым. Я хочу показать, что мир 1С развивается. Есть нормальные Open Source инструменты для 1С.
Итак. Одним пользователем нужна документация в виде текстовой документации (HTML, Markdown), другим в виде скринкаста, третьим в виде автовидео. И для всех "хотелок" есть решение в одном флаконе.
Для того, чтобы генерировать HTML и текст в markdown, необходимо установить утилиту для снятия скриншотов (IrfanView, nircmd или подобное). Далее включаем данную настройку. (Сервис — Автоинструкции. Ищем раздел HTML и Markdown). Настраиваем папку, в которую будем сохранять автоматически сгенерированные автоинструкции. Пример:
Запускаем нашу feature, если не было ошибок — сохраняется автоинструкция:
Без всякого труда мы можем сделать видео. Для этого необходимо настроить окружение для записи видео по инструкции и наслаждаться процессом. Не надо нарезать видео, склеивать и накладывать звук. Это всё делается автоматически.
Каждое видео идёт с субтитрами. Можем поставить на паузу и почитать. Не сложно. Делаем максимально удобно для пользователя.
Если скучно читать, можно сделать озвучку голосом. Для этого устанавливаем библиотеку и запускаем наш сценарий. Через пару минут видео с озвучкой будет готово.
Есть функция накладывания водяного знака, подсветки активного элемента на экране (эта фича работает для версий платформы 8.3.11 и ниже) (да, пользователи любят когда им всё разжевывают) и движения мышки туда, где происходит “Экшн”.
Всё начинается со сценария и на нём же заканчивается. Именно так.
Можно настроить ваш CI сервер так, чтобы он генерировал не для всех сценариев документацию, а только для необходимых. Для этого в сценариях, предназначенных для автодоков добавляем тег, например @tree (далее будет работать отбор по этому тегу) и… наслаждаемся процессом.
По идее, когда вы пишете большой сценарий, вам всё равно придётся его делить на логические блоки, делать в нём комментарии (что вот этот супер важный флажок надо установить, иначе ничего работать не будет).
Идея автовидео в том, чтобы эти комментарии стали частью “истории”, которую мы показываем пользователю.Когда мы смотрим сгенерированное видео, то там изначально будет только видео без звука. Мелькают какие-то скриншоты и текст, становится скучно и перестаёшь вникать. Да и грустно как-то без музыки. Фоном к видео можно поставить “лёгкую” музыку (или какую-нибудь тяжесть, любой каприз), чтобы веселее читалось. Процесс изучения пойдёт быстрее :) Опыт создания таких видео показал, что когда фоном играет музыка, то видео воспринимается проще. Без музыки — сухо как-то.
При записи видео не отображается курсор и не видно куда мы нажимаем, на какой элемент. Для этого есть настройка отображения курсора и подсветка элемента формы.
Все вышеперечисленные настройки показаны в видео и в сценарии, которые сгенерировались после успешного прохождения сценария.
Для ночной сборки (ну мы же не собираемся заливать ролики на ютуб руками, правда?) можно реализовать автоматическое выкладывание видео на youtube канал.
Натравливаем на папку с нашими feature скрипт, который определяет, что файл изменился, затем делает сборку видео и заливает его куда надо.
Для автовидео я сделал простое приложение на Golang (почему на нём? Изучал go и появилась реальная задача, где можно его применить. Если было бы что-то другое, было бы на чём-то другом), которое отправляет готовый ролик на youtube канал. Это, конечно, просто пример. Видео можно добавлять в ваши Wiki или базу знаний и т.п.Привожу вам тестовый сценарий, по которому сгенерировано видео.
Пример, feature.Краткая инструкция как настраивать автодокументирование лежит тут.
Инструкция как настраивать автодокументацию.Спасибо за потраченное время. Как бы дико это не звучало, но 1С сообщество шагнуло вперёд ( и в чём-то даже кого-то обогнало ), появились opensource инструменты тестирования, CI — интеграция. 1С делает для своих продуктов API — это и позволяет энтузиастам автоматизировать участки, до которых 1С пока не дошла, но потихоньку идёт. А скоро нас ожидает новый дивный мир :) Я в ожидании, когда мы сможем без критических ошибок творить в EDT.
Поддержите проект добрым словом, лайком, критикой (чат проекта в Gitter находится здесь) авторам это всегда приятно.
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Open with Desktop
- View raw
- Copy raw contents Copy raw contents
Copy raw contents
Copy raw contents
BDD for 1С:Enterprise
- Текущий релиз в ветке Master: 1.2.038.1
- Разработка ведется в ветке Develop. в телеграм группе, и обсудить всё, что связано с тестированием в 1С. в телеграм канале.
Проект использует принцип формирования автодокументации в формате Markdown и видео:
Как стать контрибьютором (предложить свои доработки) проекта?
Статьи по Vanessa Automation
СППР + Vanessa Automation
Сборка из исходников
В данном репозитории хранятся только исходники. Вы можете собрать необходимые файлы сами, либо скачать готовую сборку. При первом скачивании репозитория необходимо собрать файлы обработок.
- Чтобы работала сборка epf надо установить OneScript версии 1.4.0.177 или выше.
- Также, чтобы работала сборка и разборка epf надо установить платформу 1С:Предприятие 8.3.17.
- Для запуска сборки epf из исходников надо запустить Compile.bat. .
Чтобы зафиксировать изменения epf файлов, нужно запустить Decompile.bat.
Установка через OneScript
Для обычной сборки
Для сборки VASingle.
VASingle отличается от обычной сборки тем, что поставляется в виде одного epf файла, который по функциональности полностью совпадает с основной сборкой.
Описание простого использования
- пишем feature файлы в формате Gherkin - рекомендуется использовать встренный редактор (VAEditor), созданный на базе VSCode.
Классический вариант использования (без интерактивного режима)
Фактически классический вариант использования представляет собой следующий порядок действий:
- зафиксировали требования к информационной системе;
- создали автоматизированные сценарии проверки в виде epf файлов, если не хватает уже готовых;
- наполнили шаги сценариев (сниппеты) кодом проверки поведения;
- запустили сценарии проверки поведения и убедились, что они НЕ работают;
- разработали функционал;
- запустили сценарии проверки поведения;
- убедились что сценарии проверки работают и отчет о проверки показывает "Зелёный" статус.
Использование в режиме проверки поведения пользовательского интерфейса
Для команд уже имеющих функционал или производящих доработку конфигураций, работающих на управляемых формах, действует упрощенный порядок использования:
- зафиксировали требования к информационной системе;
- разработали управляемые формы или рабочие столы конфигурации в режиме прототипирования;
- запустили запись интерактивных действий пользователя в режиме менеджера тестирования;
- дополнили сценарии шагами, проверяющими результат работы (например, проверка движений документа)
- разработали основной функционал;
- запустили сценарии проверки поведения;
- убедились что сценарии проверки работают и отчет о проверки показывает "Зелёный" статус.
Кто пишет feature файлы ?
Feature файлы могут писать все участники команды:
- менеджер проекта - если обнаружил что заказчику необходимо новое поведение;
- бизнес или системный аналитик - на основе собранных требований и технических заданий;
- ведущий разработки - если обнаружил, что требования недостаточно структурированы;
- архитектор или эксперт 1С - если текущие сценарии некорректно спроектированы с точки зрения метаданных;
- тестировщик - когда пишет сценарии для проверки поведения.
Если вы не уверены в правильности ожидаемого поведения, используйте для этого системы тэгов:
- "@Draft@" - черновик требования
- "@Предварительно" - начальные заметки
и подобные им обозначения
Файл профиля запуска обработки
Для запуска в консольном режиме используется понятие профиль консольного запуска. Профиль консольного запуска предназначен для удобной передачи параметров. Профиль запуска представляет собой текстовый файл в формате JSON.
Текущие параметры запуска:
- Каталог фич - каталог где собраны требования заказчика описанные на языке Gherkin
- ВыполнитьСценарии - признак того, что необходимо запустить выполнение сценариев
- ДелатьОтчетВФорматеАллюр - признак того, что необходимо формировать HTML отчёт о результатах проверки
- КаталогOutputAllureБазовый - адрес каталога для где будет формироваться HTML отчёт
- ЗавершитьРаботуСистемы - признак того, что окончанию работы необходимо завершить работу 1С предприятия
- ВыгружатьСтатусВыполненияСценариевВФайл - признак, что необходимо формировать файл с финальным статусом проверки
- ПутьКФайлуДляВыгрузкиСтатусаВыполненияСценариев - по данному пути будет сформирован файл со статусом проверки (обычно используется на серверах сборки для автоматизированного указания статуса сборки)
- СписокТеговИсключение - массив текстовых тэгов, для исключения из проверки (используется например для черновиков сценариев и требований)
- СписокТеговОтбор - массив текстовых тэгов для запуска проверки поведения по сценариям, содержащим любой из указанных тэгов
- и другие
Профиль запуска предназначен для простого консольного запуска, пример подобной командной строки выглядит так:
Описание всех параметров командной строки можно найти тут
Описание всех параметров файла VAParams.json можно найти тут
Загрузка глобальных переменных из внешнего файла
Чтобы не зашивать в тесты все плавающие пользовательские переменные, такие как имена баз, строки подключения, логины, пароли и др., имеется возможность вынести эти переменные во внешний файл user_settings.json. Это может быть особенно полезно, когда над фичами работает команда, и у каждого участника существуют свои настройки подключения к базам.
Чтобы воспользоваться этой функциональности, нужно выполнить следующее:
- У себя в каталоге с обработкой ванессы создать файл user_settings.json. Сам файл user_settings.json должен отвечать специальному формату:
В свойства user поставить доменное (локальное) имя пользователя, для которого должны применяться настройки. Именно по этому свойству будет определяться, какие пользовательские настройки нужно загружать.
В свойстве settings прописать конкретные настройки для каждого пользователя. Состав настроек необязательно должен совпадать между пользователями, для какого-то пользователя настройки могут отсутствовать.
Открыть обработку AD - файл user_settings.json подтянется автоматически из каталога, в котором находится AD (поле каталог инструментов на вкладке Сервис). Если такого файла нет, то загрузка молча игнорируется. Имеется возможность указать свой каталог загрузки настроек, он подчиняется свойству Каталог проекта на вкладке Сервис.
Vanessa Automation Driven Development
Продукт Vanessa-ADD (Vanessa Automation Driven Development) (далее Vanessa-ADD) представляет собой набор инструментов для проверки качества решений на платформе 1С:Предприятие.
Vanessa-ADD is a set of testing tools for 1C:Enterprise 8 platform - Tests/behavior (TDD & BDD) for 1С:Enterprise.
Миссия продукта - повышение качества разработки.
Продукт позволяет проверять поведение различных систем на базе платформы 1С (в режимах совместимости не ниже 8.2.13) и проверяет/гарантирует качество функциональности системы и ее составных частей на всем протяжении жизненного цикла системы.
Основной сценарий использования - реализация концепций TDD/BDD/CI в проектах на базе 1С
- готовые универсальные "дымовые тесты" различных видов
- различные виды тестирования (модульного/юнит, приемочного, сценарного для 1С 8.3, интеграционного, TDD)
- проверка поведения (BDD/Gherkin)
- формирование автодокументации в формате Html или Markdown или в виде видео-инструкций.
Vanessa-ADD является наследником 2-х продуктов - xUnitFor1C и Vanessa-Behavior. Совместимость с VB 1.Х и xUnitFor1C 4.Х гарантирована (за исключением функциональности циклов и условий в Vanessa-ADD)
Справка и полезные ссылки
Обязательно ознакомьтесь с:
Документацией по продукту doc/README.md
часто задаваемыми вопросами FAQ.md
Порядок установки Vanessa-ADD:
Автоматическая установка (через установщик пакетов OneScript ):
- Выполнить opm install add
- После выполнения пакет будет установлен в каталог /lib/add
Автоматическая установка (при установке пакета vanessa-runner через установщик пакетов OneScript ):
- Выполнить opm install vanessa-runner
- После выполнения пакет будет установлен в каталог /lib/vanessa-runner
Ночная сборка ветки develop:
Продукт помимо основного стабильного релиза, выпускается "ночная сборка" продукта с новым, но еще не стабильным функционалом. Артефакты сборки доступны по запросу.
Пожелания к использованию можно фиксировать в виде Github Issues
Обсуждения категоризируются на 3 вида
Для удобства использования для каждой категории создан специальный шаблон, доступные для редактирования в каталоге Шаблоны обсуждений
Сравнение с другими инструментами тестирования
Продукт подразумевает следования трем ключевым принципам
- соответствение концепции BDD - "кодирование сценариев поведения до проектирования" в части приемочных тестов (приемо-сдаточных сценариев)
- соответствие концепции TDD - "тестирование до кода" в части модульных тестов (юнит-тестов)
- соответствие концепции "всё есть код" в части любых тестов и необходимых для этого данных
Остальные продукты в зоне "Качество 1С решений" исповедуют другие принципы, поэтому бессмысленно сравнивать функциональность разных продуктов, если они реализованы просто для разных целей.
Как помочь проекту
Продукт развивается при помощи независимых разработчиков, использующих продукт в собственных целях и в своих компаниях
- сообществом независимых разработчиков через концепцию краудсорсинга при помощи и отправки запросов на слияния
- Если вы желаете поучаствовать в доработке и развитии, ознакомьтесь с руководством контрибьютора (участника проекта)
Лицензии и права
- основная лицензия исходного кода продукта - Mozilla Public Licence 2.0
- лицензии стороннего кода - BSDv3, Apache License, Freeware, etc - подробные разъяснения лицензий на исходный код продукта и его документации, в том числе содержатся внутри файлов исходного кода
Для НЕ знакомых с открытыми лицензиями информация о разрешениях и запретах каждой конкретной лицензии содержится на сайте https://choosealicense.com/licenses/ - в каждой конкретной лицензии имеются 3 секции: "Permissions (Права которые вы имеете)", "Conditions (Условия с которыми вы соглашаетсь)" и Limitations (Ограничения которые на вас накладываются). При использовании продукта, материалов исходного кода обработок 1С, скриптов или документации крайне желательно ознакомится с указанным сайтом для исключения противоречий.
Данная документация распространяется под открытой лицензией
Creative Commons Attribution-ShareAlike 4.0 International License.
Писать и выполнять сценарии тестирования теперь можно в едином окне! В фреймворке появился встроенный текстовый редактор на базе VS Code, позволяющий добавлять в текст сценария шаги из библиотеки и запускать feature-файлы на выполнение (в том числе, в режиме отладки).
Расширились возможности по оформлению видеоинструкций для веб-клиента, реализовано большое количество новых шагов и других доработок.
Встроенный редактор сценариев на базе VS Code
Главным изменением релиза 1.2.033 стало появление во фреймворке полноценного редактора сценариев с возможностью автодополнения и отладки.
Теперь в окне запуска сценариев можно переключать режим работы с feature-файлом:
- выводить традиционное дерево шагов, запуская сценарии на выполнение, как раньше;
- либо работать непосредственно с текстом feature-файла из окна нового редактора на базе VS Code.
В редакторе сценариев доступны:
- выбор feature-файлов из дерева каталогов;
- подсветка грамматики Turbo Gherkin;
- автодополнение строк из библиотеки шагов с учетом данных текущей формы клиента тестирования;
- подсказка при наведении на шаг;
- сворачивание сценариев, условий/циклов и групп шагов с учетом синтаксических конструкций;
- вывод строк подсценариев в специальные HTML-вставки редактора;
- синтаксический контроль и квикфиксы при написании кода;
- установка точек останова – как для обычных строк сценария, так и для подсценариев;
- раскраска фона строк в зависимости от успешности выполнения шагов сценария (а также очистка раскраски строк по кнопке на панели инструментов);
- вывод деталей ошибки при нажатии на специальную гиперссылку с результатом выполнения сценария;
- навигация по ошибкам нескольких сценариев в рамках одной фичи;
- переключение темы редактора (четыре темы на выбор);
- встроенные поиск и замена;
- мультикурсор;
- изменение масштаба.
Главное преимущество нового редактора кода – единое пространство для написания и выполнения сценариев тестирования с возможностью отладки и получения полной информации по результатам.
Основные параметры редактора VAEditor (тема, показ строк подсценариев, использование данных текущей формы при подборе шагов) вынесены в глобальные настройки.
Подробнее о возможностях редактора можно прочитать в нашем обзоре.
Видеоинструкции для веб-клиента
Настройка среды создания видеоинструкций для веб-клиента существенно упростилась. Все дополнительные css и js файлы, обеспечивающие оформление видеоинструкций (для рисования рамок, стрелок, подсветки активного элемента и т.д.), инициализируются в веб-клиенте при работе с WebSocket автоматически.
При формировании автоинструкций в веб-клиенте с помощью компоненты VanessaExt можно подсвечивать клики мышки, а также настраивать скорость ее движения и смещение координат.
Для дополнительных эффектов при оформлении видеоинструкций в веб-клиенте реализован ряд шагов. Например, можно:
- выводить заставку с надписью и визуальным эффектом;
- показывать нажатие мыши в браузере;
- делать эффект затемнения по координатам на экране;
- переводить окно браузера в полноэкранный режим;
- показывать подсказку у элемента формы и т.д.
Прочие доработки
Библиотечные шаги разделены на категории – обычные шаги, циклы, условия, работа с файлами, асинхронные шаги, прочее:
- в списке известных шагов (Ctrl+I) в зависимости от категории меняется цвет фона строк;
- в выпадающем списке автодополнения шагов при работе с редактором кода – меняется иконка шага.
Значительно расширилось количество шагов для работы с объектами конфигурации (создание/удаление справочника/документа с указанным набором реквизитов, сохранение ссылки на объект базы данных в переменную и т.д.).
Для работы с Vanessa Automation на CI-сервере можно получить готовую строку запуска (в настройках фреймворка на закладке CI).
Запись сессии тестирования
Теперь видеозапись выполнения тестов можно получить, не формируя автоинструкции.
Это реализуется двумя способами:
- интерактивно, включением опции в настройках отчета о запуске сценариев (необходимо задать каталог и команду для записи видео) – для каждого сценария будет записано свое видео;
- программно, через указание тега @recordvideo перед шагом сценария – тогда с этого шага начнется запись видео с сессией тестирования (требует задания настроек каталога и команды записи в файле параметров Vanessa Automation, включение опции не требуется).
Развитие встроенной компоненты VanessaExt
Мы уже рассказывали, что внешняя компонента для снятия скриншотов научилась управлять процессами системы, работать с браузером через WebSocket и эмулировать действия пользователя.
В релизе Vanessa Automation 1.2.033 помимо шагов по оформлению инструкций в веб-клиенте для некоторых возможностей VanessaExt реализованы дополнительные универсальные шаги:
- для эмуляции нажатия клавиш: И я нажимаю сочетание клавиш "Ctrl+O" ;
- для открытия внешних файлов: И я выбираю файл "ИмяФайла" ВК ;
- для работы с буфером обмена:
- И я запоминаю значение поля с именем "ИмяПоля" в буфер обмена
- И я помещаю в буфер обмена строку 'Нужная строка'
- И я вставляю текстовое значение буфера обмена в поле с именем ""
Как начать применять автоматизированное тестирование
На Инфостарте опубликован ряд статей, помогающих освоить автоматизированное тестирование с помощью Vanessa Automation.
Функциональность Vanessa Automation можно использовать в полном варианте (в виде каталога инструментов) и в варианте Single (как единую обработку, но без поддержки обычных форм).
Установить релиз Vanessa Automation 1.2.033 можно двумя способами:
- если у вас используется пакетный менеджер, входящий в поставку OneScript, то через командную строку:
opm install vanessa-automation (или opm install vanessa-automation-single) - либо скачать архив в релизах проекта на GitHub и развернуть в каталог по любому удобному пути.
Проект Vanessa Automation открыт как для разработки, так и для использования.
Локализация интерфейса
Проведена большая работа по переводу интерфейса фреймворка Vanessa Automation на английский язык. Переведены не только все элементы интерфейса, но и большинство библиотечных шагов.
Это позволяет автоматически переводить текст фичи на язык, соответствующий языку генератора Gherkin (задается в настройках на закладке Сервис – Основные). Шаги, по которым автоматический перевод не доступен, будут помечены комментарием специального вида для дальнейшей обработки переводчиком вручную.
Читайте также: