Line Grouping & Filtering

Prev Next

Feature Overview

Line Grouping & Line Filtering gives you control over how document lines are selected, structured, and presented in the printed output. It covers two related but distinct capabilities.

Line Filtering is a set of Boolean flags in Document Customizer Content that determine which lines appear on the document at all. You can hide lines with zero quantity, show only lines with outstanding quantity, show only lines where there is a quantity to ship, show only lines with shipped-but-not-invoiced quantity, hide lines with a zero line amount, hide lines of blank type (e.g. comment lines), or show only item-type lines. These flags operate at the report rendering level and do not affect BC data — they purely control what is printed.

Line Grouping is a more structural feature. It allows you to define a hierarchical grouping of document lines based on field values — for example, grouping lines by product category or by project code — with the system automatically inserting group headers, group subtotals, and a separate column layout for the subtotal rows. A Line Grouping Template defines the low-level grouping field, the high-level grouping field, and which column positions carry the subtotals (quantity, amount, description, etc.). Once assigned in Document Customizer Content, the report engine reorganises the lines into the defined hierarchy and renders the grouped output.

The Group Empty Bundle Values flag handles the case where assembly or bundle item lines have no individual values on sub-components — when enabled, these blank sub-component lines are grouped together rather than printed individually.

Key Facts

Where to set up Line Grouping Line Grouping Setup page (from Document Customizer Content → Line Grouping Setup action)
Where to assign Document Customizer Content → Line Grouping Template field
Line filtering flags Document Customizer Content (Show Lines with Zero Qty., Show Only Lines With Outstanding Qty., Show Lines with Qty. to Ship, Show Only Lines With Qty. Shipped not Invoiced, Hide Lines With Line Amount = 0, Hide Lines With Blank Type, Show Only Item Lines)
Grouping fields Low Level Group On Field No. and High Level Group On Field No. from the document line table
Subtotal columns Up to 6 configurable subtotal column positions (Qty, Amount, UOM, Unit Price, Discount, Description) plus a high-level text column
MDI integration Master Data Information options: No Master Data on Lines, First Line Master Data, All Master Data
Mutual exclusivity Show Only Lines With Outstanding Qty., Show Lines with Qty. to Ship, and Show Only Lines With Qty. Shipped not Invoiced are mutually exclusive

Getting Started

Configuring Line Filtering (no setup required — flag-based):

  1. Open Document Customizer Content and find the relevant document row.
  2. Enable the appropriate filtering flags based on your requirements (e.g. enable Show Only Lines With Outstanding Quantity > 0 for a picking list that should only show unshipped lines).
  3. Run Test Report Layout to verify the filtered output.

Configuring Line Grouping:

  1. Open Document Customizer Content, find the relevant document, and navigate to Line Grouping Setup from the action bar.
  2. Create a new Line Grouping Template record. Set Table No. to the document line table.
  3. Set Low Level Group On Field No. to the field you want to group lines by (e.g. Product Group Code on Sales Invoice Line).
  4. Optionally set High Level Group On Field No. for a second-level grouping (e.g. Division).
  5. Set Columns Template to the Column Template that defines the subtotal row layout.
  6. Configure the subtotal column numbers: Subtotal Descr. Column No., Subtotal Qty. Column No., Subtotal Amount Column No., etc. — these reference column positions in the Columns Template.
  7. Return to Document Customizer Content and set Line Grouping Template to the template you just created.
  8. Run a test report to verify the grouping structure.

Related Features

Line Grouping & Line Filtering work directly with Column Setup: the grouping template references column numbers from the active Columns Template to place subtotals in the right columns. The Header Setup and Footer & Sections features are unaffected by line grouping. When Master Data Information (MDI) is installed, the Line Grouping Setup has an additional Master Data Information option that controls whether MDI item data is shown on no lines, the first line only per group, or all lines. The Line Filtering flags interact with the Show Assembly Components and Show Assembly BOM flags in Document Customizer Content, which are separate toggles that expand assembly-related sub-lines.


User Stories

US-01: Hide lines with zero quantity on a sales order confirmation

As a Sales Order Processor
I want to suppress lines where the outstanding quantity is zero from the printed sales order confirmation
So that the customer only sees items that are actually being delivered, not previously completed lines

Setup:

  1. Open Document Customizer Content for the Sales Order Confirmation row.
  2. Enable Show Only Lines With Outstanding Quantity > 0.
  3. Save. Lines with Outstanding Quantity = 0 will no longer appear on the printed document.

