Page Comparison

Description

Order line grouping can be used to group similar order lines which are normally split into separate order lines by the backend. The goal of this functionality is to combine similar order lines, removing redundant order line selection and registration for the user.
When a grouped order line is selected, it can be expanded to view the individual order lines. That functionality is disabled as soon a registration has been made on either the group order line or any of the individual order lines.

See also: How-to: Group matching order lines (GroupBy) (Business Central customization example)

...

In order to enable this functionality, all order lines which should be grouped into one order line needs need to be placed in a xml XML group element, as listed below.

The grouped order line which is displayed on the order lines page , gets it's its values from the first BaseOrderLine element in the group. However, if that is not sufficient, a display order line can be added which has the element name of GroupOrderLine. If a GroupOrderLine element is added, the displayed group order line will get it's values from that order line.

Notice that the backend controls the LineNumber of the display order line if the GroupOrderLine is send sent out. If not, a unique LineNumber is automatically generated for the representation of the grouped order lines.

...

When registrations are performed on an order line group, the quantity is added on to the individual underlying order lines. So if a group order line has a Quantity of 30, where each individual order line has a Quantity of 10. Then registering 15, will add 10 to the first order line, and 5 to the next. In cases where over delivery is enabled and 40 is registered to the empty order line group, then the first two order lines will be registered with 10, and the last will receive the remaining, which in this case is 20.

As registrations will be done on the individual order lines, posting a an order line group will not differ in the request from the mobile application. Hence, no change needs to be done here. Only if the GroupOrderLine is defined with different attributes than the individual order lines.

...

The disableOnRegistration attribute dictates whether or not the toggling between grouping and individual order lines can happen after a registration in either grouped or individual mode has been made. The default is to allow it.

...

Order line grouping does not support Tote functionality, and should therefore not be used where totes are needed.
The reason for that is, that the grouped order line uses the destination from either the <GroupOrderLine/> or the first <BaseOrderLine/>, and will therefore link all registrations to that destination.

See also