To create a report in the module, you use Templates. You populate these templates with text and replacements.
What are replacements?
Replacements are references to data in the module. A replacement always looks like this:
#replacement_name#
- The replacement starts with a hash.
- The specific replacement is then specified. This term is unique for each value to be retrieved.
- Finally, a hash marks the end of the replacement.
In this way, we can use templates to create a report that retrieves the desired data from the module.
An example of a number of replacements and the retrieved data:
| Replacement | What data is retrieved? | Example |
| #name# | Product name in the sales item | Chicken stew |
| #consumption_size# | Serving size in grams | 200 g |
You process these replacements in a .doxc document and link them to a template within the settings. Almost all our replacements must be processed in a table cell to work properly.
Another example:
The template contains the following values:
| Product details | |
| Product name: | #name# |
| Serving size (g) | #consumption_size# |
| Moisture loss (%) | #moisture_loss# |
| Explanation | #vital_recipe_remark# |
| Report date | #date# |
When exporting a report, the replacements are filled in with values from the module:
| Product details | |
| Product name: | Boeuf bourguignon |
| Serving size (g) | 200 |
| Moisture loss (%) | 10 |
| Explanation | Average 100 g of stewing meat per person. Worst-case scenario: double portion every half hour: 200 g |
| Report date | 08-05-2026 |
Table replacements
It is possible to display the allergen table, along with the processes and colour-coded standards, within a template. You can also display the process tables within a template.
However, these only work in the module in the following way:
- Reports are always exported in .docx file format.
- The page orientation in the template where the table replacement is located must be landscape.
- The replacement does not take into account formatting or font size. It will always be displayed in the same format.
You can use the following placeholders:
#vital_conclusion#
Total allergens and cross-contamination allergens. Displays a table of all allergens, the coloured standard indicators and the set standards in the module
The following table is then displayed in the template:
#vital_proces#
Total allergens and cross-contamination allergens in the various processes with the associated explanation.
Support can send you a legend of all placeholders and will be happy to help you format a template.