Генератор данных. Полезный инструмент для разработки через тестирование

Данная обработка является инструментом для разработки через тестирование. Она предназначена для генерации тестовых данных перед выполнением тестов. По назначению она является альтернативой аналогичной библиотеки из проекта xUnitFor1C, однако формат описания данных принципиально другой.

Обработка является библиотекой, имеющей основной экспортный метод СоздатьДанныеПоТабличномуДокументу(МакетОписанияДанных). Может применяться в любой конфигурации. Не зависит от сторонних библиотек.

 

Принцип работы.

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

Типы возвращаемых коллекций: Таблица значений, Массив, Структура, Структура коллекций (любого уровня вложенности).

Данные генерируются по принципу “если не находим — создаем” с режимом ОбменДанными.Загрузка = Истина. Данные удобно описывать прямо в конфигураторе без переключения в пользовательский режим.

Типы данных, которые генерируются/подставляются в коллекции:

  • Ссылочные (Документы, Справочники, Регистры, ПВХ, Планы счетов, Перечисления, Константы, Задачи, Бизнес-процессы)

  • Примитивные (Строка, Число, Булево, Дата)

  • Дополнительные типы данных (Вид движения накопления, Стандартный период)

  • Вычисляемое выражение

 

Формат описания данных

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

Наборы данных располагаются друг под другом

 

Генерация возвращаемых коллекций

В заголовке набора данных можно указывать один из следующих типов коллекции: ТаблицаЗначений, Массив, Структура.

ИМЯ в заголовке набора данных является ключом в возвращаемой структуре коллекций

Описание коллекции начинается в следующей строке после заголовка, начиная с третьей колонки.

В первой строке указывается идентификатор поля в коллекции, во второй строке — тип значений в коллекции, в последующих — элементы коллекции.

В описанном примере будет возвращена структура, имеющая три ключа:

СуммыПоПериодам — таблица значений, имеющая колонку Период с типом Дата и колонку Сумма с типом число

ПараметрыФормы — структура с полями Дата с типом дата и Только просмотр с типом булево

Товары — массив, содержащий ссылки на элементы справочника номенклатура. Причем элементы сгенерируются на лету.

 

Генерация данных в таблицах БД ссылочного типа

При генерации ссылочных данных обязательно должно присутствовать и быть заполнено поле Ссылка

При генерации данных в таблицах БД ТИП в заголовке описывается как в языке запросов.

Тип полей коллекций описывается как в конфигураторе.

В данном примере в базе будет сгенерирован документ Передача ОС с номером ПерОС-01 от 15 января 2024 года. В этом документе будут добавлены две строки в табличную часть ОС с заполнением полей Основное средство и Стоимость

 

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

 

Для справочников (и аналогичных с ними объектов) поиск ссылки выполняется:

  • при указании уникального идентификатора — по УИДу

  • при наличии кода — по коду

  • при отсутствии кода и наличии наименования — по наименованию

  • при отсутствии кода и наименования — генерация не поддерживается (на текущий момент)

 

Для документов  (и аналогичных с ними объектов) поиск ссылки выполняется: 

  • при указании уникального идентификатора — по УИДу

  • в остальных случаях — по номеру без учета периода

  •  

Генерация данных в регистрах

В независимых регистрах сведений минимальным требованием является заполнение обязательных полей

 

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

Заполнение констант

Константы заполняются по аналогии со структурами

Подстановка нессылочных типов

Дата заполняется в формате ГГГГММДД или ГГГГММДДЧЧММСС

Числовые значения не должны содержать пробелов. Разделителем является точка.

Стандартный период заполняется в формате ГГГГММДД-ГГГГММДД, где перед разделителем дата начала, а после — дата окончания.

Также поддерживается тип Вид движения накопления со значениями Приход и Расход

 

Подстановка вычисляемого значения

Для ячейки данных, начинающейся со знака “=” подставляется значение через функцию Вычислить(Выражение), где Выражение — текст из ячейки без первого символа. В описанном примере будет возвращена коллекция-структура ПараметрыТеста, в которой в поле СчетУчета будет ссылка на счет 01.09

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

 

Вложенные коллекции

 

Несколько коллекций можно поместить в структуру. Границами такой структуры-обертки являются ключевые слова НАЧАЛО и КОНЕЦ. В данном примере будет сгенерирована коллекция структура ПараметрыПередаваемыеВФорму, в которой будут поля Товары — таблица значений и Отбор — структура.

Дополнительная информация для созадания в ячейке макета

В некоторых случаях неудобно разделять таблицу на несколько частей, если она содержит составной тип данных. Тогда можно тип подставлять после ключевого сочетания «[Т]» (русская заглавная буква Т в квадратных скобках).

 

Так можно создать родителя. В данном примере созданная ссылка Новые склады будет группой

 

Или можно сразу так. Вообще, что создавать: группу или элемент — загрузчик решает при первом упоминании ссылки.

 

ps

Я сам пользуюсь инструментом чуть меньше года. При этом генерацию данных выполняю исключительно им. Меня он всем устраивает. Поэтому выкладываю его как есть. Возможно, кто-нибудь еще найдет его для себя полезным.

Данная разработка предлагается к использованию в качестве библиотеки, т.е. вызываться из других обработок. Применялась в основном на платфомре 8.3. На 8.2 применялась мало, но при этом работала корректно.

 

Версия 2.1.0 (22.06.2024)

Реализована возможность создания ссылок по УИДам 

Версия 2.1.1 (10.07.2024)

Исправлена ошибка, что неправильно отрабатывала формула, начинающаяся со знака «=»

10 Comments

  1. json

    Для файлов с примерами хотел сделать бесплатное скачивание, но все равно подставлялось платное. Поэтому файлы примеров временно выкладываю тут

    Reply
  2. artbear

    Хороший инструмент, хорошее описание.

    Спасибо.

    Reply
  3. Yashazz

    ну что ж… Вот я и опоздал. Я задумал такой «генератор» ещё давно, для создания наполнения баз к их нагрузочному тестированию. Никак не было времени закончить. Жаль, не успел…

    Автору респект.

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

    Reply
  4. artbear

    (3) Ты уже давно опоздал, я с товарищами эту работу сделали еще в 2013-2014 году 🙂

    Reply
  5. artbear

    (0) А сама форма генератора данных (для пользователя) есть?

    в скриншотах не увидел.

    Или эта форма описана в следующей статье?

    Reply
  6. json

    (5) artbear, интерфейс элементарный: Табличный документ и кнопка Создать данные. По некоторым причинам пока не стал добавлять скрин в статью. Предполагаю, что данные будут описываться в конфигураторе. На хорошо проработанный интерфейс, как в XUnitFor1C пока нет планов

    Reply
  7. JohnyDeath

    (3) Yashazz, а чем тестируете нагрузочно?

    Reply
  8. json

    Выложил данную разработку на github

    Reply
  9. Quasar

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

    http://infostart.ru/public/531285/

    В итоге не загружается. Причина в том, что в колонки «Тип Значения» в макете указан «Описание типов» и из-за этого для колонки ставится тип «Неопределено»

    Reply
  10. json

    (9) Quasar, можете привести скрин или выложить пример макета с указанием конфигурации?

    Reply

Leave a Comment

Ваш адрес email не будет опубликован. Обязательные поля помечены *