Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Create a Web Page Report
If you want to create a report on a Package to display as a web page, you can select the Package in the Project Browser and perform a simple procedure using the 'Publish as HTML' dialog. All child Packages of the selected Package are automatically included in the report.
Access Project Browser | Right-click on Package | Documentation | HTML Report (Shift+F8)
Create a Web Page report
Field/Button |
Action |
See also |
---|---|---|
Package |
Confirm the name of the selected Package, for which you are creating the web documentation. If you want to change the Package, close the dialog, select the new Package and select the 'HTML Report' option again. |
|
Title |
Defaults to the Package name. If you want the report to have a different title, overtype the field contents with your preferred text. |
|
Output to |
Type in or browse for the directory path your report is to be saved to. |
|
Style |
(Optional.) Click on the drop-down arrow and select a custom web style template to apply to your documentation, in place of the default template. Use the <default> value for the standard, system-provided template. |
Create Web Style Templates |
File |
Type the file extension for your web documentation files; the default is .htm. |
|
Theme |
Click on the drop-down arrow and select a Diagram Theme to apply the color, line thickness and font style to diagrams of elements in the report, if those elements are using default values. If you set the field to '<none>' the report will apply the system default theme defined in the 'Options' dialog, 'Diagram > Themes' page. |
Diagram Theme Options |
Header Image |
If you want the report to have an identifying image at the top, type in or browse for the image file directory path and filename. If you do not specify a path, the image defaults to the Enterprise Architect logo. |
|
Preserve White space in Notes |
Select the checkbox to reproduce the spacing of any element notes. Deselect the checkbox to remove white space. |
|
No Page for Note and Text Items |
Select the text box to exclude Note elements and Text elements from the report. |
|
Default Diagram |
Select the appropriate radio button to begin the web report with:
|
|
Image Format |
Select the appropriate file format in which to store images - PNG or GIF. |
|
Include |
Select the appropriate checkboxes to include, in your web document:
|
|
System |
Select the appropriate checkboxes to include, in your web document, the System components:
|
|
Generate |
Click on this button to generate the report. |
|
Progress |
Shows the accumulating percentage completion of the report generation process. |
|
View |
Once the report is complete, click on this button to launch your default web browser and view the web pages. |
View page for specific diagram or element
When you view the web report in your web browser, you can switch directly to a page for a specific diagram or element by specifying the appropriate GUID after the report web address. That is:
http://path/path/path/Index.htm?guid=xxxxxxxxxxxx
Type the word guid in lower case, and do not include braces { } in the value; for example:
http:// .../path/Index.htm?guid=DC62B0DA-0D60-4447-85E6-B9BBAE7FC90F
To obtain the GUID, right-click on the Package or element in the Project Browser and select the 'Copy/Paste' option, or right-click on the diagram and select the 'Copy Reference' option.
Browser behavior
The display of your web report can be affected by the browser that you use. Specifically:
- Firefox automatically converts the diagram or element page locator path to a file:///C:/path protocol and actions it
- Opera automatically adds file://localhost/ to the start of the page locator path, in the same way as Firefox adds the file:///C:/path protocol
- Opera by default disables XMLHttpRequest when loading a file, and the web report detects this and prompts the user to change settings; there are no problems when the page is hosted on a web server
- Microsoft Internet Explorer does not operate on the page locator path directly, but the protocol in Firefox also works in Internet Explorer; therefore, to use the absolute references without a web server, you must access the path using the file:/// protocol
- If you are using Internet Explorer 7.0 or later, and you do not have it open, its security profile might block the report display; click on the explanation banner at the top of the screen and select the 'Allow Blocked Content' option
- To display web reports directly from the file system, Chrome requires the command line argument chrome.exe --allow-file-access-from-files; there are no problems with direct access when the page is hosted on a webserver
Notes
- To generate a demonstration web report right now, open the EAExample project, select the 'System' Model Package and follow the steps above
- You can also select Packages in your model to exclude them (and their subordinate Packages) from the web reports you generate
Learn more
Learning Center topics
- Alt+F1 | Enterprise Architect | Reporting | HTML Reports