12.4 Заключение

В данной главе были описаны основные типы документации, и как RequisitePro используется для их создания:

• Для внутренней документации - используется наиболее часто.

• Для технической документации - используется иногда.

• Для пользовательской документации – используется изредка.

• Для маркетинговых материалов – используется очень редко.

Были приведены документы и шаблоны, доступные в RequisitePro.

Также были описаны шаги по созданию документов:

• Создание нового типа документа, если шаблон не существует.

• Добавление нового типа документа из доступных шаблонов в проект.

• Создание документа из типа документа, который уже присутствует в проекте.

Вы можете импортировать документ извне RequisitePro, но в этом случае шаблон документа должен быть определен перед импортом.

В заключение данной главы были рассмотрены два метода генерации предустановленных шаблонов SoDA:

• Генерация отчета из RequisitePro.

• Генерация отчета из SoDA.

Эта глава завершает главную часть данной книги. В вышеприведенных главах было рассмотрено, каким образом осуществляется прохождение по пирамиде требований. В главах с 5 по 12 было рассмотрено следующее:

• Создание сценариев использования (use cases) и дополнительных требований.

• Генерация тестовых сценариев (test cases).

• Проектирование Системы.

• Генерация документации.

В конце этой главы было описано, каким образом RequisitePro может содействовать в решении всех этих задач.

Следующая глава сосредоточена на некоторых особенностях RequisitePro, которые еще не были обсуждены.

Ссылки

[WIK06] See http://en.wikipedia.org/wiki/Software_documentation.

[IBM01] Using Rational SoDA for Word, Version 2001A.04.00, IBM Corporation, 2001.

Часть 3

Другие Темы

13. Управление Проектами

13. Управление Требованиями в RUP (Rational Unified Process)

Глава 13

Управление

Проектами

Данная глава охватывает различные задачи, относящиеся к управлению проектами RequisitePro:

• Распечатка сводки по проекту.

• Архивация и восстановление проектов.

• Перемещение и копирование проектов.

• Настройка и использование трассировки между проектами.

Также рассматриваются типы файлов RequisitePro.

13.1 Распечатка Сводки по Проекту

Наиболее быстрый способ получить отчет с основной информацией о проекте – это распечатать сводку по проекту, выполняя следующие действия:

1. Выберите File>Project Administration>Print Summary (Файл>Администрирование Проекта>Печать Сводки).

2. Выберите принтер в диалоговом окне Print (Печать).

Распечатанный отчет содержит следующее:

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

• Все требования и их атрибуты.

• Типы документов с главной информацией, например имя файла и краткое описание.

• Документы с главной информацией, например каталог, тип документа и данные о времени создания текущей версии.

Рисунок 13.1. показывает первую страницу отчета.

Рисунок 13.1. Сводка по проекту.

13.2 Типы Файлов RequisitePro

Рисунок 13.2. показывает некоторые файлы, обычно хранящиеся в каталоге C:\Program Files\Rational\RequisitePro\Projects\project name:

• .rqs – файл, содержащий информацию о проекте.

• .rql – файл, содержащий информацию о базе данных.

• .mdb – файл с базой данных проекта (если вы используете Microsoft Access).

• Файлы документов, у которых расширение зависит от типа документа, например .vis для Vision и .ucs для Use cases.

• .bak – файлы, содержащие резервные копии предыдущих версий документов.

Некоторые файлы из каталога C:\Program Files\Rational\RequisitePro\outlines:

• .def – файлы, содержащие описания шаблонов для всех типов документов.

• .dot – файлы, содержащие шаблоны для всех типов документов.

Файлы .def и .dot были рассмотрены в Главе 9 «Создание Тестовых Сценариев (Test Cases) из Сценариев Использования (Use Cases)» в пункте 9.3.

Рисунок 13.2. Файлы проекта.

Так как файлы документов могут иметь различные расширения, чаще назначаемые в процессе настройки проекта, эти расширения могут случайно перекрываться с расширениями, используемыми в других приложениях. В таком случае Windows Explorer может неверно истолковать название файла и назначить файлу неверную иконку. Например, расширение .rmp, используемое для Плана Управления Требованиями (Requirements Management Plan), также используется для RealJukebox Metadata Packages. В данном случае это не является проблемой. Просто не обращайте внимания на иконку. RequisitePro распознает данный файл.

У каждого типа документа есть свое расширение файла. Вы можете выбрать и настроить нужное Вам расширение. Хорошей практикой считается назначать расширения, несущие смысловую нагрузку (например .vis для Vision), т.к. в каталоге Вы сможете легко распознать файлы, принадлежащие определенному типу. Не используйте такие расширения, как .doc или .txt, т.к. эти расширения могут быть случайно открыты с помощью Microsoft Word или Notepad, а Вы не можете обновлять эти файлы вне среды RequisitePro.

Пример .rqs – файла:

[Project]

Owner=Peter Z

Name=Online Travel Agency

GUID={CD8E4430-4506-4173-9D06-6245DC2AFD6A}

Description=Project creates an online travel agency system.

Owner Key=2

Revision number=1.0010

Prefix=

NbrRequirements=140

Directory=C:\Program Files\Rational\RequisitePro\Projects

\Online Travel Agency\Online Travel Agency.rqs

Key=1

[Application]

Data file version=1.0040

Program Version=8.23.0068.1

Пример .rql – файла:

