Configuring SmartScan on Enterprise Browser

3PL Central currently requires Zebra Enterprise Browser to install and use SmartScan on any Zebra device. Enterprise Browser acts as a platform that connects the SmartScan application to Zebra hardware.

Since Enterprise Browser has certain requirements for connecting web applications, a hardware partner with knowledge of Zebra devices, Enterprise Browser, and SmartScan is highly recommended in accelerating the device configuration and deployment. 3PL Central's official hardware partner is Emkat—please contact your CSM for more information.

However, you also have the option to configure your own devices. This article reviews how to install the SmartScan application on Zebra Enterprise Browser and update the configuration files as needed.

Skip Ahead: Use the following links to skip to the relevant guidelines below.

• Step 1: Access the Enterprise Browser install location
• Step 2a: Install SmartScan
• Step 2b: Update SmartScan configuration

Step 1: Access the Enterprise Browser install location

The steps below review how to connect your Zebra device for USB file transferring and navigate to the Enterprise Browser install location so that you can properly install SmartScan and update these files as needed.

1. To begin, close Enterprise Browser on your Zebra device.
   
   • If your device is running Android 9 or newer, you can close the app by swiping up from the bottom of your device, then swiping up on the app preview.
   • If your device is running Android 8 or older, you can close the app by selecting the "Recent Items" button on the bottom-right corner of your screen (to the right of the Home button), then swiping up on the app preview.
2. Once you close the Enterprise Browser app, affix your Zebra device to your Windows computer using a supported USB cable.
   If prompted, tap Allow to grant your computer access to the files needed.
3. Swipe down from the top-right of the Zebra device, then locate the silent notification from 'Android System' and ensure it states "USB for file transfer".
   • If it does, proceed to Step 4.
   • If the notification does not indicate that the USB is configured for transferring files, tap the notification, then tap it again and select Transferring files.
     
4.  On your computer, open File Explorer (), select This PC, then double-click the device's drive to open the file repository.
   
5. Navigate to the install location via the following file path: sdcard > android > data > com.symbol.enterprisebrowser.
6. Proceed to Step 2a below if you're installing SmartScan files for the first time or Step 2b if you're simply updating these files.

Step 2a: Install SmartScan

If this is your first time installing SmartScan on your Zebra device, follow the steps below after navigating to the install location in the previous section.

 If you have already installed SmartScan on Enterprise Browser and simply need to update these files, please proceed to the next section (Step 2b).

1. Locate the config.xml file in the install location, then right-click config.xml to open the file in your default text editor and make the following edits:
   • Add the <CustomDOMElements> tag specified below in <Application>.
   • Modify the <StartPage> tag to reference index.html.

     <Configuration>
       ..
       <Applications>
         <Application>
            ..
             <General>
              ..
              <StartPage value="file://%INSTALLDIR%/Index.html" name="Menu"/>
             </General>
             ..
             <CustomDOMElements value="file://%INSTALLDIR%/eb.txt"/>
         </Application>
       </Applications>
     </Configuration>

2. Save your changes to the file, then close the text editor.
3. Next, copy each file contained in installfiles.zip to the install location by dragging and dropping or copying and pasting the files from their original location on your computer.
4. Open the zipped file from Step 3 and locate the config.json file, then right-click config.json to open the file in your default text editor.
5. Replace {database_guid_here} with your account's dedicated GUID value. If you don't know your GUID, you can find it on the Account page in the Support Portal or retrieve it from the end of your WMS login URL.
   

   configData = '{ "Tpl":"{XXXXXXX}", "Host": "secure-wms.com", "UseHttps":true }';

6. Save your changes to the file, then close the text editor.
7. Once the files are edited and loaded onto your device, unplug your Zebra device from the USB cable and tap the Enterprise Browser app to navigate to the SmartScan homepage.

Step 2b: Update SmartScan configuration

In rare situations, it may be necessary for you to update the SmartScan application files on your Zebra device. If that happens or if you're notified that this is necessary and you are not working with our recommended hardware provider Emkat, you can use the steps below to update these files once you navigate to the install location in the previous section.

Please note that you must have the necessary replacement file that we've provided you before continuing with these steps. The replacement index.html file needed for the changes going into effect on August 18 is attached here.

1. In a new File Explorer window, open the file location of the replacement file.
2. Resize the two File Explorer windows, as needed, to drag and drop the replacement file into the existing install folder. When prompted, confirm that you want to replace the existing file.
3. Once you've replaced the file, unplug your Zebra device from the USB cable and tap the Enterprise Browser app to navigate to the SmartScan homepage.

Back to top