Last updated: 25.10.2023

Valid from: 2023.06.01 and later, Opter Driver for iOS 2.3.6 and later

Configuring which fields are displayed in Opter Driver for iOS

You can set which fields are displayed in the app. From Opter 2022.12.00 and onwards, we recommend using the Design field for mobile window to set the fields to be displayed on the shipment page, in the detail view, and on the proof of delivery signature page, scan page and the Scanning details page in Opter Driver for iOS. See the instructions below. For Opter up to version 2022.11.xx see Customising the layout and features of Opter Driver.

To set which fields are displayed in the package view, package list, price item view, deviation view, change view and new order view, see Mobile data settings (window).

The image above shows an example of what it might look like in the detail view.

The default settings regarding which fields to display on the order page, detail view, proof of delivery signature page, scan page, and Scanning details page in Opter Driver for iOS are based on one of the following scenarios:

• If a new installation of Opter is done with version 2022.12.00 or later, Opter's default settings are used in the Design field for mobile window. In other words, the fields that are in the Included column of the Design field for mobile window in the case of a new installation are displayed in Opter Driver.

• If you have Opter version 2022.12.xx, and update your Opter to 2023.06.01 or later, the default settings in the Design field for mobile window (and thus in Opter Driver) are based on the settings in App.Design, except for the settings for the detail view, which are instead based on the settings you had in the Design field for mobile window. (If you have used App.OpterDriver.Design instead, that will still be used after the update).

  For more information, see Design field for mobile (window), App.OpterDriver.Design and App.Design.

• If you have Opter version 2022.11.xx or earlier, and update your Opter to 2023.06.01 or later, the default settings in the Design field for mobile window (and thus in Opter Driver) are based on the settings in App.Design. For more information, see App.Design.

Conditions

For the settings configured in the Design field for mobile window to be displayed in the app, the following must apply:

• The App.ForceOldDesign mobile data setting is set to “false” (default). (If it is set to “true” then App.Design will be followed instead). For more information, see Mobile data settings (window).

• The XML file in the App.OpterDriver.Design mobile data setting is empty, or only contains “<?xml version="1.0" encoding="UTF-8"?>”. (If App.OpterDriver.Design contains anything else, that will be followed instead of the settings in the Design field for mobile window). For more information, see App.OpterDriver.Design.

Setting the fields to be displayed in the app

1. In Opter, click on Settings > Mobile data > Design field for mobile.

2. For Opter 2023.06.01 or later (and Opter Driver for iOS version 2.3.6 or later): Click the tab for the view for which settings are to be made, such as Shipment List, Detail View or Scanning View.

3. Drag and drop the fields that are to be displayed in the Included list and those that are not to be displayed in the Excluded list. It is also possible to double-click on a field to move it to the other list.

   For example, to have Goods type displayed in the app, drag Goods type [GOODSTYPE] to Included. For more information about the fields, see Design field for mobile (window).

   Tip

   The Filter field at the top can be used to find fields more quickly.

   The order in which the fields are listed in Included does not matter.

4. Click on Save at the bottom of the window. Click on Close.

   The changes are displayed in the app after the user has logged out and then logged back in. If the user has selected Automatic login in Settings in the app, the changes will appear in the app after the user has closed the app and then started it again.

Troubleshooting

If the changes made in the Design field for mobile window are not visible in the app:

• It may take a while for the changes to appear in the app.

• Check that the App.ForceOldDesign mobile data setting is set to “false”.

• Check that the XML file in the App.OpterDriver.Design mobile data setting is empty, or only contains “<?xml version="1.0" encoding="UTF-8"?>”.

• The changes are displayed in the app after the user has logged out and then logged back in. If the user has selected Automatic login in Settings in the app, the changes will appear in the app after the user has closed the app and then started it again.

• For the fields selected for display, the following applies:

  • Most of the fields and sections are only displayed if there is any information to display, i.e. if the shipment/order contains that information.

  • The following fields are displayed even if there is no information to display: Weight [WEIGHT], Volume [VOLUME], Pallet space [AREA], Load metres [LOADMETER], Time (minutes) [TIMEMINUTES], Distance (km) [DISTANCEKM], and Extra dimension 1 [EXTRADIMENSION1] – Extra dimension 5 [EXTRADIMENSION5] and Extra ID 1 [EXTRAID1] – Extra ID 5 [EXTRAID5].

• If changes have been made to the detail view, note the following:
  If the Pickup section contains the same address as the Pickup・order section, the Pickup・order section will not be displayed as it would just be a repetition of the same information.

  If the Delivery section contains the same address as the Delivery・order section, the Delivery・order section will not be displayed as it would just be a repetition of the same information.

---