Requality: глоссарий
M
Markup Editor
– окно в перспективе 'Requality', редактор документов,
используется для разметки фрагментов требований в документах.
Module Editor
– окно в перспективе 'Requality', визуальный редактор для представления требований и текстовых узлов в виде, близком к печатному документу.
Предназначен для разработки документации путем создания требований. В отличие от редакторов
'UniEditor' и 'Review', в данном редакторе узлы отображаются без отступов,
что позволяет более компактно отображать каталог требований, но не не позволяет напрямую определить иерархию требований.
Для анализа иерархии требований в данном представлении рекомендуется использовать дерево требований в окне 'Requality Explorer'.
O
Outline
– окно в перспективе 'Requality', отображающее список фрагментов документа.
P
Properties
– окно в перспективе 'Requality',
отображает свойства выбранного объекта
(требования, документа, тестовой ситуации, отчета, комментария).
R
REFERENCE-тип атрибута.
– cпециальный тип атрибутов требований, виртуальных узлов и тестовых ситуаций, позволяющий связывать узел,
для которого он указан, с другим узлом из того же каталога проекта 'Requality'. Этот атрибут находится в окне 'Properties'
на вкладке 'Main' в таблице 'Attributes'. Это обычный атрибут, у которого указан тип 'REFERENCE',
а в качестве значения указан целевой узел, на который идет ссылка.
Связанность узлов можно посмотреть в представлении 'Requality Links Explorer'.
Ссылки в этом представлении доступны в обе стороны, как у узла, в котором была создана такая ссылка:
так и для узла, к которому она была привязана (на который она ссылается):
Requality Explorer
– окно в перспективе 'Requality', отображающее все содержимое проекта (документы, требования, отчеты, комментарии).
Requality Links Explorer
– окно в перспективе 'Requality', в котором отображаются узлы каталога проекта, связанные с выбранным узлом связью через атрибут типа 'REFERENCE'.
Review
– окно в перспективе 'Requality', визуальный редактор для
требований, тестовых ситуаций, текстовых узлов и комментариев. Предназначен скорее для просмотра, нежели для редактирования, поэтому обладает
ограниченной функциональностью. Позволяет только добавлять, редактировать и удалять комментарии, а так же изменять статусы требований
и тестовых ситуаций. В отличие от 'UniEditor' позволяет устанавливать статусы требований и тестовых ситуаций в значение 'verified'.
U
UniEditor
– окно в перспективе 'Requality', визуальный редактор для требований, тестовых ситуаций, текстовых узлов и комментариев.
Позволяет добавлять, редактировать и изменять требования, тестовые ситуации и комментарии, а так же изменять
статусы требований и тестовых ситуаций. В отличие от редактора 'Review'
не дает возможности устанавливать статусы требований и тестовых ситуаций в значение 'verified'.

Update Processor Tasks
– окно в перспективе 'Requality', используемое после автоматического переноса требований в новую
версию документа для ручного уточнения корректности переноса требований и ручного переноса фрагментов требований
в случае, если они не были перенесены автоматически. Отображает список всех требований и степень успешности их переноса:
- 'Verify' – если все фрагменты требования были перенесены, требуется проверить корректность переноса.
- 'Add Locations' – если была перенесена часть фрагментов требований, предлагается найти в новом документе
аналоги не найденных фрагментов требований, которые не были перенесены, или убедиться, что в новой версии их нет.
- 'Find Locations' – не было перенесено ни одного фрагмента требования. Предлагается найти их аналоги
в новой версии или убедиться, что данного требования больше нет в новой версии спецификации.

