Last updated: 06.12.2023

Valid from: Opter 2023.12.00, Opter Driver for Android 1.8.9

The scan list in Opter Driver

The scan list is the view displayed when a driver has scanned packages with Opter Driver. The layout of the scan list is set in the <scanrows> section in App.Design. If the section is not in your App.Design, you can copy the factory settings below. The colours in the scan list cannot be changed and it is not possible to use conditions or calculations.

Copy code

Factory settings for <scanrows>

    <scanrows>
      <row>
        <item font="BOLD" itemname="CREDITEDTOOTHERRESOURCEBLOCK"/>
      </row>
      <row>
        <item font="BOLD" itemname="CREDITEDTOOTHERRESOURCEWARNING"/>
      </row>
      <row>
        <item font="BOLD" itemname="CREDITEDTOOTHERRESOURCE"/>
      </row>
      <row>
        <item itemname="STATUS,PACKAGECOUNT"/>
      </row>
      <row>
        <item itemname="PACKAGE.PACKAGEID,' ',PACKAGE.STATUS,' ',PACKAGE.SCANTIME,' ',PACKAGE.RESOURCE,' ',PACKAGE.HUBNAME,' ',PACKAGE.DIMENSIONS" multiline="true"/>
      </row>
      <row>
        <item itemname="ADDRESSINDEXTITLE,ADDRESSINDEX"/>
      </row>
      <row>
        <item itemname="FREIGHTBILLTITLE,FREIGHTBILL"/>
      </row>
      <row>
        <item itemname="PACKAGEIDTITLE,PACKAGEID"/>
      </row>
      <row>
        <item itemname="ADDRESSFROMTITLE,ADDRESSFROM"/>
      </row>
      <row>
        <item itemname="ADDRESSTOTITLE,ADDRESSTO"/>
      </row>
    </scanrows>

Several variables can be displayed one after the other by separating them with commas. To have spaces between variables in the app, type ' ' between them, for example <item itemname="PACKAGE.PACKAGEID,'',PACKAGE.STATUS,'',PACKAGE.SCANTIME"/>.

For more information about variables, see below and in Placeholder in App.Design. This is what the scan list looks like with the factory settings.

  1. STATUS,PACKAGECOUNT

    • STATUS: Package labels - Unloading - Found one. Shows whether package labels or freight bills have been scanned, which scan direction was performed and the status of the most recently scanned package.

    • PACKAGECOUNT: 2/3 package. Shows how many packages have been scanned of the total number of packages in the shipment.

      Once all the packages for this shipment have been scanned, 3/3 is displayed and the entire block belonging to the shipment turns green in the scan list (if OneScanRowPermission is set to “true”, which is the default setting and is shown in the image). If OneScanRowPermission is set to “false”, all the blocks belonging to the shipment will be green in the scan list.

  2. Package information that is repeated for each package in the order. Preferably used when OneScanRowPermission is set to "true". If the row for a package is green, it means that the package has been scanned.

    • PACKAGE.PACKAGEID: Package ID.

    • PACKAGE.STATUS: Latest package status.

    • PACKAGE.SCANTIME: Date and time when the package was last scanned. (Not displayed in the image).

    • PACKAGE.RESOURCE: The resource that last scanned the package. (Not displayed in the image).

    • PACKAGE.HUBNAME: The terminal where the package was last scanned. (Not displayed in the image).

    • PACKAGE.DIMENSIONS: Displays the text and the package dimensions set for the mobile data setting PackageDimensionsString in the scan block, for example “Weight: 20 kg". (Not displayed in the image).

      For more information, see Mobile data settings (window) and Displaying package dimensions in the scan list (Opter Driver).

    • PACKAGE.SCANCOMMENT: The latest scan comment for the package. (Not displayed in the image. The variable PACKAGE.SCANCOMMENT is not included by default in App.Design for new installations of Opter and is therefore not included in the code example above, but "PACKAGE.SCANCOMMENT,' ',' can be added on row 15 of the code example above).

  3. FREIGHTBILLTITLE,FREIGHTBILL

    • FREIGHTBILLTITLE: Freight bill:

    • FREIGHTBILL: The freight bill number on the order.

  4. PACKAGEIDTITLE,PACKAGEID

    • PACKAGEIDTITLE: Package ID:

    • PACKAGEID: Displays the package number of the most recently scanned package (if OneScanRowPermission is set to "true", which is the default setting and is shown in the image). If OneScanRowPermission is set to “false”, the package number is displayed on the scanned package.

  5. ADDRESSFROMTITLE,ADDRESSFROM

    • ADDRESSFROMTITLE: From:

    • ADDRESSFROM: Sender’s name, for example, a company name or a private individual. (Address line 1).

  6. ADDRESSTOTITLE,ADDRESSTO

    • ADDRESSTOTITLE: To:

    • ADDRESSTO: Receiver’s name, for example, a company name or a private individual. (Address line 1).

Variables that are not shown in the image above:

Customising the scan list

See also

Mobile data settings (window)

Placeholder in App.Design

Displaying package dimensions in the scan list (Opter Driver)

Displaying scans of the same shipment in a block (Opter Driver)

Customising the layout and features of Opter Driver