Release Notes

2.8

Integration of Template studio on Business Objects

See Integration on business objects.

Groovy Expression for Print Title

The field TemplatePrintModel.printTitle has been changed from static text to a Groovy expression. This allows end users to customize the name of generated documents dynamically.

If you have customized printTitle values in your template print models, you may need to update them to use Groovy expression syntax.

New TemplatePrintModel Creation Workflow

The UI for TemplatePrintModel creation has been redesigned into a step-by-step process:

  1. Step 1: Define the general information of the print model (name, conversion type, printing language, etc.)

  2. Step 2: Configure the TemplateSettings used to build the data during printing

  3. Step 3: Load the Studio with all necessary data to function properly

More details

Please check the change log for detailed list of changes and the 2.8 migration guide.

2.7

Carbone Studio Integration

The template print model form view has been completely redesigned with Carbone Studio integration. End users can now design their templates more efficiently by reducing the number of steps needed to test their changes.

API Token Reuse

Improved Template API communication performance by implementing a retry mechanism that reduces API token generation and reuses valid tokens.

Mass Download to ZIP

Added support for mass downloading of grouped print requests into a ZIP file directly from the grid view.

GDPR Compliance - Delete Remote Data

Users can now delete their personal data (templates, generated files) stored remotely on the Template API server:

  • A button to delete uploaded models from the template print model form toolbar

  • A button to delete generated documents from the print request form sidebar (in case the automatic deletion triggered after the download failed)

Other Features

  • Customizable Payload TTL (default: 1440 minutes)

  • Option to use only local library and prevent fetching from remote servers

  • Filter library templates on library server side

More details

Please check the change log for detailed list of changes and the 2.7 migration guide.

2.6

Spreadsheet Support for Auto-Configuration

Extended template settings auto-configuration to support spreadsheet formats (ODS, XLSX) in addition to document formats.

Configurable Process Timeout

Allow configuration of the maximum duration the download process can run before detaching to a separate thread.

Multi-Select Selections Support

Added support for multi-select selections in template data binding.

Automatic Template Settings Update

The system now suggests automatic update of template settings when a new file is loaded on a template print model.

Other Features

  • Open related origin of PrintRequest from grid view

  • Install/update library elements directly from the form view

More details

Please check the change log for detailed list of changes and the 2.6 migration guide.

2.5

Enhanced Print Request Views

  • Added button to access the origin model

  • Simplified grid view (opened from menu)

  • Added download button on all print request views

  • Better highlighting on grid views

Improved Template Library Installation

Library-installed templates are now initialized only if they meet compatibility requirements, enhancing performance.

Field Tracking

Enabled field tracking for the following models: TemplatePrintModel, TemplateSettings, TemplateSettingsLine, TemplateSettingsQueryLine, TemplateSettingsQueryLineParam.

Other Features

  • Format the payload of PrintRequest into readable JSON

  • Add hilite on template-print-model-grid based on upload status

  • Hide print button when no corresponding template is uploaded

  • Improved error handling when loading templates

More details

Please check the change log for detailed list of changes and the 2.5 migration guide.

2.4

Enhanced visibility into print requests by storing the request payload for better tracking and debugging.

Dependency Upgrades

  • Upgraded axelor-guardian to 2.3 (multi-tenancy support for license certificate path)

  • Upgraded axelor-template-library to 2.7.0

  • Upgraded axelor-utils to 3.4.0

  • Upgraded com.squareup.okhttp3:okhttp to 4.12.0

Enhanced Grid View

The template-print-model-grid has been improved with uploadStatus field display.

More details

Please check the change log for detailed list of changes and the 2.4 migration guide.

2.3

Customizable Template Print Button

Split addTemplatePrintMethod to ease extension, allowing developers to customize the template print button behavior.

The root menu Template is now positioned above Library for better navigation when Library is installed.

More details

Please check the change log for detailed list of changes and the 2.3 migration guide.

2.2

Dependency Upgrades

  • Upgraded axelor-studio to 3.3

  • Upgraded axelor-template-library to 2.4

  • Upgraded axelor-message to 3.2

  • Upgraded axelor-utils to 3.3

  • Upgraded AOP to 7.2

Recursion Depth Configuration

  • Set minimum recursion depth to 1

  • Set default recursion depth to 3

Improved Upload Status

For better UX, when the template in TemplatePrintModel view is updated, the uploadStatus is automatically set to waiting to inform the user that an upload is needed.

More details

Please check the change log for detailed list of changes and the 2.2 migration guide.

2.1

Automatic Template Settings Creation

Allow users to create template settings lines easily by uploading an ODT or DOCX template file which extracts all bindings and creates the configuration automatically.

Multi-Tenant Support

  • Updated multi-thread calls using TenantAware to support multi-tenancy

  • Added tenant ID to payload sent to Template API on document generation

Template Library Preview

From the LibraryTemplate card, a Preview button allows users to preview the template before installation.

Enhanced User Experience

  • Display missing models in a popup when reloading templates from library

  • Auto-fill template when only one possibility exists

  • Show library access errors in UI instead of console only

  • Added print date to template print history

AppTemplate Tracking

Keep track of changes made in the AppTemplate configuration page.

Configurable Depth Level

The depth of template expressions level is now configurable from the configuration page.

Security Improvements

  • Secured public endpoint with JWT validation check

  • Updated axelor-guardian to 2.1

More details

Please check the change log for detailed list of changes and the 2.1 migration guide.

2.0

This is the initial major release of the Template module with AOP 7.1 support.

A new menu entry allows listing and accessing every print request ever made.

Template Dashboards

New dashboards to view template statistics and access specific data by clicking on charts.

JWT Authentication

Manage authentication with the Gateway API using a new /auth route that returns a JWT access token.

License Integration

Connection to Template API can now be handled by reading license metadata. If there is no license, the information is read from axelor-config.properties file.

Consumption Management

  • Adapted template module to work with Template API 2.0

  • Added dashlet to monitor current consumption

  • Added tenantId header to API requests

  • Check consumption limit and display warnings

Quick Download

If the file is generated quickly, it is downloaded directly. Multiple files are downloaded as a ZIP.

No AOS Dependency

The module no longer depends on AOS, using ViewProcessor and MailMessageAction interfaces instead.

More details

Please check the change log for detailed list of changes and the 2.0 migration guide.