How-to: Use LineSelection to select line and set default registration values

Description

Line selection functionality makes it possible to: 

1. Select a line based on a response from the backend
2. Set default values on the line steps

Selecting a Line

The selection can be done on any value defined on the order line, either standard like ItemNumber, or custom elements added the lines on Order Lines GetOrderLines Response

If LineNumber is used as the selection name, then the application will go straight for that line.

If any other value is sent out, the application will go through the automatic searching mechanism where order line registration status is taken into account as well as the position of the selection.

Setting Step default values

The response can also include values to be set on the line steps as predefined default values.

See also: LineSelection

Example 1: LineSelection on Pick (scan SerialNumber to select a line)

Step 1: Enable LineSelection

Add <lineSelection> tags to the existing Pick Service (or Receive etc.)

<service id="Pick" type="Order" orderType="Pick">
  <requests>
    <getOrders>GetPickOrders</getOrders>
    <getOrderLines>GetPickOrderLines</getOrderLines>
    <postOrder>PostPickOrder</postOrder>
    <lineSelection includeCollectedValues="true">SearchForPickLine</lineSelection>
  </requests>
</service>

Add <lineSelection> to the mobile PickLinesLines list page (or ReceiveLinesList etc.)

<page id="PickLines" type="OrderLines" icon="mainmenupick">
  <title defaultValue="@{PagePickOrderLinesTitle}"/>
  <orderLinesConfiguration>
    <service id="Pick"/>
    <list listId="OrderLinesWithImages"/>
    ...
    <lineSelection type="OnlineFirst"/>
    ...
  </orderLinesConfiguration>
  ...
</page>

See  Mobile Configuration Files for how to edit application.cfg