What are bookmarks?
Bookmarks limit blocks within your own template. Blocks, in turn, are used to duplicate placeholders and texts as many times as needed. This means that the placeholder [InvoiceItem.description] only appears once within a block, but 3 times within 3 different indicated articles.
So, bookmarks limit the above mentioned blocks. But where can they be found and what do they look like? Normally, Word doesn't show the bookmarks. However, under „File > Options > Advanced“ you can take a look at them. They are displayed directly at the beginning and the end of the items and taxes. Billomat supports only those two blocks. Beyond that, no other are supported.
Each block has its own bookmarks. Just like for the placeholders, they are given a different name for each document. Let's take the offer and the invoice as example:
Bookmarks in estimates
Here, the item block starts with the bookmark [blockStart_OfferItem]. Every bookmark contains a prefix and an appendix, also called suffix. The prefix indicates the beginning or the end of the block, whereas the suffix names the content.
Now, the block also requires an end. The corresponding bookmark for the offer would then be [blockEnd_OfferItems].
These bookmarks are designed only for offers or estimates and, therefore, do not work for other documents. So, in case the placeholders are correct, but the blocks are named incorrectly, nothing will be issued.
Bookmarks in invoices
In order to also make this work for invoices, the bookmarks need to be adapted. The prefix stays the same, depending on its position at the beginning or the end of the block. Just the appendix is changing. In the case of the invoice, [blockStart_InvoiceItems] is displayed at the beginning of the block and [blockEnd_InvoiceItems] at the end.
These were only two examples to explain the bookmarks. Every document type has its own bookmarks.
