Дымовые тесты для 1С и вывод результата в отчет Allure

Видео примеры:

• VanessaRunner. Проверяем доработки после обновления с помощью внешней обработки

Содержание:

• Установка
• Создание проекта
• Описание команд
• Групповая проверка доработок
• Дымовые тесты
• Информация о поддержке метаданных
• Синтаксическая проверка
• Проверка кода
• Дополнительные материалы

Установка

• Инструкция по установке
• Настройка vanessa runner (файл .env)

Предусмотрен запуск Allure в Docker

Создание проекта

С версии 1.11.0 vanessa-runner доступна команда init-project.

С ее помощью можно быстро развернуть проект следующими командами:

• vrunner init-project --template https://github.com/leobrn/ones-smoke-allure.git
• vrunner init-project --settings my-path/env.json

При создании проекта сразу будут собраны обработки.

Описание команд

• installVA.cmd - обновление пакетов onescript, установка vanessa-runner, vanessa-add, vanessa-support
• runSyntax.cmd - запуск синтаксической проверки
• runSmoke.cmd - запуск дымовых тестов
• runAllure.cmd - формирование отчета Allure. Предусмотрено сохранение истории
• runTests.cmd - запуск трех команд: runSyntax, runSmoke, runAllure
• compileEpf.cmd - cборка внешних обработок из исходников
• decompileEpf.cmd - разборка внешних обработок на исходники
• decompileCf.cmd - разборка конфигурации в исходники
• getSupportObjects.cmd - получить json-файл для всех метаданных, которые могут быть изменены и не находятся в режиме чтения
• runGroupCheck.cmd - запуск 1С:Предприятие с запуском обработки ГрупповаяПроверкаДоработок.epf

Групповая проверка доработок

Альтернативный способ проверки

Обработка для массовой проверки доработок типовой конфигурации: Открытие форм, Печать, Формирование отчетов, Проведение документов, Запись справочников, ПВХ, ПВР. Выдает список обнаруженных ошибок. Рекомендуется применять для тестирования обновленной конфигурации.

Поддерживаемые конфигурации:

• 1С:ERP Управление предприятием 2
• Комплексная автоматизация, редакция 2
• Управление торговлей, редакция 11
• Бухгалтерия предприятия, редакция 3.0 / КОРП
• Зарплата и Управление Персоналом, редакция 3 / КОРП

За основу использовалась обработка с инфостарта Групповая проверка доработок.

5 режимов проверки:

• Формы. Проверка открытия основных форм объектов (справочников и документов)
• Отчеты. Формирование отчетов с настройками по умолчанию
• Печать. Формирование печатных формы с настройками по умолчанию
• Документы. Проверяет заполнение формы и перепроводит последние документы
• Справочники. Проверяет заполнение формы и перезаписывает справочники, планы видов характеристик, планы видов расчета

Выбранные проверки выполняются по порядку.

На страницах тестов Формы, Печать, Документы, Справочники есть настройка Сколько объектов одного типа проверять.

Проверка доработок в расширениях в три шага:

• В шапке обработки нажать Заполнить объекты (все настройки и заполненные объекты сохраняются)
• Нажать Объекты расширений. Будут выбраны объекты, которые добавлены или изменены в расширениях. Для показа только выбранных объектов нажмите Только выбранные
• Запустить проверки нажав на Проверить

На странице Результат в виде дерева отображены ошибки с группировкой по полю Тип ошибки.

• Тип ошибки
• Описание (информация о возникшей ошибке, содержащая указание на модуль и строку ошибки, а также навигационную ссылку на объект)
• Проверяемый объект (имя объекта метаданных)
• Данные (ссылка на объект в базе)

На странице Настройки доступны следующие настройки:

• Очистить даты запрета. Перед проведением документов будут очищены даты запрета. Если настройка выключена обработка будет брать максимальную дату запрета и по ней отбирать документы для проведения
• Формирование данных для отчета Allure. Формировать отчет в формате Allure по результатам выполнения тестов. На данный момент выгружаются только ошибки

Отчет Allure

Дымовые тесты

• Официальная документация по дымовым тестам

Если нужна авторизация в клиенте тестирования, добавьте в xunit ключ --testclient. Если версия Vanessa-ADD меньше 6.7.0, замените плагины в библиотеке C:\Program Files\OneScript\lib\add\plugins на плагины из папки plugins.

{
  "xunit": {
    "testsPath": "./tests",
    "--xddConfig": "./tools/JSON/settingsSmoke.json",
    "--reportsxunit": "ГенераторОтчетаAllureXMLВерсия2{allure/smoke/allure.xml}",
    "--xddExitCodePath": "./build/xddExitCodePath.txt",
    "--testclient": "Администратор:123456:1538"
  }
}

Если нужно подключаться к серверной базе, измените в default ключ ibconnection

{
  "default": {
    "--ibconnection": "/Sservername\\basename"
  }
}

Информация о поддержке метаданных

С помощью vanessa-support можно получить готовый json-файл для всех метаданных, которые могут быть изменены и не находятся в режиме чтения. Полученный файл можно использовать для групповой проверки доработок.

{
 "Справочники": [
  "ВидыНоменклатуры",
  "Организации"
 ],
 "ПланыВидовХарактеристик": [
  "СтатьиДоходов",
  "СтатьиРасходов"
 ],
 "Документы": [
  "АвансовыйОтчет",
  "АктВыполненныхРабот"
 ],
 "Отчеты": [
    "ABCXYZАнализНоменклатуры"
   ]
}

1. Укажите данные для подключения к ИБ в файле env.json
2. Выполните команду decompileCf.cmd
3. Выполните команду getSupportObjects.cmd
4. Файл с результатом tools\json\supportObjects.json

Синтаксическая проверка

Кроме дымовых тестов, включена синтаксическая проверка расширений.

• Настройка синтаксической проверки

Если используется хранилище, добавьте в syntax-check ключи: --storage-name, --storage-user, --storage-pwd.

Если нужно пропустить некоторые ошибки, укажите их в файле tools/syntax_check_exception.txt. Можно указать часть текста ошибки Возможно ошибочное свойство:.

    "syntax-check": {
        "--allure-results2": "allure/syntax-check",
        "--groupbymetadata": true,
        "--exception-file": "./tools/syntax_check_exception.txt",
        "--storage-name": "D:\\Store",
        "--storage-user": "admin",
        "--storage-pwd": "123",
        "--mode": [
            "-ExtendedModulesCheck",
            "-ThinClient",
            "-WebClient",
            "-Server",
            "-AllExtensions"
        ]
    }

Проверка кода

Для быстрой проверки кода можете использовть простой инструмент Phoenix BSL.

В каталоге tools/json расположен файл с настройками settingsBSL.json.

• Возможные настройки

• Диагностики

Дополнительные материалы

• Юнит - тестирование и управление качеством кода в 1С