Requality: основная информация

Назначение инструмента

Requality - это инструмент для работы с требованиями, в первую очередь к программным системам. Он позволяет:

Возможна совместная работа над документами и требованиями при их хранении с использованием любой системы управления версиями, например, Git.

Инструмент реализован как плагин на платформе Eclipse и может быть использован как в средах разработки на основе этой платформы, так и независимо.

Информация о разработчике

Домашняя страница проекта

Отдел Технологии программирования, Институт системного программирования им. В.П. Иванникова РАН

Почта для связи: requality@ispras.ru

Инструкция по установке Requality

Системные требования

Операционная система Windows или Linux. Поддерживаются архитектуры x86 и x86-64.

Для Windows должны быть установлены:


Зависимости для Windows
Зависимость Рекомендуемая версия x86, x86-64
OpenJDK8 HotSpot 8.0 x86


Для Linux должны быть установлены OpenJDK и libxt6. Указанные далее зависимости являются требованиями для Ubuntu 14 x86, x86-64. Для других систем Linux могут потребоваться дополнительные пакеты.


Зависимости для Linux
Зависимость Рекомендуемая версия x86, x86-64 Название пакета
OpenJDK 8.0 i386 openjdk-8-jre:i386
libxt6(только 64) libxt6:i386

Пакеты могут быть установлены с помощью команды "apt-get install <package_name>" в консоли для Debian-подобных систем.

Установка Requality

Requality может быть установлена с помощью bundle. Для 64-битных систем требуется использовать 32-битную версию Java и всех требуемых библиотек.

Ссылки на bundle можно посмотреть здесь.

После окончания загрузки требуется распаковать архив в любое удобное место на диске. После распаковки Requality будет доступна для работы.

Внимание! Нужно иметь в виду, что для 64-битных систем может потребоваться указать путь к 32-битной версии Java в файле 'requality.ini'. Путь должен быть указан перед строкой "-vmargs" в виде текста:

"-vm
<путь-к-32битной-java>"


Например, <путь-к-32битной-java> может выглядеть так:



Плагины к Requality

Для Requality разработан ряд плагинов, предоставляющих дополнительные возможности. Плагины могут быть установлены в Eclipse, где находится Requality, с помощью update-site. Далее описан процесс установки плагинов и перечень доступных плагинов с описанием их возможностей и указание адресов update-site.

Установка плагина через update-site

Для такой установки плагина нужно знать адрес update-site. Далее в перечне плагинов для каждого плагина указан его update-site.

Процесс установки плагина:

  1. В Eclipse в главном меню откройте раздел 'Help -> Install New Software...'.
    Пункт главного меню 'Install New Software'
  2. В открывшемся окне 'Install' нажмите кнопку 'Add...'.
    Окно 'Add Repository' для указания адреса update-site
  3. В новом открывшемся окне 'Add Repository' в поле 'Location' введите адрес update-site. В поле 'Name' вы можете указать произвольное, понятное вам название для обозначения плагина. Под таким именем этот плагин будет фигурировать в общем списке установленных в ваш Eclipse плагинов. Нажмите 'OK'.
  4. В окне 'Install' плагин отобразится в списке доступных. На одном update-site может быть несколько плагинов, кроме того они могут быть сгруппированы в несколько групп. Вы можете развернуть группу, чтобы посмотреть, какие плагины в ней находятся. Для отображения списка плагинов без сортировки по группам нужно снять галочку 'Group items by category'. Если плагин уже установлен, пиктограмма перед его названием будет серой. Чтобы отображались только неустановленные плагины, нужно поставить галочку 'Hide items that are already installed'. На update-site может содержаться несколько версий одного плагина (актуальная и более старые), для отображения только актуальной, самой последней версии нужно поставить галочку 'Show only the latest version of availabe software'.
    Окно установки плагинов через update-site
  5. Выберите нужный плагин в списке (отметьте галочкой), нажмите кнопку 'Next >' и следуйте дальше инструкциям диалога.
  6. В процессе установки плагина появится окно 'Security Warning', сообщающее об установке неподписанного контента. В нем нужно нажать 'ОК'.
    Предупреждение о неподписанном контенте
  7. После окончания установки нужно будет перезапустить Eclipse.

Более подробно об установке плагинов можно прочитать здесь.

Обратите внимание, что ссылки в следующих подразделах предназначены только для использования в Eclipse для установки плагинов.

Requality Coverage Tools

Requality Coverage Tools требуется для создания различных отчетов о покрытии (см. Отчет 'Анализ покрытия требований', Отчет 'Анализ покрытия выделенных требований', Отчет 'Прогресс по проекту').

Update-site для установки плагина Requality Coverage Tools: https://forge.ispras.ru/repo/requality/site

Requality GIT Connector

