Customising the scan list in Opter Driver for iOS

The scan list is the view displayed when a driver has scanned packages with Opter Driver. It is possible to set which fields are displayed in the scan list and which information should be displayed for each package on the order.

Instructions for the driver are provided in Scanning freight bills and package labels with Opter Driver for iOS.

Step 1 (optional): Setting which fields are to be displayed

It is possible to set which fields should be displayed in the scan list by using the Design field for mobile window or the App.OpterDriver.Design XML file (or App.Design). For more information, see Customising the layout and features of Opter Driver. The fields are described in Design field for mobile (window).

For example, perhaps the following fields are to be displayed:

Package ID number [PACKAGE.PACKAGEID]
Status (package) [PACKAGE.STATUS]
Scan time (package) [PACKAGE.SCANTIME]
Terminal name (package) [PACKAGE.HUBNAME]
Resource (package) [PACKAGE.RESOURCE]
Comment (scanning) [PACKAGE.SCANCOMMENT]
Dimensions (package - scanning) [DIMENSIONSSTRING]

For more information about the field, see Dimensions (package - scanning) [DIMENSIONSSTRING]Step 2: Set which package information should be displayed below.

Step 2 (optional): Set which package information should be displayed

In the scan list, package information such as weight, volume, pallet location, package type and type of goods can be displayed. Package information is shown for each package in the order.

To display package information in the scan list, proceed as follows:

Use the PackageDimensionsString mobile data setting to set which text and information is to be displayed about the packages in the scan list, for example "Pallet space: 17”. For more information, see Detailed instructions for PackageDimensionString below and in Mobile data settings (window).
To make the settings in PackageDimensionsString show, proceed in one of the following ways:
- If using the Design field for mobile window:
  
  The Design field for mobile is accessed by clicking on Settings > Mobile data > Design field for mobile.
  
  Click on the Scanning view tab and search for the Dimensions (package - scanning) [DIMENSIONSSTRING] field. If it is in the Excluded list, drag and drop Dimensions (package - scanning) [DIMENSIONSSTRING] into the Included list. It is also possible to double-click on a field to move it to the other list. Click on Save at the bottom.
- If using the App.OpterDriver.Design XML file (or App.Design):
  
  Whatever is between the <scanrows> </scanrows> pair of tags in App.OpterDriver.Design is shown in the scan list.
  
  AddPACKAGE.DIMENSIONSTRING between the <scanrows> </scanrows> pair of tags, in the desired position.
  
  For complete examples of how XML files App.OpterDriver.Design can look and for more information, see App.OpterDriver.Design. Save your changes once you are done.

Detailed instructions for PackageDimensionsString

Add the mobile data setting PackageDimensionsString and enter “| Package type: {14} | Weight {1:0.##} kg | Volume: {2:0.##}" in the Value column. The variables ({0}-{15}) take their values from the package rows.

PackageDimensionsString is a free text field. This means that any text required can be written around the variables, for example:

“Package type: {0}, total weight {1:0.##} kg, volume: {2:0.##}.”
“The package is of type {14}, has a volume of {2:0.##} and weighs {1:0.##} kg.”

For information on what other dimensions can be displayed, see Mobile data settings (window).

Variables that return numbers

For variables that return numbers, it is possible to specify how many decimal places to display in the scan list, and whether to exclude unnecessary trailing zeros at the end of the number. In our example (“Weight: {1:0.##} kg”), we have limited the number of decimals for the weight to a maximum of two, but if the weight is “8.00” on the package row, only “Weight: 8 kg” is displayed in the scan list. If the weight in the package row is “8.10”, “Weight: 8.1 kg” is displayed in the scan list. The unnecessary trailing zeros after the decimal point are deleted.

The syntax works in the same way as in text and HTML reports. The number of decimal places is limited by the number of zeros after the decimal point (0.00). To exclude unnecessary trailing zeros, enter # signs instead of zeros. The dot is converted to a comma in the app.

Obs!

Numbers are stored with six decimal places in the Opter database. If a limit is not defined, all numbers are always displayed to six decimal places. For example, if “Width: {5} m” is entered in PackageDimensionsString, “Width 2.000000 m” will be displayed in the scan list.

Copy code

Variables in PackageDimensionsString that return numbers

Weight: {1:0.00}
Volume: {2:0.##}
Load metres: {3:0.00#} 
Pallet space: {4:0}
Width: {5:0.00}
Height: {6:0.00}
Depth: {7:0.00}

Returns

Weight: 8.00

Volume: 8.12, or 8.1 (if the number on the package row is 8.10), or 8 (if the number on the package row is 8.00)

Load metres: 8.123, or 8.12 (if the number on the package row is 8.120), or 8.10 (if the number on the package row is 8.100)

Pallet space: 8

Width: 8.00

Height: 8.00

Depth: 8.00

Step 3 (optional): Block or warn about other resource when scanning

It can be set so that scanning is blocked or that drivers receive a warning if they try to departure scan and/or pickup scan a shipment that is not scheduled for that resource. You set from which status the departure scan and/or pickup scan should be blocked or that the driver should receive a warning. For instructions, see Blocking or warning about another resource when scanning in Opter Driver for iOS.

Limitation in the scan list settings

For Opter Driver (classic) for Android, in the OneScanRowPermission mobile data setting it can be set whether package scans should appear in a block or as separate scans in the scan list. For Opter Driver for iOS and Opter Driver Labs for Android, package scans are always displayed in blocks, regardless of the setting that has been made for OneScanRowPermission. For more information, see Mobile data settings (window).

Troubleshooting

If you are using Design field for mobile and your changes Design field for mobile are not visible in the app, see Configuring which fields are displayed in Opter Driver for iOS.