To Next Page

To Previous Page

DataWedge

116

Switch To Profile

Use the SwitchToProfile API action to switch to the specified Profile.

Profiles Recap

DataWedge is based on Profiles and plug-ins. A Profile contains information on how DataWedge should behave

with different applications.

Profile information consists of:

• Associated application

• Input plug-in configurations

• Output plug-in configurations

• Process plug-in configurations

DataWedge includes a default Profile, Profile0, that is created automatically the first time DataWedge runs.

Using Profiles, each application can have a specific DataWedge configuration. For example, each user application

can have a Profile which outputs scanned data in the required format when that application comes to the

foreground. DataWedge can be configured to process the same set of captured data differently based on the

requirements of each application.

NOTE

A single Profile may be associated with one or many activities/apps, however, given an activity, only one Profile

may be associated with it.

Usage Scenario

An application has two activities. Activity A only requires EAN13 bar codes to be scanned. Activity B only requires

MSR card data. Profile B is configured to only scan EAN13 bar codes and is left unassociated. Profile M is

configured to only accept MSR input and is left unassociated. When Activity A launches it uses SwitchToProfile to

activate Profile B. Similarly, when Activity B launches it uses switchToProfile to activate Profile M.

If another activity/app comes to the foreground, DataWedge auto Profile switching will set the DataWedge Profile

accordingly either to the default Profile or to an associated Profile.

When Activity A (or Activity B) comes back to the foreground it will use switchToProfile to reset the Profile back to

Profile B (or Profile M).

Function Prototype

Parameters

action: String "com.symbol.datawedge.api.ACTION_SWITCHTOPROFILE"

extra_data: String "com.symbol.datawedge.api.EXTRA_PROFILENAME"

NOTE Use of this API changes only the runtime status of the scanner; it does not make persistent changes to the

Profile.

Intent i = new Intent();

i.setAction(ACTION);

i.putExtra(EXTRA_DATA, "<profile name>");

Zebra TC25 Integrator Guide

Other manuals for Zebra TC25