Полезные сценарии (скрипты), расширяющие функциональные возможности IBM Rational RequisitePro

Источник: IBM Rational

Импортируем документы

Данный инструмент был разработан для решения проблем, которые возникали, если клиенту нужно было перенести в ReqPro требования, хранившихся в большом количестве документов. Текущая версия ReqPro позволяет импортировать за один прием только один документ; в результате импорт большого количества документов становится очень утомительной работой и отнимает много времени. Предлагаемый инструмент не только автоматизирует одновременный импорт нескольких документов, но и помогает распределить их по разным пакетам.

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

  1. Установите в систему перечисленные ниже файлы. Эти файлы можно извлечь из прилагаемого zip-файла в папку RequisitePro\Bin (в которую установлен ReqPro):
    • MassDocumentImport.exe
    • MassDocumentImport.mnu
  2. Запустите RequisitePro.
  3. Из меню выберите команды Tools > Add-ins.
  4. Нажмите кнопку Add.
  5. В поле Name введите Mass Document Import.
  6. Нажав кнопку Browse, укажите путь к файлу MassDocumentImport.mnu - ...\RequisitePro\Bin\MassDocumentImport.mnu.
  7. Для остальных параметров оставьте значения по умолчанию и нажмите кнопку OK.

Подключаемый модуль Mass Document Import установлен, и мы можем испытать его через меню Requirement инструмента ReqPro. В меню должна появиться команда Mass Document Import.

Инструкции по удалению подключаемого модуля

  1. Откройте ReqPro.
  2. Выберите из меню команды Tools > Add-ins.
  3. Выделите подключаемый модуль Mass Document Import.
  4. Нажмите кнопку Remove.
  5. Удалите файлы MassDocumentImport.exe и MassDocumentImport.mnu из установочной папки.

Активация ведения журнала трассировок

Можно активировать функцию ведения журнала трассировок, который можно будет изучить в случае возникновения каких-либо проблем с инструментом. После активации данной функции в папке BIN установочного каталога ReqPro будет сгенерирован файл MassDocumentImportError.Log. Этот файл может понадобиться вам при возникновении любых проблем с подключаемым модулем (в разделе Ресурсы в конце статьи вы найдете информацию о том, где можно найти справочные материалы по работе с этим сценарием).

Примечание: При включении функции ведения журналов работа подключаемого модуля может замедлиться.

Для активации функции ведения журналов после установки подключаемого модуля выполните следующие шаги:

  1. Выберите из меню команды Tools > Add-ins.
  2. Выделите подключаемый модуль Mass Document Import.
  3. Нажмите кнопку Edit.
  4. Нажмите кнопку Edit в следующем открывшемся диалоговом окне "Add-in". После этого файл MassDocumentImport.mnu откроется в Блокноте (Notepad) Windows.
  5. Измените строку Exec MassDocumentImport.exe на Exec MassDocumentImport.exe -log.
  6. Сохраните изменения в файле и закройте его.
  7. Нажмите кнопку Cancel в обоих диалоговых окнах Add-in.

Чтобы получить детализированные журналы, повторите перечисленные выше шаги, изменив строку Exec MassDocumentImport.exe -log на Exec MassDocumentImport.exe -log -verbose.

Чтобы отключить ведение журналов, снова измените строку на Exec MassDocumentImport.exe.

Как использовать подключаемый модуль

Добавление в список импорта одного документа

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

  1. Запустите подключаемый модуль, выбрав из меню команды Requirement > Mass Document Import.
  2. Выберите из раскрывающегося списка тип документа.
  3. Добавьте документ при помощи кнопки Add File или команды меню Add File.

Документ будет добавлен в список.

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

Чтобы добавить все документы из какого-либо каталога в список импорта, выполните следующие шаги:

  1. Запустите подключаемый модуль, выбрав из меню команды Requirement > Mass Document Import.
  2. Выберите из раскрывающегося списка тип документа.
  3. Добавьте нужный каталог при помощи кнопки Add Directory или команды меню Add Directory.

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

Выбор пакета для документа

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

  1. Выделите имя документа в списке.
  2. Дважды щелкните левой кнопкой мыши на имени документа.
  3. Выделите нужный пакет в панели обозревателя пакетов Package Browser.
  4. Имя выделенного пакета будет отображаться напротив данного документа.

Документ будет импортирован в выбранный пакет.

