How-to: Add Header Step for Planned Function (ImageCapture Step)

Description

Interrupts posting in Pick and adds an extra Header (ImageCapture) Step.

• Adds an extra ImageCapture step during posting of a pick.
• The collected image is then saved in Mob Wms Media Queue.
• In the Mobile Document Queue List, a PostMedia Request will  appear after adding the Header Steps - in this case, after PostPickOrder.

Behaviour on the device

To collect an Image in the step, the user will need to use the  plus sign (+) to take a picture and add an optional note before posting.

Step 1 - Create an header step

Use OnPostPickOrder_OnAddStepsToWarehouseActivityHeader to add an ImageCapture step:

    // Create an ImageCapture header step that interrupts the posting of a pick.
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Pick", 'OnPostPickOrder_OnAddStepsToWarehouseActivityHeader', '', true, true)]
    local procedure MyOnPostPickOrder_OnAddStepsToWarehouseActivityHeader(var _OrderValues: Record "MOB Common Element"; _WhseActivityHeader: Record "Warehouse Activity Header"; var _StepsElement: Record "MOB Steps Element")
    begin

        //Already collected, break to avoid adding the same new step indefinitely
        if _OrderValues.HasValue('ImageCapture') then
            exit;

        _StepsElement.Create_ImageCaptureStep(10000, 'ImageCapture', 'Take a Picture');

        _StepsElement.Set_helpLabel('Take a picture of the item');
    end;

Step 2 - Handle the header step

  // Handle the step, saving the values in the Mob Wms Media queue.

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Pick", 'OnPostPickOrder_OnBeforePostWarehouseActivityOrder', '', true, true)]

    local procedure OnPostPickOrder_OnBeforePostWarehouseActivityOrder(var _OrderValues: Record "MOB Common Element"; var _WhseActivityHeader: Record "Warehouse Activity Header")
    var
        MobWmsLanguage: Codeunit "MOB WMS Language";
        MobMedia: Codeunit "MOB WMS Media";
        ImageIdsAndNotes: Text;
    begin
        ImageIdsAndNotes := _OrderValues.GetValue('ImageCapture', true);

        if ImageIdsAndNotes = '' then
            Error(MobWmsLanguage.GetMessage('NO_PICTURE_TO_ATTACH'));

        MobMedia.AddImageToMediaQueue(ImageIdsAndNotes);
    end;

 ImageCapture Step in Pick

From BC, go to the Mobile WMS Media Queue page.

 The picture and note were saved in Mob Wms Media Queue

See also 

• Page:
  Tutorial: Create a Positive Adjustment function
• Page:
  PostPickOrder
• Page:
  Picking — The Mobile WMS app supports registering the picking of items in several different setups.
• Page:
  Pick — Customize the Pick functionality.
• Page:
  OnWhseInquiryOnCustomDocumentTypeAsXml — Handle existing or new 'Whse. Inquiry' document types as XML.
• Page:
  OnWhseInquiryOnCustomDocumentType — Handle existing or new 'Whse. Inquiry' document types.
• Page:
  OnWhseInquiry_OnAddSteps — Return extra steps based on already collected values.
• Page:
  OnUnlockOrder_OnBeforeUnlockOrder — Implement custom document locking scheme for the Mobile Device.
• Page:
  OnSynchronizePackingStations — Optional:  Synchronize master data for Package Stations from 3rd party Shipping App to Pack and Ship
• Page:
  OnSynchronizePackageTypes — Synchronize master data for Package Types from 3rd party Shipping App to Tasklet Pack and Ship
• Page:
  OnSearchOnItemSearch_OnSetFilterItem — Filter Items to be displayed on the mobile device for SearchType "ItemSearch".
• Page:
  OnSearchOnItemSearch_OnAfterSetFromItem — Modify existing response for online search 'ItemSearch' (values transferred from "Item" table).
• Page:
  OnSearchOnCustomSearchType — Implement your own custom SearchType or override standard SearchTypes.

  
  

• Page:
  OnSearchOnBinSearch_OnSetFilterBin — Filter Items to be displayed at the mobile device for SearchType = "BinSearch".
• Page:
  OnSearchOnBinSearch_OnAfterSetFromBin — Modify existing response for online search 'BinSearch' (values transferred from "Bin" table).