Generate RTF Documentation Dialog
The Generate RTF Documentation dialog enables you to set the exact contents and look and feel of your report.
Each tab of the dialog offers a number of RTF document generation options, as described in the following sections:
- RTF Templates
- Document Options
- Advanced Options
- Element Filters
- Other Filters
- Project Constants
- Word Substitution
- Language Substitution (Codepage)
When you have worked through these tabs and set the options you require, return to the Generate tab and click on the Generate button to produce your report.
Reference:
|
|
|
Model Document
Root Element
Root Package
|
Confirm the name of the element selected from the Project Browser, Diagram List or Model Search
If this is the specially-created model document element for a Virtual Document, the field is Model Document
Otherwise, this field identifies the selected element of the hierarchy to be reported on; that is, the Root Element or Root Package
|
Virtual Document
|
Output to File
|
Type or select the location and filename for the generated documentation
The ( ... ) (Browse)button enables you to navigate to the location
|
|
Use Template
|
Type or select the name of the RTF template to apply to document generation
You can select either a standard template (enclosed in parentheses) or a user-generated template
The standard templates include the following:
- (basic template)
- (diagrams template)
- (maintenance template)
- (requirements template)
|
|
Output to PDF
|
Generate the report in PDF format rather than in RTF format
|
|
Use Language Substitutions
|
Switch custom language word substitutions on
Deselect to switch custom language word substitutions off
|
Word substitutions
|
View Document On Completion
|
Open the document as soon as it has been generated
|
|
Use Internal Viewer
|
Enable the button to launch the generated RTF Documentation in the Enterprise Architect internal viewer
Deselect to enable the button to launch the generated RTF Documentation in the MS Windows default RTF file viewer
|
Document options
|
Include all Diagram Elements in Report
|
Include elements in the report from external packages that are referenced from a diagram, for every diagram covered by the report; this defaults to selected
The Package.Diagram.Element and Package.Element checkboxes must be selected in the current template
If external elements are to be included only for specific diagrams, deselect this checkbox and - only for the diagrams for which you want to include external elements in the report - for each diagram select the checkbox in the diagram properties
When both options are deselected, or when neither of the Package.Diagram.Element or Package.Element checkboxes are selected in the template, only elements in the current package are documented
|
Diagram properties
|
Optimize for Open Office
|
Generate reports where diagrams are adjusted for clean rendering in Oracle Open Office
The option also overwrites the value fields defined in a document section with the actual value text.; if you open a generated report in Word, you can format the text but you cannot display the original field code
If the checkbox is deselected, diagrams displayed in Open Office are less distinct - value fields remain and are populated with the appropriate values; when you display a generated report in Word, you can right-click on the field and toggle between the value text and the field code
If you use Open Office as your text editor, you must select this checkbox to show the field values; Open Office defaults to showing the field codes only, and you cannot toggle to the field values
|
|
Resource Document
|
Save the current options as a document definition
|
Document definition
|
Edit Template
|
Edit the currently-named template using the RTF Style Template Editor
You can only edit user-defined templates, not the standard templates provided with Enterprise Architect; standard template names are enclosed in parentheses
|
RTF Style Template Editor
|
Generate
|
Generate the document (after you have set all the options you require, on all tabs of the dialog)
|
|
View
|
Launch the generated RTF Documentation in:
- The MS Windows default RTF file viewer, or
- The Enterprise Architect internal viewer, if you have selected the Use Internal Viewer checkbox
|
|
Abort
|
Cancel report generation; a prompt displays to confirm cancellation of the report
|
|
Notes:
- For an introduction to generating RTF documentation, see the RTF Documents topic
- If you have never selected the checkbox, the document generator prompts you to confirm which document style you want to adopt - Microsoft Office or Oracle Open Office; once you have made a selection in this prompt, the document generator always acts on the status of the checkbox and does not display the prompt again
Learn More:
The material ("material" includes all pages, documents and on-line graphics) on this web site is protected by copyright law. (C) 1998-2011 Sparx Systems Pty Ltd.