Enable barcode scanning with an external scanner
Set the externalScanEnabled mobile property to True to enable barcode scanning with an external scanner while the device camera is available in other parts of the mobile app.
Before you begin
Role required: admin
About this task
When the externalScanEnabled mobile property is set to True, you can use an external scanner without denying access to the camera for the mobile app.
By default, the externalScanEnabled mobile property isn't configured, which turns off this feature.
In ServiceNow® mobile apps version 19.0 and later, when you configure the externalScanEnabled property on your ServiceNow instance, it enables a toggle switch on the barcode scan screen. This switch can be used to select the device camera or an external device.
Important:
External barcode scanning devices must be configured with a 'tab' character appended to the end of each barcode. Multi-scan and group scans use the tab suffix character to automatically advance to the next field.
Please refer to the user manual of your device to learn how to configure the tab suffix. For example:
- For all Zebra scanners, see Add a Tab Key after Scanning a Barcode.
- For Zebra DS2278 Bluetooth scanner, see Tab Key.
- For Zebra TC52X, TC78x, and MC 900 (phone with built-in scanner), see DataWedge: Append Send Enter or Tab Key after Scanning.
- For Honeywell CT40 (phone with built-in scanner), see Article 000076406 in the Honeywell knowledge base.
For more information, see Mobile barcode scanning.
Procedure
Navigate to All > sys_sg_properties.list.
The Mobile Properties list appears.
In the Mobile Properties list, select New.
The Mobile Properties form appears.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name for the mobile property record. Enter Note: The record name is case-sensitive and must be entered as |
| Application | Application scope where the mobile property is applied. To select a different application scope, select the globe icon ( Image omitted: globe-icon.png Globe icon image) on the instance banner. Then select <strong>Application scope : <em>application_scope</em></strong>.</p> For information about how mobile properties are affected by application scope, see Mobile properties. |
| Description | Description of the mobile property. Enter a description of the property. |
| Type | Data type of the mobile property record. You must select True/False for the externalScanEnabled mobile property. |
| Value | Enter one of the following options: - To enable barcode scanning with an external scanner without denying access to the camera for the mobile app, enter `True`. - To turn off the ability to scan barcodes with an external scanner and use the mobile device camera for barcode scanning, enter `False`. |
| Active | Indicates if the mobile property is activated. If the check box is cleared, the mobile property isn't activated for use. |
| Is Public | Determines whether the pre_auth property is included in the API response. By default, this option is not selected. If you want this property included in the /pre_auth API response, select this checkbox. For more information, see Adaptive authentication events. Mobile properties with this checkbox enabled are excluded from the /user_client API response. |
| Mobile App Config | Mobile app configuration for which you want to use the mobile property. This setting limits the mobile property behavior to users who have access to this mobile app configuration. Other users don't have access to this mobile property and instead experience default behavior. To enter a value, either start typing the application name or select the search icon ( Image omitted: search-icon.png Search icon image ). The search dialog box lists the configurations from which you can choose.</p> Select one of the following mobile app configs:
|
| Mobile Application | Mobile application to which you want to send the mobile property. This setting limits the mobile property behavior to users who have access to this mobile app. Other users don't have access to this mobile property and instead experience default behavior. To enter a value, either start typing the application name or select the search icon ( Image omitted: search-icon.png Search icon image ). The search dialog boxt lists the application from which you can choose.</p> Select one of the following mobile applications:
|
- Select Submit.
What to do next
After updating this property, the end-user must pull to refresh and get the latest feature configurations.
Parent Topic:Mobile properties