Troubleshooting
Problem
Attempts to export to Microsoft Word from Document Generation using IBM Rational DOORS result in the Table of Contents not being generated
Symptom
From the IBM DOORS Formal Module Navigate to:
File -> Export -> Document Generation -> Export
Click Advanced button
Check for "Use custom template"
Browse to the custom template for example *.dotm
Click OK
Export
The Table of Contents not being generated after exporting a document to Microsoft Word.
Cause
The reason is because the macro is missing the custom template. The Table of Contents issue only occurs on custom defined template using Document Generation -> Export option. The Export to Microsoft Word or using default template with Document Generation -> Export option does populate the Table of Contents.
Environment
IBM Rational DOORS 9.6
Microsoft Word 2010
Diagnosing The Problem
In IBM DOORS versions pre and including 9.6.0, export tries to run default macro called 'rpe'. If this macro is not available in the supplied Microsoft Word template all fields remain not updated. If you provide a custom template via Advanced dialog, the IBM DOORS still aim to run this macro.
Background how DOORS TOC generations works:
By default IBM DOORS uses a rpe.dot template. This is supplied with IBM DOORS under:
C:\Program Files (x86)\IBM\Rational\DOORS\9.x\lib\dxl\standard\export\RPE_light\utils\word\rpe.dot
This is a Microsoft Word template which contains 'rpe' macro which generates (and updates) the Table of Contents
Resolving The Problem
In order to have the Table of Contents updated, you can perform one of the following:
- Use Ctrl+A and F9 combination on generated document - but that is not an automated approach
- Update your custom template with macro similar to the one from rpe.dot - a default macro should be named rpe
Default macro from rpe.dot available under C:\Program Files (x86)\IBM\Rational\DOORS\9.x\lib\dxl\standard\export\RPE_light\utils\word\rpe.dot
Was this topic helpful?
Document Information
Modified date:
01 May 2020
UID
swg21682781