Publishing URLs
Builds data source URLs for IBM Engineering Publishing, ready to use, from wherever you are in DOORS Next, so document templates are connected in minutes.
What it is and why it exists
Specifications, test plans and compliance documents are often generated from DOORS Next with IBM Engineering Publishing (formerly Rational Publishing Engine). Every template needs data source URLs that point to the right project, configuration, module, view or artifacts, plus the matching schema URLs.
Writing these Reportable REST URLs by hand requires knowing many parameters and the internal identifiers of projects, modules and configurations. A single mistake gives an empty or wrong document. Publishing URLs builds the correct URLs from the place where you are in DOORS Next.
Problems it solves
- Writing data source URLs by hand, with internal IDs and many parameters.
- Documents generated from the wrong configuration, stream or baseline.
- Time lost searching documentation for the right parameter.
- Dependence on a few specialists who know the Reportable REST interface.
Benefits
- Correct URLs in seconds for the module, its artifacts, a view, the selection or the whole project.
- Schema URLs included, as the publishing template needs them.
- The right configuration: stream, baseline, change set or global configuration, taken from your current context.
- Copy and open each URL with one click, or copy all of them at once.
- Read only and safe.
How to use
- You1Open the module, select artifacts or open a view if needed
- You3Choose a comparison, attributes and extras in Settings
- Result4Data source and schema URLs to copy into RPE
- Open the project, configuration and module the document is about. Select artifacts if only those should be published, and open a saved view in DOORS Next if you need the view URLs.
- Check the Context section, which shows what the URLs are built from.
- In Settings, click Change and choose a configuration under Compare with (Diff), the Attributes and what to Include, for example Cover page variables.
- Under Data source URLs, open a group and copy the data source URL and its schema URL into your publishing template. The open icon shows the server's answer first; the copy icon at the heading copies all URLs at once.
Screenshots
1The context the URLs are built from: project, configuration, module and selection 2Settings: a baseline to compare with, a cover page and other extras for the URLs 3The data source and schema URLs of the open module, each with copy and open buttons 4A URL for only the artifacts selected in DOORS Next 5With a view open in DOORS Next, the Module view URL and its schema URL are ready too
Good to know
- URLs that do not fit the current context are listed with the reason, for example when no module is open.
- Very long URLs, from large selections, get a warning, because some tools limit URL length.
What's new in version 1.25
· Change titles are published in English.
- Messages in the notifications