Versions Compared

Key

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

Use this event to

Excerpt

Handle a Lookup request for a custom LookupType unhandled by the standard Mobile WMS application.

...

Use this event to

Excerpt

Handle a Lookup request for a custom LookupType using XmlDom.


Requires corresponding changes to Application.cfg to generate a Lookup-request including a new custom LookupType. 


If you are using MOB5.29 (or newer) consider using the OnLookupOnCustomLookupType event instead.
If you are using MOB5.21 -MOB5.28 consider using the (Legacy) OnLookupOnCustomLookupType (MOB5.21 - MOB5.28) event instead.

Sample request

<request name="Lookup" created="2018-12-06T15:23:00+01:00" xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Request">
     <requestData name="Lookup">
          <ItemNumber>1980-s</ItemNumber>
          <LookupType>MyCustomSubstituteItems</LookupType>
    </requestData>
</request>

Template

        [EventSubscriber(ObjectType::CodeunitCodeunit::"MOB WMS Lookup", 'OnLookupOnCustomLookupTypeAsXml''', true, true)]
    local procedure OnLookupOnCustomLookupTypeAsXml(var _XmlRequestDoc: XmlDocument; _LookupType: Text[50]; var _XmlResultDoc: XmlDocumentvar _IsHandled: Boolean)
    begin
    end;


