Column Setup

Prev Next

Feature Overview

Column Setup controls what information appears in the line section of a printed document — the table of rows that lists the items, services, or other line entries. Each column in this table is defined individually: you choose what data to display, how wide the column should be, how it is aligned, and whether it is the primary text column, a picture column, or a barcode column. All columns together form a Column Template, which is then assigned to a document in Document Customizer Content.

A Column Template is built in two layers. The outer layer is the Columns Setup, which defines the template code, the maximum number of columns (1–12), the row height, and whether to show horizontal border lines between rows. Each column within the setup then has its own Column line (number, width, alignment, type), and each column line links to an Extended Description Fields setup that defines precisely which fields to pull from the document table — including optional lookups to related tables, multilingual captions, zero-blanking, and Command Line expressions.

Beyond the primary columns, the same mechanism supports Supplementary Columns (extra columns rendered after the main lines, e.g. for item tracking or serial/lot numbers), VAT Specification Columns (for the VAT breakdown section), VAT Specification (LCY) Columns (for a parallel LCY VAT section), Customs Tariff Columns (enabled via Feature Management), and Waybill Columns (enabled via Feature Management). Each of these is a separate Column Template assigned in Document Customizer Content.

Key Facts

Where to set up Columns Setup page; Columns page; Extended Description Fields page
Where to assign Document Customizer Content page (Columns, Supplementary Columns, VAT Specification Columns, VAT Spec. (LCY) Columns, Customs Tariff Columns, Waybill Columns fields)
Max columns per template 1–12 (set via Template Number; default is 11)
Max total width 510 pt across all columns combined
Row height Configurable per template in pt (default 20 pt)
Supported column types Standard (data), Text Column (description/extended text), Picture Column (image), Barcode Column (barcode rendering)
Automatic width adjustment One column per template can be set to auto-adjust its width based on remaining space
MDI integration "Don't print Master Data" flag on Columns Setup suppresses MDI line injection for this template

Getting Started

  1. Open Columns Setup (search for it, or navigate from Document Customizer Content → Columns action).
  2. Create a new record with a Column Setup code and a Description. Set the Template Number to match the number of columns you need (e.g. Template Number 11 gives 11 columns).
  3. Open Fields to go to the Columns page for this template. You will see one row per column (Column no. 1 through 11, or however many you chose).
  4. For each column, set the Setup code — this is the name of the Extended Description Fields configuration for that column. You can reuse the same setup code across multiple columns if they share the same field definition.
  5. Set Width (pt) for each column. The total across all columns must not exceed 510 pt. If you want one column to automatically fill the remaining space, enable Adjust Automatically on that column.
  6. Set Align (Left, Center, Right) for each column. Mark the primary description column as Text Column (only one column per template can be the Text Column).
  7. With the cursor on a column row, open Fields to go to the Extended Description Fields page for that column. Add one or more rows: select Table No (the document line table) and Field (the field to display).
  8. If you want to pull data from a related table (e.g. Item Description from the Item table), set Using Table and Using Field.
  9. Optionally set a Caption code for the column header label, and configure Blank if Zero, Add Caption To Line, or Command Line as needed.
  10. Return to Document Customizer Content, find the relevant document, and set the Columns field to your new Column Setup code. Run Test Report Layout to verify the output.

Related Features

Column Setup interacts with most other Document Customizer features. Footer & Sections can reference the same Caption pool for consistent labelling. The Captions & Translations feature provides the multilingual caption texts used as column headers and inline field labels. Line Grouping uses the Column Setup to define which column numbers carry subtotals — you reference column numbers from the active template when configuring subtotal positions. The Layout & Visual Design feature controls the row height default and border lines at the template level, and fonts globally; individual column widths and the Text Column designation complement those settings. Special Document Types such as Customs Tariff and Waybill rely on separately configured Column Templates assigned in dedicated fields in Document Customizer Content.


User Stories

US-01: Configure a standard column layout for a sales invoice

As a Business Manager
I want to set up a column template that shows Item No., Description, Quantity, Unit of Measure, Unit Price, Line Discount %, and Line Amount on printed sales invoices
So that the invoice lines present all commercially relevant information in a clean tabular format

Setup:

  1. Open Columns Setup, create a new template, e.g. SALES-STD, with Template Number 7 (seven columns).
  2. Open Fields (Columns page). For each of the 7 column rows, assign a Setup code and a Width.
  3. For each column, open the Fields action on that row to go to Extended Description Fields. Set Table No to the Sales Invoice Line table and select the relevant Field (No., Description, Quantity, Unit of Measure Code, Unit Price, Line Discount %, Line Amount).
  4. Mark the Description column as Text Column on the Columns page, and set Adjust Automatically on it so it fills available space.
  5. Assign Align = Right on the numeric columns (Quantity, Unit Price, Discount %, Line Amount); Left on the text columns.
  6. In Document Customizer Content, set Columns to SALES-STD for the Sales Invoice row.
