Generating Requirements Documents from DNG


 

Introduction

Toolset requirements:

- Rational Publishing Engine version 6.0.6.1 and later

- Doors Next Generation version 6.0.6.1 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)
Prerequisites:  

    • 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.

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.

 

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 This email address is being protected from spambots. You need JavaScript enabled to view it..