The Barcode tool allows a mobile user to scan a barcode directly into a mobile form by using the mobile device's camera. doForms has also integrated the scan APIs of both Zebra and Honeywell. If doForms is loaded on a device from one of these vendors, the standard scan API is automatically replaced. For devices with physical scan buttons, you can use standard text fields versus the scan tool. That is because these devices have a feature called keyboard interrupt which will place the scan result directly into your text field as if you typed it. doForms has added many features into the text tool to support scanning. Because of this, doForms is able to support almost all devices that support keyboard interrupt.
The Barcode tool provides the ability to parse the returned barcode into multiple data fields and assign them as "destination" fields to other fields in the form.
To scan a barcode from within a form, the user taps the "Scan" button in the field, and the mobile device's camera or 2d imager activates and allows the user to scan a barcode. Upon scanning, the barcodes alphanumeric sequence is transferred to the barcode field.
Supported barcode formats include UPC-A and UPC-E; EAN-8 and EAN-13; Code 39, 93, and 128; QR Code; ITF; Codabar, RSS-14 (all variants); Data Matrix; PDF 417 alpha quality; Aztec alpha quality
Properties
Default value: The value of the field first presented to the user when they see the question. Unless the question is marked as “Read Only”, the mobile user will be able to change the value. This is very useful where the answer to a question is likely to repeat itself over and over. Setting a default value minimizes the work for mobile users. Note that repeating values can also be set on the mobile app using the “Remember Answer” option.
Button Type: Choose between a button with the text SCAN or a scan icon.
Allow Edit: This setting allows the user to re-scan a barcode if necessary. If this setting is unchecked once the user scans the first barcode the field will become read only and they will not be able to re-scan.
Allow Manual Entry: Sometimes a barcode is damaged or unreadable. This option allows the user to scan or manually type in the barcode.
Auto Start Scan: This setting when turned on will automatically activate the 2d imager on a Honeywell or Zebra device, as soon as, the field gets the focus.
Display barcode image: Place a barcode image in the form based on the value entered in the barcode field.
- Hide scan value: Remove the barcode text and only display the barcode image.
-
Barcode type: Select your barcode type.
There are several options for setting the barcode text that will be used to generate the image:
- Click the scan button in the field to turn on your camera's red line scanner or 2D imager (Zebra & Honeywell) and scan a barcode.
- Manually enter a value. Check the Allow manual entry option to allow this.
- Use a device that supports scanning and keyboard interrupt to scan a value into the field. Check the Allow manual entry option to allow this.
- Enter a default value when you build the form.
- Pull the value from another field using the If, Then Else action. For example, point to a Calculation field that combines multiple values to generate a multiple field QR code.
Type: Specifies the type of value used in the barcode, either String or Numeric.
Parse: Parses the returned barcode into multiple data fields and assigns them as other fields within the form. This option requires that the barcodes have delimiters to differentiate between the fields.
-
Delimiter fields: To use parsing your barcode must contain a starting delimiter, a separation delimiter and an ending delimiter. These are character that will never appear normally in your barcode. Example {John|Smaith|908.634,4565}
-
Destination fields: As the system breaks up your barcode into separate items, each item is placed into a destination field in the order in which they are parsed. A destination field is simply just a field in your form.
- Action button only: This setting provides for a single action button to start the scan. The fields will automatically be populated into the destination fields and the button will disappear once selected.
Length: If desired, select the Length checkbox and enter values in the Minimum and Maximum fields that appear when select this setting. These values act to validate the character length of the barcode input in terms of a minimum and a maximum number of permitted characters (note that spaces are counted).
Ignore scan if exceed limit: This setting when turned on will not place the scanned value into the field if it does not meet the length criteria. For example, if the length is set to be Minimum and Maximum 6 characters, and the user scans a tag with 8 characters, it will pop up an error message and not accept the answer because it is not 6 characters.
Action: Select Jump to next question to jump to the next available field after a scan is successful. When inside of a table or grid the users will have the ability to jump to the next column in the table/grid or the next row after a scan is successful.