Данный раздел посвящен вопросам интеграции ClearQuest с мощным инструментом по работе с требованиями Rational RequisitePro. Освещаются вопросы доведения как ClearQuest, так и RequisitePro, а также необходимые шаги по настройке проекта Rational Administrator, который объединяет все необходимые данные для интеграции этих двух продуктов.

Версии: ClearQuest - 2002.05.01, RequisitePro - 2002.05.01

• Требования к расширению схемы ClearQuest • Требования к настройке проектов RequisitePro • Порядок интеграции ClearQuest и RequisitePro

Требования к расширению схемы ClearQuest

Требования к схеме репозитория

Для возможности интеграции CQ и RP необходимо наличие в схеме следующих пакетов: Repository 3.0, RequisitePro 1.6, RequisitePro 1.6 upgrade. Установка пакетов производится из ClearQuest Designer мастером "Packages Wizard". Необходимо связать данные пакеты с тем типом записи, который предполагается к использованию совместно с RP.

Внимание! При установке пакетов возможны проблемы с русским названием типа записи, в случае с типом "Запрос" он был переименован в "Request" до установки пакетов, а после успешной установки - обратно переименован в "Запрос". Однако, будьте внимательны со скриптами устанавливаемых пакетов.

Пояснение к новым элементам схемы

После успешной установки схемы, она дополнится новыми типами записей, необходимых для интеграции CQ и RP

RAProject (проект Rational Administrator) Запись данного типа создается автоматически утилитой Rational Administrator (RA), при создании нового RA-проекта, суть которого - связать проекты RequisitePro и ClearQuest. Записи этого типа содержат информацию о RA-проекте и его расположении. RequirementMap (мэппинг типа записи на тип требования) Отображение метаданных некоторого типа требования на метаданные запроса. Данные записи содержат информацию необходимую для сопоставления атрибута некоторого типа требования (например, Запрос) с полями типа записи "Запрос": в каком поле хранится список ссылок на требования, в каком поле хранится название RA-проекта и т.п. Requirement (связь требования RP с записью CQ, например, некоторого Запроса) Осуществляет связь Запроса в CQ с некоторым требованием в RP, суть данной записи хранить расширенную информацию об этой связи: название требования и его описание. Данные записи создаются автоматически при сопоставлении требованию запросов в среде RP. Повлияет ли создание записи этого типа непосредственно в CQ на связь требования с запросами, пока неизвестно.

Внимание! Ручное создание записи типа Requirement недопустимо, данную операцию необходимо проводить при помощи утилиты ASCQISetup.exe (см. Порядок интеграции ClearQuest и RequisitePro).

Доработки пользовательского интерфейса схемы

Установка пакета RequisitePro 1.6 влечет за собой некоторые изменения в пользовательском интерфейсе: добавление поля RAProject на главную закладку (проверить этот факт и, в случае отсутствия поля, добавить его вручную), добавление закладки Requirements. Добавлять связанные с Запросом требования можно лишь в том случае, если поле RAProject уже содержит ссылку на запись RAProject. В связи с тем, что, как правило, отношение между RAProject и проектом Запроса один к одному, то можно доработать сценарий выбора проекта Запроса и в нем автоматически заполнять поле RAProject. Предварительно необходимо доработать форму Проекта: добавить поле RAProject.

Требования к настройке проектов RequisitePro

Метаописание проекта

Как известно, RequisitePro позволяет пользователю дорабатывать для собственных нужд метаописания проектов RP, например, добавить новые атрибуты некоторому типу требования. Таким образом осуществляется расширение информационной нагрузки на требования. Механизм интеграции с CQ ведется по тому же принципу. Итак, необходимо добавить новый атрибут, например, под названием Запрос (название может быть любым) некоторому типу требования, например, "Требование к ПО", а в качестве типа нового атрибута указать ClearQuest.

Внимание! Название проекта должно в точности совпадать с именем файла проекта, иначе интеграция с ClearQuest будет невозможной.

Мэппинг атрибутов

Для того, чтобы RP смог сохранить связь между требованием и записями CQ, например, запросами, необходимо описать мэппинг атрибутов требования на поля запроса (см. описание типа RequirementMap в Требования к схеме ClearQuest), информация о мэппинге хранится в CQ. Данная операция является очень ответственной, так как неверное задание мэппинга не позволит использовать интеграцию CQ и RP. Далее приводится пример конфигурационного файла для создания мэппинга (важно: мэппинг создается между одним типом требования RP и типом записи CQ). Утилита "ASCQISetup.exe", сохраняющая данные мэппинга, располагается в "\Program Files\Rational\common\".

