# The Report Engine

The Boomi Console Report Engine takes a well defined JSON input (like a [list of components](/boomi-console/library/the-report-engine/the-render-dataset/components-dataset.md)) and renders this using a FreeMarker 2 template into any kind of output file.

{% hint style="info" %}
[Apache FreeMarker](https://freemarker.apache.org/docs/index.html) is a populate and proven template engine written in JAVA.

> *"Apache FreeMarker™ is a template engine: a Java library to generate text output (HTML web pages, e-mails, configuration files, source code, etc.) based on templates and changing data. Templates are written in the FreeMarker Template Language (FTL), which is a simple, specialized language (not a full-blown programming language like PHP). ..."*

The template engine is based on Freemarker 2.3.32. Please refer to[ Apache FreeMarker Manual](https://freemarker.apache.org/docs/index.html) for more information about the templating engine.
{% endhint %}

Output files will be written to [`/OutDir`](/boomi-console/commands/arguments/common-arguments.md#outdir-o) into a file named: `<TemplateName>_<TimeStamp>.<templateExtension>`. This ensures unique filenames to not lose any information

<figure><img src="/files/0QXOtbzchTGaU2zETqkB" alt=""><figcaption><p>Deployment Overview report</p></figcaption></figure>

{% hint style="info" %}
The latest file is always written to the same file (without time-stamp). This was implemented to have a non changing reference to the latest file.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://boomi.markusschmidt.pro/boomi-console/library/the-report-engine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