Выбор пакета для нескольких документов

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

  1. Выделите в списке несколько документов при помощи клавиатурной комбинации Shift - нажатие левой кнопки мыши или Control- нажатие левой кнопки мыши..
  2. Выберите команды File > Assign Package.
  3. Выделите нужный пакет в панели обозревателя пакетов Package Browser.

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

Импортируем документы

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

Удаление выбранных документов из списка импорта

  1. Выделите в списке один или более документов.
  2. Выберите из меню команды File > Remove.

Выделенные документы будут удалены из списка.

Удаление всех документов из списка импорта

Примечание: Эту функцию следует использовать с осторожностью.

  1. Выберите из меню команды File > Remove All.

Из списка импорта будут удалены все документы..

Важно: Документ остается в той же папке, но расширение файла документа изменяется в соответствии с выбранным вами типом документа.

Добавление гиперссылок на документы, содержащие требования

Данная утилита позволяет пользователю добавлять гиперссылки на любой документ, содержащий требования, для этого в меню Requirement имеется две команды.

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

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

Ниже перечислены установочные файлы:

  1. AddRequirementHyperlink.exe
  2. RefreshRequirementHyperlinks.exe
  3. RequirementHyperlinks.mnu
  4. RequirementHyperlink.ini

Эти файлы можно извлечь из прилагаемого zip-файла в папку: RequisitePro\Bin (установочный каталог ReqPro)..

  1. Запустите ReqPro.
  2. Выберите из меню команды Tools > Add-ins.
  3. Нажмите кнопку Add.
  4. Введите имя Requirement Links в поле Name.
  5. Нажав кнопку Browse, укажите путь к файлу RequirementHyperlinks.mnu - ...\RequisitePro\Bin\RequirementHyperlinks.mnu.
  6. Для остальных параметров оставьте значения по умолчанию и нажмите кнопку OK.

Подключаемый модуль Requirement Links установлен, и мы можем испытать его через меню Requirement инструмента ReqPro. Теперь в нем должна появиться команда Requirement Links. Эта команда меню имеет две вложенные команды:

  • Add Requirement Hyperlink
  • Refresh Requirement Hyperlinks

Инструкции по удалению подключаемого модуля

  1. Откройте ReqPro.
  2. Выберите из меню команды Tools > Add-ins.
  3. Выделите подключаемый модуль Requirement Hyperlinks.
  4. Нажмите кнопку Remove.
  5. После этого удалите из папки RequisitePro\Bin следующие файлы:
    • AddRequirementHyperlink.exe
    • RefreshRequirementHyperlinks.exe
    • RequirementHyperlinks.mnu
    • RequirementHyperlink.ini

Как использовать подключаемый модуль

Adding requirement hyperlinks

Эту команду можно использовать для создания гиперссылок на существующие требования. Форматом гиперссылки можно управлять при помощи файла RequirementHyperlink.ini.

Данный файл управляет тем, как создаются требования. В нем можно задать текст (формат) гиперссылки и текст подсказки. В этом файле по умолчанию имеется раздел [RequisitePro]. Если подключаемый модуль не обнаружит раздел с именем проекта, он будет использовать значения из данного раздела. Значения по умолчанию не используются, если будет создан новый раздел с именем, соответствующим имени проекта.

В любом разделе обязательно должны быть два параметра:

  • Параметр FORMAT: Параметр format определяет текст гиперссылки на требование.
  • Параметр SCREENTIP: параметр screentip определяет текст, который будет отображаться при наведении указателя мыши на гиперссылку.

Если какой-либо из этих параметров не определен, то используется соответствующее значение из раздела ([RequisitePro]) INI-файла. Значение параметра может содержать определенные теги.. Эти теги в процессе выполнения заменяются соответствующими значениями. Например, тег <REQTEXT> заменяется текстом требования выбранного требования, а <REQNAME> заменяется именем требования. Остальной текст (не заключенный в теги) отображается "как есть".

Решение проблем

  1. Если гиперссылка отображается не в соответствии с заданными параметрами, проверьте, находится ли INI-файл в требуемой папке.
  2. Если INI-файл находится там, где нужно, а результат все же оказывается непредвиденным, проверьте параметр FORMAT в INI-файле для этого проекта. Возможно, это связано с выбором значений по умолчанию.

Страница сайта http://test.interface.ru
Оригинал находится по адресу http://test.interface.ru/home.asp?artId=19861