Use this event to
Add steps to be displayed on the mobile device when collecting values for each individual document line.
Description
Steps at line level (collected for each individual line) requires a collectorConfiguration-Key to be declared in Reference Data.
This is unlike steps at header level, that allows steps to be declared directly in the OnGetPhysInvtRecordingLines_OnAddStepsToPhysInvtRecordHeader event.
- Use OnGetReferenceData_OnAddRegistrationCollectorConfiguration to define a Collector configuration key.
Line-level step are:
- ..merged with existing workflow steps
- ..declared as part of Reference Data
- ..added by calling the Create_StepsByReferenceDataKey-function
- ..sorted by Id. Sorting can be changed using the
<orderLineConfiguration><extraInformationConfiguration stepSorting="ById"/><orderLineConfiguration/>
in mobile configuration.
Only one key per order line:
- You can have multiple keys with different steps. But just one key can be assigned to a line.
- So you might need to create multiple keys, for the unique combinations of steps you want to collect.
Template
[EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Phys Invt Recording", 'OnGetPhysInvtRecordingLines_OnAddStepsToPhysInvtRecordLine', '', true, true)]
local procedure OnGetPhysInvtRecordingLines_OnAddStepsToPhysInvtRecordLine(_PhysInvtRecordLine: Record "Phys. Invt. Record Line"; var _BaseOrderLineElement: Record "MOB NS BaseDataModel Element")
begin
end;
// [Example]: Add steps referenced by new RegistrationCollectorConfiguration-Key to line steps collectors
[EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Phys Invt Recording", 'OnGetPhysInvtRecordingLines_OnAddStepsToPhysInvtRecordLine', '', true, true)]
local procedure MyOnGetPhysInvtRecordingLines_OnAddStepsToPhysInvtRecordLine(_PhysInvtRecordLine: Record "Phys. Invt. Record Line"; var _BaseOrderLineElement: Record "MOB NS BaseDataModel Element")
begin
_BaseOrderLineElement.Create_StepsByReferenceDataKey('CustomCountSteps');
end;
[EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Reference Data", 'OnGetReferenceData_OnAddRegistrationCollectorConfigurations', '', true, true)]
local procedure MyOnGetReferenceData_OnAddRegistrationCollectorConfigurations(var _Steps: Record "MOB Steps Element")
begin
_Steps.InitConfigurationKey('CustomCountSteps');
_Steps.Create_DecimalStep(10000, 'CustomNetWeightGrams');
_Steps.Set_header('Net Weight (Grams)');
_Steps.Set_label('Net Weight (Grams):');
_Steps.Set_helpLabel('Net Weight in Grams per Base Unit of Measure');
_Steps.Set_minValue(0);
_Steps.Set_maxValue(100000);
_Steps.Set_performCalculation(true);
end;
Examples
-
Case: Add Line Steps to Warehouse Receipts — A customer wishes to start using Item NetWeight and -GrossWeight, but have currently no values registered at the Item Card. Create a temporary customization is to collect these weights when goods are received.
-
Case: Scan ExpirationDate in custom format — Scan ExpirationDate as custom format YYYYMM when goods is received from any Vendor.
-
Case: Use your own custom Item Barcode table — A customer wishes to start using there own Item Barcode table when scanning Items on the mobile device.
-
-
How-to: Online Validation for Line step — Online Validation on Steps can instantly validate the user data, with a call to BC.
Version History
Version | Changes |
---|---|
MOB5.19 | Introduced |