Skip to main content

How To Configure the Zebra TC27 Scanner

Introduction​

The purpose of this document is to describe how to configure the built-in scanner on a Zebra TC27 device, using Zebra's DataWedge app and the POS Terminal configuration in the Estate Manager, so that scanned input is passed to Enactor.

The Enactor Mobile POS application must be installed on the device before the scanner can be configured. APK installation is included here as a prerequisite step.

Overview​

This guide covers the following:

  1. Configuring the Scanner with DataWedge - Importing the Enactor profile and associating it with the Enactor POS application
  2. Configuring the POS Terminal - Setting the scanner type and connection on the POS Terminal in the Estate Manager
  3. Broadcasting - Delivering the POS Terminal configuration to the device

Installing the Enactor APK is covered first, as a prerequisite.

note

The Zebra MC40 is another Zebra device that uses the same scanner type and configuration as the TC27, so this guide also applies to the MC40.

Prerequisites​

Resources required:

  • A Zebra TC27 (or MC40) device
  • The Enactor Mobile POS APK
  • The Enactor DataWedge profile file (dwprofile_EnactorV2.db)

You should be familiar with the following:

  • Estate Manager Configuration
  • Provisioning Mobile POS devices (Client Configuration Sets, Option Sets, and device registration)
tip

The Mobile POS device must already be provisioned in the Estate Manager before it can connect. See Configuring the Mobile Client Application on Android for Client Configuration Set, Option Set, and device registration.

Installing the Enactor APK​

Installing the Enactor Mobile POS application is a prerequisite for scanner configuration. If the app is already installed on the device, continue to the scanner configuration below.

The Enactor APK can be installed via a Mobile Device Management (MDM) solution, or manually copied to the device.

To install manually, copy the APK to the device and open it from the file browser (for example, the Downloads folder), then select the Enactor Android app.

Selecting the Enactor APK in the device Downloads folder

Selecting the Enactor Mobile POS APK in the device Downloads folder.

The first time an APK is installed from this source, Android prompts that the device is not currently allowed to install unknown apps from this source. Select Settings and authorise installation when prompted.

Android prompt to allow installation from an unknown source

Allowing installation from an unknown source.

Once installation completes, the app is installed.

Enactor Mobile POS app installed confirmation

The Enactor Mobile POS app is installed.

This completes the APK installation.

Configuring the Scanner with DataWedge​

Zebra devices use a pre-installed app called DataWedge to configure and control the device's built-in scanner. Some configuration is needed in DataWedge to enable it to pass scanned input to Enactor.

info

Obtain the Enactor DataWedge profile file (dwprofile_EnactorV2.db) from your Enactor representative and copy it to the device's file system (for example, the Download folder) before starting.

Open the DataWedge application - it loads the set of DataWedge Profiles. Select the top-right menu button to open the drop-down menu, then select Settings.

DataWedge Profiles list with the drop-down menu open and Settings highlighted

Opening the DataWedge Settings menu.

From the Settings menu, select Import Profile, then navigate the Android file system to locate the dwprofile_EnactorV2.db file and select it. Assuming a successful import, a confirmation message is displayed.

note

Select Import Profile, not Import. These are two different options on the Settings menu.

DataWedge Settings menu showing the configuration imported confirmation

The profile has been imported successfully.

Select the Android Back button to return to the DataWedge Profiles, then select the EnactorV2 profile and select Associated apps.

EnactorV2 profile Associated apps screen

The Associated apps screen for the EnactorV2 profile.

Select the top-right menu option, then select New app / activity. Scroll down the list until com.enactor.mobile.android.pos is reached and select it.

Selecting com.enactor.mobile.android.pos from the application list

Selecting the Enactor POS application.

On the next screen, select *.

Selecting the wildcard activity

Selecting the wildcard activity.

The Enactor POS application is now associated with the EnactorV2 profile.

Associated apps list showing the Enactor POS application added

The Enactor POS application associated with the EnactorV2 profile.

This completes the DataWedge configuration, and the app can now be closed.

Configuring the POS Terminal to use the Zebra Scanner​

The POS Terminal is configured to use the Zebra device's built-in scanner. The POS Terminal maintenance application can be accessed through:

Main Menu > Configuration > Organisation > POS Terminals

Edit the POS Terminal for the relevant Zebra device, select the Peripherals > Input tab, and configure the following values.

POS Terminal scanner configuration on the Peripherals Input tab

Scanner configuration on the POS Terminal Peripherals Input tab.
FieldValue
Scanner 1 TypeMobile Built-In Scanner
Scanner 1 AddressTC27 (or MC40)
Scanner 1 ConnectionAt client (direct)

This completes the POS Terminal configuration.

Broadcasting​

To deliver the configuration change to the device, broadcast the following entity:

  • POS Terminal
info

After broadcasting, restart the POS application for the POS Terminal scanner configuration change to take effect.

tip

Enactor provides a sample Client Configuration Set and Option Set for mobile devices, together with a document describing how to configure a mobile device using them. The Option Set should not normally require any amendment. Obtain these samples from your Enactor representative.