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 .
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
- In the Launcher or Document Studio, click .
- Select one of these options:
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: 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.
- In the Add templates window,
the templates already listed in the document specification display.
- Select the location of any templates to add.
- Select the template to add.
- Click Add template.
- Repeat to add additional templates.
- Click Next.
- Select Yes to continue configuring
the document specification.
- Review the existing details for each data source
in the document specification and click Next.
- For each data source:
- 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
- Select a value for the configuration.
- 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.
- Click Next
- For each variable:
- 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
- Enter or select a value for the configuration.
- Click Next.
- In the Configure Document Output
Formats window, add or remove output types with the arrows.
- 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.
- In the Configure the style options
for document output formats window, select each output
format and configure the options for each.
- Verify that the template and output information
in the summary window is correct.
- Optional: To enter additional
metadata or configure other document properties that are not included
in the wizard, click Edit advanced properties.
- 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.
- 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.