Project

General

Profile

Perspective » History » Version 42

Viktoria Kopach, 03/02/2011 06:23 PM

1 17 Alexey Demakov
h1. Перспектива Requality
2 18 Alexey Demakov
3 17 Alexey Demakov
Перспектива Requality содержит:
4
# Requality Explorer view, в котором отображается дерево проектов и их содержимое (документы, требования и т.п.);
5
# Properties view, в котором отображаются подробности отдельных элементов проекта;
6
# Document Markup editor, в котором осуществляется редактирование и просмотр разметки документа;
7
# Document Markup Outline view, в котором отображается структура разметки документа.
8
9 41 Viktoria Kopach
h2. 1. Requality Explorer view
10 6 Viktoria Kopach
11
Requality Explorer содержит все проекты, что и PackageExplorer, но развернуть можно только проекты типа Requality.
12
В Requality-проекте есть две папки: Documents и Requirements (содержащие, соответственно, документы с требованиями и сами требования).
13 19 Alexey Demakov
При *двойном клике* на требование:
14
# требование становится выделенным;
15
# если для документа первого location требования Document markup editor ещё не открыт, он открывается;
16 23 Alexey Demakov
# вкладка с указанным Document markup editor становится видимой;
17 20 Alexey Demakov
# в Outline view первый location требования становится выделенным (следующие два пункта выполняются при любом изменении выделения в Outline view);
18 19 Alexey Demakov
# документ в указанном Document markup editor перематывается так, чтобы вверху видимой области редактора оказался текст первого location требования;
19 22 Alexey Demakov
# текст этого location специально подсвечивается;
20 23 Alexey Demakov
# если для выделенного требования есть pinned Properties view, вкладка с ним становится видимой. Иначе видимой становится вкладка с одними из unpinned Properties view, если такого нет, оно открывается.
21
# подробности выделенного требования отображаются во всех pinned Properties view для него и во всех unpinned Properties View;
22 21 Alexey Demakov
23 24 Alexey Demakov
При *выборе требования (одинарный клик, переключение стрелочками)*:
24
# требование становится выделенным.
25
# подробности выделенного требования отображаются во всех pinned Properties view для него и во всех unpinned Properties View;
26 22 Alexey Demakov
27 41 Viktoria Kopach
h2. 2. Properties view (Редактор требований).
28 1 Alexey Demakov
29 2 Viktoria Kopach
Properties view содержит вкладки:
30
* Main
31
** Id
32
** Name
33
** Attributes
34 3 Viktoria Kopach
* Advanced
35
** Predicate (возможно стоит его перенести на вкладку Main? Или он может быть слишком большой?)
36
** Base requirement
37
* Descriptions
38 1 Alexey Demakov
** Alternative description
39
** список документов (или список location''ов - надо решить)
40 26 Alexey Demakov
* Source
41
** json
42 1 Alexey Demakov
43 26 Alexey Demakov
*Вкладка Base Requirement*
44 1 Alexey Demakov
При нажатии на базовое требование (специальная кнопка? Ссылка?) происходит переход к редактору базового требования (если текущий редактор не закреплен кнопкой — см.ниже).
45
46 27 Alexey Demakov
*Properties view имеет кнопку «Канцелярская кнопка» (Pin) для закрепления* 
47 26 Alexey Demakov
Если кнопка Pin выглядит нажатой, то это Properties View отображает детали фиксированного требования, которое было выделенным в момент нажатия кнопки.
48
Выглядит отжатой, то в этом Properties View отображаются детали выделенного требования. При изменении выделения меняется и отображаемое требование.
49 1 Alexey Demakov
50 27 Alexey Demakov
*Во view menu пункт Pin to Selection*.
51
При выборе этого пункта меню нажимается кнопка Pin (это второй способ ее нажатия). Кнопка Pin выглядит нажатой. Этот пункт меню выделяется как нажатый. При повторном нажатии Pin отжимается и выделение пункта меню снимается. Кнопка Pin отжата. Все происходящие изменения такие же, как при нажатии кнопки Pin.
52 1 Alexey Demakov
53 27 Alexey Demakov
*Во view menu пункт New Properties View*
54
При выборе этого пункта открывается новая закладка с редактором того же требования и не нажатой кнопкой Pin. (Что будет, если в редакторе внести изменения, не сохранить и выбрать это меню?)
55 4 Viktoria Kopach
56 27 Alexey Demakov
*Выбор другого документа*
57 13 Viktoria Kopach
Если на вкладке Documents нажать документ, который еще не был открыт, то он откроется на первом указанном в редакторе требования location, находящемся в этом документе (location пролистывается в верх видимой области и выделяется цветом). Этот же location выделяется в Outline.
58 1 Alexey Demakov
59 38 Viktoria Kopach
*Description*
60
В Description находится список имен всех location''ов этого требования (из всех документов), отсортированный по документам (???). Имена location''ов выглядят так же, как и в outline: 
61
user-visible-name(req) - это
62
* name, если name не пустое 
63
* user-visible-name(req.parent).id, иначе.
64
65
При клике на имя location''а документ пролистывается на этот location. Если документ с этим location''ом не был еще открыт, то он открывается. Происходят все соответствующие переключения в Outline и Requality Explorer.
66
67 27 Alexey Demakov
*Кнопка переключения между location''ами*
68 1 Alexey Demakov
В редакторе требования есть кнопка для переключения на следующий и предыдущий location. Порядок location''ов соответствует их порядку в редакторе требования. При переключении на другой location этот location выделяется в Outline и редакторе документа (пролистывается в верх видимой области и выделяется цветом).
69
70 42 Viktoria Kopach
h2. 3. Document Markup editor (Редактор документа)
71 41 Viktoria Kopach
72
Это окно-браузер с текстом документа. В нем размечаются требования. При выделении требования оно маркируется выделением. При наведении курсора на требование возникает всплывающая подсказка с его именем. При клике на выделенное требование в Explorer (не лучше ли при двойном клике?) выделяется данное требование, также открывается его редактор (если уже было хоть одно открытое и не закрепленное окно редактора), в Outline выделяется указанное location.
73
74 42 Viktoria Kopach
h2. 4. Document Markup Outline view
75 36 Viktoria Kopach
76 34 Viktoria Kopach
+Outline - плоский вид+
77 36 Viktoria Kopach
78 34 Viktoria Kopach
В Outline должен быть список location''ов в порядке их присутствия в html документе.
79 1 Alexey Demakov
80 34 Viktoria Kopach
Каждый location отображается следующим образом:
81 40 Viktoria Kopach
# Если location соответствует ноль требований в базе, то отображается текст "orphan location" красным жирным шрифтом.
82
# Если location соответствует одно требование, то user-visible-name(req).
83
# Если location соответствует несколько требований, то user-visible-name(req1),user-visible-name(req2),user-visible-name(req3).
84 1 Alexey Demakov
85
Если в данном документе у одного требования несколько location''ов, то в тексте выше user-visible-name(req) заменяется на user-visible-name(req)#i, где i - порядковый номер location''а среди всех location''ов данного требования в данном документе.
86
87 40 Viktoria Kopach
Определение user-visible-name(req) следующее: 
88
* name, если name не пустое 
89
* user-visible-name(req.parent).id, иначе
90 34 Viktoria Kopach
91
Кроме того, Outline должет быть синхронизирован с Document''ом в том смысле, что
92 40 Viktoria Kopach
# всегда при событии приводящем к промотке документа на определенный location, этот location должен выделяться в Outline.
93
# при выделении location в Outline необходимо проматывать документ к этому location.
94 1 Alexey Demakov
95 36 Viktoria Kopach
-(Зачеркнуто, т.к. неактуально, но может понадобиться потом)-
96 35 Viktoria Kopach
-В outline находится список всех location''ов. Список может быть в двух форматах:-
97
* -список location''ов в порядке их нахождения в документе (в текущем открытом документе или во всех документах?)-
98
* -список location''ов, сгруппированных по требованиям (требования - это узлы, раскрывающиеся в списки location''ов). Внутри группы location''ы упорядочены в порядке нахождения в документе. - надо разбить на два: в одном все location''ы только из текущего документа, в другом - все location''ы, принадлежащие требованиям, которые есть в этом документе (включая location''ы из других документов).-
99 31 Viktoria Kopach
100 30 Viktoria Kopach
При выборе одного из location''ов:
101
# документ пролистывается так, чтобы это location оказалось вверху видимой области документа
102 37 Viktoria Kopach
# текст location''а в документе размечается выделением. 
103 30 Viktoria Kopach
# если документ был закрыт, то он сначала открывается. - ?
104 15 Viktoria Kopach
При этом 
105 32 Viktoria Kopach
# если выбирается location, принадлежащий документу, редактор которого открыт, но неактивен, этот редактор становится активен и выполняются все вышеперечисленные пункты.
106 15 Viktoria Kopach
# -если выбирается location, принадлежащий документу, редактор которого не открыт, этот редактор открывается и выполняются все вышеперечисленные пункты.-
107 16 Viktoria Kopach
# если выбирается location, принадлежащий другому требованию (которое сейчас не выбрано), это требование выделяется в Requality Explorer''е и открывается в Properties view и выполняются все вышеперечисленные пункты.