Working-with-reqdb » History » Revision 35
Revision 34 (Илья Рудаков, 12/18/2009 12:31 PM) → Revision 35/64 (Илья Рудаков, 12/18/2009 12:32 PM)
h1. Working with reqdb console interface h2. Описание Дистрибутив ReqDB выглядит следующим образом: <pre> /.. /bin /libs /src /templates reqdb-someversion.jar </pre> В папке /bin находится три файла для работы с reqdb в консольном режиме: reqdb, reqdb.64 и reqdb.exe. Первые два позволяют вам работать в Linux системе, последний - в Windows. Если вы работаете в Linux, reqdb и reqdb.64 нужно сделать executable. Достаточно набрать следующую команду в консоли: <pre>$ chmod +x reqdb</pre> или <pre>$ chmod +x reqdb.64</pre> reqdb.64 используется если у вас Linux x64. h2. Работа с консольным интерфейсом Если вы запустите один из вышеописанных файлов без каких-либо параметров, то на консоль будет выведена следующая информация: <pre>Usage: reqdb <help|import|convert|init|report> [params]</pre> Вы видите, что в интерфейсе используется 5 параметров. > *+help+* *help* параметр выводит вспомогательную информацию о других параметрах. Например, вызов <pre>$reqdb help import</pre> выведет на экран следующую информацию <pre>Usage: reqdb import <input file> <path to catalogue> <root id> OR reqdb import <input file> <path to catalogue> <root id> <branch path> </pre> > *import* позволяет импортировать существующий документ с разметкой требований в каталог требований. Для данного параметра предусмотрено следующие использование: <pre>Usage: reqdb import <input file> <path to catalogue> <root id> OR reqdb import <input file> <path to catalogue> <root id> <branch path> </pre> *_<input file>_* - путь к документу, который должен быть импортирован в каталог требований; *_<path to catalogue>_* - путь к каталогу требований; *_<root id>_* - идентификатор корневого требования; *_<branch path>_* - путь branch''а импортируемых требовании. > *convert* позволяет конвертировать документы со старой разметкой требований в документ с новой разметкой требований. Для данного параметра предусмотрено следующие использование: <pre>Usage: reqdb convert <input file> <output file> OR reqdb convert <input file> <output file> <encoding> </pre> *_<input file>_* - путь к html файлу со старой разметкой требований; *_<output file>_* - путь к результирующему файлу; *_<encoding>_* - кодировка( если параметр не указан, то используется стандартная кодировка UTF-8 ) > *init* позволяет создать новый пустой каталог требований. Для данного параметра предусмотрено следующие использование: <pre>Usage: reqdb init <path to new catalogue></pre> *_<path to new catalogue>_* - путь где должен быть создан новый каталог требований. > *report* позволяет генерировать отчет. Для данного параметра предусмотрено следующие использование: <pre>Usage: reqdb report <path to template> <path to data> <path to catalogue> <root id> <location> <version> <path to log file></pre> *_<path to template>_* - путь к template.xml( в нем описывается связка - имя файла с freemarker шаблоном -> имя результирующего файла ); *_<path to data>_* - путь к файлу с freemarker шаблоном( имеет расширение .ftl ); *_<path to catalogue>_* - путь к каталогу требований; *_<root id>_* - идентификатор корневого требования; *_<location>_* - путь к папке куда должен быть сохранен файл с отчетом; *_<version>_* - указание версии( для игнорирования этого атрибута нужно оставлять символ пустой строки - "" ); *_<path to log file>_* - путь к log-файлу;