Generating Requirements Documents from DNG

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.

Overview

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

Objectives

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.