Powered by Smartsupp

Generating Requirements Documents from DNG



Toolset requirements:

- Rational Publishing Engine version and later

- Doors Next Generation version and later

Type:               Instructor-led Classroom
Duration:        2 days (8 hours/day)

Level:              Intermediary/Advanced
Location:        Remote or Onsite (World-Wide)
Language:      English

Audience:       Individuals responsible for generating requirements documents from IBM Doors Next Generation (DNG)

    • Basic knowledge of XML language and XML schema definitions
    • Basic knowledge of requirements management 
    • Basic knowledge of CLM suite (especially DNG)
    • Some knowledge of OOP concept and Javascript language

This course is intended for developers and engineers that want to build complex documents/reports (e.g. traceability reports) in IBM® Rational® Publishing Engine v6.0 + 

Note: As of version 7.0, IBM Rational Publishing Engine (RPE) is renamed to IBM Engineering Lifecycle Optimization - Publishing (PUB), and IBM DOORS Next Generation is renamed to IBM Engineering Requirements Management DOORS Next.

IBM® Rational® Publishing Engine is an automated document generation solution that generates documents from Rational products and selected applications from other vendors that use XML and REST interfaces.


This two-day, hands-on class covers all aspects of building RPE templates and connect them to DNG to generate requirements documents.

This basic course is for:

  • Business/Requirements Analyst
  • Systems / Software Engineer
  • Product Manager
  • Support/QA Engineer
  • Technical Document Author


After completing this course, you should be able to use IBM Rational Publishing Engine (RPE) to:

  • Install/Configure RPE components
  • Understand data structure - learn how DNG reportable API works
  • Learn how to iterate different types of elements like resources, modules, text, collections, etc.
  • Understand the difference between reporting on a module vs a view
  • Learn how to export basic and custom requirement attributes
  • Learn how to export diagrams
  • Learn how to build traceability by following different types of links in DNG
  • Learn best practices regarding DNG templates
  • Learn how to deploy/run RPE templates in DNG web client

Training modules

 Day 1:

  1. Introduction
  2. IBM Rational Publishing Engine - components overview
    1. Document Studio
    2. Standalone Launcher
  3. Configure RPE components
  4. Working with DNG XML Schemas
    1. Importing schemas for: resources, modules, text, collections, terms, reviews, use case diagrams, etc.
    2. Performing different operations on schemas: upgrade, edit, rename.
  5. Design basic RPE templates for DNG
    1. Adding simple elements: container, paragraph, text, table, etc.
    2. Adding queries
    3. Exporting requirement attributes
    4. Using variables and conditions
  6. Report on DNG Modules (book format) and requirements
    1. Using conditions to display differently the module headlines and text requirements
  7. Using Dynamic Datasource Element
    1. Extract more information from each resource using dynamic data source configuration
    2. Follow links: using POX for data reconfiguration

 Day 2:

  1. Sorting and filtering requirements
    1. RPE and Native sort
    2. RPE and Native filter
    3. Create dynamic filters using external variables
  2. Report on DNG Module Views
  3. Include diagrams
    1. Use case diagrams, user interface (UI), sketches, or business process modeling diagrams
  4. Handling the ToC, ToT, and ToF sections 
  5. Create traceability reports
    1. Export links like DerivedLink (design) and ValidatedBy (verification)
  6. Format documents
    1. Using RPE format properties
    2. Using RPE internal styles
    3. Using external styles
    4. Format elements based on conditions
  7. Test, document, and debug RPE templates
    1. Enable DNG debugging for document generation
  8. Deploy and install RPE templates in the DNG web client
  9. Publish documents directly from the DNG web client

Contact us to get a customized offer for your team. Upon discussion, we can learn you a process and include important elements and terms known to your team into the training program.


Softacus Services

We, in Softacus, are experts when it comes to consulting and service delivery of IBM software products and solutions in your business. We help our clients to improve visibility and transparency when licensing and managing commercial software, providing measurable value while increasing efficiency and accountability and we are providing services in different areas (see Softacus Services).
IBM ELM extensions developed by Softacus are free of charge for the customers who ordered IBM ELM licenses via Softacus or for the customers who ordered any of our services. If you are interested in any of our IBM ELM extensions, you found a bug or you have any enhancement request, please let us know at info@softacus.com.

Related and Referenced Topics

Blog Articles:

Basics of Links and Link Types in IBM DOORS Next Generation - learn the basics about the linking and link types in IBM DOORS Next.

Linking Techniques in IBM DOORS Next - article explaining basic concepts and showing multiple ways of creation of links between artifacts. 

Link By Attribute Feature in IBM DOORS Next -  the article explains how to use the "Link by attribute" function to automatically create, update, or delete one or more links between artifacts based on values in the attributes of the artifact. 

Softacus Widgets:

Link Switcher -  widget developed by Softacus, that converts the context of artifacts links in a very short time. 

Module Link Statistics -  extension that provides users with a quick overview of the amount of the links in specific link types in a module.

Link Type Change-  extension developed by Softacus designed to enhance the functionality of DOORS Next Generation by allowing users to manipulate the direction of a link or convert it to another type of link. 

Links Builder- extension that allows the users to create a link between two artifacts in DOORS Next Generation according to the certain rules. 

Link by Foreign Attribute -  this extension allows users to create links between artifacts in the selected module(s), based on the attributes values. 

Show Attributes of Linked Artifacts -  this extension shows the attributes and links of the artifact that is currently selected. 


Softacus AG

Löwenstrasse 20
8001 Zürich
E-Mail: info@softacus.com
Tel.: +41 43 5087081
Fax: +41 43 344 6075 

VAT: CHE-108.817.809 MWST
D-U-N-S® Number 486800618


Softacus GmbH

Westendstrasse 28
60325 Frankfurt am Main
E-Mail: info@softacus.com
Tel.: +49 69 34876544
Fax: +49 69 5830 35709

VAT: DE301903892
D-U-N-S® Number 313482703


Softacus s.r.o.

Křídlovická 351/47A
603 00 Brno
Czech Republic
E-Mail: info@softacus.com
Tel.: +420 530333482
Fax: +41 43 344 6075

VAT: CZ07286333
D-U-N-S® Number 496165108


Softacus s.r.o.

Tatranské nám. 3
058 01 Poprad
E-Mail: info@softacus.com
Tel: +421 911 083 612
Fax: +41 43 344 6075

VAT: SK2121388148
D-U-N-S® Number  2121388148


Cookie Policy