Note: This flag is mutually exclusive with Show Lines with Qty. to Ship and Show Only Lines With Qty. Shipped not Invoiced. Enabling one will automatically disable the others.

US-02: Print only the lines ready to ship on a picking document

As a Sales Order Processor
I want to show only lines where there is a positive Qty. to Ship on the picking instruction
So that the picker focuses only on the items to be picked in this shipment, not on back-ordered lines

Setup:

  1. In Document Customizer Content for the Pick Instruction row.
  2. Enable Show Only Lines with Qty. to Ship > 0.
  3. Save and run a test with an order that has partial quantities.
US-03: Suppress comment lines (blank type) from a customer-facing invoice

As a Business Manager
I want to hide all lines of blank type (comment lines) from printed invoices so that internal notes added to the sales order do not appear on the customer copy
So that the invoice is clean and professional without internal commentary

Setup:

  1. In Document Customizer Content for the Sales Invoice row.
  2. Enable Hide Lines With Blank Type.
  3. Save. Lines where the Type field is blank will no longer print.

Note: If you also want the column setup to handle blank-type lines differently when they are visible (e.g. show only the description without amounts), use the Use Column Setup For Lines With Blank Type flag instead.

US-04: Show lines with zero amounts (e.g. free-of-charge items)

As a Business Manager
I want to ensure that lines with a line amount of zero still appear on the invoice, since some items are deliberately free of charge as part of a promotion
So that the customer can see all items included in the order, even those at no cost

Setup:

  1. In Document Customizer Content for the Sales Invoice row.
  2. Ensure Hide Lines With Line Amount = 0 is disabled (it is disabled by default).
  3. To force zero-quantity lines to also appear, enable Show Lines with Zero Qty. if needed.
US-05: Group invoice lines by product category with subtotals per group

As a Business Manager
I want to print sales invoice lines grouped by product category (e.g. Hardware, Software, Services) with a subtotal line at the end of each group
So that the customer gets a clear breakdown of the invoice by type of purchase

Setup:

  1. Open Document Customizer Content for the Sales Invoice row and navigate to Line Grouping Setup.
  2. Create a new template (e.g. CATEGORY-GROUP). Set Table No. to the Sales Invoice Line table.
  3. Set Low Level Group On Field No. to the Product Group Code (or Type, or another category field) on Sales Invoice Line.
  4. Set Columns Template to the column setup used for subtotal rows.
  5. Set Subtotal Descr. Column No. to the column where the category label should appear, and Subtotal Amount Column No. to the column where the subtotal amount should appear.
  6. Set SubTotal/HighLevel Text Column to the column that shows the group label.
  7. Return to Document Customizer Content and set Line Grouping Template to CATEGORY-GROUP.
US-06: Add a second-level grouping for invoices with department and category breakdowns

As a Business Manager
I want to group invoice lines first by department (high level) and then by product category within each department (low level), with subtotals at both levels
So that complex invoices with multiple departments are structured and easy to review

Setup:

  1. In the Line Grouping Setup template, set High Level Group On Field No. to the department field on the line table.
  2. Set Low Level Group On Field No. to the product category field.
  3. Set Subtotal Group On Field No. to the same field as High Level if you want subtotals to reset at the department level (this is set automatically when High Level is configured).
  4. Configure subtotal column numbers for both levels.
  5. Assign the template in Document Customizer Content.
US-07: Group empty bundle component lines together instead of printing them individually

As a Business Manager
I want to prevent assembly/bundle sub-component lines that have no individual values from being printed as separate blank rows
So that the document is compact and the bundle is presented as a single unit

Setup:

  1. In Document Customizer Content for the relevant document.
  2. Enable Group Empty Bundle Values.
  3. Save. Sub-component lines with blank values will be aggregated rather than printed individually.
US-08: Control how MDI item data appears on grouped lines

As a IT Manager
I want to show Master Data Information item attributes only on the first line of each group, not on every individual line, so that the grouped view remains compact
So that item attributes from MDI appear once per product group entry rather than repeating for every sub-line

Setup:

  1. In the Line Grouping Setup template, set Master Data Information to First Line Master Data.
  2. Save. MDI data will be rendered on the first line of each group only.

Note: Options are: No Master Data on Lines (MDI suppressed entirely on lines), First Line Master Data (MDI on first line per group only), All Master Data (MDI on every line). This option is only available when MDI is installed.

