Overview
DataWedge can be associated with any app on the device and called upon to acquire barcode, mag-stripe or other data, to process the data in a specified way, and to pass it to one or more apps. Therefore, each Profile must specify these three things:
Input device determines whether to acquire data from barcodes, a magnetic stripe or using SimulScan.
Process options manipulate the acquired data using Basic or Advanced data formatting processes.
Output method specifies whether to pass data as keystrokes, within an intent and/or over an IP network.
For more information about DataWedge Profiles, see the Architecture Overview.
Create a New Profile
The launcher icon for DataWedge varies from one system and version to another. The icon for DataWedge 6.x is shown below. Locate the DataWedge icon and tap it to begin.
Launcher icon for DataWedge 6.x
On a new installation, the DataWedge Profiles screen appear similar to that of the image below, showing the three included (visible) Profiles. White text indicates enabled Profiles. Also shown is a fourth, disabled Profile (grey text) that's not present out-of-the-box.
Note: If DataWedge had been opened previously, it will reopen to the last screen used. If necessary, press BACK until the Profiles screen appears.
2. Tap the "hamburger" menu and select -> New profile.
3. Enter a name for the new Profile and tap OK. The Profiles list appears, similar to the image in Step 4, below.
Zebra recommends that Profile names be unique and contain alpha-numeric characters only.
Associate the Profile with App(s) and/or Activities:
4. Tap the Profile to be associated:
5. From the Profile screen, tap the "Profile enabled" checkbox to enable it, then tap "Associated apps" to link it with an app or activity:
6. Tap the menu and select -> New app/activity. A list appears with all apps and activities installed on the device.
7. From the device apps/activities list, select the app or activity to associate with the Profile being edited. When an app is selected, its activities list appears (see Step 8).
8. From the app activities list, tap the asterisk to associate all app activities with the Profile, or tap on an indvidual activity to use DataWedge for that specific activity only:
9. The app now appears in the Profile associations list as below. Repeat Steps 6-8 until all desired apps and/or activities are associated.
When finished adding associations, Tap the BACK button to return to the Profile screen.
Configure a Profile for Input, Processing and Output:
10. From the Profile screen, enable the desired Input device (scrolling down as necessary). For example, the Barcode Input displays an option for Scanner selection:
11. From the Scanner selection screen, select the desired scanner or imager. Tap BACK to return to the Input screen.
Note: Lists such as the one above display only devices that are present on (or connected to) the unit being configured. For related information, see Scanner Selection in the Barcode Input guide.
12. From the Decoders screen (accessible from the Input screen), select only the decoders required by the application to optimize scanning performance. Tap BACK to return to the Input screen. For more information about configuring Decoder parameters, see the Barcode Input Guide.
13. From the Profile screen, select the desired Output method (scrolling down as necessary). For example, the image below shows that Keystroke Output is enabled:
Note: Output sections contain selectors for configuring "Basic data formatting" and "Advanced data formatting." These contain the data Processing options.
14. Select the Basic data formatting for options on inserting special keystrokes or adding text before (prefix) and/or after (suffix) the collected data:
See Basic Data Formatting and Advanced Data Formatting sections for more information about processing of acquired data.
The app will now use DataWedge for barcode data acquisition.
Editing Profiles
To modify, rename, delete or clone a profile:
1. Long-press the Profile name to bring up its Context menu.
2. Tap on the desired action:
Editing a Profile also can be started by tapping the Profile name in the Profile list.
Related Guides:
- Profile Architecture Overview - explains how DataWedge uses Profiles
- Profile Options - links and details for all DataWedge Profile options
- DataWedge APIs - access DataWedge programmatically