Requality GIT Connector требуется для работы с GIT через внутренний интерфейс Requality для GIT. Также этот плагин нужен, например, при создании отчетов по шаблону 'Прогресс по проекту' (см. Отчет 'Прогресс по проекту'), если для использовании управления версиями используется GIT.

Update-site для установки плагина Requality GIT Connector: https://forge.ispras.ru/repo/requality/site

Requality API provider

Requality API provider требуется для обеспечения взаимодействия Requality с LibreOffice Writer (см. Работа с плагином LORequality и Перенос требований из документа LibreOffice в Requality).

Update-site для установки плагина Requality API provider: https://forge.ispras.ru/repo/requality/site


Плагин к LibreOffice: LORequality

LORequality требуется для работы с проектами Requality в LibreOffice Writer и для обеспечения переноса проектов между этими инструментами (см. Работа с LibreOffice). Плагин LORequality устанавливается в LibreOffice. Версия Eclipse, где установлен Requality, должна быть не старше 4.6 (Neon). Также на машине должен быть установлен LibreOffice 5.3.

Для установки требуется выполнить следующие шаги:

  1. Скачать плагин LORequality_0.21.9.oxt по адресу: https://forge.ispras.ru/projects/reqdb/files

  2. Запустить LibreOffice.

    1. В главном меню открыть Сервис -> Управление расширениями...

      Окно 'Управление расширениями' в LibreOffice

    2. В окне 'Управление расширениями' нажать кнопку 'Добавить' и в открывшемся окне выбрать в файловой системе скачанный oxt-файл. Дождаться окончания установки плагина. Его название появится в списке установленных плагинов в окне 'Управление расширениями'.

    3. Если ранее уже была установлена более старая версия плагина LORequality, нужно выбрать ее в списке установленных плагинов, нажать кнопку 'Удалить' и дождаться завершения процесса удаления.

    4. Закрыть окно 'Управление расширениями'.

  3. Запустить LibreOffice Writer.

    В окне LibreOffice Writer в главном меню теперь есть пункт 'Requality', а также в окне появилась дополнительная панель для работы с плагином LORequality. Для удобства использования эту панель можно перетащить на основную панель инструментов.

    Панель для работы с плагином LORequality в LibreOffice Writer
  4. Кроме того на стороне Requality требуется в настройках указать путь к LibreOffice. Для этого нужно в главном окне открыть меню 'Window → Preferences', в открывшемся диалоговом окне слева выбрать пункт 'Requality', справа в поле 'Path to libreoffice(v5+) soffice' с помощью кнопки 'Select' указать путь к запускаемому файлу LibreOffice. Далее сохранить настройки, нажав 'Apply' и 'OK'.


Перспектива Requality

Чтобы открыть перспективу Requality, выберите в главном меню 'Window -> Open Perspective -> Other...'. В появившемся диалоговом окне выберите 'Requality' (как показано на рисунке ниже) и нажмите кнопку 'OK'.
Окно для выбора перспективы Requality

Если вы начнете работу с создания проекта Requality, переключение на перспективу 'Requality' произойдет автоматически.

В перспективе 'Requality' по умолчанию открыты следующие отображения:

  1. Requality Explorer – содержит дерево документов, дерево требований с тестовыми ситуациями и комментариями и дерево отчетов проекта. 'Requality Explorer' аналогичен 'Package Explorer', но раскрыть в нем вы можете только проекты формата Requality. Проект Requality содержит следующие компоненты: Структура проекта Requality
  2. Properties – окно, в котором отображаются свойства требований, тестовых ситуаций, отчетов, документов. Содержимое окна 'Properties' разбито на несколько вкладок. Для различных объектов набор и содержимое вкладок отличаются. Обратите внимание, вы можете открыть несколько окон 'Properties'. Для этого выберите в меню окна 'New Properties View'. Чтобы зафиксировать в окне Properties свойства какого-либо конкретного объекта, нажмите кнопку закрепления окна или выберите в меню окна 'Pin to Selection'. Теперь в этом окне содержимое не будет меняться, даже если вы будете переключаться между другими объектами.
  3. Outline – отображает список отмеченных фрагментов требований. Причем отображаются фрагменты только того документа, который в данный момент открыт в 'Markup Editor' и находится в фокусе. В остальное время окно пусто.
  4. Requality Links Explorer — окно, в котором отображаются ссылки между узлами. Если в 'Requality Explorer' выбрать один из узлов дерева требований, то в 'Requality Links Explorer' отобразятся узлы, которые связаны с выбранным узлом различными видами ссылочных связей.
  5. Кроме того, в центре перспективы расположено большое, по умолчанию пустое окно, в котором будут открываться сгенерированные отчеты и различные редакторы. Например, редактор документов 'Requality Markup Editor', в нем открываются импортированные документы с требованиями, здесь же они размечаются на фрагменты для требований. Или 'UniEditor' – редактор, предоставляющий возможность удобного манипулирования и редактирования требований, тестовых ситуаций и комментариев. И другие редакторы.


Requality perspective