Report Templates & Multi-layout

Prev Next

Feature Overview

Report Templates & Multi-Layout is the feature that enables multiple distinct configurations of the same printed document to coexist and be selected automatically based on context. It operates across two dimensions: Report Templates differentiate the content setup (header, columns, footer, line behaviour) for a single report; Layout Codes differentiate the visual presentation (fonts, colours, logo, address position) for the same report. These two dimensions are independent and combinable.

A Report Template is a variant identifier on the Document Customizer Content table. Every report can have multiple content configurations, each with a different Report Template code. For example, a sales invoice might have a standard template and a copy template (with a "COPY" watermark), or a domestic template and an export template (with different columns or footer content). One template per report is flagged as the Default Report Template — this is the one used for normal printing. The Default Report Setup table allows you to route specific documents (by customer, responsibility center, or other key values) to a non-default template or layout automatically.

A Layout Code on the Layouts page differentiates visual configurations. Multiple layouts can exist per report; one is the Default Report Layout. Just as Report Templates can be assigned per customer via Default Report Setup, Layout Codes can also be specified in Default Report Setup, enabling per-customer or per-responsibility-center visual branding.

When a document is printed, the system runs through a priority hierarchy to determine which content configuration and which layout to apply. The SubstituteReport event subscriber intercepts the print job and redirects the standard BC report to the appropriate Document Customizer report; the layout and template are then resolved from Report Options and Report Content using the Default Report Setup and the document context.

Key Facts

Report Template Code on Document Customizer Content distinguishing content variants for the same report
Default Report Template Flag on Document Customizer Content; the template used unless overridden by Default Report Setup
Layout Code Code on Document Customizer Layouts distinguishing visual variants for the same report
Default Report Layout Flag on Document Customizer Layouts; the layout used unless a more specific match exists
Default Report Setup Links a specific document key (customer, responsibility center) to a specific template and/or layout
Where to configure Default Report Setup Accessible from Document pages via Document Customizer extensions (Customer Card, Vendor Card, Sales Invoice, etc.)
Copy function Document Customizer Content supports copying a template to a new template code
Import/Export Setup export/import supports exporting specific report configurations for migration between environments

Getting Started

Creating a second Report Template for an existing report:

  1. Open Document Customizer Content and find the document row you want to create a variant for.
  2. Use the action Copy to new and enter a new template code (e.g. COPY) and a description (e.g. "Invoice - Copy").
  3. Modify the copied configuration: for example, change the title caption to a "COPY" variant, or assign a background image with a "COPY" watermark.
  4. The original template remains the default (Default Report Template = true). The new template is available for explicit assignment via Default Report Setup.

Setting up automatic template selection per customer:

  1. Open the Customer Card for the customer who should receive a different template.
  2. In the Document Customizer factbox or action, navigate to Default Report Setup for that customer.
  3. Select the Report No., the Layout Code (if different from default), and the Report Template to use for this customer.
  4. Documents printed for this customer will automatically use the specified template and layout.

Related Features

Report Templates and Multi-Layout sit at the top of the Document Customizer configuration hierarchy — they govern which specific combination of Header, Column, Footer, Layout, and Address settings is applied to each print job. All other features (Header Setup, Column Setup, Footer & Sections, Layout & Visual Design, Captions & Translations, Address Setup) provide the building blocks; Report Templates and Default Report Setup determine which block combination is used per document, per customer, or per responsibility center. The Import/Export functionality allows specific report configurations to be exported as XML for transfer between environments.


User Stories

US-01: Create a "Copy" invoice template with a watermark distinguishing it from the original

As a Business Manager
I want to have a copy version of the sales invoice that adds a "COPY" watermark or label, which can be sent to customers who request a reprint
So that copies are clearly distinguished from originals and cannot be used for duplicate payment

Setup:

  1. In Document Customizer Content, select the standard Sales Invoice row and use Copy to new. Enter template code COPY, description "Invoice Copy".
  2. In the new template, assign a Layout Code that has a "COPY" background image, or modify the title caption to include the word "Copy".
  3. Leave the original template as Default Report Template.
  4. Use Default Report Setup or print the Copy template manually when a reprint is needed.
US-02: Create separate invoice templates for domestic and export customers

As a Business Manager
I want to use a domestic invoice template that shows local payment terms and a DKK bank account, and an export invoice template that shows international payment terms, IBAN, and SWIFT code
So that each customer type receives appropriately formatted documents

Setup:

  1. Create two Report Templates in Document Customizer Content for the Sales Invoice:
    • Template DOMESTIC: configure with DKK bank account footer, domestic payment terms footer, and local columns.
    • Template EXPORT: configure with IBAN/SWIFT footer, international terms, and column setup including currency.
  2. Set DOMESTIC as Default Report Template.
  3. For each export customer, open Default Report Setup and assign template EXPORT and the relevant Layout Code.
US-03: Set a specific layout and template for a customer

As a IT Manager
I want to configure a specific customer to always receive invoices with our "Brand-B" layout and the "EXPORT" template, without any manual intervention at the time of printing
So that documents for that customer are consistently formatted according to their agreement

