Project

General

Profile

Reqeditor-getting-started » History » Version 48

Илья Рудаков, 12/17/2009 04:57 PM

1 15 Илья Рудаков
h1. Getting started with ReqEditor
2 1 Yuriy Shekochihin
3 4 Yuriy Shekochihin
ReqEditor является инструментом для организации каталога требований. Этот инструмент выполнен в виде расширения для Eclipse. 
4 2 Yuriy Shekochihin
5
Найти подробную информацию о ReqEditor можно по адресу: http://forge.ispras.ru/projects/show/reqdb
6
7 30 Илья Рудаков
h2. 1. Установка
8 1 Yuriy Shekochihin
9 5 Yuriy Shekochihin
Для работы ReqEditor требуется установленный Eclipse. Если у Вас уже установлен Eclispe следующий пункт можно пропустить.
10
11 16 Илья Рудаков
h3. 1.1 Системные требования
12 1 Yuriy Shekochihin
13 2 Yuriy Shekochihin
* Firefox 3.5 или выше;
14
* Eclipse 3.5 или выше;
15
16 16 Илья Рудаков
h3. 1.2 Установка Eclipse
17 1 Yuriy Shekochihin
18 30 Илья Рудаков
Eclipse можно скачать, зайдя на сайт http://eclipse.org/
19 2 Yuriy Shekochihin
20 16 Илья Рудаков
h3. 1.3 Установка ReqEditor
21 2 Yuriy Shekochihin
22 32 Илья Рудаков
Для установки ReqEditor необходимо скачать последнюю версию расширения с "сайта проекта":http://forge.ispras.ru/projects/list_files/reqdb и распаковать архив в директорию: 
23 33 Илья Рудаков
<pre>%ECLIPSE%/dropinst</pre>, где %%ECLIPSE%% - путь к Eclipse IDE.
24 1 Yuriy Shekochihin
25 19 Илья Рудаков
26 21 Илья Рудаков
h2. 2. Разметка требований
27 20 Илья Рудаков
28 34 Илья Рудаков
Рассмотрим подробнее работу инструмента на примере требований к функции g_array_sized_new()
29 2 Yuriy Shekochihin
библиотеки glib.
30
31 20 Илья Рудаков
h3. 2.1 Подготовка к работе
32 1 Yuriy Shekochihin
33 23 Илья Рудаков
Перед началом работы необходимо открыть вкладки Documents и Requirements. Для этого нужно открыть Window -> Show View -> Other, как показано на следующем рисунке.
34 1 Yuriy Shekochihin
35
!Views-menu-path.png!
36 23 Илья Рудаков
37
Перед вами появится диалоговое окно. Выберите Requirement Editor -> Requirements.
38 11 Yuriy Shekochihin
39
!Views-show-reqs.png!
40
41 24 Илья Рудаков
Повторите туже операцию, но теперь выберете Documents.
42
43 11 Yuriy Shekochihin
!Views-show-docs.png!
44 24 Илья Рудаков
45
После выполнения данных операций в основном окне Eclipse появятся две вкладки: Requirements и Documents. В первой вкладке будет отображаться иерархия требований, во второй - документы. Расположите эти вкладки так, как вам будет удобно. Например, как на рисунке ниже.
46 11 Yuriy Shekochihin
47
!Views-result.png!
48
49 20 Илья Рудаков
h3. 2.2 Создание нового каталога
50 1 Yuriy Shekochihin
51 26 Илья Рудаков
Теперь нам нужно создать каталог требований. Под каталогом требований мы будем понимать контейнер, в котором хранятся документы и требования. Чтобы создать каталог требований, зайдите в File -> New -> Other, как показано ниже.
52 25 Илья Рудаков
53 1 Yuriy Shekochihin
!Catalog-call-wizards.png!
54 26 Илья Рудаков
55 27 Илья Рудаков
Вы увидите диалоговое окно. Выберите Unitesk Wizards -> Catalogue of Requirements  и нажмите Next.
56 10 Yuriy Shekochihin
57 1 Yuriy Shekochihin
!Catalog-select-wizard.png!
58 27 Илья Рудаков
59
В следующем диалоговом окне нужно указать имя каталога. В нашем примере мы назвали его "Glib-Catalogue". Жмем Finish.
60 9 Yuriy Shekochihin
61
!Catalog-_wizard_creates_new_cat.png!
62
63 12 Yuriy Shekochihin
В итоге должно получиться следующее:
64
65
!cat-after-creation.png!
66
67 20 Илья Рудаков
h3. 2.3 Импорт документа в каталог
68 1 Yuriy Shekochihin
69 2 Yuriy Shekochihin
Правый клик -> Импорт...
70
71 40 Илья Рудаков
h3. 2.4 Создание требований
72 1 Yuriy Shekochihin
73 42 Илья Рудаков
Теперь давайте создадим простую иерархию требований. Для этого перейдем в "Requirements", выделим каталог требований "Glib-Catalogue" и нажмем на правую кнопку мыши. Далее нажимаем на "Add requirement", как показано ниже.
74 40 Илья Рудаков
75 1 Yuriy Shekochihin
!Req-new-call.png!
76 42 Илья Рудаков
77
Появится диалоговое окно, в котором нужно указать имя требования. В нашем примере это "g_array_sized_new".
78
79 1 Yuriy Shekochihin
!Req-set-name.png!
80 42 Илья Рудаков
81
Следующий шаг - аналогичным образом добавим дочерние требования с именами: "01", "02", "03" и "04" к "g_array_sized_new". 
82
83 41 Илья Рудаков
!Req-new-call2.png!
84 40 Илья Рудаков
85
h3. 2.5 Добавление выделенного текста из документа в требование
86
87 35 Илья Рудаков
Выберите в Documents нужный вам документ и двойным щелчком мыши откройте его. Далее выделите текст в документе, как показано ниже.
88
89
!Req7.png!
90
91
После того как текст выделен нажмите правую кнопку мыши и выберете "Add to requirement...".
92
93
!Req9.png!
94
95 38 Илья Рудаков
Появится диалоговое окно, в котором вы можете выбрать к какому требованию добавить выделенный текст. В нашем примере мы добавляем текст к требованию g_array_sized_new.01.
96
97
!Req-select.png!
98
99 39 Илья Рудаков
После нажатия кнопки "OK", выбранный текст будет добавлен в требование и подсвечен желтым цветом в документе, как показано ниже.
100 36 Илья Рудаков
101
!Req.png!
102
103 43 Илья Рудаков
h3. 2.6 Удаление размеченного текста из требования
104 1 Yuriy Shekochihin
105 43 Илья Рудаков
Чтобы удалить размеченный текст из требования, достаточно один раз кликнуть мышью по тексту. Текст поменяет цвет с желтого на розовый. Это значит, что вы, таким образом, выбрали именно этот участок текста.
106 44 Илья Рудаков
После этого нажмите правую кнопку мыши и выберите "Remove from requirement".
107
108
!Req10.png!
109 43 Илья Рудаков
110 45 Илья Рудаков
h3. 2.7 Редактирование требований
111 1 Yuriy Shekochihin
112 47 Илья Рудаков
Чтобы открыть окно редактирования требования, нужно в Requirements выбрать нужное требование и двойным щелчком мыши его открыть.
113
В открывшемся окне вы увидите раздел "Main information". Здесь указана информация об id требования, об всех размеченных текстовых фрагментах из документа( поле "Description" ) и т.д.
114
115 1 Yuriy Shekochihin
!Req11.png!
116 47 Илья Рудаков
117
Вы можете добавить к требованию альтернативное описание в поле "Alternative description".
118
119 1 Yuriy Shekochihin
!Req-edit-desc.png!
120
121 48 Илья Рудаков
Так же, в графе "Additional information" вы можете добавить предикаты и атрибуты.
122 47 Илья Рудаков
123
!Req-erit-attr-pred.png!
124 9 Yuriy Shekochihin
125 28 Илья Рудаков
h2. 3. Генерация отчета
126
127 1 Yuriy Shekochihin
Итак, мы дошли до генерации отчета о покрытии. Наведите курсор на название каталога требований во вкладке Requirements и нажмите на правую кнопку мыши - появится всплывающие меню. Выберите Generate Report, как показано ниже.
128 9 Yuriy Shekochihin
129 29 Илья Рудаков
!RepGen-call.png!
130
131
Появится диалоговое окно. 
132
В нем четыре пункта для ввода:
133
# *Root* - определяет корневое требование в вашей иерархии требований;
134
# *Data* - путь к шаблону FreeMarker. Файл с расширением .ftl;
135
# *Template* - путь к файлу template.xml;
136 8 Yuriy Shekochihin
# *Save to* - путь к директории куда мы хотим сохранить получившийся отчет.
137 1 Yuriy Shekochihin
138
!RepGen-dialog.png!