==================== ASCQISetup.bat ====================== REM Имя базы ClearQuest, в нашем случае NPPM. set CQDatabaseName=NPPM REM Диск где установлены продукты Rational (локально). REM Для стандарта рабочего места это диск E: set H=E: REM Логин администратора для базы RequisitePro. set U=Bulantsev REM Путь к локально установленным продуктам Rational. set P=\Program Files\Rational\ REM Имя проекта RequisitePro. В нашем случае "DDMTS". set RP="DDMTS" REM Полный путь к файлу проекта RequisitePro. set RQS="\\srvx.icc.mpei.local\Requisite\DDMTS\DDMTS.rqs" REM Путь к файлу помощи, для стандарта рабочего места set Help="E:\Program Files\Rational\RequisitePro\help\cqi.hlp" REM Настройку оставшейся части скрипта следует проводить совместно REM с администратором CQ. Замечание! Типы полей указанные в CQ русским, REM следует заносить с помощью FAR, выбрав в качестве кодировки DOS. REM Использование блокнота невозможно. %H% cd %P%\common REM Создаем ассоциацию между типом требования и типом записи. ASCQISetup.exe -c %U% %CQDatabaseName% <Тип записи CQ [Запрос]*> Requirements_List Defects_list RAProject <Название действия для изменения запроса [Изменить]*> "Сопоставление запросов" %Help% 1 %RP% %RQS% <название типа требования RP [RQP]*> <название атрибута типа требования RP [Запрос]> 2 * - в квадратных скобках указаны примеры названий, которые были использования для проекта NPPM

Данный .bat-файл, с необходимыми заменами, запускается администратором RequisitePro на своей машине по требованию координаторов проекта RP.

Порядок интеграции ClearQuest и RequisitePro

Необходимо создать проект в терминах Rational Administrator, поставляемого с Rational RequisitePro, который свяжет информацию о проектах RequisitePro и ClearQuest. В Rational Administrator выбрать File -> New Project… Project name - имя проекта Rational Administrator, только латиницей и желательно одним словом. Project location - место расположения проекта Rational Administrator. Т.к. проект Rational Administrator должен быть доступен всем пользователям сети, создавать его следует в разделяемой директории (например, \\ijnl.icc.mpei.local\Requisite\RationalAdmin), создавая для каждого нового проекта отдельную папку Указать интегрируемые базы данных RP и CQ (пользовательская база данных) Внимание! Название проекта должно в точности совпадать с именем файла проекта, иначе интеграция с ClearQuest будет невозможной. В ClearQuest необходимо установить дополнительные пакеты, в частности, для проекта NPPM потребовалась установка пакетов Repositore 3.0, RequsitePro 1.6, RequsitePro 1.6 upgrade. Доработать карту атрибутов(ClearQuest) необходимых к интеграции типов требований, например, добавить атрибут "Запрос" типу требования "Требование к ПО". Имя атрибута может быть произвольным. Запустить правильно настроенный файл ASCQISetup.bat находящийся в E:\Program Files\Rational\common, который свяжет метаданные об атрибутах CQ и RP. Внимание! Настройка этого файла является довольно ответственным занятием, так как все задаваемые атрибуты имеют существенное значение. Его настройка должна осуществляться совместно как администратором RequisitePro, так и администратором ClearQuest. Имя проекта(поле Name) RequisitePro должно быть латинским, и желательно в одно слово. Т.е. существующий проект RequisitePro "DDMTS - определение потребности в МТР" пришлось переименовать в "DDMTS" Вероятно существует зависимость и от именования файла проекта, по этому желательно совпадение имени файла проекта и имени проекта. Проект в RP необходимо открывать используя полный путь (\\ijnl.icc.mpei.local\ddmts\ddmts.rgs), а не как стоит по умолчанию (\\ijnl\requisite\ddmts\ddmts.rgs). Существуют некоторые ограничения об отношениях между проектами, то есть проект RequisitePro может быть ассоциирован только с одним проектом ClearQuest, но пока неизвестно, может ли проект ClearQuest ассоциироваться с несколькими проектами RequisitePro.