For documents with large amounts of data, you can generate
a document from the Launcher and Document Studio applications with
only a subset of the data to decrease generation time.
About this task
In the Launcher or Document Studio,
click .
The
subset of data that is included in the preview is the first ten data
entries by default. You can change this number in the Engine Preferences:
- Click .
- In the Preview query results limit, enter
the number of data entries to include in the preview.
Procedure
- In the Launcher or Document Studio, click .
- Select one of these options:
Preview Document: The preview is generated
immediately without requirement any of the additional selections that
are outlined in this task. Only a subset of the data displays in the
output.
Configure and Preview Document:
A configuration wizard opens to allow you to make additional selections
for the preview before it is generated. Continue through the remaining
steps in this task.
- 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.