Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Use this event to

Excerpt

Add steps to be displayed at the mobile device when collecting values for indented lines representing 'Consumption'

 (derived from Assembly Line).

Description

...

New steps defined at line level (collected for

...

each individual line) are merged with steps from your existing workflow defined in application.cfg 

You may add custom steps using either the _Steps-parameter or a ConfigurationKey (to be declared in Reference Data).

...

This is unlike steps at header level, that allows "on posting" steps to be declared directly in the OnGetAssemblyOrderLines_OnAddStepsToAssemblyHeader event.

Line-level steps are:

  • ...declared as part of a collectorConfiguration-Key in Reference Data.
  • ...added by calling the Create_StepsByReferenceDataKey-function (Currently only once)
  • ...sorted by Id. Sorting can be changed using the <orderLineConfiguration><extraInformationConfiguration stepSorting="ById"/><orderLineConfiguration/> in mobile configuration.

(warning) Currently Mobile WMS supports only one (custom) referenced key per Order Line, meaning only one customization may subscribe to this event at any time. This single one subscriber must set a Key that includes all steps for all other intended subscribers as well. This can only be done by knowing other customizations are in place and manually create a new RegistrationCollectorConfigurationKey that includes all steps (this will improve in a future version). 
Using the _Steps-parameter is the easiest and most flexible, but you may consider using a ConfigurationKey when performance or backwards compatibility with older Android Apps is more important to you.


Using _Steps-parameterUsing ConfigurationKey from ReferenceData
Easier syntax (Steps defined on-the-fly)More difficult to use (requires ConfigurationKey in ReferenceData)
Multiple subscribers to same OnAddSteps event is possible

Only a single subscriber must exist to same OnAddSteps event

Performance cost per step added to order linesNo performance cost per additional step
Minimum requirements are Mobile WMS 5.39 and Android App 1.8
Minimum requirement is Mobile WMS 5.24


Collected values for Steps created from this event is best handled in the 
OnPostAssemblyOrder_OnHandleRegistrationForAssemblyLine event.

Template

        [EventSubscriber(ObjectType::Codeunit,  Codeunit::"MOB WMS AssemblyMOB WMS Assembly",  'OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine',  '',  truetrue,  truetrue)]
        local procedure OnGetAssemblyOrderLines OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine(_AssemblyLine:  Record  "Assembly LineAssembly Line";   _TrackingSpecification:  Record  "Tracking SpecificationTracking Specification";  var  _BaseOrderLineElementRecord "MOB Ns BaseDataModel Element: Record "MOB Ns BaseDataModel Element"; var _Steps: Record "MOB Steps Element")
        begin
        end;


Example

...

1: Add line steps by using _Steps-parameter

    // Prerequisites: Mobile WMS 5.39 and Android App 1.8
    [EventSubscriber(ObjectType::Codeunit,  Codeunit::"MOB WMS AssemblyMOB WMS Assembly",  'OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine',  '',  truetrue,  truetrue)]
        local procedure MyOnGetAssemblyOrderLines My01OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine(_AssemblyLine:  Record  "Assembly LineAssembly Line";   _TrackingSpecification:  Record  "Tracking SpecificationTracking Specification";  var  _BaseOrderLineElementRecord "MOB Ns BaseDataModel Element: Record "MOB NS BaseDataModel Element"; var _Steps: Record "MOB Steps Element")
    begin
        // Text lines and Resource lines may be enabled by customization
        if _AssemblyLine.Type = _AssemblyLine.Type::Item then
                begin
        // if not (_BaseOrderLineElement.Get_UnitOfMeasure() in ['KG', 'GR']) then  // Example: Condition based on input
        //     exit;

        _Steps.Create_DecimalStep(10000, 'CustomGrossWeightGrams');
        _Steps.Set_header('Gross Weight (Grams)');
        _Steps.Set_label('Gross Weight (Grams):');
        _Steps.Set_helpLabel('Gross Weight in Grams per Base Unit of Measure');
        _Steps.Set_minValue(0);
        _Steps.Set_maxValue(100000);
        _Steps.Set_performCalculation(true);
    end;


Example 2: Add line steps by referencing a ConfigurationKey from ReferenceData

Note

Currently Mobile WMS supports only one (custom) referenced key per Order Line, meaning only one customization may create StepsByReferenceDataKey at any time. This single one subscriber must set a Key that includes all steps for all other intended subscribers as well. This can only be done by knowing other customizations are in place and manually create a new RegistrationCollectorConfigurationKey that includes all steps.

    // Prerequisites: Mobile WMS 5.11
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Assembly", 'OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine', '', true, true)]
    localprocedure My02OnGetAssemblyOrderLines_OnAddStepsToConsumptionLine(_AssemblyLine: Record "Assembly Line"; _TrackingSpecification: Record "Tracking Specification"; var _BaseOrderLineElement: Record "MOB NS BaseDataModel Element")
    begin
        _BaseOrderLineElement.Create_StepsByReferenceDataKey('CustomAssemblyConsumptionSteps', true);
    end;    );

        // Example: Modify attribute values for steps defined by the ReferenceDataKey used above (i.e. defaultValue)
        // See: https://taskletfactory.atlassian.net/wiki/display/TFSK/How-to:+Modify+Custom+Line+Step+dynamically
    end;

    [EventSubscriber(ObjectType::Codeunit,  Codeunit::"MOB WMS Reference DataMOB WMS Reference Data",  'OnGetReferenceData_OnAddRegistrationCollectorConfigurations',  '',  truetrue,  truetrue)]
        local procedure MyOnGetReferenceData My02OnGetReferenceData_OnAddRegistrationCollectorConfigurations(var  _Steps:  Record  "MOB Steps ElementMOB Steps Element")
        begin
                _Steps.InitConfigurationKey('CustomAssemblyOutputStepsCustomAssemblyConsumptionSteps');

        _Steps.Create_DecimalStep(1000020000,  'CustomGrossWeightGramsCustomNetWeightGrams');
                _Steps.Set_header('Gross Weight Net Weight (Grams)');
                _Steps.Set_label('Gross Weight Net Weight (Grams):');
                _Steps.Set_helpLabel('Total Gross Weight in GramsNet Weight in Grams per Base Unit of Measure');
                _Steps.Set_minValue(0);
                _Steps.Set_maxValue(100000);
                _Steps.Set_performCalculation(true);
    end;    end;

Sorting Steps for order lines

Steps are generally sorted by Id. This can be changed using the <orderLineConfiguration><extraInformationConfiguration stepSorting="ById"/><orderLineConfiguration/> in application.cfg


Filter by label (Content by label)
showLabelsfalse
showSpacefalse
sorttitlemodified
reversetrue
titleMore examples
excerptTypesimple
cqllabel = "bc" and label = "assemblyorderlines" and label = "example" and label = "onaddstepsonaddstepsto"

...


Version History

VersionChanges
MOB5.24Introduced
MOB5.39New _Steps parameter introduced