Working with reqdb console interface¶

Описание¶

Дистрибутив ReqDB выглядит следующим образом:

/..
/bin
/libs
/src
/templates
 reqdb-someversion.jar

В папке /bin находится три файла для работы с reqdb в консольном режиме: reqdb, reqdb.64 и reqdb.exe. Первые два позволяют вам работать в Linux системе, последний - в Windows.
Если вы работаете в Linux, reqdb и reqdb.64 нужно сделать executable. Достаточно набрать следующую команду в консоли:

$ chmod +x reqdb

или

$ chmod +x reqdb.64

reqdb.64 используется если у вас Linux x64.

Работа с консольным интерфейсом¶

Если вы запустите один из вышеописанных файлов без каких-либо параметров, то на консоль будет выведена следующая информация:

Usage: reqdb <help|import|convert|init|report> [params]

Вы видите, что в интерфейсе используется 5 параметров.

help параметр выводит вспомогательную информацию о других параметрах. Например, вызов

$reqdb help import

выведет на экран следующую информацию

Usage: reqdb import <input file> <path to catalogue> <root id>
OR
reqdb import <input file> <path to catalogue> <root id> <branch path>

import позволяет импортировать существующий документ с разметкой требований в каталог требований. Для данного параметра предусмотрено следующие использование:

Usage: reqdb import <input file> <path to catalogue> <root id>
OR
reqdb import <input file> <path to catalogue> <root id> <branch path>

<input file> - путь к документу, который должен быть импортирован в каталог требований; <path to catalogue> - путь к каталогу требований; <root id> - идентификатор корневого требования; <branch path> - путь branch''а импортируемых требовании.

convert позволяет конвертировать документы со старой разметкой требований в документ с новой разметкой требований. Для данного параметра предусмотрено следующие использование:

Usage: reqdb convert <input file> <output file>
OR
reqdb convert <input file> <output file> <encoding>

<input file> - путь к html файлу со старой разметкой требований; <output file> - путь к результирующему файлу; <encoding> - кодировка( если параметр не указан, то используется стандартная кодировка UTF-8 )

init позволяет создать новый пустой каталог требований. Для данного параметра предусмотрено следующие использование:

Usage: reqdb init <path to new catalogue>

<path to new catalogue> - путь где должен быть создан новый каталог требований.

report позволяет генерировать отчет. Для данного параметра предусмотрено следующие использование:

Usage: reqdb report <path to template> <path to data> <path to catalogue> <root id> <location> <version> <path to log file>

<path to template> - путь к template.xml( в нем описывается связка - имя файла с freemarker шаблоном -> имя результирующего файла ); <path to data> - путь к файлу с freemarker шаблоном( имеет расширение .ftl ); <>