[ODBC]

DRIVER=Microsoft Access Driver (*.mdb)

[DBMaint]

CompactDate=2005-07-21 21:42:49

CompactBaselineSize=1495040

CompactPreviousSize=1540096

CompactThresholdSize=10

13.3 Архивация Проектов

Целью архивации является создание копии текущего состояния файлов проекта, чтобы в дальнейшем Вы могли восстановить их. Вы можете архивировать, используя как команду RequisitePro Archive (Архивация), так и команду ClearCase Archive. Данный пункт демонстрирует первый вариант.

Для архивации проекта выполните следующие действия:

1. Выберите File>Project Administration>Archive>RequisitePro Archive (Файл> Администрирование Проекта>Архивация>Архив RequisitePro).

2. В диалоговом окне Archive Project (Архивация Проекта), как показано на Рисунке 13.3, выберите каталог.

Рисунок 13.3. Диалоговое окно Archive Project (Архивация Проекта).

3. Если необходимо, введите номер версии, наименование версии и описание изменений.

4. Если Вы хотите применить название версии ко всем документам, выберите галочку Propagate to all documents (Распространить на все документы).

5. Нажмите кнопку ОК.

6. Если Вы получили сообщение то том, что каталог проекта не существует и Вам предлагается создать его, нажмите (Yes) Да для создания каталога.

Проектные файлы (.rql, .rqs) и документы копируются в архивный каталог. Для проектов, используемых базу данных Microsoft Access, также копируется файл .mdb с базой данных, а база данных обновляется в соответствии с новым местонахождением документов. Для проектов, используемых базу данных enterprise, файл базы данных не копируется автоматически, поэтому нужны некие дополнительные действия, такие как создание файла с помощью логического экспорта или с использованием Data Transport Wizard. (См. Руководство Пользователя Rational RequisitePro – Rational RequisitePro User’s Guide[IBM03d]).

Для восстановления проекта из архива выполните следующие действия:

1. Выберите File>Open (Файл>Открыть).

2. В диалоговом окне Open Project (Открыть Проект) нажмите кнопку Add (Добавить).

3. Выберите файл RQS, содержащий заархивированный проект. Проект добавляется в список существующих проектов.

4. Двойным щелчком мышки нажмите на названии проекта, либо выберите проект и нажмите кнопку ОК.

13.4 Перемещение и Копирование Проектов

Вы не можете копировать или перемещать проекты простым копированием проектных каталогов. Для копирования проекта в новый каталог выполните следующие действия:

1. Скопируйте проектные файлы (.rqs и .rql) в новый каталог (используя Windows Explorer).

2. Скопируйте все файлы документов в новый каталог.

3. Если проект использует базу данных Microsoft Access, также скопируйте файл .mdb.

4. Выберите File>Open Project (Файл>Открыть Проект).

5. Нажмите кнопку Add (Добавить).

6. Выберите проект в новом каталоге для добавления его в список проектов.

7. Если Вам больше не нужен проект в прежнем каталоге, выберите его и нажмите кнопку Remove (Удалить).

13.5 Трассировка Между Проектами

Трассировка (связь) между проектами позволяет Вам отслеживать требования между различными проектами. Она используется, если набор требований является общим для многих проектов, например некие главные требования, которым следуют все проекты в организации.

Для осуществления трассировки между проектами выполните следующие действия:

1. Назначьте префикс всем проектам, участвующим в трассировке.

2. Отметьте типы требований, которые будут доступны для трассировки.

3. Соедините проекты.

Создадим проект Global, который содержит общие для нескольких других проектов требования.

Чтобы назначить префикс проекту выполните следующие действия:

1. Откройте проект.

2. Выберите проект в Explorer (Проводнике).

3. Откройте диалоговое окно Project Properties (Свойства Проекта), выбрав File>Properties (Файл>Свойства).

4. На закладке General (Основное), как показано на Рисунке 13.4, заполните поле Prefix (Префикс).

Рисунок 13.4. Диалоговое окно Project Properties (Свойства Проекта) для проекта Global.

5. Нажмите кнопку ОК.

Чтобы отметить типы требований, доступных для трассировки, выполните следующие действия:

1. В диалоговом окне Project Properties (Свойства Проекта) выберите закладу Requirement Types (Типы Требований).

2. Двойным щелчком мышки на типе требований откройте диалоговое окно Requirement Type (Тип Требований), либо выберите тип требований и нажмите на кнопку Edit (Редактировать).

3. Выберите галочку Allow External Traceability (Разрешить Внешнюю Трассировку), как показано на Рисунке 13.5.

4. Нажмите ОК.

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

Рисунок 13.5. Разрешение внешней трассировки в диалоговом окне Requirement Type (Тип Требований).

Чтобы соединить проекты выполните следующие действия:

1. Выберите File>Project Administration>External Projects (Файл>Администрирование Проекта>Внешние Проекты).

2. Нажмите на кнопку Add (Добавить).

3. Выберите путь к файлу RQS. Проект появится в списке, как показано на Рисунке 13.6.

Рисунок 13.6. Добавление проекта в список внешних проектов.

После того как Вы выполнили эти действия, требования из внешних проектов будут доступны в процессе трассировки. Они отображаются с определенными префиксами, как это показано на Рисунке 13.7.

Рисунок 13.7. Требования проекта Global доступны для настройки трассировки.