Admin get started
Last updated July 26th, 2023
The following tutorial is intended for IT admins, and guides you through the basics of Knox Capture using the default scanning profile as a starting point.
Step 1: Download, install, and launch the app
Knox Capture is available to download from Google Play. As mentioned in the Knox Capture Overview, the app runs in admin mode by default. End-users who wish to use Knox Capture must have the app deployed to their devices through an EMM/UEM.
After installing and launching Knox Capture for the first time, it presents you with links to all of the applicable Terms, Conditions, and privacy policies. Review these, and if you agree to all of the documents, tap Agree.
From the Knox Capture home screen, you can review or dismiss the in-app tips for new users, and access the Knox Capture options by tapping the menu button (three dots) near the top-right next to the search icon.
Step 2: Edit the default profile
Tap Default scanning profile to explore and edit the profile settings. Note that you cannot change the profile’s App list, as the default scanning profile works with all apps on the device. Review Scanning profiles for more information.
Step 3: Change scan engine settings
On the Default scanning profile screen, tap Knox Capture in the Scanner field to view or change the scan engine settings. In this example, you’ll learn how to:
- Update the profile’s list of supported barcode types.
- Enable a flashlight button during a barcode scan.
To change these scan engine settings:
- Tap Barcode types, then scroll down to review the selected types. Upon creation, profiles automatically use Code 128, Code 39, DataMatrix, EAN8, Interleaved 2 of 5, QR, UPCA, and UPCE. Add or remove a barcode type of your choice. For best performance, only select the barcode types necessary when creating the profile.
- Tap Save to return to the Scan engine settings screen.
- Scroll down to Camera Settings, then enable the Flashlight button by moving the slider to the right.
- Tap < Scan engine settings to return to the Default scanning profile screen.
Step 4: Set keystroke output rules
The last step in component of a Knox Capture profile keystroke output rules. In this example, you’ll set rules to append an Enter keystroke to the scanned data. To do this:
- Expand the Keystroke output options, then tap Send Enter character as.
- In the pop-up, select Key event. This emulates a user hitting the Enter key on their keyboard after they type characters into a field.
- Tap Save to return to the Keystroke output options.
- Scroll down to Basic data formatting, then expand the options.
- Enable the Append Enter character option by moving the slider to the right.
- Tap < Default scanning profile to return to the home screen.
Step 5: Test your profile
After making the modifications to your profile, you can test your Knox Capture to ensure that your barcode types, flashlight, and keystroke output rules were configured properly. In this example, you’ll use Samsung Internet to test the configuration.
- On the home screen, tap the options icon in the top-right next to the search icon, then tap Test apps. After starting the test mode, a system pop-up notification indicates that Test mode is on.
- Select the Samsung Internet app from the Test apps list, then tap Open.
- Tap your browser’s search field to bring up the device’s on-screen keyboard. Tap the Knox Capture icon near the top-left side of the keyboard to trigger a scan. Optionally, if you are using a rugged device like an XCover Pro, trigger a scan with the Scan trigger hardware key.
- Test the flashlight by tapping the button near the top-left corner of the screen.
- Aim the camera at a barcode to scan. The barcode will automatically scan once in focus,unless the barcode wasn’t selected in the profile.
- Review the scanned data in the test overlay. You’ll see the following values:
- Output — The processed data in test mode notation with keystroke output rules applied.
- Scanned — The scanned barcode data in test mode notation without any keystroke output rules applied.
- Scanned raw — The scanned barcode data in hexadecimal format without any keystroke output rules applied.
- Inspect and compare the Scanned data to the Output data to ensure you’ve set the correct keystroke output rules. Repeat this test with other apps as required.
- Exit test mode tapping X in the top-right corner of the test overlay, then in the confirmation pop-up, tap Close to return to the Test apps list.
Step 6: Export configuration
After editing your profiles, you can export the configuration as a .txt file. This configuration file can be shared with other Knox Capture IT admins, or it can be used in your EMM/UEM to deploy Knox Capture as a managed-app to end-users. To export a scanning configuration:
- On the home screen, tap the Share button in the lower-right corner.
- In the pop-up, seelct Email, then select your preferred email app. The configuration file is automatically attached.
- After sending the email with the configuration file attached, re-launch Knox Capture. You should see a notification confirming the email submission followed by the date and time.
Step 7: Deploy Knox Capture using an EMM/UEM
You have now configured a basic Knox Capture configuration and exported it as an email attachment. The only thing left to do is use the configuration to deploy Knox Capture as a managed-app to your end-users.
Actual deployment steps vary depending on the EMM provider, but they should generally resemble the following:
Add the Knox Capture app to your Managed Google Play Store.
Assign the app to a group or organization and launch the app configuration dialog. In a typical console, the app configuration dialog opens as a pop-up window or modal.
Activate the license by pasting it into the field within the app configuration (App Config) screen.
Copy and paste the exported configuration into the provided app configuration field. Adding a configuration to Managed Google Play is the only step necessary to ensure all devices installing the app operate in Managed mode. However, if you’re using a trial version of Knox Capture, you’ll need to push a Knox Suite license key as well.
Refer to the following table for details on the configuration data:
Configuration key Configuration type Configuration value smartscan_license String Knox license key smartscan_config String Exported configuration data from Knox Capture
Save the updated settings and deploy.
You have now completed a typical Knox Capture workflow for IT admins, and have been introduced to configuring and deploying the app to managed devices. For more information, browse the how-to guides for detailed instructions for each feature.
Is this page helpful?