Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Using Bookmarks
Within a document template, you can insert a bookmark to locate material inside the generated document, either from within the same document or from a separate Word document.
Manage bookmarks
As your report template develops, the editor automatically assigns a unique bookmark to the start and end of each model section you select from the 'Sections' panel.
You can also create your own bookmarks in any document wherever you want to reference a specific point, and move these to other points in the text.
(In the report template you can move the automatic bookmarks as well, but if you want to use these as reference points for a Word document to access, it is better to leave them as they are.)
To insert a bookmark:
- Move the cursor to the point in the text to mark, and select the 'Insert | Bookmark' menu option; the 'Bookmark' dialog displays.
- Either select an existing bookmark from the list (to switch it to the current location) or type a new bookmark name in the top field.
- Click on the .
To locate bookmarked text in the document:
- Select the 'Insert | Bookmark' menu option and, on the 'Bookmark' dialog, click on the bookmark and on the ; the editor displays the point at which the bookmark was set, in the top left corner of the display
To delete an existing bookmark:
- Select the 'Insert | Bookmark' menu option and, on the 'Bookmark' dialog, click on the bookmark and on the
To insert a reference to a bookmark:
- Move the cursor to the point at which to insert the reference and, if you want to, type some lead-in text such as 'Go to page' or 'See page'.
- Select the 'Insert | Bookmark' menu option and, on the 'Bookmark' dialog, click on the bookmark and on the
The editor inserts the number of the page containing the bookmark, at the cursor position in the text; for a document, this acts as a hyperlink to the bookmark position.
If you set the reference in a template, the link is created in the document you generate from the template.
.
In the Document Generation, Bookmarks provide additional facilities:
- All .Start and .End bookmarks that enclose a labeled field will hide the label in the report if the field has no content; for example:
- The bookmarks Element.Keywords.Start and Element.Keywords.End enclose the Keywords
{Element.Keywords} report field, but if an element has no keywords, the Keywords label in the
generated report is hidden and the space closed up - All Begin and End bookmarks containing the string _LIST_ will add a comma to the enclosed section, so that all values extracted from the model for that section will be presented in a comma-separated list; for example:
- The bookmarks Pkg_Element_Meth_MethParameter_LIST_Begin and
Pkg_Element_Meth_MethParameter_LIST_End in the parameter section set a comma that, in the
report, is inserted between the multiple parameter name/type pairs in the section - All Begin and End bookmarks containing the string _TITLE_ will add a line break and a value title to the field, and present the values extracted from the model as a vertical list underneath the title; for example:
- The bookmarks Pkg_Element_Meth_FeatTagVal_TITLE_Begin and
Pkg_Element_Meth_FeatTagVal_TITLE_End in the Tagged Value section insert a line space and the
heading 'Properties', underneath which is printed, in the report, the names and values of the parameter
Tagged Values
Learn more