Setup:

  1. Open the Customer Card for the relevant customer.
  2. Navigate to the Document Customizer section and open Default Report Setup for the Sales Invoice report.
  3. Set Report No. to the Sales Invoice, Layout Code to BRAND-B, Report Template to EXPORT.
  4. Save. The next time an invoice is printed for this customer, the system automatically selects the configured template and layout.
US-04: Assign a different layout per Responsibility Center

As a IT Manager
I want to use a distinct branded layout for the Copenhagen Responsibility Center and a different one for the Aarhus center, so that documents issued from each office carry the correct regional branding
So that regional offices' documents are visually distinct without requiring any manual selection by users

Setup:

  1. Create two Layout records in Document Customizer Layouts:
    • Layout Code CPH: Copenhagen branding (logo, colours).
    • Layout Code AAR: Aarhus branding.
  2. Open Default Report Setup for the relevant report, scoped to Responsibility Center CPH, and set Layout Code to CPH. Repeat for AAR.
  3. Documents printed from each Responsibility Center will automatically use the correct layout.
US-05: Use the Default Report Template flag to control which template is the standard

As a Business Manager
I want to switch the default invoice template from STANDARD to NEW-DESIGN after our rebranding, so that all new prints use the new design automatically
So that no user action is required to start using the new template

Setup:

  1. In Document Customizer Content, find the NEW-DESIGN template row for the Sales Invoice.
  2. Enable Default Report Template on the NEW-DESIGN row.
  3. The system automatically clears the flag on the previous default template.
  4. All future prints that do not have a specific Default Report Setup entry will now use NEW-DESIGN.
US-06: Export a specific report configuration to migrate it to another environment

As a IT Manager
I want to export the complete Document Customizer setup for the Sales Invoice — including all templates, layouts, and their associated header, column, and footer configurations — so that I can import it into the production environment after testing
So that the testing and production environments stay in sync without manual re-entry

Setup:

  1. Open Document Customizer and navigate to Import/Export Setup (enable via Feature Management if not visible).
  2. Use Export Specific Setup to export only the Sales Invoice report rows, or use Export Setup to export all configuration.
  3. In the target environment, use Import Specific Setup or Import Setup to load the exported file.

Note: The export/import does not support all fields — verify the imported setup and check any fields that may need manual correction. The import adds new records but cannot delete existing ones.

US-07: Activate a Document Customizer report as the standard report

As a Business Manager
I want to replace BC's standard Sales Invoice report with the Document Customizer version so that all invoice printouts use Document Customizer automatically
So that the custom layout takes effect for all users without requiring any per-user configuration

Setup:

  1. Open Document Customizer and find the Sales Invoice row.
  2. Select the row and use the action Set as standard report.
  3. The system registers the Document Customizer Sales Invoice as the default in BC's Report Selections. The original BC report is stored and will be restored if you use Remove as standard report.
US-08: Remove a Document Customizer report from standard report selections

As a Business Manager
I want to temporarily revert to the standard BC sales invoice layout while we work on a new Document Customizer design
So that customers still receive invoices without interruption while we reconfigure Document Customizer

Setup:

  1. Open Document Customizer and find the Sales Invoice row.
  2. Use the action Remove as standard report.
  3. BC's default Sales Invoice report will be restored in Report Selections. Document Customizer remains configured and can be re-activated later using Set as standard report.
US-09: Run the Dynamic Document Setup Guide to configure a new report

As a IT Manager
I want to use the guided setup wizard to configure the basic content and layout for a report I am adding to Document Customizer for the first time
So that the initial setup is faster and I am prompted for all required settings in the right order

Setup:

  1. Open Document Customizer and select the report you want to set up.
  2. Use the action Run Setup Guide.
  3. The Dynamic Document Setup Guide walks you through assigning a Header Template, Column Template, Footer, and Layout for the selected report.
  4. Complete the guide. The settings are saved to Document Customizer Content and Layouts.

Field Reference

Field Where to find it What it does Default
Report Template Document Customizer Content Code distinguishing this content variant from others for the same report Blank
Description Document Customizer Content Free-text description of this template variant
Default Report Template Document Customizer Content Marks this as the standard template for the report (only one per report) Auto on insert
Active as Default Report Document Customizer Content Indicates whether this report/template is currently active as the BC standard report Read-only
Layout Code Document Customizer Layouts Code distinguishing this visual variant from others for the same report Blank
Default Report Layout Document Customizer Layouts Marks this as the fallback layout for the report (only one per report) Auto on insert
Report No. Default Report Setup The Document Customizer report this setup entry applies to
Layout Code Default Report Setup The Layout Code to use for documents matching this setup entry
Report Template Default Report Setup The Report Template to use for documents matching this setup entry
Description Default Report Setup Auto-populated from the matched Report Content description
Alternative VAT Spec. Currency (LCY) Default Report Setup Override currency for the VAT Specification (LCY) section on matched documents