Sum numerical attribute (Shipment)
See also: Sum numeric attribute, Sum numeric attribute (Order)
Event action – Abstract
Purpose: This function aggregates, for one or more Line item types in a shipment, the individual values for a selected Numeric types in a Source Level of the line item hierarchy to calculate subtotals for the line items of a parent Target level. The subtotals are assigned as a value (value) to the (aggregated) numeric attribute of the same number type in the Target level.
The Sum numerical attribute (Shipment) event action creates subtotals for the numeric attribute values for exactly one Numeric types selected by Type within the item hierarchy of a reference object of the Shipments type.
For each line item of a selectable Target level (target item), a subtotal is determined that combines all single values from a selectable subordinate Source level. The summary of single values from the direct or indirect sub line items is assigned as a value to the aggregated numeric attribute for the same Numeric types at the Target level. A value existing at the target item will be overwritten. The subtotal is rounded or not depending on the setting for the Decimal places parameter.
CAUTION
If the subhierarchy below a certain target item does not contain any values in the Source Level for the Numeric types to be summarized, then the value 0 is assigned for the target item.
Source leveland Target levelcan be identified in either an absolute or relative way to the lowest hierarchy level (see 'Configuration'). Under certain circumstances, the header level of the reference object can also serve as theTarget level.
►NOTE◄ Regardless of whether absolute or relative references are used, the Target level must effectively always be above the Source level, otherwise no aggregation takes place.
The Line item types parameter defines by multiple selection a positive list for the line item types relevant for the aggregation. Without specifications for the Line item type, only line items of the 'Default' (DEFAULT) type are considered relevant.
The Sum numeric attribute event action processes only the volatile data of the reference object and does not save it.
Specific variants of this event action are provided for the entity types Common business object and Orders, which work according to the same principles.
►NOTE◄ An illustrative runtime example can be found on the page for the entity type Common business object:
Configuration
The event action Sum numeric attribute expects a shipment (see Shipments) as the reference object. In the context of entities of other types, the event action has no effect without an error occurring at runtime.
|
As a required field, the Type statically determines by single selection the Numeric types of the attributes whose values are to be summed up. The Target level parameter uses a positive or negative integer index to define the hierarchy level for which subtotals are to be calculated:
The Source level parameter uses a positive or negative integer index to define the hierarchy level in which to search for single values for the Numeric types:
Decimal places defines if and how the total is rounded:
The relevant Line item types for the calculation can be qualified by multiple selection. |
|
|
►NOTE◄ In Lobster Data Platform / Orchestration, each Line item type creates an independent line item hierarchy, so that the subtotals always summarize only single values for the same Line item type. If several Line item types are selected as relevant, then the entire event handling calculation procedure is repeated sequentially for each relevant Line item type. Therefore, the following aspects have to be considered:
|
|
