Generating a document

You can generate a document from Launcher and Document Studio.

Before you begin

Every template is associated with a blank document specification by default. When you preview or publish a template from the Document Studio application, this blank document specification can be customized or used without customization to generate the output. The Document Studio keeps the template in sync with the default document specification when you open or save the template.

About this task

In the Launcher or Document Studio, click Publish > Generate Document.
You can generate documents from both the Launcher and Document Studio applications. You can also publish documents from the Rational® DOORS® and Rational Tau user interfaces when you have the add-ins installed.

Procedure

  1. In the Launcher or Document Studio, click Document Specification > Generate.
  2. Select one of these options:
    • Generate document icon Generate Document: The document is generated immediately without requiring any of the additional selections that are outlined in this task to be made.
    • Configure and generate document icon Configure and Generate Document: A configuration wizard opens to allow you to make additional selections for the document generation before generating the document. Continue through the remaining steps in this task.
  3. In the Add templates window, the templates already listed in the document specification display.
    1. Select the location of any templates to add.
    2. Select the template to add.
    3. Click Add template.
    4. Repeat to add additional templates.
    5. Click Next.
  4. Select Yes to continue configuring the document specification.
  5. Review the existing details for each data source in the document specification and click Next.
  6. For each data source:
    1. From the drop-down menu, select one of the following options:
      • From local or remote file: To select a local or remote data source, click Browse to select a file or enter a URL to the data source
      • From Configuration Layer: To select a value from the configuration metadata you entered for the data source in your template
      • Using data source labels from the central library: To select a data source stored in the Central Management component
    2. Select a value for the configuration.
    3. If there are additional configuration options for your data source, click Configure to enter them. For example, if your data source is Rational DOORS, click Configure to enter the connection details.
    4. Click Next
  7. For each variable:
    1. From the drop-down menu, select one of the following options:
      • Manual configuration: To enter a value only for this document generation to be used in place of the variable
      • From Configuration Layer: To select a value from the configuration metadata you entered for the variable in your template
      • Using variable values from the central library: To select a variable stored in the Central Management component
    2. Enter or select a value for the configuration.
    3. Click Next.
  8. In the Configure Document Output Formats window, add or remove output types with the arrows.
  9. Optional: If the document must be saved, enter a location and filename for the output. If the name and location for the output is not specified, the file is generated in the temporary location. Click Next.
  10. In the Configure the style options for document output formats window, select each output format and configure the options for each.
  11. Verify that the template and output information in the summary window is correct.
  12. Optional: To enter additional metadata or configure other document properties that are not included in the wizard, click Edit advanced properties.
  13. Select which action to take when you click Finish:
    • Run the document generation: Generates the output types you specified.
    • Run the document generation and close RPE: Generates the output types you specified and closes the Rational Publishing Engine application after you exit the Results window.
    • Close this wizard and open the RPE client: Opens the document specification with the details you entered in the Launcher application.
  14. Click Finish.
    Tip: If you are generating the document remotely, you can close the Document Studio or Launcher application before the document generation completes without interrupting the generation process. If you are generating the document locally, do not close the Document Studio or Launcher application until the document generation completes.

Results

The document specification is loaded in the Launcher and generates or saves the document, depending on the selections.

Feedback