Difference between revisions of "Setting Up and Configuring Scanner"

From HandiFox Desktop Wiki
Jump to navigation Jump to search
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Built-in Camera ==
+
==[[File:tabletandroid.png | 36px]]Built-in Camera ==
 
This method is the simplest but the least performant of all, so if you plan on scanning a lot of barcodes regularly, we recommend that you consider other methods described below.
 
This method is the simplest but the least performant of all, so if you plan on scanning a lot of barcodes regularly, we recommend that you consider other methods described below.
  
Line 7: Line 7:
  
 
{{Info | 1 = Scanning barcodes with camera requires the [https://play.google.com/store/apps/details?id=com.google.zxing.client.android Barcode Scanner] app to be installed on the device, otherwise you will be prompted to install it after pressing the Scan button.}}
 
{{Info | 1 = Scanning barcodes with camera requires the [https://play.google.com/store/apps/details?id=com.google.zxing.client.android Barcode Scanner] app to be installed on the device, otherwise you will be prompted to install it after pressing the Scan button.}}
{{Gototop}}
+
{{Gototop}}<br>
== Bluetooth Scanner ==
+
 
 +
==[[File:tabletandroid.png | 36px]]Bluetooth Scanner ==
 
<html><iframe width="560" height="315" src="https://www.youtube.com/embed/heB0IhiMUOs" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe></html>
 
<html><iframe width="560" height="315" src="https://www.youtube.com/embed/heB0IhiMUOs" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe></html>
  
Line 19: Line 20:
 
{{Info | If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled}}
 
{{Info | If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled}}
 
{{Warning | Only scanners capable of [https://en.wikipedia.org/wiki/List_of_Bluetooth_profiles#Serial_Port_Profile_.28SPP.29 SPP] mode will work with HandiFox as advertised. Check the [http://www.handifox.com/products/system-requirements/ System Requirements] for recommended models.}}
 
{{Warning | Only scanners capable of [https://en.wikipedia.org/wiki/List_of_Bluetooth_profiles#Serial_Port_Profile_.28SPP.29 SPP] mode will work with HandiFox as advertised. Check the [http://www.handifox.com/products/system-requirements/ System Requirements] for recommended models.}}
{{Gototop}}
+
{{Gototop}}<br>
== Devices with Built-in Scanner ==
+
 
 +
==[[File:tabletandroid.png | 36px]]Devices with Built-in Scanner ==
 
HandiFox supports certain devices with built-in laser scanners. Visit [https://www.handifox.com/about/news/we-have-updated-the-list-of-handifox-hardware-requirements/ this page] to see all the devices supported. On Motorola devices, additional configuring is required to start using the scanner in HandiFox. Please [mailto:support@handifox.com contact us] for details.
 
HandiFox supports certain devices with built-in laser scanners. Visit [https://www.handifox.com/about/news/we-have-updated-the-list-of-handifox-hardware-requirements/ this page] to see all the devices supported. On Motorola devices, additional configuring is required to start using the scanner in HandiFox. Please [mailto:support@handifox.com contact us] for details.
 
{{Info | If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled}}
 
{{Info | If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled}}
Line 87: Line 89:
 
|| [[File:Dw13.jpg]]
 
|| [[File:Dw13.jpg]]
 
|}
 
|}
<br>{{Gototop}}
+
{{Gototop}}<br>
=== Scanner Settings in HandiFox ===
+
 
 +
===[[File:tabletandroid.png | 36px]]Scanner Settings in HandiFox ===
  
 
# Open your HandiFox app and go to ''Admin → Settings → Select Scanner''.
 
# Open your HandiFox app and go to ''Admin → Settings → Select Scanner''.
 
# Uncheck ''«Use camera to scan barcodes»''. This will hide the Scan button inside HandiFox and avoid confusion, since you will instead use the built-in scanner and activate it via a hardware trigger or button.
 
# Uncheck ''«Use camera to scan barcodes»''. This will hide the Scan button inside HandiFox and avoid confusion, since you will instead use the built-in scanner and activate it via a hardware trigger or button.
#*[[File:Info-sign.png]] Just in case, double-check that it says ''«DataWedge»'' in the text field under Scanner. This means HandiFox is detecting DataWedge on your device and will expect input from it.
+
#*[[File:Infocircle.png | 30px]] Just in case, double-check that it says ''«DataWedge»'' in the text field under Scanner. This means HandiFox is detecting DataWedge on your device and will expect input from it.
 
# When done, tap ''Save''.<br>
 
# When done, tap ''Save''.<br>
 +
<br>
  
 
[[File:Dw14.jpg]]
 
[[File:Dw14.jpg]]
{{Gototop}}
+
<br>
== Testing Scanner ==
+
 
 +
=== Troubleshooting ===
 +
Click [[Troubleshooting#Scanner_not_finding.2Flocating_items_after_reinstalling.2C_updating_or_clearing_the_mobile_app.27s_data|here]] to troubleshoot some known problems that may arise when testing if your scanner works in HandiFox.
 +
 
 +
{{Gototop}}<br>
 +
 
 +
==[[File:tabletandroid.png | 36px]]Testing Scanner ==
  
 
The best way to test if your scanner now works with HandiFox is in ''Inventory → Item List''.
 
The best way to test if your scanner now works with HandiFox is in ''Inventory → Item List''.
Line 103: Line 113:
  
 
If everything is set up and working correctly, the outcome must be one of the two:
 
If everything is set up and working correctly, the outcome must be one of the two:
Open your HandiFox app and go to Admin Settings Select Scanner.
 
 
* If the barcode you scanned is assigned to one of your products in HandiFox, the Item List will be instantly scrolled to that product, and the item will be highlighted.
 
* If the barcode you scanned is assigned to one of your products in HandiFox, the Item List will be instantly scrolled to that product, and the item will be highlighted.
 
* If this barcode is not assigned to any of your items, you will see a warning: ''«Cannot find scanned item with barcode XXXXXXX»''.
 
* If this barcode is not assigned to any of your items, you will see a warning: ''«Cannot find scanned item with barcode XXXXXXX»''.
 
Either one of these results means scanning in your HandiFox app is working as intended.
 
Either one of these results means scanning in your HandiFox app is working as intended.
 
{{Gototop}}
 
{{Gototop}}

Latest revision as of 17:51, 14 July 2021

Tabletandroid.pngBuilt-in Camera

This method is the simplest but the least performant of all, so if you plan on scanning a lot of barcodes regularly, we recommend that you consider other methods described below.

To scan a barcode with your device’s camera, simply tap the Scan button in the mobile app. This button will appear on all screens where barcode scanning is applicable.

Info-sign.png If a different scanning method is used, the Scan button becomes unnecessary and can be disabled in Admin → Settings → Select Scanner to avoid confusion.
Info-sign.png Scanning barcodes with camera requires the Barcode Scanner app to be installed on the device, otherwise you will be prompted to install it after pressing the Scan button.
[Back to top]


Tabletandroid.pngBluetooth Scanner

You can use a wireless Bluetooth barcode scanner with your mobile device for barcode scanning inside the HandiFox app.

The scanner must first be paired with the mobile device (per the scanner’s manual). Once the scanner is paired, open HandiFox app and go to Admin → Settings → Select Scanner. Tap Scan Bluetooth and wait for the search to complete, then select your scanner from the list.

You can also enter scanner’s Bluetooth address manually in case automatic discovery fails (this address can be viewed in the Bluetooth section of Android settings, in the properties of the paired scanner).

Info-sign.png If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled
Warning-sign.png Only scanners capable of SPP mode will work with HandiFox as advertised. Check the System Requirements for recommended models.
[Back to top]


Tabletandroid.pngDevices with Built-in Scanner

HandiFox supports certain devices with built-in laser scanners. Visit this page to see all the devices supported. On Motorola devices, additional configuring is required to start using the scanner in HandiFox. Please contact us for details.

Info-sign.png If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled

Creating a DataWedge Profile (for Zebra Devices)

Zebra devices require a DataWedge Profile to be set up to ensure the correct functioning and integration with HandiFox.

DataWedge Setup for HandiFox
Creating a New Profile
First, find the DataWedge app on your device and open it. Dw1.jpg
You will see a list with some pre-made DataWedge profiles.

Each profile tells DataWedge to do something specific with the data coming from the scanner (product codes, etc).

Dw2.jpg
You need to create another profile that you will point to HandiFox.

To do that, press the Menu key and select New Profile.

Dw3.jpg
The profile name doesn’t really matter, but let’s call it HandiFox for clarity.

Now you should see another profile on the list, named HandiFox. Tap on it to go into its settings.

Dw4.jpg
Under Applications, tap Associated apps. Dw5.jpg
On this screen, press the Menu key and select New app/activity. Dw6.jpg
You will see a list of all packages installed on your device. Find and select the package that has the HandiFox icon and is named com.tecomgroup.handifox. Dw7.jpg
In the next list, select the asterisk (*) at the top. You should end up with a record that looks like this:


Press the Back button to return from the associations list back into the profile settings.

Dw8.jpg
Keystroke Output
Keystroke output must be disabled for this profile. Find this

section and uncheck the checkbox next to «Enabled».

Dw9.jpg
Intent Output
Intent output must be enabled for this profile, so make sure

the checkbox next to «Enabled» is checked.

Dw10.jpg
Next, tap on Intent Action. Dw11.jpg
You will see a prompt to enter an intent action name.

enter: com.motorolasolutions.emdk.handifox.recvr

Make absolutely sure you’ve entered this name correctly and there are no spaces or line breaks in front, after or in the middle of this name. After entering this name, tap OK.

Dw12.jpg
Tap on Intent Delivery and select «Broadcast intent».

This is it for the DataWedge profile. Press the Back button to leave the profile settings.

Dw13.jpg
[Back to top]


Tabletandroid.pngScanner Settings in HandiFox

  1. Open your HandiFox app and go to Admin → Settings → Select Scanner.
  2. Uncheck «Use camera to scan barcodes». This will hide the Scan button inside HandiFox and avoid confusion, since you will instead use the built-in scanner and activate it via a hardware trigger or button.
    • Infocircle.png Just in case, double-check that it says «DataWedge» in the text field under Scanner. This means HandiFox is detecting DataWedge on your device and will expect input from it.
  3. When done, tap Save.


Dw14.jpg

Troubleshooting

Click here to troubleshoot some known problems that may arise when testing if your scanner works in HandiFox.

[Back to top]


Tabletandroid.pngTesting Scanner

The best way to test if your scanner now works with HandiFox is in Inventory → Item List. On this screen, try to scan any barcode you can find around you. It doesn’t have to be one of your products.

If everything is set up and working correctly, the outcome must be one of the two:

  • If the barcode you scanned is assigned to one of your products in HandiFox, the Item List will be instantly scrolled to that product, and the item will be highlighted.
  • If this barcode is not assigned to any of your items, you will see a warning: «Cannot find scanned item with barcode XXXXXXX».

Either one of these results means scanning in your HandiFox app is working as intended.

[Back to top]