Book a Demo

Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next

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.)



See also

Insert a Bookmark

  1. Right-click on the point in the text to mark, and select the 'Bookmark' menu option; the 'Bookmarks' dialog displays.
  2. 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. Do not use spaces in the Bookmark; this will prevent the bookmark from being inserted.
  3. Click on the Insert button.

Locate Bookmarked Text in the Document

  1. Select the 'Bookmark' menu option.
  2. On the 'Bookmarks' dialog, click on the bookmark and on the Go to button.
  3. The editor displays the point at which the bookmark was set, in the top left corner of the display.

Delete an Existing Bookmark

Select the 'Bookmark' menu option.

On the 'Bookmarks' dialog, click on the bookmark and on the Delete button.

Insert a Reference to a Bookmark

  1. 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'.
  2. Select the 'Bookmark' menu option.
  3. On the 'Bookmarks' dialog, click on the bookmark and on the Set Page Reference button.
  4. 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.

Additional Bookmark Facilities in Document Generation

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


  • When you force a custom SQL field in the fragment to be processed as a formatted notes, you must have '.formatted' in the custom field name; for example:
  • The same is required in the bookmarks for SQL fragments; for example:
         {FieldName.Formatted.Start} or FieldName.Formatted.End}.

Learn more