Use test mode

Check the scanning configuration by starting Knox Capture’s system-wide test mode and launching a business app. Use test mode to visually confirm scan engine settings and keystroke output rules for each app in the configuration.

Start test mode

1. Start test mode and open the Test configuration screen in one of the following ways:

   • Tap the More actions menu icon next to the Profiles label on the home screen. Select Test apps.
   • Tap the Share button in the lower-right of the home screen. Then, tap the Test configuration button in the Share configuration menu.

2. After starting test mode, look for a system pop-up notification indicating Test mode is on.

   

Select an app to test

1. Either search for an app and tap the Open button next to it in the list on the Test apps screen, or exit Knox Capture and open the app.

   

2. Review the content of the blue test overlay in the open app’s UI. The overlay displays:

   • Activity — The name of the activity in focus.
   • Active profile — The Knox Capture profile to which the in-focus activity belongs. This is the profile defining scan settings and keystroke output rules for the in-focus activity.

   

Scan a barcode and view the test overlay

1. Press the camera scan trigger to open the camera for scanning.

2. Aim the camera at the barcode to scan.

3. View the test overlay. You should see the following new values:

   • Output — The processed data in test mode notation with keystroke output rules applied.
   • Scanned data — 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.

4. Expand the overlay by tapping its down arrow icon for a full view of the test data.

   

5. Inspect and compare the Scanned data to the Output value to verify the correct keystroke output rules and scanning settings for the activity in question.

6. Repeat for each app included in the configuration as required. After testing an app, there should be a green check mark badge next to the app logo on the Test apps screen. Use this to track testing progress.

   

7. Tap All activities under an app to open a list of app activities that are included in the profile you’re testing. Here, you can check if individual activities were tested. If so, a green checkmark appears next to the activity.

8. Clear all the check marks by tapping the additional actions menu icon at the upper-right of the Test apps screen and selecting Clear test activity.

Exit test mode

Exit test mode in one of the following ways:

• Toggle Test mode to the off position on the Test apps screen.
• Tap the X in upper-right corner of the test overlay, then tap Exit to confirm.

Test mode notation

Test mode uses special notation when displaying scanned data in the test overlay to verify the keystroke output rules are set up correctly.

Character representation

• Printable ASCII or Unicode characters are represented in their native printable format. For example, “abc123” appears as “abc123” in the test overlay.
• Non-printable ASCII control characters are represented with standard abbreviation. For example, a Tab control character appears as “HT” in the test overlay.

Standard ASCII control character abbreviations

Type interpretation

String

• Printable ASCII or Unicode characters aren’t modified. For example, “abc” will appear as “abc” in the test overlay.
• Non-printable ASCII control characters get embedded in curly brackets. For example, a Tab control character will appear as “{HT}” in the test overlay if sent as a string.

Key event

Printable and non-printable characters appear in their character representation embedded in angle brackets when sent as key events. For example, if sent as key events, the data abHT appears as <a><b><HT> in the test overlay.

Example

The following example applies test mode notation to scanned barcode data based on a small set of keystroke output rules.

Barcode input: abc\n123\teh

Keystroke output rules:

• Send Enter as String
• Send Tab as Key event
• Send ASCII Printable characters as String

Test mode notation:

• Scanned data: abc{LF}123{HT}eh
• Output : abc{LF}123 eh