ITP versions before 2.1 handled bookmarks as a single point of reference in the document. ITP version 2.1 and higher can handle bookmarks as a range in the document. However, to enable this bookmark range support, the setting ITPCOMPATIBLEBOOKMARKS=N must be added to the ITP.CFG file.
Bookmarks must be unique in a document. This means that it normally not possible to place bookmarks in a repeating piece of text.
ITP offers a fix for this problem.
If the name of the bookmark starts with ItP (note the lower-case 't'!) ITP will replace the name of the bookmark by an expression, which will be evaluated during run-time.
The model builder has to provide a variable of type TEXT or a parameter-less function that will return a TEXT value with the same name as the bookmark without the ItP.
Note that the variable or function might be called twice for every bookmark, once at the start of the bookmark range, and once at the end of the bookmark range.
Example
If ITP encounters a bookmark with the name ItPbookmark, this name will be replaced by the expression @(bookmark) when the model is created. The variable or function 'bookmark' must be present in the model document.
During the execution of the model this expression, @(bookmark), will be evaluated every time the bookmark is encountered. The result of the expression is used as the name of the bookmark in the result document.
The model builder is responsible for creating unique bookmarks. Be warned that the behavior of Microsoft Word is unknown if multiple identical bookmarks exist.
The PageRef field is a very useful combination of the fields and bookmarks. The PageRef field inserts the page-number of the page containing the specified bookmark.
This allows you to use references to pages (Go to page 3) or multi-section page-totals (Page 4 of 9) by referring to a bookmark. Combined with the \p option of the PageRef field it is also possible to create text that says 'See table 14-3 below' if the table (bookmark) is on the same page, or refer to table 14-3 on page 23 if the table (bookmark) is on another page.
Refer to the sample document in the Examples folder of the support section of the Aia Software website for a documented example how to use repeating bookmarks in a result document.