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

1. Navigate to All > sys_sg_properties.list.

   The Mobile Properties list appears.

2. In the Mobile Properties list, select New.

   The Mobile Properties form appears.

3. On the form, fill in the fields.

   Table 1. Mobile properties new record form

   Field	Description
   Name	Name for the mobile property record. Enter externalScanEnabled to enable using an external scanner without turning off your mobile device camera. Note: The record name is case-sensitive and must be entered as externalScanEnabled.
   Application	Application scope where the mobile property is applied. To select a different application scope, select the globe icon () on the instance banner. Then select Application scope : application_scope. 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 ( ). The search dialog box lists the configurations from which you can choose. Select one of the following mobile app configs: Mobile Agent Now Mobile
   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 ( ). The search dialog boxt lists the application from which you can choose. Select one of the following mobile applications: If you selected Mobile Agent for the Mobile App Config, select Agent. If you selected Now Mobile for the Mobile App Config, select Request.

4. Select Submit.

What to do next

After updating this property, the end-user must pull to refresh and get the latest feature configurations.