Promoted menu items

Owned by Morten Attermann Holst
Last updated: Jan 09, 2023 by Johannes Sebastian NielsenVersion comment
2 min read

Description

Promote menu items (actions)

The application can have a wide range of menu items, which can be sorted to fit user needs. However, sometimes menu items are heavily used and the extra step of opening the menu can be an irritation factor for the user. The application therefore now supports taking menu items from within the menu item, and placing them next to the burger menu item. That way, the user does not need to open the burger menu in order to access the specific menu items.

Page Configuration

The easiest way to utilize this functionality is to add the menu configuration element on the desired page configuration <menu numberOfPromotedItems=""/>. E.g. <menu numberOfPromotedItems="3"/>, which will promote three items.

The way it works, is that it takes menu items from the top of the burger menu, and places them next to the burger menu. The order of any menu item can be changed as described here.

Example
<page id="ReceiveLines" type="OrderLines" icon="mainmenureceive">
  <title defaultValue="@{PageReceiveOrderLinesTitle}"/>
  <orderLinesConfiguration postingTrigger="PostWhenAllLinesCompleteShowDialog" suggestQuantity="true" verifySingleScanRegistrations="false" actionOnEmptyList="ClosePage">
    <service id="Receive"/>
    ...
  </orderLinesConfiguration>
  <actions>
    <open icon="mainmenuscaninfo" id="ItemCrossReference" title="@{AddCrossReferenceMenuItem}" automaticValueTransfer="true" menuPlacement="1">
      <returnTransfer property="UnplannedItemRegistrationCompleted" to="RefreshOnResume"/>
    </open>        
    <open icon="mainmenuprint" id="PrintLabelTemplate" title="@{PagePrintLabelTitle}" automaticValueTransfer="true"  menuPlacement="2"/>
    <open id="RegisterImage" icon="camera" title="@{AttachImages}">
      <returnTransfer property="UnplannedItemRegistrationCompleted" to="RefreshOnResume"/>
    </open>
    <open id="Attachments" icon="attachment" title="@{Attachments}" menuPlacement="3"/>
    <open id="LocateItem" icon="mainmenulocateitem" title="@{PageLocateItemTitle}"/>		
    <showImage id="ShowImage" enabled="true" imageProperty="ItemImage" title="@{MenuItemShowImageTitle}"/>
  </actions>
  <menu numberOfPromotedItems="3"/> <!-- Writing -1 will take as many items as the screen with will allow. -->
</page>

See also

Promoted menu items