О Unit-тестах замолвите слово. Часть 2
Разработка - Инструментарий разработчика
Подготовка
Тесты будем писать с использованием фреймворка Vanessa-ADD.
Самый простой путь к его установке - менеджер пакетов OneScript. Скачать его можно тут: http://oscript.io/.
После того как будет установлен OneScript нам будет достаточно открыть командную строку и выполнить:
opm install add
После выполнения команды в папке с библиотеками OneScript (C:\Program Files (x86)\OneScript\Lib\) появится папка add. В ней будут лежать компоненты фреймворка Vanessa-Add.
Нас прежде всего интересуют файлы, относящиеся к части xUnit (фреймворк для Unit-тестирования):
- Внешняя обработка xddTestRunner.epf - обработка для запуска Unit-тестов
- Набор плагинов, который располагается в папке add/plugins
Подробнее о запуске тестов и использовании плагинов можно почитать в документации тут.
Организация хранения тестов и состав набора тестов
Для того чтобы практические примеры лучше читались, разберем как тесты хранятся и из чего состоят наборы тестов.
Тесты располагаются в модулях внешних обработок, каждая обработка может содержать несколько тестов, разделенных на группы.
Т.к. Unit-тесты пишутся на процедуры и функции, то удобно разбивать тесты на блоки со следующей иерархией:
- метаданные
-- модуль менеджера/модуль объекта либо функциональная область
Например, такая структура файлов и папок:
- Документ.Заказ клиента
-- Тест_ЗаказКлиентаОбъект.epf
-- Тест_ЗаказКлиентаМенеджер.epf
Каждая внешняя обработка состоит из следующих частей:
Инструментарий
В основном в тестах мы будем использовать следующие плагины:
- ТекучиеУтверждения - плагин предоставляющий методы для проверки утверждений
// Пример проверки значения
// Ожидаем - плагин ТекучиеУтверждениея
// Что() - передаем плагину значение для проверки
// Равно() - вызываем процедуру сравнения переданного значения с эталоном
Ожидаем.Что(ПроверямоеЗначение).Равно(1);
// Пример проверки метода
// Что() - передаем плагину расположения проверяемого метода
// Метод() - передаем плагину имя метода и его параметры
// ВыбрасываетИсключение() - провермя, что метод выбросил определенное исключение
Ожидаем.Что(ОбщийМодуль).Метод(ИмяМетода).ВыбрасываетИсключение("Наше исключение");
- Данные - плагин для генерации данных, необходимых для теста
// Данные - плагин
// НачатьСоздание() - Объявляем какой объект нужно создать Справочник, Документ, Набор записей регистра накопления или сведений
// Реквизит() - объявляем, что у нашего объекта будет заполнен реквизит определенным значением
// ШапкаТабличнойЧасти() - объявляем, что у создаваемого объекта будет заполнены табличная часть и некоторые из её колонок
// СтрокаТЧ() - описываем какими именно значениями будет заполнена строка табличной части
// Создать() - завершаем создание объекта, по умолчанию объект записывается в базу и возвращается ссылка на него
Данные.НачатьСоздание("Документ.ДокументСДвижениями")
.Реквизит("РеквизитПростойСправочник")
.ШапкаТабличнойЧасти("ТЧ","Реквизит1", "РесурсЧисло")
.СтрокаТЧ("Элемент1", 10)
.СтрокаТЧ("Элемент2", 15).Создать();
Более подробно о плагинах можно прочитать на страницах документации.
К сожалению не для всех плагинов есть документация, но в них можно легко разобраться, открыв сами плагины в каталоге add/plugins =)
Пример теста: Распределение значений по базе
У нас реализована собственная подсистема Бюджетирования. Нам была необходима функция, которая будет распределять затраты, которые были сформированы в одних подразделениях на другие подразделения, в зависимости от их показателей.
Рассмотрим пример проверки функции распределения:
// Создадим тестовые подразделения первичных затрат
Подразделение1 = Данные.СоздатьЭлементСправочника("СтруктураПредприятия");
Подразделение2 = Данные.СоздатьЭлементСправочника("СтруктураПредприятия");
// Тут мы подготавливаем описание колонок таблиц, которые будут передваться нашей функции
Колонка_АналитикаДоходовРасходов = Данные.ОписаниеКолонкиТЧ("АналитикаДоходовРасходов", Новый ОписаниеТипов("СправочникСсылка.СтруктураПредприятия"));
Колонка_Ресурс1 = Данные.ОписаниеКолонкиТЧ("Ресурс1", Новый ОписаниеТипов("Число"));
Колонка_Ресурс2 = Данные.ОписаниеКолонкиТЧ("Ресурс2", Новый ОписаниеТипов("Число"));
Колонка_АналитикаРасходов = Данные.ОписаниеКолонкиТЧ("АналитикаРасходов", Новый ОписаниеТипов("СправочникСсылка.СтруктураПредприятия"));
Колонка_Коэффициеннт = Данные.ОписаниеКолонкиТЧ("Коэффициент", Новый ОписаниеТипов("Число"));
// Создадим тестовые подразделения, на которые необходимо распределить затраты
ПодразделениеРаспределения3 = Данные.СоздатьЭлементСправочника("СтруктураПредприятия");
ПодразделениеРаспределения4 = Данные.СоздатьЭлементСправочника("СтруктураПредприятия");
// Формируем таблицу первоначальных затрат
ИсходнаяТаблица = Данные.НачатьСоздание("ТаблицаЗначений")
.ШапкаТабличнойЧасти(, Колонка_АналитикаДоходовРасходов, Колонка_Ресурс1, Колонка_Ресурс2)
.СтрокаТЧ(Подразделение1, 10, 10)
.СтрокаТЧ(Подразделение2, 20, 10).Создать();
// Формируем таблицу коэффициентов
ТаблицаКоэффицентов = Данные.НачатьСоздание("ТаблицаЗначений")
.ШапкаТабличнойЧасти(, Колонка_АналитикаРасходов, Колонка_Коэффициеннт)
.СтрокаТЧ(ПодразделениеРаспределения3, 0.4)
.СтрокаТЧ(ПодразделениеРаспределения4, 0.6).Создать();
// Формируем таблицу эталон, для проверки результата работы функции
Эталон = Данные.НачатьСоздание("ТаблицаЗначений")
.ШапкаТабличнойЧасти(, Колонка_АналитикаДоходовРасходов, Колонка_Ресурс1, Колонка_Ресурс2, "АналитикаДоходовРасходовИсточник")
.СтрокаТЧ(ПодразделениеРаспределения3, 4, 4, Подразделение1)
.СтрокаТЧ(ПодразделениеРаспределения4, 6, 6, Подразделение1)
.СтрокаТЧ(ПодразделениеРаспределения3, 8, 4, Подразделение2)
.СтрокаТЧ(ПодразделениеРаспределения4, 12, 6, Подразделение2).Создать();
// Выполняем функцию
Справочники.ИсточникиДанныхБюджета.РаспределитьПоКоэффициентам(ИсходнаяТаблица, ТаблицаКоэффицентов);
// Сравниваем эталон и результат работы нашей функции
СравнениеТаблиц.ПроверитьРавенствоТаблиц(Эталон, ИсходнаяТаблица);
Стоит отметить, что коэффициенты и значения затрат подобраны не очень хорошо, т.к. при таких значениях не возникает проблемы копеек.
Пример теста: разбор информации об обновлениях мобильного приложения
На складе компании используется приложение на мобильной платформе 1С. Из-за политики безопасности мы не можем распространять обновления через GooglePlay. Поэтому мы написали приложение, которое проверяет наличие обновлений на сервере (сравнение версии установленного приложения с настройками, хранящимися на сервере) и устанавливает обновление, если оно есть.
Мы рассмотрим тест на разбор файла настроек, которые загружаются с сервера:
Процедура Тест_ЧтениеИнформациисСервера_НесколькоНастроек() Экспорт
Настройка = ШаблонНастройки("version_несколько_настроек");
// Процедура читает файл переданной настройки и заполняет справочник "Конфигурации"
ОбновлениеКонфигурацийВызовСервера.ЗагрузитьОписаниеВерсийССервера(Настройка, Ложь);
// Проверяем, что настройка прочитана корректно
ЗагруженнаяНастройка = Справочники.Конфигурации.НайтиПоНаименованию("ru.yarvet.mw");
Ожидаем.Что(ЗагруженнаяНастройка.ИмяФайлаОбновления).Равно("тест")
.Что(ЗагруженнаяНастройка.ВерсияСервера).Равно("2.1.0");
ЗагруженнаяНастройка = Справочники.Конфигурации.НайтиПоНаименованию("ru.yarvet.launcher");
Ожидаем.Что(ЗагруженнаяНастройка.ИмяФайлаОбновления).Равно("тест2")
.Что(ЗагруженнаяНастройка.ВерсияСервера).Равно("1.1.0");
КонецПроцедуры
// Функция возвращает путь до файла с тетсовой настройки
Функция ШаблонНастройки(Настройка)
// ИспользуемоеИмяФайла - путь до обработки теста, стандартный реквзит внешней обработки
ОписаниеТеста = Новый Файл(ИспользуемоеИмяФайла);
Возврат ОписаниеТеста.Путь + ПолучитьРазделительПути() + Настройка+".json";
КонецФункции
Собственно сам файл настройки выглядит так:
[
{
"application": "ru.yarvet.mw",
"version":"2.1.0",
"updateFile":"тест"
},
{
"application": "ru.yarvet.launcher",
"version":"1.1.0",
"updateFile":"тест2"
}
]
Почему мы писали тест на казалось бы такой простой код - чтобы полностью проверить его в пользовательском режиме нужно было настроить: сервер, установить приложение на мобильное устройство, подключить его к нужной сети, ввести настройки сервера и загрузить настройки. В случае нахождения ошибки нужно было скомпилировать приложение, обновить его на устройстве и проверить еще раз. Поэтому намного легче было написать тест =)
P.S.
Рассуждение о том, в каких случаях лучше писать unit-тесты было тут.
Специальные предложения
См. также
Новый раздел на Инфостарте - Electronic Software Distribution Промо
Инфостарт напоминает: на нашем сайте можно купить не только ПО, связанное с 1С. В нашем арсенале – ESD-лицензии на ПО от ведущих вендоров: Microsoft, Kaspersky, ESET, Dr.Web, Аскон и другие.
- Низкие цены, без скрытых платежей и наценок
- Оперативная отгрузка
- Возможность оплаты с личного счета (кешбек, обмен стартмани на рубли и т.п.)
- Покупки идут в накопления для получения скидочных карт лояльности Silver (5%) и Gold (10%)
Просмотр и анализ структуры базы данных (отчет на СКД) 121
5 стартмани
24.07.2019 8495 93 YPermitin 25
1С:Предприятие через Интернет. 1С:Fresh Промо
Ведение бухгалтерского и налогового учет, сдача отчетности, управление бизнесом из любой точки мира. Привычные программы «1С» через Интернет без приобретения коробочных программ.
Онлайн-курс "Технология выполнения проектов ERP-класса – процессный подход". Третий поток. Курс проходит с 21 января по 18 марта 2020 года. Промо
Курс разработан Внедренческим центром «Раздолье». Курс предназначен для подготовки аналитиков, архитекторов и руководителей проектов автоматизации процессов управления с использованием комплексных ИТ-систем (1С:ERP, 1С:УХ, 1С:КА, 1С:УТ). В основе курса лежит методика применения процессного подхода.
9000 рублей
Переводим рутину ручного тестирования 1C на рельсы Jenkins-а и ADD 141
1 стартмани
03.06.2019 11665 1 ripreal1 86
Универсальный HTTP-сервис на платформе 1С, аля HTTP-сервер с примером 196
1 стартмани
13.05.2019 18193 93 Diversus 38
Программы для исполнения 488-ФЗ: Маркировка товаров Промо
1 января 2019 года вступил в силу ФЗ от 25.12.2018 № 488-ФЗ о единой информационной системе маркировки товаров с использованием контрольных (идентификационных) знаков, который позволяет проследить движение товара от производителя до конечного потребителя. Инфостарт предлагает подборку программ, связанных с применением 488-ФЗ и маркировкой товаров.
Расширение "Быстрая проверка кода" для конфигурации 1С:Автоматизированная проверка конфигураций 92
1 стартмани
26.03.2019 10855 42 Bazil 25
С 2020 года сервис «Продление поддержки конфигурации 1С:УПП» подорожает вдвое Промо
Успейте продлить поддержку УПП до повышения цен! Фирма «1С» предупредила об изменении цен на сервис «Продление поддержки конфигурации "1С:Управление производственным предприятием"». С 1 января 2020 года сервис подорожает в два раза.
Методика оптимизации программного кода 1С: проведение документов 85
1 стартмани
19.03.2019 15480 14 dmitrydemenew 83
Перенос документов и справочников ERP 2 / КА 2 / УТ 11 => БП 3.0 Промо
Перенос позволяет настроить собственный обмен данными между указанными программами, альтернативный предлагаемому фирмой 1С. Предоставляем техподдержку по всем вопросам данного обмена. Можем подключиться к вам удаленно для разбора ситуаций. Оперативно обновляем при выходе новых релизов 1С. Бесплатные обновления в течение полугода.
19700 руб.
Инструктор. Прототип инструмента создания быстрых пользовательских инструкций 71
1 стартмани
15.02.2019 7773 37 ROM_NN 8
Перенос данных УТ 10.3 => УТ 11 / КА 2 / ERP 2 (ЕРП 2) (документы, остатки и справочная информация из "1С:Управление торговлей, ред. 10.3" в УТ 11 / КА 2 / ERP 2). Обновлен до УТ 10.3.56.х, УТ 11.4.10.х, КА 2.4.10.х и ERP 2.4.10.х! Промо
Уже более 100 компаний приобрели перенос и выполнили переход на УТ 11 / КА 2 / ERP 2 с помощью нашей разработки! Обработка перехода с УТ 10.3 на УТ 11 / КА 2 / ERP 2 позволяет перенести не только остатки на указанную дату (как типовой перенос), но и все возможные документы за выбранный период. При выходе новых релизов этих программ оперативно выпускаем обновление обработки. Предоставляем техническую поддержку. Можем сделать бесплатный тестовый перенос!
29700 руб.
Программы для исполнения 54-ФЗ Промо
С 01.02.2017 контрольно-кассовая техника должна отправлять электронные версии чеков оператору фискальных данных - правила установлены в 54-ФЗ ст.2 п.2. Инфостарт предлагает подборку программ, связанных с применением 54-ФЗ, ККТ и электронных чеков.
Конструктор мобильного клиента Simple WMS Client: способ создать полноценный ТСД без мобильной разработки. Теперь новая версия - Simple UI (обновлено 14.11.2019) 178
5 стартмани
09.01.2019 24547 225 informa1555 174
Управление задачами в 1С - готовая подсистема с открытым кодом и широким базовым функционалом. Версия 1.0.6 94
2 стартмани
17.12.2018 11436 82 for_sale 38
Перенос данных КА 1.1 => ERP 2 (ЕРП) (обработка переноса документов, остатков и справочной информации из "1С:Комплексная автоматизация, ред. 1.1" в "1С:ERP Управление предприятием, ред 2"). Обновлен до КА 1.1.115.х и ERP 2.4.10.х Промо
Обработка позволяет переносить из КА 1.1 в ERP 2 документы за выбранный период и остатки. Типовая обработка от фирмы 1С документы не переносит. Также исправлены ошибки типовой обработки. При выходе новых релизов обновление высылается бесплатно в течение года. Разработка будет полезна фирмам-франчайзи, которые периодически выполняют такой перенос данных для заказчиков. Вы можете один раз приобрести обработку переноса, и потом бесплатно получать обновления в случае выхода новых релизов конфигураций 1С.
29700 руб.
Go. Разбор лога технологического журнала. Достойная альтернатива perl'у 85
1 стартмани
24.10.2018 11864 4 lazarenko 39
Перенос данных УПП 1.3 => ERP 2 (ЕРП) / УТ 11 / КА 2.х (обработка переноса документов, остатков и справочников из "1С:Управление производственным предприятием, ред. 1.3" в ERP / УТ 11 / КА 2). Обновлен до УПП 1.3.127.х, КА 2.4.10.х и ERP 2.4.10.х! Промо
Обработка позволяет переносить из УПП 1.3 в ERP 2 документы за выбранный период и остатки. Типовая обработка от фирмы 1С документы не переносит. Также исправлены ошибки типовой обработки. При выходе новых релизов обновление высылается бесплатно в течение года. Разработка будет полезна фирмам-франчайзи, которые периодически выполняют такой перенос данных для заказчиков. Вы можете один раз приобрести обработку переноса, и потом бесплатно получать обновления при выходе новых релизов конфигураций 1С.
29700 руб.
Пользовательское определение языка 1С для Notepad++ и пример использования списка функций для навигации под свои нужды 66
1 стартмани
10.09.2018 7937 43 albert.goncharov 23
Готовые переносы данных из различных конфигураций 1C Промо
Рекомендуем готовые решения для переноса данных из различных конфигураций 1C. C техподдержкой от разработчиков и гарантией от Инфостарт.
Подборка программ для взаимодействия с ЕГАИС Промо
ЕГАИС (Единая государственная автоматизированная информационная система) - автоматизированная система, предназначенная для государственного контроля за объёмом производства и оборота этилового спирта, алкогольной и спиртосодержащей продукции. Инфостарт рекомендует подборку проверенных решений для взаимодействия с системой.
Позиционирование в помещении с помощью нейросети по сигналу Wi-Fi. Интерактивная карта склада в 1С с показом позиции 65
5 стартмани
09.08.2018 17008 23 informa1555 26