А
Активный шаблон узла (активный шаблон)
- шаблон узла, который выбран в качестве активного для данного типа узлов. Если шаблон выбран в качестве активного,
то при создании новых узлов данного типа все узлы будут создаваться по этому шаблону по умолчанию. Изначально для всех узлов проекта выбран пустой шаблон,
где все параметры заданы по умолчанию. (Cм. Редактор шаблонов.)
Для одного типа узлов активный шаблон может быть только один. Активный шаблон выделяется жирным шрифтом в списке шаблонов в окне редактора шаблонов.
В
Виртуальный узел (Virtual Node)
– это элемент каталога проекта 'Requality', используемый для повторного использования (переиспользования) фрагментов каталога требований. Результатом использования виртуального узла является автоматически созданное поддерево узлов-клонов (см. 'Клон'), повторяющих уже существующее поддерево каталога требований.
Процесс переиспользования осуществляется путем выбора метода итерации узлов-клонов с
последующим указанием целевого элемента, для которого будет проводиться переиспользование (см. 'Параметры виртуального узла').
Существует два возможных метода итерации:
- 'Reuse' — копии целевого узла будут добавлены к виртуальному узлу как потомки со всем своим поддеревом.
- 'Base element'- копии прямых потомков целевого элемента будут добавлены к виртуальному узлу как потомки со всем своим поддеревом.
Для метода итерации 'Reuse' также доступны настройки 'It.vars', связанные с определением количества копий. Эта настройка позволяет использовать списочные переменные для создания нескольких клонов одного узла с разными значениями переменной.
В дереве проекта виртуальный узел отображается как один из элементов дерева требований в виде потомка того элемента, для которого предполагается создать поддерево узлов-клонов.
Виртуальный узел может быть скрыт (может не отображаться) в дереве проекта. В скрытом режиме вместо виртуального узла
отображаются его потомки-клоны.
Г
Генератор значений атрибута
– специальный механизм для автоматической генерации списка значений атрибута.
У всех типов узлов проекта 'Requality' (кроме папок и документов) в окне 'Properties' во вкладке Main находится таблица атрибутов
(см. 'Таблица атрибутов').
В этой таблице крайний справа столбец называется Generator. При клике в ячейку этого столбца открывается окно генератора значений атрибута -
Attribute value generator.
Окно Attribute value generator содержит следующие параметры:
- Origin – элемент дерева требований, в котором задан генератор. Не может быть отредактировано вручную.
Как правило, здесь указан тот узел, для атрибута которого был открыт генератор. Но в случае, если атрибут был унаследован, в этом поле будет
указан узел, от которого произошло наследование.
- Attr.gen.type – способ генерации атрибута.
Доступны три способа генерации атрибута: 'RANDOM', 'BY_FORMULA', 'CYCLE'.
- RANDOM - генерация случайным образом. При выборе этого способа появляются поля
'Min' (минимальное значение выборки),
'Max' (максимальное значение выборки) и 'Count' (количество генерируемых значений).
- По умолчанию во всех этих полях установлено значение 0.
- Значение полей может быть отредактировано пользователем.
- Значение 'Max' всегда должно быть не меньше значения 'Min', если пользователь указывает обратное, значения полей меняются местами между собой.
- Изменение значений этих полей сразу влияет на содержимое поля 'Preview'.
- Также, если выбрано значение 'RANDOM', доступна кнопка 'Generate new set', при нажатии которой генерируется новый набор значений в поле 'Preview'.
- Изменение значений этих полей сразу влияет на содержимое поля 'Preview'.
- BY_FORMULA - генерация значений в соответствии с заданной формулой. Если выбран этот способ, становится доступно поле 'Formula'.
- По умолчанию оно пусто. Может быть отредактировано пользователем вручную.
- Формулы описываются в виде выражений на языке JavaScript. В качестве переменных могут использоваться атрибуты узла.
- Пример: если указать в поле Formula значение: 'element'+_i, где i - это имя одной из переменных узла,
имеющей значение 'IValue', то генератор сгенерирует значение element_IVALUE.
- Изменение значений этих полей сразу влияет на содержимое поля 'Preview'.
- CYCLE - генерация значений с помощью перебора циклом типа From-To (с указанием начального и конечного значения, а так же шага).
При выборе этого способа генерации становятся доступны следующие поля: 'From', 'To' и 'Step'.
- По умолчанию во всех этих полях установлено значение 0. Пользователь может редактировать значение этих полей вручную.
- Значение 'To' всегда должно быть не меньше значения 'From', если пользователь указывает обратное, значения полей меняются местами между собой.
- Изменение значений этих полей сразу влияет на содержимое поля 'Preview'.
- Preview - поле, где отображается сгенерированный указанным способом набор значений атрибута.
Содержимое этого поля является результатом установки значений параметров генератора. По умолчанию поле пусто. Редактирование возможно
косвенным образом при изменении параметров генератора (см. редактирование поля 'Attr.gen.type').
Д
Документ (Document)
– это документ некоторого формата, содержащий требования, написанные в свободной форме. В документе пользователь выделяет фрагменты текста
и присваивает их требованиям.
К
Клон, узел-клон
- узел-потомок виртуального узла, созданный на основе другого узла дерева требований (так называемого переиспользованного узла) в соответствии с настройками виртуального узла (см. 'Параметры виртуального узла'). Клон по умолчанию получает тип и свойства от переиспользованного узла. Однако, они могут быть изменены пользователем. В окне 'Requality Explorer' пиктограмма узла-клона помечается дополнительным значком с буквой 'V'.
Комментарий (Comment)
- некоторая сущность,
содержащая текстовый
комментарий, относящийся к требованию, текстовому узлу
или тестовой ситуации. У одного
требования/одного тестового узла/одной тестовой ситуации
может быть несколько комментариев.
Н
Настройки отчета (Report settings)
– некоторая сущность, позволяющая
сгенерировать отчетный документ, содержащий сводную информацию по проекту (количество проверенных и непроверенных требований,
покрытие требований тестовыми ситуациями, покрытие документа требованиями и т.п.). Обладает набором параметров, которые
влияют на содержимое и вид отчета, а так же определяют источник информации для формирования отчета. На основе одного узла
Настроек отчета можно сгенерировать несколько отчетов. Изменение Настроек отчета не влияет на уже сгенерированные отчеты.
О
Отчет (Report)
– некоторая сущность, представляющая собой готовый сгенерированный отчет.
Отчет генерируется на основе настроек, указанных в узле Настройки отчета, перегенерирован быть не может. Обладает нередактируемым набором параметров,
позволяющих узнать, по каким настройкам был сгенерирован данный отчет. Изменить можно только имя отчета. По умолчанию имя отчета содержит информацию о дате и времени генерации.
Отчет по шаблону Coverage
- отчет о покрытии требований и тестовых ситуаций другими
элементами (например, тестами), заданном с помощью дополнительного
источника информации о покрытии. Таких источников может быть два:
- Файл с информацией о покрытии, записанной в определенном формате
- Автоматический поиск файлов, содержащих идентификаторы покрытых ими
требований или тестовых ситуаций.
При использовании этого источника происходит поиск по выбранным
пользователем проектам в workspace на предмет обнаружения файлов с
заданным расширением. Расширение задается пользователем. Для указанных
файлов производится построчная проверка содержимого файла на
соответствие регулярному выражению, описанному пользователем. В
результате такого поиска инструмент получает набор покрытых элементов и
информацию о покрывающих файлах.
Отчет по шаблону Document Model
– отчет о покрытии выделенных фрагментов документа другими
элементами (например, тестами), заданный с помощью дополнительного
источника информации о покрытии. Таких источников может быть два:
- Файл с информацией о покрытии, записанной в определенном формате
- Автоматический поиск файлов, содержащих идентификаторы покрытых ими
требований или тестовых ситуаций
При использовании этого источника происходит поиск по выбранным
пользователем проектам в workspace на предмет обнаружения файлов с
заданным расширением. Расширение задается пользователем. Для указанных
файлов производится построчная проверка содержимого файла на
соответствие регулярному выражению, описанному пользователем. В
результате такого поиска инструмент получает набор покрытых элементов и
информацию о покрывающих файлах.
Отчет по шаблону Progress
– отчет со статистикой по разным ревизиям, загруженным в SVN.>
Отчет состоит из двух страниц:
- На первой странице находятся следующие графики:
- График, отображающий общее количество элементов: требований (внутренних и листовых узлов), тестовых ситуаций.
- График с информацией о покрытии.
- И график с соотношением количества требований и количества тестовых ситуаций.
- На второй странице отчета отображается общая таблица с числовыми характеристиками по ревизиям:
количество требований, тестовых ситуаций, количество и процентное соотношение покрытых и не покрытых требований.
Для построения данного отчета можно установить настройки отчета (интересующий период времени и временной шаг между ревизиями), а также указать источник, откуда необходимо брать информацию о покрытии.
Отчет по шаблону Traceability
– отчет со ссылками между связанными узлами каталога проекта.
Отчет состоит из двух страниц. Первая содержит информацию о прямых ссылках, вторая об обратных.
По умолчанию открывается первая страница, для перехода на вторую следует нажать на ссылку с
именем обратного отношения (задается в свойствах проекта). Для обратного перехода к первой странице следует нажать на имя отношения.
П
Параметры виртуального узла
– свойства виртуального узла, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для виртуальных узлов окно 'Properties' содержит 4 вкладки:
- Вкладка Main содержит следующие параметры виртуального узла:
- Id – идентификатор виртуального узла. Идентификатор уникален среди дочерних узлов одного родителя. Может быть изменен вручную.
- Name – имя виртуального узла. Может не быть уникальным. По умолчанию пусто. Может быть изменено вручную.
- Attributes – атрибуты виртуального узла, представлены в таблице. Подробнее о таблице атрибутов
здесь.
- Вкладка Iteration содержит следующие параметры виртуального узла:
- Target – целевой элемент,
которым будет оперировать виртуальный узел. Требование или тестовая ситуация.
По умолчанию не указан. Может быть выбран среди узлов каталога проекта.
Если у требования-родителя виртуального узла есть дочерняя тестовая ситуация,
то в качестве 'Target' может быть выбрана только тестовая ситуация (не требование).
- Iteration method –
способ использования виртуального узла. Может иметь два значения, выбираемые из выпадающего списка:
- Reuse - использование обобщенного описания, копии которого будут добавлены к виртуальному узлу.
- Base element- определение базового элемента, при котором копии прямых потомков целевого элемента будут добавлены к виртуальному узлу.
- It.vars – итерируемые переменные.
Этот параметр появляется только в том случае, если выбран способ 'Reuse'.
По умолчанию ни одна итерируемая переменная не указана. Итерируемых переменных может бысть несколько.
Они могут быть добавлены и удалены с помощью соответствующих кнопок.
Выбираются с помощью выпадающего списка, который содержит
список доступных атрибутов. В качестве итерируемой переменной может
быть использован один из атрибутов данного
виртуального узла (т.е. находящийся в списке атрибутов на вкладке 'Main'),
имеющий тип List (то есть имеющий список значений).
- Вкладка Source содержит только json-код:
- json – низкоуровневое
представление виртуального узла как
сущности. Не редактируется.
Параметры Комментария
– свойства узла Комментарий, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для Комментария окно 'Properties' содержит 2 вкладки:
- Вкладка Main содержит следующие параметры комментария:
- Id – идентификатор комментария. Идентификатор уникален среди дочерних узлов одного родителя. Не редактируется.
- Name – имя комментария. Может не быть уникальным. По умолчанию пусто. Может быть изменено вручную.
- Author – автор комментария. По умолчанию это поле заполнено в соответствии с настройками операционной системы.
- Поле для текста комментария – по умолчанию пусто. Может быть заполнено вручную.
- Вкладка Source содержит только json-код:
- json – низкоуровневое
представление комментария как
сущности. Не редактируется.
Параметры Настроек отчета
– свойства узла Настройки отчета, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для Настроек отчета окно 'Properties' содержит 2 вкладки:
- Вкладка Report Settings:
- Id – идентификатор Настроек отчета. Идентификатор уникален
среди узлов одной папки в разделе Отчетов. Может быть изменен
вручную.
- Root requirement – требование, для
которого будет генерироваться отчет. В отчете, сгенерированный на основе этих Настроек отчета,
будет рассматриваться не все дерево узлов проекта, а только поддерево указанного узла-требования и все его дочерние узлы (требования и комментарии).
В случае подключения дополнительных плагинов к 'Requality' в отчет могут войти и узлы других типов.
Эта настройка изменяется вручную.
- Template – шаблон отчета, в соответствии с которым модифицируется
вид и содержимое отчета. Например, данные можно представить в виде списка или таблицы. Можно включить в отчет
все узлы дерева Requirements или только узлы некоторого конкретного типа. В случае использования
плагинов к 'Requality' список доступных шаблонов отчета может пополняться. Вы также можете самостоятельно
создавать нужные шаблоны отчета. Шаблон отчета изменяется вручную: выбирается из списка
доступных шаблонов отчета. По умолчанию доступны следущие шаблоны отчета: 'Coverage', 'XML-export', 'Requirements',
'Document Model', 'Test Purposes Coverage', 'Progress' and 'Traceability'.
- 'Coverage' - содержит информацию о покрытии требований и тестовых ситуаций другими элементами (например, тестами).
Для генерации требуется задать источник информации о покрытии. Подробнее о 'Coverage' отчете можно прочитать здесь.
- 'XML-export' - отчет в формате XML, предназначем для
использования отчета другими инструментами.
- 'Requirements' - содержит список всех требований.
- 'Document Model' аналогичен 'Coverage', но предоставляет информацию о покрытии фрагментов документа.
- 'Test Purposes Coverage' - содержит сводную информацию о текущем статусе (находятся в работе, проверены и т.д.) требований и тестовых ситуаций.
- 'Progress' - позволяет просматривать статистику по количеству требований и тестовых ситуаций в разных ревизиях, загруженных в SVN по данному проекту.
- 'Traceability' - отчет со ссылками между связанными узлами каталога проекта.
- Attributes – атрибуты настроек отчета, представлены в таблице.
Подробнее о таблице атрибутов здесь. Если для
генерации отчета требуется указать источник информации об отчете, то информация
о нем записывается в таблицу атрибутов как значение атрибута с именем coverageFilePath.
Для задания или изменения значения этого атрибута используется кнопка
'Update Coverage Source', которая возникает на вкладке в том случае,
если выбранный шаблон отчета требует указания источника информации о покрытии.
- Вкладка Source содержит только json-код:
- json – низкоуровневое
представление отчета как сущности. Не
редактируется.
Параметры отчета
– параметры узла Свойства отчета, на основе которых отчет был сгенерирован. Указываются в окне 'Properties'.
Полностью идентичны параметрам узла Свойства отчета (за исключением атрибута 'date'), однако не могут быть отредактированы (за исключением параметра 'Id').
- Параметр Id в данном случае - это идентификатор отчета,
располагающийся на вкладке 'Report Settings' окна 'Properties'. По умолчанию он включает идентификатор
'Настроек отчета', на основе которых был сгенерирован данный отчет, и дату и время генерации. Однако может быть вручную отредактирован пользователем.
- Таблица атрибутов содержит атрибут date, который автоматически создается при генерации отчета и содержит информацию о дате и времени генерации отчета.
Параметры проекта 'Requality' (свойства проекта)
– свойства проекта 'Requality', задаются как параметры корневого узла проекта. Устанавливаются в окне 'Properties'.
Для проекта окно 'Properties' содержит 2 вкладки:
- 'Main'
- Кнопка 'Extract enum definitions from attributes' открывает диалоговое окно для извлечения перечисляемого
типа из уже существующих атрибутов проекта. См. подробнее 'Перечисляемый тип атрибута (Enum)'.
- 'Attributes' - атрибуты проекта, представлены в таблице. Таблица атрибутов (см. 'Таблица атрибутов') проекта аналогична таблицам
атрибутов других узлов проекта, за исключением того, что отсутствует столбец 'Scope'. Все атрибуты проекта считаются
по умолчанию глобальными, то есть наследуются всем деревом
проекта. В таблице атрибутов проекта могут быть заданы атрибуты типа 'ENUM_DEFINITION'
(см. 'Перечисляемый тип атрибута (Enum)'),
которые служат для задания перечисляемого типа для использования в других атрибутах проекта. Подробнее о перечисляемом типе см. здесь.
- 'Templates' - содержимое этой вкладки полностью совпадает с содержимым окна 'Редактора шаблонов' и имеет ту же функциональность.
См. 'Редактор шаблонов'.
Параметры тестовой ситуации
– свойства тестовой ситуации, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для тестовых ситуаций окно 'Properties' содержит 4 вкладки:
- Вкладка Main:
- Id – идентификатор тестовой
ситуации. Идентификатор уникален
среди тестовых ситуаций одного
требования. Может быть изменен
вручную.
- Name – имя тестовой ситуации. Может
не быть уникальным. По умолчанию пусто. Может быть изменено
вручную.
- Status - статус требования,
может иметь одно из трех значений: 'in
process', 'complete' или 'verified'.
Изменяется вручную.
- Author - автор требования,
изменяется вручную.
- Attributes – атрибуты
тестовой ситуации, представлены в таблице.
Подробнее о таблице атрибутов здесь.
- Вкладка Description:
- Test purpose description - описание теста,
изменяется вручную.
- Expected results - ожидаемый после
выполнения теста результат.
- Вкладка Advanced содержит:
- Predicate – предикат, условие
отбора тестовых ситуаций для отчетов.
По умолчанию наследуется от
родительских требований. Заполняется
вручную.
- Вкладка Source:
- json – низкоуровневое
представление тестовой ситуации как
сущности. Не редактируется.
Параметры текстового узла
– свойства текстового узла, которые устанавливаются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для текстовых узлов окно 'Properties' содержит 4 вкладки:
- Вкладка Main содержит следующие параметры текстового узла:
- Id – идентификатор
текстового узла. Идентификатор уникален
среди дочерних узлов одного родителя. Может
быть изменен вручную.
- Name – имя текстового узла. Может
не быть уникальным. По умолчанию пусто. Может быть изменено
вручную.
- Type – тип узла.
Для текстового узла тип всегда указан или 'Text' (для простого текста),
или 'Header' (для заголовка).
Это поле представляет собой выпадающий список и предназначено для смены типа узла на другой вид текстового узла
('Text' на 'Header' или обратно) или требование ('Requirement').
- Attributes – атрибуты
текстового узла, представлены в таблице. Подробнее о таблице атрибутов здесь.
- Вкладка Description содержит следующие параметры текстового узла:
- Description –
текст текстового узла. Заполняется вручную.
- Вкладка Advanced содержит следующие параметры текстового узла:
- Predicate – предикат, условие
отбора текстовых узлов для отчетов. По
умолчанию наследуется от родительских
узлов. Заполняется вручную.
- Вкладка Source содержит только json-код:
- json – низкоуровневое
представление текстового узла как
сущности. Не редактируется.
Параметры требования
– свойства требования, которые устанавливаются в окне 'Properties'. (Также могут быть в сокращенном виде
просмотрены и отредактированы в 'окне редактирования параметров'.)
Для требований окно 'Properties' содержит 4 вкладки:
- Вкладка Main содержит следующие параметры требования:
- Id – идентификатор
требования. Идентификатор уникален
среди дочерних узлов одного родителя. Может
быть изменен вручную.
- Name – имя требования. Может
не быть уникальным. По умолчанию пусто. Может быть изменено
вручную.
- Type – тип узла. Для требования - всегда 'Requirement'.
Это поле представляет собой выпадающий список и предназначено для смены типа узла на текстовый ('Text' или 'Header').
- Attributes – атрибуты
требования, представлены в таблице. Подробнее о таблице атрибутов здесь.
- Вкладка Description содержит следующие параметры требования:
- Alternative Description –
альтернативный текст требования,
уточняет и дополняет текст выделенных
фрагментов. Заполняется вручную.
- Locations - список выделенных
фрагментов данного требования,
сгруппированный по документам.
Вручную можно только удалять фрагменты.
- Вкладка Advanced содержит:
- Predicate – предикат, условие
отбора требований для отчетов. По
умолчанию наследуется от родительских
требований. Заполняется вручную.
- Вкладка Source содержит только json-код:
- json – низкоуровневое
представление требования как
сущности. Не редактируется.
Параметры узла
– свойства узла, набор параметров, которые характеризуют узел. Полный перечень параметров узла можно посмотреть и отредактировать
в окне-представлении 'Properties' перспективы Requality. Сокращенный перечень параметров находится в специальном
'окне редактирования параметров', которое открывается при создании и редактировании узлов в редакторах 'Module Editor', 'UniEditor' и 'Review'.
Параметры шаблона узла
– свойства шаблона узла (см. 'Шаблон узла'). Параметры шаблона узла определенного типа полностью аналогичны параметрам узла этого типа. Устанавливаются в окне 'Properties'.
(Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Переиспользуемый (переиспользованный) узел
- любой узел дерева требований, указанный в качестве целевого узла для итерации в параметрах виртуального узла (см. 'Target' в разделе 'Параметры виртуального узла'). На основе этого узла создаются узлы-клоны (см. 'Клон') данного виртуального узла. На сам переиспользованный узел это никак не влияет. Изменения в переиспользуемом узле и его поддереве узлов влияют на узлы-клоны.
Перечисляемый тип атрибута (Enum)
– это тип атрибута, определяющий список допустимых значений атрибута. Перечисляемый тип - 'Enum' - в 'Requality'
определяется пользователем в окне параметров проекта (см. 'Параметры проекта 'Requality') как обычный атрибут узла проекта:
- Имя этого атрибута будет считаться названием 'Enum'-типа.
- В качестве типа этого атрибута должен быть выбран тип 'ENUM_DEFINITION'.
- В качестве значения атрибута указывается список значений. Его можно задать вручную с помощью специального
редактора или воспользоваться дополнительной возможностью извлечения из уже существующих атрибутов всех узлов проекта:
- Редактор открывается при клике в столбце 'Value'. В окне редактора перечислены все допустимые
значения типа и комментарии к ним (если есть). Окно редактора значений для задания перечисляемого типа выглядит так:
- Процедура извлечения 'Enum'-типа из узлов проекта запускается с помощью кнопки 'Extract enum definition from attributes'
в окне 'Properties' проекта. Где пользователь может выбрать один из атрибутов, использующихся в дереве узлов проекта.
Там же пользователю предлагается ввести имя для нового типа (по умолчанию оно будет совпадать с названием выбранного атрибута).
После завершения процедуры все значения атрибута с таким именем станут списком значений перечисляемого типа.
А атрибуты, по которым был задан 'Enum'-тип, получат в качестве типа название этого нового созданного перечисляемого типа, сохранив свои значения.
- Сам по себе атрибут 'ENUM_DEFINITION' не виден (не наследуется) в качестве атрибута в других узлах проекта.
Но заданный им 'Enum'-тип отображается в списке доступных типов для всех атрибутов в узлах дерева проекта (во избежание путаницы он отображается с префиксом Ⓔ).
Подтребование, дочернее требование (sub-requirement,
child-node)
– это требование, являющееся дочерним узлом другого требования в иерархии проекта.
Проект Requality (Requality project)
– проект Eclipse, созданный
с помощью плагина 'Requality'. Cодержит документы, требования
отчеты, комментарии.
Р
Редактор значений списка
– редактор значений атрибута типа 'LIST' (список).
Если в 'Properties view' узла есть атрибут типа 'LIST', то для задания и редактирования его значений используется 'Редактор значений списка'.
Редактор открывается в специальном окне, которое содержит два следующих элемента:
- поле с выпадающим списком для выбора типа значений ('INT', 'FLOAT', 'BOOL', 'STRING', 'LIST', 'REFERENCE').
- таблица с перечислением всех значений. Редактируется вручную. Порядок перечисления значений можно изменить с помощью стрелок.
Редактор шаблонов
– редактор шаблонов узлов (см. 'Шаблон узла'). Позволяет создавать, удалять, редактировать шаблоны узлов и задавать активные шаблоны.
Открывается из редакторов: 'Module Editor', 'UniEditor', 'Review'.
Содержит поля:
- Select Node Type - выпадающий список для выбора типа узла. Определяет тип узлов, с которыми
будет осуществляться работа в окне редактора шаблонов. То есть если, например, выбран тип 'Requirement', то
ниже в списке шаблонов будут отображаться только шаблоны требований и при создании нового шаблона будет создан шаблон требования.
- Create template - кнопка для создания нового шаблона.
- Extract template - кнопка для создания нового шаблона на основе существующего узла.
- List of templates - список доступных шаблонов для выбранного в выпадающем списке 'Select Node Type' типа узлов.
- Edit - кнопка, открывающая редактор для шаблона, выбранного в списке 'List of templates'.
- Remove - кнопка для удаления шаблона, выбранного в списке 'List of templates'.
- Set as active - кнопка, делающая выбранный в списке 'List of templates' шаблон активным (см. 'Активный шаблон узла').
По умолчанию активным является пустой шаблон - 'Empty'.
Активный шаблон выделяется жирным шрифтом в списке 'List of templates'.
Т
Таблица атрибутов (атрибуты)
– это набор параметров - атрибутов - узла проекта 'Requality', которые характеризуют различные свойства этого узла.
- Атрибуты перечислены в окне 'Properties view'.
- Каждый атрибут имеет имя, тип, значение, область действия.
- Так же для атрибута опционально может быть указан генератор значений.
- Атрибуты могут быть заданы вручную или сгенерированы автоматически с помощью генератора, параметры которого задаются пользователем.
- Атрибуты могут быть унаследованы от родительского узла, в таком случае они помечаются символом-стрелкой.
- Атрибуты применяются в предикатах, в описаниях узлов, а так же при переиспользовании и итерации узлов.
- Некоторые атрибуты задаются автоматически, например, дата генерации отчета.
- Некоторые атрибуты должны иметь строго определенные имена, такие атрибуты обычно создаются с помощью вспомогательных диалоговых окон
(например, атрибут 'coverageFilePath' у узла настроек отчета 'Report Settings', который задает пусть к файлу с информацией о покрытии).
- Для разных типов узла атрибуты могут различаться.
Атрибуты представлены в виде таблицы с полями 'Name' (имя атрибута), 'Type' (тип), 'Value' (значение),
'Scope' (область видимости) и 'Generator' (генератор значений атрибута).
Тестовая ситуация (Test purpose)
– это некоторая сущность,
содержащая описание тестового случая и
ожидаемый результат. Принадлежит
требованию, не имеющему
требований-потомков. Тестовая ситуация
обладает набором параметров, задающих ее
содержимое и свойства. Для одного
требования может быть задано несколько
тестовых ситуаций.
Текстовый узел (Text Node)
– это сущность, содержащая некоторый текст. Предназначена для хранения и отображения примечаний и комментариев, входящих в состав документации.
Такой текст может являться частью документации, не будучи при этом требованием.
- Текстовый узел аналогичен требованию ('Requirement'), но им не является и в отчетах о покрытии требований или о покрытии требованиями не учитывается.
- Текстовый узел обладает набором параметров, которые задают его содержимое и свойства
(см. 'Параметры текстового узла').
- Текстовый узел может иметь два формата: обычный текст ('text') и текст-заголовок ('header').
Формат текстового узла влияет на его отображение в редакторах 'UniEditor' и 'Module Editor'.
- Текстовый узел может быть преобразован в требование ('Requirement') с сохранением всех параметров.
Требование (Requirement)
– это сущность,
содержащая описание некоторого
требования и ссылающаяся на те фрагменты
документа, которые соответствуют этому
требованию.
- Требование может не иметь
описания и не ссылаться на документ,
такие требования обычно используются
для организации иерархической структуры
требований, выступая в роли
узлов-родителей.
- Только требования, не
имеющие в иерархии требований-потомков,
могут иметь тестовые ситуации.
- Требования обладают набором параметров,
которые задают его содержимое и
свойства (см. 'Параметры требования').
- Требование может быть преобразовано в текстовый узел ('Text Node') с сохранением всех параметров.
У
Уточняемое требование
– требование, на которое ссылается другое (уточняющее) требование.
Уточняющее требование
– требование, которое ссылается на другое требование. У уточняющего
требования есть атрибут типа 'REFERENCE', в котором указано требование, на которое идет ссылка (уточняемое требование).
Ф
Файл с информацией о покрытии
– это XML-документ, задающий покрытие требований и
тестовых ситуаций другими элементами (например, тестами). Используется для генерации некоторых отчетов.
Записывается следующим образом:
<?xml version="1.0" encoding="UTF-8"?>
<coverageInfo>
<reqcoverage qid="уникальный_идентификатор_требования_или_тестовой_ситуации">
<covered_by uri="путь_к_покрывающему_элементу" [hits="1"]/>
</reqcoverage>
<reqcoverage qid="уникальный_идентификатор_требования_или_тестовой_ситуации">
<covered_by uri="путь_к_покрывающему_элементу"/>
</reqcoverage>
<error [name="имя_ошибки"] testuri="uri_элемента_covered_by" [uri="ссылка_на_описание_ошибки"]>
[<violates qid="уникальный_идентификатор_требования_или_тестовой_ситуации"/>]*
[<description [format="вид_описания_ошибки"]>описание_ошибки</description>]
</error>
</coverageInfo>
Здесь:
Квадратными скобками обозначены опциональные параметры.
-
coverageInfo - может быть только один экземпляр в файле. Он содержит вложенные XML-элементы reqcoverage (один или несколько) и error (может не быть, может быть один или несколько).
-
reqcoverage - элемент-ребенок для coverageInfo. Должен быть задан отдельно для каждого покрытого Requality-элемента. (Непокрытые узлы не описываются никак.)
Содержит вложенные XML-элементы covered_by (один или несколько). Каждому вложенному covered_by должен соответствует одна тестовая процедура или тест. Имеет атрибут qid.
-
qid - это user-visible-name(element) или qualifying-id(element) покрываемого элемента:
-
user-visible-name(element) - это имя элемента, если оно есть (то есть если поле name в Properties view у этого элемента не пустое),
иначе это user-visible-name(element.parent)/id, то есть сначала user-visible-name родительского элемента, потом id - идентификатор элемента (в качестве разделителя использовать '/').
Например:
"TR-FMF-01-01-002/TR-FMF-01-01-002_T01"
-
qualifying-id(element) - это полный путь к элементу, начиная с корневого элемента (Requirements), в качестве разделителя используется '/'.
Например:
"Requirements/01/MyRequirement01"
-
covered_by - элемент-ребенок для reqcoverage. Внутри reqcoverage их может быть несколько в зависимости от того, сколько тестовых процедур или тестов покрывают
соответствующий ему Requality-элемент. Каждый covered_by соответствует одному покрывающему Requality-элементу. covered_by
меет атрибуты uri и hits.
-
uri - атрибут XML-элемента covered_by, указывает путь к тесту, описанному в этом covered_by элементе:
-
если описывается покрытие тестовых ситуаций тестовыми процедурами, то это путь к шагу тестовой процедуры.
-
Если тестовая процедура находится в том же проекте, то путь записывается без протокола, например:
"/TestProcedures/01/TestStep04"
Здесь 01 - идентификатор тестовой процедуры, 04 - номер шага тестовой процедуры.
-
Если тестовая процедура находится в другом проекте Requality, то путь записывается следующим образом:
"requality://ProjectName/TestProcedures/01/TestStep04"
Здесь ProjectName - имя проекта, где находится тестовая процедура.
-
если описывается покрытие тестовых ситуаций тестами, то это путь к тесту, например:
"file:///home/user/work/test1.c#12"
-
hits - атрибут XML-элемента covered_by, является опциональным. Указывает количество упоминаний этого требования reqcoverage в тесте covered_by.
-
error - элемент для описания ошибки, полученной в результате выполнения теста. Может содержать один элемент description с описанием ошибки. Может включать один или
несколько элементов violates в ситуации, когда можно определить какие именно требования нарушает ошибка.
Имеет атрибут testuri и опциональные атрибуты name и uri.
-
testuri - путь к одному из тестов, описанному в covered_by элементе.
-
name - опциональный параметр, представляет собой отображаемое имя ошибки. В случае если не определен, используется имя "error"+порядковый_номер_ошибки.
-
uri - опциональный параметр, путь к файлу с подробной информацией об ошибке.
-
violates - опциональный элемент, соответствует требованию, которое нарушает ошибка. Каждый элемент violates соответствует одному нарушенному требованию.
Имеет атрибут qid. Если элемент violates не указан, ошибка в отчете отображена не будет.
-
qid – это user-visible-name(element) или qualifying-id(element) покрываемого элемента (подробнее см. выше, в описании элемента reqcoverage).
-
description - опциональный элемент, текстовое описание ошибки. Имеет опциональный атрибут format.
-
format - формат описания ошибки. Может быть "html" или "plain". В случае "plain" все html теги будут отображаться в виде текста.
-
описание_ошибки представляет собой описание ошибки, при этом для формата "html" допускается использование html тегов для форматирования текста.
Фрагмент требования (выделенный фрагмент документа, фрагмент, Location)
– это часть документа, которая была
отмечена пользователем как
принадлежащая какому-либо требованию. То есть фрагмент - это и выделенная часть текста документа,
и ссылка в свойствах требования на эту выделенную часть. Один фрагмент может принадлежать
одновременно нескольким разным требованиям
в одном проекте.
Ш
Шаблон узла
– это некоторая сущность, соответствующая одному из типов узлов
('Comment', 'Report Settings', 'Requirement', 'Test Purpose', 'Text Node', 'Virtual Node')
проекта 'Requality', которая служит шаблоном для создания новых узлов того же типа.
- Шаблон узла обладает такими же параметрами (см. 'Параметры шаблона узла'), как и обычный узел такого же типа.
- Параметры шаблона узла задает пользователь.
- При создании нового узла по шаблону созданный узел перенимает все параметры шаблона.
- Шаблонов узлов одного типа в проекта может быть несколько,
но активный шаблон - тот, по которому создаются узлы конкретного типа - только один.
- Пользователь может указать 'активный шаблон' для узлов каждого типа.
- По умолчанию активный шаблон пустой, то есть все параметры в нем имеют значения по умолчанию (cм. 'Редактор шаблонов').