Publishing URLs

Что это и зачем

Спецификации, планы тестирования и документы о соответствии часто формируются из DOORS Next с помощью IBM Engineering Publishing (ранее Rational Publishing Engine). Каждому шаблону нужны URL источников данных, указывающие на нужный проект, конфигурацию, модуль, представление или артефакты, а также соответствующие URL схем.

Чтобы писать такие URL Reportable REST вручную, нужно знать множество параметров и внутренние идентификаторы проектов, модулей и конфигураций. Одна ошибка – и документ получается пустым или неверным. Publishing URLs создан, чтобы формировать правильные URL из того места в DOORS Next, где вы находитесь.

Какие проблемы решает

• Ручное написание URL источников данных с внутренними ID и множеством параметров.
• Документы, сформированные не из той конфигурации, потока или базовой линии.
• Время, потерянное на поиск нужного параметра в документации.
• Зависимость от нескольких специалистов, знающих интерфейс Reportable REST.

Преимущества

• Правильные URL за секунды для модуля, его артефактов, представления, выделения или всего проекта.
• URL схем в комплекте – так, как они нужны шаблону публикации.
• Правильная конфигурация: поток, базовая линия, набор изменений или глобальная конфигурация – берётся из текущего контекста.
• Копирование и открытие каждого URL в один клик или копирование всех сразу.
• Только чтение и полная безопасность.

Как пользоваться

1. Откройте проект, конфигурацию и модуль, к которым относится документ, и выделите артефакты, если публиковать нужно только их.
2. Проверьте раздел Context: в нём показано, на основе чего формируются URL.
3. В разделе Settings выберите формат артефактов, параметр конфигурации, представление, атрибуты и дополнительные элементы, например титульную страницу.
4. Скопируйте нужные URL из раздела Data source URLs в свой шаблон публикации.

Полезно знать

• URL, которые не подходят к текущему контексту, выводятся списком с указанием причины – например, если не открыт ни один модуль.
• Для очень длинных URL, получающихся при больших выделениях, выводится предупреждение, поскольку некоторые инструменты ограничивают длину URL.