– окно в перспективе Requality, редактор документов, используется для разметки фрагментов требований в документах.
– окно в перспективе Requality, визуальный редактор для представления требований и текстовых узлов в виде, близком к печатному документу. Предназначен для разработки документации путем создания требований. В отличие от редакторов 'UniEditor' и 'Review', в данном редакторе узлы отображаются без отступов, что позволяет более компактно отображать каталог требований, но не позволяет напрямую определить иерархию требований. Для анализа иерархии требований в данном представлении рекомендуется использовать дерево требований в окне 'Requality Explorer'.
– параметр, использующийся для обозначения идентификатора или имени некоторого узла дерева требований. Если у узла есть имя, то 'nameorid' — это имя узла, в противном случае 'nameorid' - это его идентификатор. Может использоваться, например, как параметр в описаниях требований. В этом случае его нужно записывать с символом подчеркивания в начале: '_nameorid'.
– окно в перспективе Requality, отображающее список фрагментов документа.
– окно в перспективе Requality,
отображает свойства выбранного объекта
(требования, документа, тестовой ситуации, отчета, комментария).
– cпециальный тип атрибутов узла дерева требований, позволяющий связывать узел, для которого он указан, с другим узлом из того же каталога проекта Requality. Этот атрибут находится в окне 'Properties' на вкладке 'Main' в таблице 'Attributes'. Это обычный атрибут, у которого указан тип 'REFERENCE', а в качестве значения указан целевой узел, на который идет ссылка.
Имя этого атрибута является именем ссылки.
Связанность узлов можно посмотреть в представлении 'Requality Links Explorer'. Ссылки в этом представлении доступны в обе стороны, как у узла, в котором была создана такая ссылка:
так и для узла, к которому она была привязана (на который она ссылается):
– окно в перспективе Requality, отображающее все содержимое проекта Requality (документы, требования, отчеты, комментарии).
– окно в перспективе Requality, в котором отображаются узлы каталога проекта Requality, связанные с выбранным узлом связью-ссылкой, указанной в атрибуте типа 'REFERENCE'. В этом окне можно просматривать вместе и по отдельности как исходящие,
так и входящие ссылки, сортировать их отображение по именам и включать подсветку связанных ссылкой узлов в окне
'Requality Explorer'.
– окно в перспективе Requality, визуальный редактор для требований, тестовых ситуаций, текстовых узлов и комментариев. Предназначен скорее для просмотра, нежели для редактирования, поэтому обладает ограниченной функциональностью. Позволяет только добавлять, редактировать и удалять комментарии, а также изменять статусы требований и тестовых ситуаций. В отличие от 'UniEditor' позволяет устанавливать статусы требований и тестовых ситуаций в значение 'verified'.
– окно в перспективе Requality, визуальный редактор для требований, тестовых ситуаций, текстовых узлов и комментариев. Позволяет добавлять, редактировать и изменять требования, тестовые ситуации и комментарии, а также изменять статусы требований и тестовых ситуаций. В отличие от редактора 'Review' не дает возможности устанавливать статусы требований и тестовых ситуаций в значение 'verified'.
– окно в перспективе Requality, используемое после автоматического переноса требований в новую версию документа для ручного уточнения корректности переноса требований и ручного переноса фрагментов требований в случае, если они не были перенесены автоматически. Отображает список всех требований и степень успешности их переноса:
- уникальный и неизменный внутрисистемный (в рамках Requality) идентификатор любого узла проекта Requality. Представляет собой 128-битный номер. При изменении идентификатора 'Id' узла его 'UUId' не меняется, хотя нужно иметь в виду, что Requality понимает такую операцию как удаление старого узла (со старым идентификатором 'Id') и появление нового (с новым идентификатором 'Id').
- cпециальное обозначение узла для его идентификации.
– это уникальный в рамках проекта идентификатор узла дерева требований. Является атрибутом узла дерева требований (требования, текстового узла, комментария и т.д.) и представляет собой число. В некоторых случаях это число может иметь определяемый пользователем префикс, но по умолчанию его нет. Имя атрибута, содержащего 'SeqID', может быть задано пользователем, по умолчанию это 'ForeignID'. Уникальность идентификатора заключается в том, что в проекте на протяжении всего его жизненного цикла только один узел дерева требований может иметь такой идентификатор, и, даже если данный узел будет удален, пока механизм включен никакой другой узел не получит такой же идентификатор. Чтобы механизм поддержки автогенерируемых идентификаторов в проекте Requality работал и их уникальность отслеживалась, он должен быть включен в настройках проекта (по умолчанию при создании нового проекта механизм не включен). В противном случае такие атрибуты считаются обычными рядовыми атрибутами узла, и уникальность их значений не соблюдается. При включении механизма автогенерируемых идентификаторов все узлы дерева требований, которые уже были в проекте, получают атрибут с указанным именем и уникальным значением. Если у каких-то узлов атрибут с таким именем уже был, он учитывается как 'SeqID', и его значение будет зарезервировано за данным узлом. Все новые узлы будут получать данный атрибут с автоматически задаваемым значением. После отключения механизма автогенерируемых идентификаторов, все эти атрибуты будут удалены.
- 'шаблон узла', который выбран в качестве активного для данного типа узлов. Если шаблон выбран в качестве активного, то при создании новых узлов данного типа все узлы будут создаваться по этому шаблону по умолчанию. Изначально для всех узлов проекта выбран пустой шаблон, где все параметры заданы по умолчанию. (Cм. Редактор шаблонов.) Для одного типа узлов активный шаблон может быть только один. Активный шаблон выделяется жирным шрифтом в списке шаблонов в окне редактора шаблонов.
– это элемент каталога проекта Requality, используемый для повторного использования (переиспользования) фрагментов каталога требований. Результатом использования виртуального узла является автоматически созданное поддерево узлов-клонов (см. Клон), повторяющих уже существующее поддерево каталога требований.
Процесс переиспользования осуществляется путем выбора метода итерации узлов-клонов с последующим указанием целевого элемента, для которого будет проводиться переиспользование (см. Параметры виртуального узла). Существует два возможных метода итерации:
Для метода итерации 'Reuse' также доступны настройки 'It.vars', связанные с определением количества копий. Эта настройка позволяет использовать списочные переменные для создания нескольких клонов одного узла с разными значениями переменной.
В дереве проекта виртуальный узел отображается как один из элементов дерева требований в виде потомка того элемента, для которого предполагается создать поддерево узлов-клонов.
Виртуальный узел может быть скрыт (может не отображаться) в дереве проекта. В скрытом режиме вместо виртуального узла отображаются его потомки-клоны.
– специальный механизм для автоматической генерации списка значений атрибута.
У всех типов узлов проекта Requality (кроме папок и документов) в окне 'Properties' во вкладке 'Main' находится таблица атрибутов (см. Таблица атрибутов). В этой таблице крайний справа столбец называется 'Generator'. При клике в ячейку этого столбца открывается окно генератора значений атрибута - 'Attribute value generator'.
Окно Attribute value generator содержит следующие параметры:
– это документ формата 'xhtml', содержащий требования, написанные в свободной форме.
Формируется на основе документа с требованиями, импортированного в проект Requality. В документе пользователь выделяет фрагменты текста
и присваивает их требованиям.
- узел-потомок виртуального узла, созданный на основе другого узла дерева требований (так называемого переиспользованного узла) в соответствии с настройками виртуального узла (см. Параметры виртуального узла). Клон по умолчанию получает тип и свойства от переиспользованного узла. Однако, они могут быть изменены пользователем. В окне 'Requality Explorer' пиктограмма узла-клона помечается дополнительным значком с буквой 'V'.
- некоторая сущность,
содержащая текстовый
комментарий, относящийся к требованию, текстовому узлу
или тестовой ситуации. У одного
требования/одного тестового узла/одной тестовой ситуации
может быть несколько комментариев.
– некоторая сущность, позволяющая
сгенерировать отчетный документ, содержащий сводную информацию по проекту (количество проверенных и непроверенных требований,
покрытие требований тестовыми ситуациями, покрытие документа требованиями и т.п.). Обладает набором параметров, которые
влияют на содержимое и вид отчета, а так же определяют источник информации для формирования отчета.
Основной параметр для генерации отчета — 'Шаблон отчета'.
На основе одного узла 'Настроек отчета' можно сгенерировать несколько отчетов.
Изменение 'Настроек отчета' не влияет на уже сгенерированные отчеты.
– это атрибуты, которые в соответствии с настройками проекта Requality автоматически указываются для уже существующих и для вновь создаваемых элементов дерева требований.
Для разных типов узлов обязательные атрибуты могут быть разные. Обязательными являются все системные атрибуты.
В соответствии с настройками обязательными атрибутами могут стать пользовательские атрибуты.
– некоторая сущность, представляющая собой готовый сгенерированный отчет. Отчет генерируется на основе настроек, указанных в узле 'Настройки отчета' (см. Настройки отчета (Report settings)), перегенерирован быть не может. Обладает нередактируемым набором параметров, позволяющих узнать, по каким настройкам был сгенерирован данный отчет. Изменить можно только имя отчета. По умолчанию имя отчета содержит информацию о дате и времени генерации.
Отчет может состоять из нескольких отчетов, если он сгенерирован для нескольких связанных ссылками проектов сразу. В таком случае в его верхней части будет располагаться строка с перечнем ссылок для этих проектов. При клике на такую ссылку в этом же окне будет открыт отчет для соответствующего проекта.
Каждый отчет в начале содержит сводную таблицу с краткой информацией о себе. Она включает такие данные, как дата и время генерации, версия инструмента на момент генерации отчета, имя инициатора генерации (как оно указано в настройках операционной системы), а также указание на репозиторий, если проект находится под версионным управлением.
- отчет о покрытии требований и тестовых ситуаций другими элементами (например, тестами), заданном с помощью дополнительного источника информации о покрытии. Таких источников может быть два:
– отчет о покрытии выделенных фрагментов документа другими элементами (например, тестами), заданный с помощью дополнительного источника информации о покрытии. Таких источников может быть два:
– отчет со ссылками между связанными узлами каталога проекта Requality.
Отчет состоит из двух страниц. Первая содержит информацию о прямых ссылках, вторая об обратных. По умолчанию открывается первая страница, для перехода на вторую следует нажать на ссылку с именем обратного отношения (задается в свойствах проекта). Для обратного перехода к первой странице следует нажать на имя отношения.
- отчет в виде таблицы, содержащей перечень узлов, в которых нарушены правила 'Checker rules', и информацию о том, какие именно правила нарушены в каждом таком узле.
– отчет со статистикой по разным ревизиям, загруженным в репозиторий.
Отчет состоит из двух страниц:
Для построения данного отчета можно установить настройки отчета (интересующий период времени и временной шаг между ревизиями), а также указать источник, откуда необходимо брать информацию о покрытии.
– свойства виртуального узла, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для виртуальных узлов окно 'Properties' содержит 4 вкладки:
– свойства узла Комментарий, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для Комментария окно 'Properties' содержит 3 вкладки:
– свойства узла 'Настройки отчета', которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для Настроек отчета окно 'Properties' содержит 3 вкладки:
ЭКСПЕРИМЕНТАЛЬНЫЕ
– параметры узла Настройки отчета, на основе которых отчет был сгенерирован. Указываются в окне 'Properties'.
Полностью идентичны параметрам узла Свойства отчета (за исключением атрибута 'date'), однако не могут быть отредактированы (за исключением параметра 'Id').
– свойства проекта Requality, задаются как параметры корневого узла проекта. Устанавливаются в окне 'Properties'.
Для проекта окно 'Properties' содержит 3 вкладки:
– свойства текстового узла, которые устанавливаются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для текстовых узлов окно 'Properties' содержит 5 вкладок:
– свойства тестовой ситуации, которые указываются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для тестовых ситуаций окно 'Properties' содержит 5 вкладок:
– свойства требования, которые устанавливаются в окне 'Properties'. (Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
Для требований окно 'Properties' содержит 5 вкладок:
– это свойства узла, набор атрибутов, которые характеризуют узел. Полный перечень параметров узла можно посмотреть и отредактировать в окне-представлении 'Properties' перспективы Requality. Сокращенный перечень параметров находится в специальном 'окне редактирования параметров', которое открывается при создании и редактировании узлов в редакторах 'Module Editor', 'UniEditor' и 'Review'. Некоторые атрибуты могут быть 'обязательными', они настраиваются в настройках проекта Requality. Атрибуты, которые указаны в таблице атрибутов, являются пользовательскими, т.к. их наличие определяется пользователем, в отличие от всех остальных — системных — атрибутов.
– свойства шаблона узла (см. Шаблон узла). Параметры шаблона узла определенного типа полностью аналогичны параметрам узла этого типа.
Устанавливаются в окне 'Properties'.
(Также могут быть в сокращенном виде просмотрены и отредактированы в 'окне редактирования параметров'.)
- любой узел дерева требований, указанный в качестве целевого узла для итерации в параметрах виртуального узла (см. 'Target' в разделе Параметры виртуального узла).
На основе этого узла создаются узлы-клоны (см. Клон) данного виртуального узла. На сам переиспользованный узел это никак не влияет. Изменения в переиспользуемом узле и его поддереве узлов влияют на узлы-клоны.
– это тип атрибута, определяющий список допустимых значений атрибута. Перечисляемый тип - 'Enum' - в Requality определяется пользователем в окне параметров проекта (см. Параметры проекта Requality) как обычный атрибут узла проекта:
– это требование, являющееся дочерним узлом другого 'требования' в иерархии проекта. Если родительское требование R содержит N подтребований RC_1, ..., RC_N, то считается, что
требования RC_1, ..., RC_N представляют собой декомпозицию требования R. Другими словами, целевая система удовлетворяет требованию R тогда и только тогда, когда она удовлетворяет
всем требованиям RC_1, ..., RC_N.
– путь к узлу, идентифицирующий этот узел. Содержит перечисление всех родительских узлов по порядку, начиная от корневого узла 'Requirements' и
заканчивая самим рассматриваемым узлом. В этом перечислении узлы указываются по их именам, в случае отсутствия имени — по идентификаторам. В качестве разделителя используется '/'.
– это параметры узла, которые настраиваются пользователем (в отличие от системных атрибутов): пользователь может создавать их, удалять, указывать для них тип данных. Пользовательские атрибуты задаются в таблице атрибутов
(см. Таблица атрибутов). Следует различать 'пользовательские атрибуты' и 'системные атрибуты'
(см. Системные атрибуты), а так же иметь в виду, что 'пользовательские атрибуты' могут стать 'обязательными атрибутами'
(см. Обязательные атрибуты).
– проект Eclipse, созданный
с помощью плагина Requality. Cодержит документы,
отчеты, требования и другие элементы.
- состояние проекта и всех его узлов, сохраненное в репозиторий.
– редактор значений атрибута типа 'LIST' (список). Если в окне 'Properties' узла есть атрибут типа 'LIST', то для задания и редактирования его значений используется 'Редактор значений списка'. Редактор открывается в специальном окне, которое содержит два следующих элемента:
– редактор шаблонов узлов (см. Шаблон узла). Позволяет создавать, удалять, редактировать шаблоны узлов и задавать активные шаблоны. Открывается из редакторов: 'Module Editor', 'UniEditor', 'Review'.
Содержит поля:
- это параметры узла проекта Requality, которые существуют для узлов по умолчанию, пользователь не может создать их, удалить или изменить их тип данных, но, как правильно,
может отредактировать значение. Иногда значение отредактировать тоже невозможно, например, некоторые системные атрибуты
отчета не редактируются, т.к. они содержат информацию о том, на основе
каких настроек этот отчет был сгенерирован. Системные атрибуты можно редактировать в 'Параметрах узла' (см. в качестве примера Параметры требования).
Следует различать 'системные атрибуты' и 'пользовательские атрибуты', а так же иметь в виду,
что бывают 'обязательные атрибуты'.
- это однонаправленная именованная связь между двумя узлами дерева требований проекта Requality. Ссылка исходит из ссылающегося узла и входит в целевой узел.
Она устанавливается в таблице атрибутов целевого узла как атрибут типа 'REFERENCE' и отображается для обоих узлов (ссылающегося и целевого) в окне 'Requality Links Explorer'
(для ссылающегося узла как исходящая ссылка, для целевого узла — как входящая). Имя этого атрибута является именем исходящей ссылки у ссылающегося узла и, если специально не установлено
в свойствах проекта иное, является именем входящей ссылки у целевого узла. При создании новой ссылки имя входящей ссылки у целевого узла совпадает с именем соответствующей исходящей ссылки
у ссылающегося узла. Однако, в проекте Requality существует несколько предустановленных имен ссылок, у которых различаются имя входящей и исходящей ссылки.
– это набор параметров - атрибутов - узла проекта Requality, которые характеризуют различные свойства этого узла.
Атрибуты представлены в виде таблицы с полями 'Name' (имя атрибута), 'Type' (тип), 'Value' (значение), 'Scope' (область видимости) и 'Generator' ('генератор значений атрибута').
ВНИМАНИЕ! Столбец 'SCOPE' отсутствует в таблице атрибутов проекта, т.к. по умолчанию область видимости таких атрибутов - все дерево проекта.
– это понятие в Requality, обозначающее наличие особой направленной связи 'Terms - Term referrers' типа 'один-ко-многим' между несколькими узлами, причем один из этих узлов считается местом определения термина, а все остальные - это места, где он используется. Эта связь задается не с помощью атрибута типа 'Reference', а с помощью специальных атрибутов с именами 'def-term' (в узле, где термин определен) и 'usedef' (в узлах, где термин используется). Имя термина уникально в рамках проекта.
– это некоторая сущность, содержащая описание тестового случая и ожидаемый результат. Принадлежит требованию, не имеющему требований-потомков. Тестовая ситуация обладает набором параметров, задающих ее содержимое и свойства. Для одного требования может быть задано несколько тестовых ситуаций.
– это сущность, содержащая некоторый текст. Предназначена для хранения и отображения примечаний и комментариев, входящих в состав документации. Такой текст может являться частью документации, не будучи при этом требованием.
– это сущность,содержащая описание некоторого требования и ссылающаяся на те фрагменты документа, которые соответствуют этому требованию.
– требование, на которое ссылается другое (уточняющее) требование.
– требование, которое ссылается на другое требование. У уточняющего
требования есть атрибут типа '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>
Здесь:
Квадратными скобками обозначены опциональные параметры.
– это часть документа, которая была
отмечена пользователем как
принадлежащая какому-либо требованию. То есть фрагмент - это и выделенная часть текста документа,
и ссылка в свойствах требования на эту выделенную часть. Один фрагмент может принадлежать
одновременно нескольким разным требованиям
в одном проекте.
– это уникальный числовой идентификатор узла в дереве требований, который задается в атрибуте 'ForeignID'. Его наличие пользователь обеспечивает самостоятельно.
– это основная настройка, определяющая содержимое и внешний вид отчета. Указывается в узле 'Настроек отчета'. Например, данные можно представить в виде списка или таблицы. Можно включить в отчет все узлы дерева 'Requirements' или только узлы некоторого конкретного типа. В Requality существует набор встроенных шаблонов отчета, которые доступны по умолчанию. В случае использования плагинов к Requality список доступных шаблонов может пополняться. Также можно добавлять и удалять свои шаблоны отчета. Сам по себе шаблон отчета описан в отдельном файле в файловой системе.
– это некоторая сущность, соответствующая одному из типов узлов ('Comment', 'Report Settings', 'Requirement', 'Test Purpose', 'Text Node', 'Virtual Node') проекта Requality, которая служит шаблоном для создания новых узлов того же типа.