Setting output properties for Microsoft Word documents

You can set output properties such as path, style sheet, and macros for Microsoft Word documents.

Before you begin

For more information about how user names and passwords are stored, see Security considerations for IBM® Rational® Publishing Engine.

Procedure

  1. In the Launcher perspective, expand Output, right-click the Target: Word, and select Configure Output.
  2. In the Configure Word Output window, enter the following field details:
    1. Path: Type a path with a file extension or click Browse to select the location for the output. You can edit the path to be a relative path from the document specification. You can choose .doc or .docx as the file extension for your output. Example: ..\output\sampleWordOutput.docx
    2. Stylesheet: Type or click Browse to specify any Microsoft Word 1997-2003 (.doc or .dot) or any Microsoft Word 2007, 2010, or 2013 document or template (.docx or .dotx). All of these file types are handled the same way when generating documents with Rational Publishing Engine.

      For example, RPE_HOME\utils\word\rpe.dot.

    3. Macro: Enter the Microsoft Word macros to use in the generated output.
    4. User: Enter the user name, if the data source is in a secured location.
    5. Password: Enter the password.
    6. Authentication: Select the authentication type that applies to accessing your stylesheet. You can select one of the following authentication types:
      • Form
      • Basic
      • OAuth
      • OAuth-OSLC
    7. Accept header: Enter an accept type for your stylesheet. Examples:
      • image/jpeg
      • text/html
      • application/xml
      • */*
    8. Bidirectional languages: Select this option to support languages that are read from right to left such as Arabic and Hebrew.
  3. Click OK.
    Note: You can run a macro at the end of the process. The macro is run only if Microsoft Word is available on the computer that hosts the Rational Publishing Engine.

    The macro must be defined in the style sheet. Run the macro with Microsoft Word in visible mode, which lets you confirm or cancel messages added by the macros. The macro might run for a while, depending on its complexity and the length of the document. Wait for the macro to complete before opening the document. To run macros for Microsoft Word 2007 formats, specify the .docm (document with macros) extension for the output document.


Feedback