From product version 19.3, Produmex Scan is available as an APK client. Produmex Scan for Android can be installed directly on an Android scanner and all features of previous Windows CE and RDP versions are available.

1. A configured SAP Business One company

2. A working Produmex Scan environment (as the APK file is the client part only)

• The minimum Produmex Scan version is 19.3.
• Produmex Scan can be downloaded from here and the normal installation and configuration procedures must be followed (see Installation Guide and Configuration Guide).

Note: If you already have an environment with a Produmex Scan version lower than 19.3, you only need to perform a version upgrade, and add the APK file as an extra client.

3. An Android scanner or an Android smartphone version 6 or later

Note: Produmex Scan for Android is optimized for simple smartphones and it uses the camera for scanning. It is for demonstration purposes instead of actual operations as scanning by using a smartphone camera has limited functionality.

1. Download the ProdumexScan_ClientAndroid_[version].apk file to your device from here.

2. Execute the APK file on your device.

Note: Depending on the device, it may be necessary to allow untrusted sources.

3. Enter the server URL (i.e. the URL where the Service Broker is running) in the Server URL field of the General tab.

4. Select a company.

5. Select a language.

Go to the Advanced tab and set up the configurations.

1-2. Use camera for barcode and Do not show keyboard settings:

• In case of using an industrial scanner with a keyboard:
  • Leave the Use camera for barcode setting disabled.
  • Enable the Do not show keyboard setting.
• In case of using an industrial scanner without a keyboard:
  • Leave the Use camera for barcode setting disabled.
  • Leave the Do not show keyboard setting disabled.
• In case of using an Android smartphone:
  • Enable the Use camera for barcode setting.
  • Leave the Do not show keyboard setting disabled.
  • For more information see section
• 5. Scanning Barcodes with Camera.

3. Allow text field focusing

With the cursor focusing option, you can define the text field on which the cursor is focused and the keyboard is also automatically displayed so that you can immediately start writing. The setting is available from product version 2021.10.

1. Enable the Allow text field focusing option in the Advanced settings.

2. Write a user query in the Query Manager:

• SQL command: SELECT
• Keyword: Focus$

Example : The cursor is focused on the Password field of the Login screen.

• Query name: BXMobileWH9_LoginScreen_Activate
• User query: SELECT 'TextPassword' AS 'Focus$'

4. Smaller controls: If the setting is enabled, the size of controls is reduced and the Data Repeater list has more space on the screen.

5. (Initial) Connection Timeout (sec): An initial timeout setting for the Client application with a default value of 15 seconds.

• First the Client application requests its configuration (including the Kill Time value - 30 seconds by default) from the application server and it uses the Connection Timeout setting. If the application server does not respond within the time limit defined by the Connection Timeout setting, the Client application aborts the connection.
• If this first communication is successful, that is, the application server responds to the Client application within the time limit, a total timeout value is applied to define the timeout for future communication among the Client application, the application server and the database. The total timeout value is defined by the sum of the (Initial) Connection Timeout and the Kill Time with a default value of 45 seconds (15 sec + 30 sec).
• If your application or database server is slow, it is recommended to change the value of the (Initial) Connection Timeout to a higher number.

6. Play Sound

With the Play Sound setting you can define if you want Produmex Scan to play a sound whenever a barcode has been scanned successfully or a problem has occured while scanning.

If you enable the Play Sound setting, you can also set the success and the fail sound in the drop-down menus. In case of the success sound, the no sound option is also available.

If the setting is enabled and Produmex Scan displays a message, it displays the following sound:

• error: fail sound
• warning: fail sound
• info: success sound

Note: If the setting is enabled, Produmex Scan also plays a success sound when you leave a field where a barcode has been scanned successfully, for example when you tap the Add or the Update button.

The path of the sounds files Produmex Scan displays in the drop-down menus can be defined with the Audio directory for scanning (Service Broker directory) setting, see documentation here.

This section describes the steps of configuring the Windows Defender Firewall.

Note: If you use a different firewall software, make sure that you consult with the manual of the given software and proceed accordingly.

By default, Windows Defender Firewall does not allow smartphones to connect to PCs or laptops and it also prevents the Produmex Scan Android Client from connecting to the server. The following error message is displayed: Information: Could not connect to server, please enter the correct URL. Click OK and proceed as follows:

1. Open the Windows Defender Firewall on the Control Panel.

2. Select Advanced settings.

3. Select Inbound Rules and then select New Rule.

4. On the New Inbound Rule Wizard screen select Port and click Next.

5. Select TCP and write the Port number configured on the Produmex Server to the Specific local ports field. Click Next.

Note: The default value is 50231. If you configure the Produmex Scan Server on a different port, make sure that you provide the appropriate value.

6. Select Allow the connection and click Next.

7. Select all the options (Domain, Private, Public) and click Next.

8. Provide a name in the Name field and click Finish.

The same customization can be used for the Android version as for the Windows version and the same configurations apply to it. The following section describes some specificities.

Enable the Customization assist mode setting on the Advanced tab and the general customization guidelines apply to it. Exceptions:

• fields on external form
• data positioning

If you select Yes in the On External Form column of the Customization Fields screen, the Extra button is displayed on the given screen and if you click the button, it opens the external screen with the fields and buttons positioned to the external screen:

In addition to the x, w and lines values, the possible values for data positioning include row and fullrow while the vertical position (y), the screen height (h) and the font size (f) are not applicable.

If a field has buttons (for example the Quantity field has the Add and the Update buttons), there is no need to customize the buttons with the field. Once a field is customized, its buttons are automatically positioned accordingly.

The following message types can be used in user queries:

I: Information

• A pop-up information message is prompted and it needs user confirmation (OK). The event is executed.

E: Error

• A pop up error message is prompted and it needs user confirmation (OK). The event is not executed.

YM: Yes/No with message box

• A pop up confirmation message is prompted that it can be answered with yes or no. The event is executed depending the user's choice.
• This message type can be used in case of button click events and validate events.

Navigate to the login screen and tap the gear icon to access the Logs tab. The tab is divided into two parts:

• On the top of the screen the system displays general errors, for example unsuccessful login. When you log out in the main menu, this log is sent to the Service Broker and cleared.

• On the second part of the screen unexpected events and their causes are displayed. With the Send logs button the logs can be sent to the Produmex Service Broker, which saves them among its own log files. The files can be sent to the Produmex Support Team.

With the Clear logs button you can clear logs on both parts of the screen.

With Produmex Scan on Android it is possible to use the camera of your device for scanning GS1-128 barcodes if the barcode does not have any group separators.

Prerequisites:

• Enable the Use camera for barcode setting on the Advanced tab.
• Delete the default values in the fields of the Barcode scanner prefix and Barcode scanner suffix settings on the Produmex Scan Scanning tab of the Produmex Scan Settings screen in SAP Business One.

To use the function tap the icon:

On the Recommendations screens, you can see all the Stock Transfer Draft documents where the Transaction Type user-defined field is Incoming.

After selecting the appropriate document, on the next screen the < > signs indicate that the locations are the recommended ones configured in the draft document and the locations must be re-scanned during the process.

You can use the TAB or the arrow down key to navigate to the bin location fields.