Other Features
HTML Schema Doc Generator
You access this window from the Tools | HTML Schema Doc Generator menu item.
This window lets you select one or more schemas from the Sources tab and create HTML documentation describing the schema(s) via the Begin HTML
Schema Doc Generation button at the top of the screen. Hyperlinks throughout the HTML document let you jump between sections of the documentation.
The HTML Schema Doc Generator includes command line support. Refer to
Toad Help for more information.
All options are saved to and loaded from the Toad.INI file. Schema selections are saved and loaded on a per-database basis. The following options require further explanation.
Content tab
This tab contains check boxes that let you select what to include in your HTML document.
Counts of All Objects
If checked, the document will list each object type owned by the schema and the number of objects of that type in the schema.
227
Toad for Oracle
Object Summary
Each Object Summary check box (Tables Summary, Snapshots Summary, etc.) when checked, creates a list of characteristics of the object. For most object types, the object name is a hyperlink to a more complete description of the object.
Object Descriptions
Each Object Description check box enables additional check boxes that let you specify what to include in the description. The Table Descriptions includes a
Default Values check box. If checked, a Default Value column will be added to the table descriptions and display the default value for each column in a table.
Format tab
File Options radio buttons
One file per schema
If selected, each schema is written to its own file. If more than one schema is selected, an additional HTML page will be created that is a link between the schema documents.
A few files per schema
If selected, schemas are broken into a few files, one file for each major section.
One file per object
If selected, each object is written to its own file, and each summary section is written to its own file.
Background
Use Existing CSS file
Most of the style options are written to a CSS file. If you want to use your own customized version of the CSS file, select this option and specify the file name or URL (The default will be the same name as the HTML file but with the css extension.). When this option is selected, the options that are written to the CSS file are disabled.
228
Other Features
Indent HTML files
When checked, the HTML code in the files will be indented with spaces so it can be more easily read. When the option is unchecked, no indentations will be made in the HTML code, so the resulting files are smaller and can be read faster by computers. This option does not change the way the HTML documents are displayed when viewed through a browser.
In/Exclusions tab
This tab lets you create and select inclusion and exclusion files.
The filter button lets you select either the Tables or Views button. The Create a file button generates an inclusion/exclusion text file for the schema that lists all your tables or views. You can then view and edit the file. If you use it as an inclusion file then only the tables or views listed will be included. If you use it as an exclusion file then only the tables or views listed will be excluded. You can also add STARTSWITH: ENDSWITH: CONTAINS: filters.
A radio button also lets you select to specify object sets. This lets you specify the objects using the GUI instead of editing a text file. This is the fastest way to create HTML schema documentation for large schemas when you are interested in creating documentation for only a small percentage of the schema objects.
The inclusion/exclusion files are suited for specifying a large percentage of schema objects.
Headers/Footers tab
This lets you add headers and footers and select the fonts for each header/footer.
Aliases for Schema Names tab
This lets you add aliases for the generated HTML for individual schemas.
229