Example

    [EventSubscriber(ObjectType::CodeunitCodeunit::"MOB WMS Lookup", 'OnLookupOnCustomLookupTypeAsXml''', true, true)]
    local procedure MyOnLookupOnCustomLookupTypeAsXml(var _XmlRequestDoc: XmlDocument; _LookupType: Text[50]; var _XmlResultDoc: XmlDocumentvar _IsHandled: Boolean)
    begin
        if _LookupType = 'MyCustomSubstituteItems' then begin
            if _IsHandled then
                exit;

            MyCustomLookupSubstituteItems(_XmlRequestDoc, _XmlResultDoc);

            _IsHandled := true;
        end;
    end;

    local procedure MyCustomLookupSubstituteItems(_XmlRequestDoc: XmlDocumentvar _XmlResultDoc: XmlDocument);
    var
        ItemSubstitution: Record "Item Substitution";
        TempLookupResponseElement: Record "MOB NS WhseInquery Element" temporary;
        MobWmsLookup        MobWmsLookupCodeunit "MOB WMS Lookup";
        MobWMSToolbox        MobToolboxCodeunit "MOB WMS ToolboxMOB Toolbox";
        MobBaseToolbox        MobWmsToolboxCodeunit "MOB ToolboxMOB WMS Toolbox";
        MobXmlMgt: Codeunit "MOB Xml Management";
        XmlResponseData: XmlNode;
        XmlRequestNode: XmlNode;
        XmlRequestDataNode: XmlNode;
        XmlParameterNode: XmlNode;
        ItemNumber: Code[20];
        VariantCode: Code[10];
    begin

        // Extract any parameters from the XML
        // The parameters are located in the <requestData> element
        // The "Lookup bin content" supplies two parameters:
        // Location and Bin
        // The names of the XML elements are determined by the LookupBinContentConfiguration supplied as reference data
        MobXmlMgt.GetDocRootNode(_XmlRequestDoc, XmlRequestNode);
        MobXmlMgt.FindNode(XmlRequestNode, 'requestData', XmlRequestDataNode);

        // -- Now find the location parameter
        MobXmlMgt.FindNode(XmlRequestDataNode, 'ItemNumber', XmlParameterNode);
        // -- Get the parameter
        ItemNumber := MobWMSToolboxMobWmsToolbox.CheckCrossRef(CopyStr(MobBaseToolboxMobToolbox.ReadEAN(MobXmlMgt.GetNodeInnerText(XmlParameterNode))120), VariantCode);

        // Initialize the response xml
        MobBaseToolbox        MobToolbox.InitializeResponseDocWithNS(_XmlResultDoc, XmlResponseData, CopyStr(MobXmlMgt.NS_WHSEMODEL()11024));

        // Determine if the item has substitutes
        ItemSubstitution.SetRange("No.", MobWMSToolbox.GetItemNumber(ItemNumber));
        ItemSubstitution.SetRange("Variant Code", VariantCode);
        if ItemSubstitution.FindSet() then
            repeat
                with ItemSubstitution do begin
                    // Collect the buffer values for the <LookupResponse> element
                    TempLookupResponseElement.Create();
                    MyCustomSetFromLookupSubstituteItem(ItemSubstitution, TempLookupResponseElement);
                    TempLookupResponseElement.Save();
                end;
            until ItemSubstitution.Next() 0;
        MobWmsLookup.AddLookupResponseElements(XmlResponseData, TempLookupResponseElement);
    end;
    local procedure MyCustomSetFromLookupSubstituteItem(_ItemSubstitution: Record "Item Substitution"; var _LookupResponseElement: Record "MOB NS WhseInquery Element")
    var
        Item: Record Item;
        ItemVariant: Record "Item Variant";
        MobWmsLookup: Codeunit "MOB WMS Lookup";
        MobWmsLanguage: Codeunit "MOB WMS Language";
        LineBuf: array[10of Text[250];
    begin
        Item.Get(_ItemSubstitution."Substitute No.");
        // Populate LineBuf[1] and LineBuf[2] from details about the substitute
        Clear(LineBuf);
        if (_ItemSubstitution."Substitute Variant Code" <> '') and (ItemVariant.Get(_ItemSubstitution."Substitute No.", _ItemSubstitution."Substitute Variant Code")) then
            MobWmsLookup.GetText(ItemVariant.Description, ItemVariant."Description 2", LineBuf)
        else
            MobWmsLookup.GetText(Item.Description, Item."Description 2", LineBuf);
        with _LookupResponseElement do begin
            Init();
            Set MobWmsToolbox.GetItemNumber(ItemNumber));
        ItemSubstitution.SetRange("Variant Code", VariantCode);

        if ItemSubstitution.FindSet() then
            repeat
                // Collect the buffer values for the <LookupResponse> element
                TempLookupResponseElement.Create();
                MyCustomSetFromLookupSubstituteItem(ItemSubstitution, TempLookupResponseElement);
                TempLookupResponseElement.Save();

            until ItemSubstitution.Next() 0;

        MobWmsLookup.AddLookupResponseElements(XmlResponseData, TempLookupResponseElement);
    end;

    localprocedure MyCustomSetFromLookupSubstituteItem(_ItemSubstitution: Record "Item Substitution"; var _LookupResponseElement: Record "MOB NS WhseInquery Element")
    var
        MobWmsLanguage: Codeunit "MOB WMS Language";
        MobWmsToolbox: Codeunit "MOB WMS Toolbox";
    begin
        _LookupResponseElement.Init();

        _LookupResponseElement.Set_Location('');
            Set        _LookupResponseElement.Set_ItemNumber(_ItemSubstitution."Substitute NoSubstitute No.");
            Set        _LookupResponseElement.Set_Barcode('');
            Set
        _LookupResponseElement.Set_SerialNumber('');
            Set        _LookupResponseElement.Set_LotNumber('');
            Set        _LookupResponseElement.Set_Bin('');
            Set
        _LookupResponseElement.Set_Quantity(1);
            Set        _LookupResponseElement.Set_UoM('');
            SetValue        _LookupResponseElement.SetValue('MyCustomValue',  'My Custom ValueMy Custom Value');
            Set
        _LookupResponseElement.Set_DisplayLine1(_LookupResponseElement.Get_ItemNumber());
            Set_DisplayLine2(LineBuf[1]);
            Set_DisplayLine3(LineBuf[2]);
            Set        _LookupResponseElement.Set_DisplayLine2(MobWmsToolbox.GetItemDescription(_ItemSubstitution."Substitute No.", _ItemSubstitution."Substitute Variant Code"));
        _LookupResponseElement.Set_DisplayLine3('');
        _LookupResponseElement.Set_DisplayLine4(_ItemSubstitution."Substitute Variant CodeSubstitute Variant Code"  <> <> '',  MobWmsLanguageMobWmsLanguage.GetMessage('VARIANT_LABEL')  +  '   '  +   _ItemSubstitution."Substitute Variant CodeSubstitute Variant Code",  '');
            Set        _LookupResponseElement.Set_DisplayLine5('Interchangeable:   '  +  FORMATMobWmsToolbox.Bool2TextAsDisplayFormat(_ItemSubstitution.Interchangeable));
            Set_ExtraInfo1('');
            Set_ExtraInfo2('');
            Set_ExtraInfo3('');
            end;    end;


Version History

VersionChanges
MOB5.38GetText replaced with new MobWmsToolbox.GetItemAndVariantDescription
MOB5.00Introduced