US-02: Pull a field from a related table into a column (e.g. item's purchase price)

As a Business Manager
I want to show the item's vendor item number (from the Item table) as a column on the printed picking instruction
So that warehouse staff can cross-reference the document with vendor labelling without looking up items separately

Setup:

  1. Open the Extended Description Fields page for the relevant column.
  2. Set Table No to the document line table (e.g. Sales Line).
  3. Set Field to the Item No. field on the sales line (used as the lookup key).
  4. Set Using Table to the Item table.
  5. Set Using Field to the Vendor Item No. field on the Item table.
  6. The system will look up the item record by Item No. and display the Vendor Item No. in the column.
US-03: Suppress zero values in a numeric column

As a Business Manager
I want to leave the discount column blank when the line discount is 0%, rather than printing "0"
So that documents are cleaner and recipients are not confused by zero values in discount columns

Setup:

  1. Open the Extended Description Fields page for the discount column.
  2. Enable Blank if Zero on the field row.
  3. Save. Lines with 0% discount will now show a blank cell in that column.
US-04: Show a caption label inline in a column value (e.g. "Qty: 5")

As a Business Manager
I want to prefix the quantity value with the word "Qty:" directly in the column cell, so the column can be used without a header in certain compact document layouts
So that the document remains readable even when column headers are suppressed

Setup:

  1. Open the Extended Description Fields page for the quantity column.
  2. Assign a Caption code (e.g. a caption with translation "Qty:" in ENU and "Antal:" in DAN).
  3. Enable Add Caption To Line.
  4. Optionally enable Blank caption if no value if you do not want the "Qty:" label when there is no value.
  5. Save and run a test report to verify the inline label.
US-05: Add multiple fields to a single column (stacked lines within one cell)

As a Business Manager
I want to show both the item's Description and its Variant Code stacked in a single description column, so that variant information appears below the main description without needing an extra column
So that the document provides full product detail without widening the layout

Setup:

  1. Open the Extended Description Fields page for the description column.
  2. Add a first row with the Description field. Set Caption if desired.
  3. Add a second row with the Variant Code field.
  4. The system renders both fields one below the other within the same column cell. Set Blank caption if no value on the Variant Code row if variants are not always populated.

Note: Multiple rows in Extended Description Fields are stacked vertically within the column. The column width and row height from the Columns Setup and Layout determine how much space is available. Set the row height generously if stacking multiple lines.

US-06: Configure a picture column to show item images on a picking list

As a Business Manager
I want to include a column on the warehouse picking list that shows a small image of each item
So that pickers can visually identify items, reducing picking errors

Setup:

  1. Open the Columns page for the relevant template.
  2. On the column row designated for images, enable Picture Column. (A column can only be one type: Picture, Barcode, or Text — enabling one disables the others.)
  3. Open Fields for that column in Extended Description Fields.
  4. Set Table No to the document line table. Set Field to the Item No. field (used as the key).
  5. Set Using Table to the Item table. Set Using Field to the Picture field (MediaSet type) on the Item table.
  6. The system will retrieve and render the item picture. Control the image size via Target Image Size in Document Customizer Content (Original Size or Custom Size with a pixel limit).

Note: Only one picture is allowed per Picture Column. If multiple Extended Description Fields rows are configured for a Picture Column, the system will error. Image rendering requires JPEG or bitmap format; very large images will be automatically downscaled if Target Image Size is set.

US-07: Configure a barcode column on a picking document

As a IT Manager
I want to add a column to the picking list that renders the item's barcode so that handheld scanners can confirm picks directly from the printed document
So that pick confirmation is faster and error-free

Setup:

  1. Open the Columns page for the picking template.
  2. On the barcode column row, enable Barcode Column.
  3. Open Fields for that column and set up the field that contains the barcode value (e.g. GTIN or Cross-Reference No. from the Item table via Using Table/Field).
  4. In Document Customizer Layouts, for the relevant Layout Code and Report ID, set Barcode Type (1D or 2D), Barcode Font (e.g. Code128, EAN-13, QR-Code), and Barcode Font Size.
  5. Save and run a test report to verify the barcode renders and scans correctly.
US-08: Set one column to automatically adjust its width

As a Business Manager
I want to fix the widths of all numeric columns precisely, while letting the description column automatically fill whatever space remains up to the 510 pt total
So that the document layout always fills the full page width regardless of how I adjust the numeric columns

Setup:

  1. Open the Columns page for the template.
  2. On the description column row, enable Adjust Automatically.
  3. Set explicit widths on all other columns.
  4. The description column's width will be automatically calculated as 510 pt minus the sum of all other columns' widths. Only one column per template can have Adjust Automatically enabled.
US-09: Configure VAT Specification Columns to show a VAT breakdown section

As a Accountant
I want to display a VAT specification table at the bottom of sales invoices showing VAT base, VAT %, and VAT amount per VAT rate
So that the invoice complies with local VAT reporting requirements

Setup:

  1. Create a new Column Template specifically for VAT specification, e.g. VAT-SPEC.
  2. In the Extended Description Fields for each column, set Table No to the VAT Amount Line table and select the relevant fields (VAT Base, VAT %, VAT Amount, Amount Including VAT).
  3. For the VAT Amount column, enable Show Total so that the total VAT amount is included in the totals row.
  4. In Document Customizer Content, assign this template to the VAT Specification Columns field for the relevant document.
  5. Optionally create a separate template for VAT Spec. (LCY) Columns if you need a parallel section in the company's local currency.
US-10: Configure Supplementary Columns for serial/lot number tracking

As a Business Manager
I want to show serial and lot number tracking lines below each main document line, using a different (narrower) column layout
So that the printed shipment document provides a full item tracking appendix without cluttering the main columns

Setup:

  1. Create a new Column Template for the supplementary section, e.g. SERIAL-SUPP, using the Item Tracking Line table as the source.
  2. Define columns for Serial No., Lot No., Quantity (Handled), Expiration Date, and any other tracking fields needed.
  3. In Document Customizer Content, assign this template to the Supplementary Columns field for the relevant document.
  4. Enable Show Serial/Lot No. Appendix in Document Customizer Content to activate the appendix section on the report.

Note: The Supplementary Columns template uses the same Column/Extended Description Fields setup as the primary columns. The system renders supplementary rows indented below each parent line.

US-11: Suppress Master Data Information line injection for a specific column template

As a IT Manager
I want to prevent the Master Data Information app from adding extra lines to the column section for documents using a specific column template
So that documents that should not show MDI item attributes remain unaffected by the global MDI configuration

Setup:

  1. Open Columns Setup and select the relevant template.
  2. Enable Don't print Master Data.
  3. Save. For documents assigned this column template, MDI will not inject additional lines into the column section.

Note: This option is only visible when Master Data Information (BC682) is installed and enabled.

US-12: Copy a Column Template to create a variant for a different document type

As a Business Manager
I want to copy an existing column template as the starting point for a purchase order variant that shows different fields (e.g. Vendor Item No. instead of our Item No.)
So that I save setup time while maintaining a consistent base structure

Setup:

  1. Open Columns Setup and select the template to copy.
  2. Use the action Copy to new and enter a new template code.
  3. The system creates a complete copy including all Columns rows and their Extended Description Fields.
  4. Open the new template and modify the fields, widths, or captions as needed.
  5. Assign the new template to the target document in Document Customizer Content.
US-13: Use a Command Line expression to show a translated item description

As a IT Manager
I want to show the item description in the customer's language (from the Item Translation table) in the description column, falling back to the standard item description if no translation exists
So that international customers receive documents in their own language without manual intervention

Setup:

  1. Open Extended Description Fields for the description column.
  2. Set Table No and Field to the description field on the document line.
  3. In Command Line, build an expression using LOOKUPRECORD and GETFIELDVALUE to look up the Item Translation table using the Item No. and Language Code, returning the translated description.
  4. Use the Build Command Line action to construct and test the expression visually rather than writing it manually.
  5. Save and run a test report with a document for a customer who has a language code set up, and verify the translated description appears.

Note: If no translation is found, the Command Line will return an empty string. Add a fallback by combining the Command Line result with the standard Description field: if the lookup returns blank, the system will fall back to rendering the Description directly via the Field setting.


Field Reference

Field Where to find it What it does Default
Column Setup Columns Setup Unique code identifying this column template
Description Columns Setup Free-text description of the template
Template Number Columns Setup Number of columns (1–12); sets Number of Columns automatically 11
Number of Columns Columns Setup Maximum columns allowed in this template (read-only, set by Template Number) 11
Height (pt) Columns Setup Row height for all lines using this template 20 pt
Horizontal Border Line Columns Setup Draws a horizontal line between each row Disabled
Don't print Master Data Columns Setup Suppresses MDI line injection for this template (visible when MDI is installed) Disabled
Column no. Columns Position of the column from left to right
Setup Columns Extended Description Fields setup code for this column
Align Columns Alignment of column content: Left, Center, or Right Left
Width (pt) Columns Width of this column in points (total across all columns max 510 pt)
Text Column Columns Marks this as the primary description/text column (only one allowed per template) Disabled
Adjust Automatically Columns Column width auto-adjusts to fill remaining space (only one allowed per template) Disabled
Picture Column Columns Column renders an image instead of text Disabled
Barcode Column Columns Column renders a barcode instead of text Disabled
Table No Extended Description Fields Source table for this field's data
Field Extended Description Fields Field from Table No to display
Caption Extended Description Fields Caption code for the column header or inline label
Add Caption To Line Extended Description Fields Prints the caption as a prefix in the cell value Disabled
Blank caption if no value Extended Description Fields Suppresses the caption label when the field value is empty Disabled
Blank if Zero Extended Description Fields Shows blank instead of 0 for numeric fields Disabled
Show Total Extended Description Fields Includes this field in the document's totals row Disabled
Using Table Extended Description Fields Related table to look up when the value is not in the line table
Using Field Extended Description Fields Field in Using Table to display
Command Line Extended Description Fields Advanced expression for calculated or multi-step lookups
Hide Additional Cap. in Header Extended Description Fields Suppresses this field's caption from appearing in the column header row Disabled