US-09: Show assembly BOM components below parent lines on a production order

As a Business Manager
I want to expand assembly BOM components below each parent assembly item on the production order printout
So that production staff can see the full list of components required for each assembly without looking up the BOM separately

Setup:

  1. In Document Customizer Content for the Assembly Order row.
  2. Enable Show Assembly BOM.
  3. Save. Components from the assembly BOM will be printed as indented sub-lines below each assembly parent line.

Note: Show Assembly Components from Assembly Order is a separate flag that pulls live component demand from the assembly order (as-requested), while Show Assembly BOM expands the standard BOM definition. Use the appropriate flag depending on whether you need live demand or the standard BOM structure.

US-10: Show serial and lot number tracking lines as a supplementary appendix

As a Business Manager
I want to print item tracking detail (serial numbers, lot numbers, quantities) as an appendix section after the main document lines on the sales shipment
So that the shipping document serves as a tracking confirmation that can be signed and retained

Setup:

  1. Create a Supplementary Columns template targeting the Item Tracking Line table (configure fields for Serial No., Lot No., Quantity).
  2. In Document Customizer Content for the Sales Shipment, set Supplementary Columns to this template.
  3. Enable Show Serial/Lot No./Package No. Appendix.
  4. Optionally enable Hide Qty. in Serial/Lot No. if you want to suppress the quantity from the tracking appendix.
  5. Save and run a test with a shipment that has item tracking entries.

Field Reference

Field Where to find it What it does Default
Lines Grouping Template Line Grouping Setup Unique code identifying this grouping configuration
Table No. Line Grouping Setup Document line table to group (e.g. Sales Invoice Line)
Low Level Group On Field No. Line Grouping Setup Field used for the primary (innermost) grouping of lines
High Level Group On Field No. Line Grouping Setup Field used for the secondary (outer) grouping level
Subtotal Group On Field No. Line Grouping Setup Field at which subtotals reset; defaults to High Level field
Columns Template Line Grouping Setup Column Setup used for rendering group header and subtotal rows
Subtotal Descr. Column No. Line Grouping Setup Column position for the group/subtotal description label
Subtotal Qty. Column No. Line Grouping Setup Column position for the subtotal quantity
Subtotal Amount Column No. Line Grouping Setup Column position for the subtotal amount
Subtotal UOM Column No. Line Grouping Setup Column position for the subtotal unit of measure
Subtotal U.Price Column No. Line Grouping Setup Column position for the subtotal unit price
Subtotal Line Disc. Column No. Line Grouping Setup Column position for the subtotal line discount
SubTotal/HighLevel Text Column Line Grouping Setup Column for the high-level group label text
LowLevel Text Column No. Line Grouping Setup Column for the low-level group label text
Master Data Information Line Grouping Setup MDI rendering: No MDI, First Line only, or All Lines (visible when MDI installed) No MDI
Line Grouping Template Document Customizer Content Assigns a Line Grouping Template to this document Blank
Group Empty Bundle Values Document Customizer Content Groups blank-value assembly sub-components instead of printing them individually Disabled
Show Lines with Zero Qty. Document Customizer Content Shows lines where quantity = 0 Disabled
Show Only Lines With Outstanding Qty. > 0 Document Customizer Content Hides lines where outstanding quantity = 0 Disabled
Show Lines with Qty. to Ship > 0 Document Customizer Content Shows only lines with a positive Qty. to Ship Disabled
Show Only Lines With Qty. Shipped not Invoiced > 0 Document Customizer Content Shows only lines with shipped-but-not-invoiced quantity Disabled
Hide Lines With Line Amount = 0 Document Customizer Content Suppresses lines where the line amount is zero Disabled
Hide Lines With Blank Type Document Customizer Content Suppresses lines where the line type is blank (comment lines) Disabled
Use Column Setup For Lines With Blank Type Document Customizer Content Applies the column setup to blank-type lines instead of using the default description-only rendering Disabled
Show Only Item Lines Document Customizer Content Shows only lines of type Item Disabled
Show Assembly Components from Assembly Order Document Customizer Content Expands assembly components from the live assembly order demand Disabled
Show Assembly BOM Document Customizer Content Expands assembly BOM components below parent lines Disabled
Show Serial/Lot No./Package No. Appendix Document Customizer Content Activates the supplementary tracking appendix section Disabled
Hide Qty. in Serial/Lot No. Document Customizer Content Suppresses quantity from the tracking appendix Disabled