Tool Mentor: Adding Templates to Your Rational RequisitePro Project
This tool mentor describes how to use Microsoft® Word documents as templates for documents in your Rational RequisitePro projects. The templates are referred to as document "outlines" within RequisitePro .
Tool: Rational RequisitePro
Relationships
Related Elements
Main Description

Overview

Every new document in RequisitePro is based on a document type. The document type includes a default file extension, a default requirement type, and default text and formatting (regarding fonts, tabs, and so on) and is controlled by an associated outline. RequisitePro provides the following outlines for requirements and use-case development:

  • Product Requirements Document
  • Software Requirements Specification
  • Modern Software Requirements Specification
  • Multiple Use-Case Specification
  • Test Requirements Document
  • Functional Test Cases
  • Requirements Management Plan
  • Stakeholder Requests
  • Vision
  • Glossary
  • Use-Case Specification
  • Software Requirements Specification (with use cases)
  • Software Requirements Specification (without use cases)
  • Supplementary Specification
  • Test Plan

Accessing Outlines

You can access outlines for your documents in several ways:

  • In RequisitePro, outlines are associated with document types. To create a document, select a package in the Explorer and click File > New > Document. Then select a document type on which to base the new document. To add a new document type and outline to a project, select the project in the Explorer, click File > Properties, click the Document Types tab, and click the Add button. In the Document Type dialog box, you can select an outline.
  • The outlines, which are based on Word .dot files, are located in the following RequisitePro installation directory: Program Files/RationalRequisitePro/outline.
  • Word templates can be accessed through the RUP treebrowser (click Templates > Microsoft Word).

Creating Custom Outlines

You can use your existing Word documents to create custom outlines. A RequisitePro outline is a reference document used to control the formatting of Word documents in RequisitePro. This is useful for maintaining consistency across documents of the same type.

RequisitePro outlines are composed of two files, which are stored in the outlines directory in your RequisitePro installation:

  • An outline file, which has a .def extension, is a simple, unformatted text file that contains an outline name, a description, and a reference to a Word template.
  • The Word template, which has a .dot file extension, contains the paragraph styles and other information, such as formats, page layout information, attributes, attribute definitions, and system defaults that control the appearance of your RequisitePro document.

Tool Steps

To add a new outline to your RequisitePro project, do the following:

  1. Create a Microsoft Word template
  2. Create an outline file
  3. Add your outline to RequisitePro
  4. Create a document type based on your outline

1. Create a Microsoft Word template

  1. Start Microsoft Word outside of RequisitePro.
  2. Open the file you want to use to create a Word template.
  3. Edit the file, as needed, to prepare the content for use as an outline.
  4. Save the file as a Word template with the extension .dot. See the Microsoft Word documentation for more information about creating templates.

2. Create an outline file

An outline file is created in a text editor and saved with a .def extension. The outline file is unformatted text file that contains an outline name, a description of the outline, and a reference to a Word template. The .def and the .dot files, created in procedure 1 above, must have the same name with different extensions. Example: usecase.def , usecase.dot. Both files must be stored in the outlines directory in your RequisitePro installation or in a secondary outlines directory referenced in RequisitePro by clicking Tools > Options/Directories/Document Outlines.

  1. Open a text editor, such as Notepad.
  2. Create a new text file containing the following three lines of information, separated by returns:
    • The outline's full (logical) name, up to 64 characters in length. Be sure that this logical name is unique in the outlines directory.
    • A description of the outline, up to 256 characters in length.
    • The Word template's file name (with the .dot extension).
  3. Save the text file using the same file name as the template but with the extension .def.

For example, the usecase.def file includes the following lines:

RUP Use Case Specification
Rational Unified Process supplied template used to specify a use case. rup_ucspec.dot

3. Add your outline to RequisitePro

Copy .dot / .def files to the outlines directory in your RequisitePro installation directory or a secondary outlines directory. The path of a typical outlines directory is: C:\Program Files\Rational\RequisitePro\outlines. Your installation may vary, depending on the Rational products you've installed.

If you use a secondary directory, be sure that the path is defined in RequisitePro. Click Tools > Options, and in the Directories/Document Outlines field, type the path and directory name for your custom outlines.

4. Create a document type based on your outline

  1. In the Explorer, select the project, and then click File > Properties. The Project Properties dialog box appears.
  2. Click the Document Types tab, and then click the Add button. The Document Type dialog box appears.
  3. In the Name text box, enter a name for the document type (up to 64 characters).
  4. In the File Extension text box, enter a three-character text string, or, if long file names are supported, a longer extension. (File extensions can contain a maximum of 20 characters in RequisitePro.) The file extension is applied to all documents associated with the document type.
  5. Select a default requirement type in the list, or click New to create a new requirement type.
  6. Select an outline from the Outline Name list.
  7. Click OK to close the Document Type dialog box.
  8. Click OK to close the Project Properties dialog box.

For More Information

helpbook icon Refer to the following topics in the RequisitePro online Help:
  • Creating and modifying document types (Index: document types > creating)
  • Creating document outlines (Index: outlines > creating)