Use this event to
Handle collected values during Order Posting (“Header Steps”).
Description
This event is used to handle collected "header" level steps and is executed only once per order posting from the mobile device.
Examples of use could be:
- Stage collected values to new or existing fields in the database that can subsequently can be accessed from standard posting function events.
- Validate collected values against live data since registration at the mobile device is mostly conducted offline.
- But not to process "line" level steps. Steps added via OnAddStepsToProdOrderComponent is better handled via OnPostProdConsumption_OnHandleRegistrationForProductionJnlLine-event.
Commit
Database transactions in this event is committed to database prior to calling standard BC posting routines. Your customized code must be structured accordingly.
However, since the Production Journal is used for the posting, all journal lines for the UserId is consistently disposed and recreated between each posting attempt.
Template
[EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Production Consumption", 'OnPostProdConsumption_OnBeforePostProdOrderLine', '', true, true)]
local procedure OnPostProdConsumption_OnBeforePostProdOrderLine(var _OrderValues: Record "MOB Common Element"; var _ProdOrderLine: Record "Prod. Order Line")
begin
// Add your custom code here...
// Note: OnBeforePost-events is committed to the database prior to posting. Your custom code must be structured accordingly (or use standard BC events).
end;
Example
See: Case: Add Header Signature step for inbound goods documents
More examples
-
Case: Add Header Step to inbound goods documents (Signature Step) — The warehouse employee must sign inbound goods (signature step).
-
Case: Add Header Step to inbound goods documents (Text Step) — When receiving goods, a new text collector step must be added for the user to enter comments about goods being damaged etc.
-
Case: Show G/L Account Lines and Non-Inventory Items on Receive and Pick — This case doesn't work with Warehouse Documents, Only basic Inventory on Sales and Purchase Orders.
-
How-to: Register Quantity By Multiplication (enableMultiplier) — You want to scan the Quantity multiplier and then manually type the quantity to automatically calculate the total quantity to register.
The multiplers are defined by using the "Qty. per Unit of Measure" from the barcode "Unit of Measure" in the "Item Reference". See Barcode Quantity (enableMultiplier) Example: Box (5) x 10 = 50 Pcs
-
How-to: Register Quantity By Scan — You want to scan the Quantity . Either one piece or have the system calculate quantity based on "Item Cross Reference".
-
How-to: Subscribing to standard events — You may subscribe to posting events in the Business Central base App to process collected values, or when events offered by Extension API do not fit your exact need.
Version History
| Version | Changes |
|---|---|
| MOB5.22 | Introduced |