DATAWEDGEUSERGUIDE

TableofContents
DATAWEDGECONFIGURATION
Introduction
Profiles
Profile0

Plugins
InputPlugins
ProcessPlugins
OutputPlugins

ProfilesScreen
ProfileContextMenu
OptionsMenu
DisablingDataWedge

CreateaNewProfile
ConfiguringaProfile
Applications
BarcodeInput
MSRInput
KeystrokeOutput
IntentOutput
IPOutput

GeneratingAdvancedDataFormattingRules
ConfiguringADFPlugin

DataWedgeSettings
ImportConfigurationFile
ExportConfigurationFile
RestoreDataWedge

ConfigurationFileManagement
EnterpriseFolder
AutoImport

ProgrammingNotes
OverridingTriggerKeyinanApplication
CaptureDataandTakingaPhotointheSameApplication
DisableDataWedgeonmobilecomputerandMassDeploy

DATAWEDGECONFIGURATION
Introduction
DataWedgeisanapplicationthatreadsdata,processesthedataandsendsthedatatoanapplication.

Profiles
DataWedgeisbasedonprofilesandplugins.AprofilecontainsinformationonhowDataWedgeshouldbehave
withdifferentapplications.
Profileinformationconsistsof:
Associatedapplication
Inputpluginconfigurations
Outputpluginconfigurations
Processpluginconfigurations
Usingprofiles,eachapplicationcanhaveaspecificDataWedgeconfiguration.Forexample,eachuserapplication
canhaveaprofilewhichoutputsscanneddataintherequiredformatwhenthatapplicationcomestotheforeground.
DataWedgecanbeconfiguredtoprocessthesamesetofcaptureddatadifferentlybasedontherequirementsof
eachapplication.
DataWedgeincludesthefollowingvisibleandhiddenpreconfiguredprofileswhichsupportspecificbuiltin
applications:
Visibleprofiles:
Profile0createdautomaticallythefirsttimeDataWedgeruns.Genericprofileusedwhenthereareno
usercreatedprofilesassociatedwithanapplication.
LauncherdisablesscanningwhentheLauncherisinforeground.
DWDemolauncherstheDWDemoapplicationanddisplaysthecaptureddataintheapplication.

Hiddenprofiles(notshowntothedevice):
RDClientprovidessupportforMSP.
MSPAgentprovidessupportforMSP.
MspUserAttributeprovidessupportforMSP.
Cameradisablesscanningwhenthedefaultcameraapplicationisinforeground.
RhoElementsdisablesscanningwhenRhoElementsisinforeground.

Profile0
Profile0canbeeditedbutcannotbeassociatedwithanapplication.Thatis,DataWedgeallowsmanipulationof
pluginsettingsforProfile0butitdoesnotallowassignmentofaforegroundapplication.Thisconfigurationallows
DataWedgetosendoutputdatatoanyforegroundapplicationotherthanapplicationsassociatedwithuserdefined
profileswhenProfile0isenabled.
Profile0canbedisabledtoallowDataWedgetoonlysendoutputdatatothoseapplicationswhichareassociated
inuserdefinedprofiles.Forexample,createaprofileassociatingaspecificapplication,disableProfile0andthen
scan.DataWedgeonlysendsdatatotheapplicationspecifiedintheusercreatedprofile.Thisaddsadditional
securitytoDataWedgeenablingthesendingofdataonlytospecifiedapplications.

Plugins
ApluginisasoftwaremoduleutilizedinDataWedgetoextenditsfunctionalitytoencompasstechnologiessuchas
barcodescanning.Thepluginscanbecategorizedintothreetypesbasedontheiroperations:
InputPlugins
OutputPlugins
ProcessPlugins

InputPlugins
AnInputPluginsupportsaninputdevice,suchasabarcodescannercontainedin,orattachedtothemobile

computer.DataWedgecontainsbasepluginsfortheseinputdevices.
BarCodeScannerInputPlugin
TheBarCodeScannerInputPluginisresponsibleforreadingdatafromtheintegratedbarcodescannerand
supportsdifferenttypesofbarcodereadersincludinglaser,imagerandinternalcamera.Rawdatareadfromthebar
codescannercanbeprocessedorformattedusingProcessPluginsasrequired.DataWedgehasbuiltinfeedback
functionalityforthebarcodescannertoissueuseralerts.Thefeedbacksettingscanbeconfiguredaccordingtouser
requirement.
MSRInputPlugin
TheMSRInputPluginisresponsibleforreadingdatafromtheintegratedMSRreaderorattachedScan/MSR
Module.RawdatareadfromthebarcodescannercanbeprocessedorformattedusingProcessPluginsasrequired.

ProcessPlugins
ProcessPluginsareusedinDataWedgetomanipulatethereceiveddataaccordingtotherequirement,before
sendingtotheforegroundapplicationviatheOutputPlugin.
BasicFormatProcessPlugin
TheBasicFormatPluginallowsDataWedgetoaddaprefixand/orasuffixtothecaptureddatabeforepassingitto
anOutputPlugin.
AdvancedFormatProcessPlugin
TheAdvancedFormatPluginallowsDataWedgetoaddaprefixand/orasuffixtothecaptureddatabeforepassing
ittoanOutputPlugin.

OutputPlugins
OutputPluginsareresponsibleforsendingthedatafromInputPluginstoaforegroundapplicationontheET1.
KeystrokeOutputPlugin
TheKeystrokeOutputPlugincollectsandsendsdatareceivedfromtheInputPlugintotheforegroundapplications
byemulatingkeystrokes.

IntentOutputPlugin
TheIntentOutputPlugincollectsandsendsdatareceivedfromtheInputPluginstoforegroundapplicationsusing
theAndroidIntentmechanism.
IPOututPlugin
TheIPOutputPluginallowscaptureddatatobesentoveranIPnetworktoaspecifiedIPaddressandportusing
eitherTCPorUDPtransportprotocols.

ProfilesScreen
TolaunchDataWedge,touch
profilesappear:

>DataWedge.TheDataWedgeProfilesscreenappears.Bydefault,three

Profile0
Launcher
DWDemo
Profile0isthedefaultprofileandisusedwhennootherprofilecanbeapplied.

Figure1.DataWedgeProfilesScreen
Profilenamesarecolorcoded.Enabledprofilesarewhiteanddisabledprofilesaregray.
Toconfigureaprofiletouchtheprofilename.

ProfileContextMenu
Touchandholdaprofiletoopenacontextmenuthatallowsadditionalactionstobeperformedontheselected
profile.

Figure2.ProfileContextMenu
Theprofilecontextmenuallowstheprofiletobeedited(sameasjusttouchingaprofile),renamedordeleted.

OptionsMenu
Touch

toopentheoptionsmenu.

Figure3.DataWedgeOptionsMenu
Themenuprovidesoptionstocreateanewprofiles,accesstogeneralDataWedgesettingsandDataWedgeversion
information.

DisablingDataWedge
TodisableDataWedge:
1.Touch

>DataWedge

2.Touch

>Settings

3.TouchDataWedgeenabled.ThegreencheckdisappearsfromthecheckboxindicatingthatDataWedgeis
disabled.

CreateaNewProfile
Tocreateanewprofile:
1.Touch

>DataWedge.TheDataWedgeProfileswindowappears.

2.Touch

>Newprofile.

3.Inthedialogbox,enteranameforthenewprofile.Itisrecommendedthatprofilenamesbeuniqueandmade
upofonlyalphanumericcharacters(AZ,az,09).

Figure4.NewProfileNameDialogBox
4.TouchOK.ThenewprofilenameappearsintheDataWedgeprofilesscreen.

ConfiguringaProfile
ToconfiguretheProfile0orausercreatedprofile,touchtheprofilename.TheProfileconfigurationscreenappears.

Figure5.ProfileConfigurationScreen
ProfileenabledEnablesordisablesthisprofile.Acheckinthecheckboxindicatesthattheprofileis
enabled.

Applications
UsetheApplicationsoptiontoassociateapplicationswiththisprofile.

AssociatedApps
Usercreatedprofilesshouldbeassociatedwithoneormoreapplicationsanditsactivities.
1.TouchAssociatedapps.Alistofapplications/activitiesassociatedwiththeprofiledisplays.Initiallythelist
doesnotcontainanyapplications/activities.

Figure6.AssociatedAppsScreen
2.Touch

>Newapp/activity.TheSelectapplicationmenuappears.

Figure7.SelectApplicationMenu
3.Selectthedesiredapplicationfromthelist.TheSelectactivitymenuappears.

Figure8.SelectActivityMenu
4.Selectingtheactivityaddsthatapplication/activitycombinationtotheassociatedapplicationlistforthat
profile.Selecting*astheactivityresultsinallactivitieswithinthatapplicationbeingassociatedtotheprofile.
Duringoperation,DataWedgewilltrytomatchthespecificapplication/activitycombinationswiththe
foregroundapplication/activitybeforetryingtomatchthegeneralapplication/*combinations.
5.Touch

Figure9.SelectedApplication/Activity

BarcodeInput
UsetheBarCodeInputoptionstoconfiguretheBarCodeScannerInputPluginfortheprofile.
Enabled
Enablesordisablesthisplugin.Acheckinthecheckboxindicatesthatthepluginisenabled.
ScannerSelection
Configureswhichscanningdevicetousefordatacapture.
AutoAutomaticallydeterminesthebestscanningdevice.IfaScanModuleorScan/MSRModuleisinstalled

onthemobilecomputer,thenthe2Dimagerisselected.Otherwisethecameraisselected.
CameraScannerScanningisperformedwiththerearfacingcamera.
2DImagerScanningisperformedusingtheinstalledScanorScan/MSRmodule.
Decoders
Configureswhichbarcodedecodersareenabledordisabled.Forbestperformancedisableallunnecessarydecoders.
TouchDecoders.TheBarcodeinputscreenappears.Acheckinthecheckboxindicatesthatthedecoderis
enabled.Bydefaultthemostcommonlyuseddecodersareenabled(shownbelowwithanasterisk).Thesupported
decodersare:
UPCE0*

UPCE1

UPCA*

MSI

EAN8*

EAN13*

Codabar*

Code39*

Discrete2of5

Interleaved2of5

Code11

Code93

Code128*

PDF417*

Trioptic39

MicroPDF*

MacroPDF*

Maxicode*

Datamatrix*

QRCode*

MacromicroPDF*

GS1DataBar

GS1DataBarLimited

GS1DataBarExpanded

CompositeAB*

Webcode

CompositeC*

TLC39*

USPostnet

USPlanet

UKPostal

JapanesePostal

AustralianPostal

CanadianPostal

DutchPostal

Chinese2of5

Aztec*

MicroQR

Korean3of5

US4state
Touch

US4stateFICS

Matrix2of5

toreturntothepreviousscreen.

DecoderParams
UseDecodeParamstoconfigureindividualdecoderparameters.TouchDecodeParams.TheDecodeparams
screenappears.Touchthedecoderparametertomodify.
UPCE0
ReportCheckDigitThecheckdigitisthelastcharacterofthesymbolusedtoverifytheintegrityofthe
data.Enablesordisablesthisoption.Acheckinthecheckboxindicatesthattheoptionisenabled(default
disabled).
PreamblePreamblecharactersarepartoftheUPCsymbolconsistingofCountryCodeandSystem
Character.TherearethreeoptionsfortransmittingaUPCE0preamble:
PreambleSysCharTransmitSystemCharacteronly.
PreambleCountryandSysCharTransmitSystemCharacterandCountryCode("0"forUSA).
PreambleNoneTransmitnopreamble(default).
Selecttheappropriateoptiontomatchthehostsystem.
ConvertUPCE0ToUPCAEnabletoconvertUPCE0(zerosuppressed)decodeddatatoUPCAformat
beforetransmission.Afterconversion,thedatafollowsUPCAformatandisaffectedbyUPCAprogramming
selections.DisabletotransmitUPCE0decodeddataasUPCE0data,withoutconversion(defaultdisabled).
UPCE1
ReportCheckDigitThecheckdigitisthelastcharacterofthesymbolusedtoverifytheintegrityofthe
data.Enablesordisablesthisoption.Acheckinthecheckboxindicatesthattheoptionisenabled(default
disabled).
PreamblePreamblecharactersarepartoftheUPCsymbolconsistingofCountryCodeandSystem
Character.TherearethreeoptionsfortransmittingaUPCE1preamble:
PreambleSysCharTransmitSystemCharacteronly.

PreambleCountryandSysCharTransmitSystemCharacterandCountryCode("0"forUSA).
PreambleNoneTransmitnopreamble(default).
Selecttheappropriateoptiontomatchthehostsystem.
ConvertUPCE1ToUPCAEnablethistoconvertUPCE1decodeddatatoUPCAformatbefore
transmission.Afterconversion,thedatafollowsUPCAformatandisaffectedbyUPCAprogramming
selections.DisablethistotransmitUPCE1decodeddataasUPCE1data,withoutconversion(default
disabled).
UPCA
ReportCheckDigitThecheckdigitisthelastcharacterofthesymbolusedtoverifytheintegrityofthedata.
Enablesordisablesthisoption.Acheckinthecheckboxindicatesthattheoptionisenabled(defaultenabled).
PreamblePreamblecharactersarepartoftheUPCsymbolconsistingofCountryCodeandSystem
Character.TherearethreeoptionsfortransmittingaUPCApreamble:
PreambleSysCharTransmitSystemCharacteronly.
PreambleCountryandSysCharTransmitSystemCharacterandCountryCode("0"forUSA).
PreambleNoneTransmitnopreamble(default).
Selecttheappropriateoptiontomatchthehostsystem.
MSI
Length1[endnote1]TodecodeaMSIsymbolwithaspecificlengthrangesetthisvaluetothelowerlimit.For
example,todecodeMSIsymbolscontainingbetween4and12characters,setthisvalueto4.(default4).
Length2[endnote1]TodecodeaMSIsymbolwithaspecificlengthrangesetthisvaluetotheupperlimit.For
example,todecodeMSIsymbolscontainingbetween4and12characters,setthisvalueto12(default55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
CheckDigitWithMSIsymbols,onecheckdigitismandatoryandalwaysverifiedbythereader.Thesecond
checkdigitisoptional.
OneCheckDigitVerifyonecheckdigit(default).
TwoCheckDigitsVerifytwocheckdigits.

CheckDigitSchemeTwoalgorithmsarepossiblefortheverificationofthesecondMSIcheckdigit.Select
thealgorithmusedtoencodethecheckdigit.
Mod1110FirstcheckdigitisMOD11andsecondcheckdigitisMOD10(default).
Mod1010BothcheckdigitsareMOD10.
ReportCheckDigitTransmitMSIdatawithorwithoutthecheckdigit.Acheckinthecheckboxindicatesto
sendMSIdatawithcheckdigit(defaultdisabled).
EAN8
ConvertEAN8ToEAN13ConvertEAN8datatoEAN13.Acheckinthecheckboxindicatesthattheoption
isenabled(defaultdisabled).
Codabar
Length1[endnote1]TodecodeaCodabarsymbolwithaspecificlengthrangesetthisvaluetothelowerlimit.
Forexample,todecodeCodabarsymbolscontainingbetween8and24characters,setthisvalueto8.(default
6).
Length2[endnote1]TodecodeaCodabarsymbolwithaspecificlengthrangesetthisvaluetotheupperlimit.
Forexample,todecodeCodabarsymbolscontainingbetween8and24characters,setthisvalueto24(default
55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
ClsiEditingEnablethisparametertostripthestartandstopcharactersandinsertaspaceafterthefirst,
fifth,andtenthcharactersofa14characterCodabarsymbol.Enablethisfeatureifthehostsystemrequiresthis
dataformat(defaultdisabled).
NotisEditingEnablethisparametertostripthestartandstopcharactersfromadecodedCodabarsymbol.
Enablethisfeatureifthehostsystemrequiresthisdataformat(defaultdisabled).
Code39
Length1[endnote1]TodecodeaCode39symbolwithaspecificlengthrangesetthisvaluetothelowerlimit.
Forexample,todecodeCode39symbolscontainingbetween8and24characters,setthisvalueto8.(default
0).
Length2[endnote1]TodecodeaCode39symbolwithaspecificlengthrangesetthisvaluetotheupperlimit.

Forexample,todecodeCode39symbolscontainingbetween8and24characters,setthisvalueto24(default
55).
VerifyCheckDigitEnablethisfeaturetochecktheintegrityofallCode39symbolstoverifythatthedata
complieswithaspecifiedcheckdigitalgorithm.ThedigitalscannerdecodesonlythoseCode39symbolsthat
includeamodulo43checkdigit.EnablethisfeatureonlyiftheCode39symbolscontainamodulo43check
digit(defaultdisabled).
ReportCheckDigitTransmitCode39datawithorwithoutthecheckdigit.Acheckinthecheckbox
indicatestosendCode39datawithcheckdigit(defaultdisabled).
FullAsciiCode39FullASCIIisavariantofCode39thatpairscharacterstoencodethefullASCIIcharacter
set.ToenableordisableCode39FullASCII(defaultdisabled).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultdisabled).
ConvertCode39ToCode32Code32isavariantofCode39usedbytheItalianpharmaceuticalindustry.
ScantheappropriatebarcodebelowtoenableordisableconvertingCode39toCode32(defaultdisabled).
ReportCode32PrefixScantheappropriatebarcodetoenableordisableaddingtheprefixcharacter"A"to
allCode32barcodes(defaultdisabled).
SecurityLevelOptions:Securitylevel0,SecurityLevel1,SecurityLevel2andSecurityLevel3
(defaultSecuritylevel1).
Discrete2of5
Length1[endnote1]TodecodeaDiscrete2of5symbolwithaspecificlengthrangesetthisvaluetothelower
limit.Forexample,todecodeDiscrete2of5symbolscontainingbetween4and12characters,setthisvalueto
4.(default0).
Length2[endnote1]TodecodeaDiscrete2of5symbolwithaspecificlengthrangesetthisvaluetotheupper
limit.Forexample,todecodeDiscrete2of5symbolscontainingbetween4and12characters,setthisvalueto
12(default14).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
Interleaved2of5
Length1[endnote1]TodecodeanInterleaved2of5symbolwithaspecificlengthrangesetthisvaluetothe

lowerlimit.Forexample,todecodeInterleaved2of5symbolscontainingbetween4and12characters,setthis
valueto4(default14).
Length2[endnote1]TodecodeanInterleaved2of5symbolwithaspecificlengthrangesetthisvaluetothe
upperlimit.Forexample,todecodeInterleaved2of5symbolscontainingbetween4and12characters,setthis
valueto12(default10).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
CheckDigit
NoCheckDigitAcheckdigitisnotused.(default).
USSCheckDigitSelecttochecktheintegrityofallInterleaved2of5symbolstoverifythedata
complieswitheithertheUniformSymbologySpecification(USS)checkdigitalgorithm.
OPCCCheckDigitSelecttochecktheintegrityofallInterleaved2of5symbolstoverifythedata
complieswitheithertheOpticalProductCodeCouncil(OPCC)checkdigitalgorithm.
ReportCheckDigitTransmitInterleaved2of5datawithorwithoutthecheckdigit.Acheckinthe
checkboxindicatestosendI2of5datawithcheckdigit(defaultdisabled).
ConvertITF14ToEAN13Convert14characterInterleaved2of5barcodestoEAN13,andtransmitas
EAN13.TheInterleaved2of5barcodemustbeenabledandmusthavealeadingzeroandavalidEAN13
checkdigit.Acheckinthecheckboxindicatesthattheoptionisenabled(defaultdisabled).
Code11
Length1[endnote1]TodecodeaCode11symbolwithaspecificlengthrangesetthisvaluetothelowerlimit.
Forexample,todecodeCode11symbolscontainingbetween4and12characters,setthisvalueto4(default
4).
Length2[endnote1]TodecodeaCode11symbolwithaspecificlengthrangesetthisvaluetotheupperlimit.
Forexample,todecodeCode11symbolscontainingbetween4and12characters,setthisvalueto12(default
55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
VerifyCheckDigitChecktheintegrityofallCode11symbolstoverifythatthedatacomplieswiththe
specifiedcheckdigitalgorithm.ThisselectsthecheckdigitmechanismforthedecodedCode11barcode.

NoCheckDigitDonotverifycheckdigit.
OneCheckDigitBarcodecontainsonecheckdigit(default).
TwoCheckDigitsbarcodecontainstwocheckdigits.
ReportCheckDIgitTransmitCode11datawithorwithoutthecheckdigit.Acheckinthecheckbox
indicatestosendCode11datawithcheckdigit(defaultdisabled).
Code93
Length1[endnote1]TodecodeaCode93symbolwithaspecificlengthrangesetthisvaluetothelowerlimit.
Forexample,todecodeCode93symbolscontainingbetween4and12characters,setthisvalueto4(default
0).
Length2[endnote1]TodecodeaCode93symbolwithaspecificlengthrangesetthisvaluetotheupperlimit.
Forexample,todecodeCode93symbolscontainingbetween4and12characters,setthisvalueto12(default
55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultdisabled).
Code128
Length1[endnote1]TodecodeaCode128symbolwithaspecificlengthrangesetthisvaluetothelowerlimit.
Forexample,todecodeCode128symbolscontainingbetween4and12characters,setthisvalueto4(default
0).
Length2[endnote1]TodecodeaCode128symbolwithaspecificlengthrangesetthisvaluetotheupperlimit.
Forexample,todecodeCode128symbolscontainingbetween4and12characters,setthisvalueto12(default
55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultdisabled).
EnableEAN128SettheEAN128subtype.Acheckinthecheckboxindicatesthattheoptionisenabled
(defaultenabled).
EnableISBT128SettheISBT128subtype.Acheckinthecheckboxindicatesthattheoptionisenabled
(defaultenabled).
EnablePlainCode128Enablesother(nonEANorISBT)Code128subtypes.Acheckinthecheckbox

indicatesthatredundancyisenabled(defaultenabled).
ISBT128ConcatModeSelectanoptionforconcatenatingpairsofISBTcodetypes:
ConcatModeNeverDonotconcatenatepairsofISBTcodesencountered(default).
ConcatModeAlwaysTheremustbetwoISBTcodesinordertodecodeandperformconcatenation.
DoesnotdecodesingleISBTsymbols.
ConcatModeAutoDecodesandconcatenatespairsofISBTcodesimmediately.IfonlyasingleISBT
symbolispresent,thedevicemustdecodethesymbolthenumberoftimessetviaRedundancyCode128
beforetransmittingitsdatatoconfirmthatthereisnoadditionalISBTsymbol.
CheckISBTTableTheISBTspecificationincludesatablethatlistsseveraltypesofISBTbarcodesthatare
commonlyusedinpairs.IfISBT128ConcatModeisset,enableCheckISBTTabletoconcatenateonly
thosepairsfoundinthistable.OthertypesofISBTcodesarenotconcatenated.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultdisabled).
SecurityLevelThescanneroffersfourlevelsofdecodesecurityforCode128barcodes.Selectincreasing
levelsofsecurityfordecreasinglevelsofbarcodequality.Thereisaninverserelationshipbetweensecurityand
scanneraggressiveness,sochooseonlythatlevelofsecuritynecessaryforanygivenapplication.
SecurityLevel0Thissettingallowsthescannertooperateinitsmostaggressivestate,while
providingsufficientsecurityindecodingmost"inspec"barcodes.
SecurityLevel1Thissettingeliminatesmostmisdecodes(default).
SecurityLevel2SelectthisoptionifSecuritylevel1failstoeliminatemisdecodes.
SecurityLevel3IfSecurityLevel2isselectedandmisdecodesstilloccur,selectthissecuritylevel.Be
advised,selectingthisoptionisanextrememeasureagainstmisdecodingseverelyoutofspecbarcodes.
Selectingthislevelofsecuritysignificantlyimpairsthedecodingabilityofthescanner.Ifthislevelof
securityisneeded,trytoimprovethequalityofthebarcodes.
Trioptic39
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).</li>
MicroPDF
Code128EmulationEnablethisoptiontotransmitdatafromcertainMicroPDF417symbolsasCode128.
AIMCodeIDCharactermustbeenabledforthisoptiontowork(defaultdisabled).

EnableCode128EmulationtotransmittheseMicroPDF417symbolswithoneofthefollowingprefixes:
]C1ifthefirstcodewordis903905
]C2ifthefirstcodewordis908or909
]C0ifthefirstcodewordis910or911
DisableCode128EmulationtotransmittheseMicroPDF417symbolswithoneofthefollowingprefixes:
]L3ifthefirstcodewordis903905
]L4ifthefirstcodewordis908or909
]L5ifthefirstcodewordis910or911.
Webcode
WebcodeSubtypeEnablesthedecodingoftheGTWebcodesubtype.Acheckinthecheckboxindicatesthat
theoptionisenabled(defaultenabled).
CompositeAB
UCCLinkMode
LinkFlagignored
AlwaysLinked
AutoDiscriminate(default).
MultiPacketMode
MultiPartSinglePacket(default)
MutliindependentReads
UseUPCPreambleCheckDigitUsetheUPCrulesspecifiedintheUPCEANparameterswhenreporting
compositedecodedata(defaultdisabled).
CompositeC
MultiPacketMode
MultiPartSinglePacket(default)
MutliindependentReads

USPostnet
ReportCheckDigitTransmitUSPostnetdatawithorwithoutthecheckdigit.Acheckinthecheckbox
indicatestosendUSPostnetdatawithcheckdigit(defaultdisabled).
USPlanet
ReportCheckDigitTransmitUSPlanetdatawithorwithoutthecheckdigit.Acheckinthecheckbox
indicatestosendUSPlanetdatawithcheckdigit(defaultdisabled).
UKPostal
ReportCheckDigitTransmitUKPostaldatawithorwithoutthecheckdigit.Acheckinthecheckbox
indicatestosendUKPostaldatawithcheckdigit(defaultdisabled).
Korean3of5
Length1[endnote1]TodecodeaKorean3of5symbolwithaspecificlengthrangesetthisvaluetothelower
limit.Forexample,todecodeKorean3of5symbolscontainingbetween4and12characters,setthisvalueto4
(default1).
Length2[endnote1]TodecodeaKorean3of5symbolwithaspecificlengthrangesetthisvaluetotheupper
limit.Forexample,todecodeKorean3of5symbolscontainingbetween4and12characters,setthisvalueto12
(default55).
RedundancySetsthereadertoreadthebarcodetwicebeforeacceptingdata.Acheckinthecheckbox
indicatesthatredundancyisenabled(defaultenabled).
DecodeLengths
TheallowabledecodelengthsarespecifiedbyLength1andLength2asfollows:
Variablelength:Decodesymbolscontaininganynumberofcharacters.
SetbothLength1andLength2to0.
Range:Decodeasymbolwithaspecificlengthrange(fromatob,includingaandb).
SetLength1toaandsetLength2tob.
TwoDiscreteLengths:Decodeonlysymbolscontainingeitheroftwoselectedlengths.
SeteitherLength1orLength2tothespecificlengths.

OneDiscreteLength:Decodeonlysymbolscontainingaspecificlength.
SetbothLength1andLength2tothespecificlength.
UPCEANParams
AllowstheconfigurationoftheparametersthatapplytomorethanoneUPCorEANdecoder.
SecurityLevelThescanneroffersfourlevelsofdecodesecurityforUPC/EANbarcodes.Selecthigher
securitylevelsforlowerqualitybarcodes.Thereisaninverserelationshipbetweensecurityanddecodespeed,
sobesuretochooseonlythatlevelofsecuritynecessaryfortheapplication.
Level0Thisdefaultsettingallowsthescannertooperatefastest,whileprovidingsufficientsecurityin
decoding"inspec"UPC/EANbarcodes(default).
Level1Asbarcodequalitylevelsdiminish,certaincharactersbecomepronetomisdecodesbefore
others(i.e.,1,2,7,8).Ifthescannerismisdecodingpoorlyprintedbarcodes,andthemisdecodesare
limitedtothesecharacters,selectthissecuritylevel.
Level2Ifthescannerismisdecodingpoorlyprintedbarcodes,andthemisdecodesarenotlimitedto
characters1,2,7,and8,selectthissecuritylevel.
Level3Ifthescannerisstillmisdecoding,selectthissecuritylevel.Beadvised,selectingthisoptionis
anextrememeasureagainstmisdecodingseverelyoutofspecbarcodes.Selectingthislevelofsecurity
cansignificantlyimpairthedecodingabilityofthescanner.Ifthislevelofsecurityisnecessary,tryto
improvethequalityofthebarcodes.
Supplemental2Enablesordisablesthisoption.Acheckinthecheckboxindicatesthattheoptionis
enabled.
Supplemental5Enablesordisablesthisoption.Acheckinthecheckboxindicatesthattheoptionis
enabled.
SupplementalMode
NoSupplementalsthescannerispresentedwithaUPC/EANplussupplementalsymbol,thescanner
decodesUPC/EANandignoresthesupplementalcharacters(default).
SupplementalAlwaysthescanneronlydecodesUPC/EANsymbolswithsupplementalcharacters,
andignoressymbolswithoutsupplementals.
SupplementsAutothescannerdecodesUPC/EANsymbolswithsupplementalcharacters
immediately.Ifthesymboldoesnothaveasupplemental,thescannermustdecodethebarcodethe

numberoftimessetviaUPC/EANSupplementalRedundancybeforetransmittingitsdatatoconfirmthat
thereisnosupplemental.
SupplementalSmartEnablessmartsupplementals.Inthismodethedecoderreturnsthedecoded
valueofthemainblockrightawayifitdoesnotbelongtooneofthefollowingsupplementaltypes:378,
379,977,978,979,414,419,434or439.Ifthebarcodestartswithoneoftheprefixesitsearchesthe
imagemoreaggressivelyforasupplemental.Triestoscanthesupplementalifitispresent.Ifthe
supplementalscanningfailed,thenthemainbarcodeisreturned.
Supplemental378379Enables(autodiscriminate)supplementalforUPC/EANcodesstartingwith
378or379.DisablesreadingofsupplementalsforanyotherUPC/EANbarcodenotstartingwith378or
379.Triestoscanthesupplementalifitispresent.Ifthesupplementalscanningfailed,thenthemainbar
codeisreturned.
Supplemental978979Enables(autodiscriminate)supplementalforUPC/EANcodesstartingwith
978or979.DisablesreadingofsupplementalsforanotherUPC/EANbarcodenotstartingwith978or
979.Triestoscanthesupplementalifitispresent.Ifthesupplementalscanningfailed,thenthemain
barcodeisreturned.
Supplemental414419434439Enables(autodiscriminate)supplementalforUPC/EANcodes
startingwith414,419,434or439.DisablesreadingofsupplementalsforanotherUPC/EANbarcodenot
startingwith414,419,434or439.Triestoscanthesupplementalifitispresent.Ifthesupplemental
scanningfailed,thenthemainbarcodeisreturned.
Supplemental977Enables(autodiscriminate)supplementalforUPC/EANcodesstartingwith977.
DisablesreadingofsupplementalsforanotherUPC/EANbarcodenotstartingwith977.Triestoscanthe
supplementalifitispresent.Ifthesupplementalscanningfailed,thenthemainbarcodeisreturned.
RetryCountRetrycountforautodiscriminatingforsupplementals.Possiblevaluesare2to20inclusive.
NotethatthisflagisonlyconsideredifSupplementalModeissettooneofthefollowingvalues:
SupplementalsAuto,SupplementalsSmart,Supplementals378379,Supplementals978979,
Supplementals977orSupplementals414419434439(2to20,default10).
RandomCheckDigitEnablesrandomweightcheckdigitverification.Acheckinthecheckboxindicates
thattheoptionisenabled.
LinearDecodeEnableslineardecode.Acheckinthecheckboxindicatesthattheoptionisenabled.
BooklandEnableordisablethisoption.Acheckinthecheckboxindicatesthattheoptionisenabled.
CouponEnablesCouponcodedecoding.NotethatinordertosuccessfullydecodeCouponcodes,allofthe
correctdecodersmustbeenabled.Acheckinthecheckboxindicatesthattheoptionisenabled.

BooklandFormatIfBooklandoptionisenabled,selectoneofthefollowingformatsforBooklanddata:
FormatISBN10ThescannerreportsBooklanddatastartingwith978intraditional10digitformat
withthespecialBooklandcheckdigitforbackwardcompatibility.Datastartingwith979isnot
consideredBooklandinthismode(default).
FormatISBN13ThescannerreportsBooklanddata(startingwitheither978or979)asEAN13in13
digitformattomeetthe2007ISBN13protocol.
ConvertGS1ToUPCEANIfthisissetitconvertsGS1barcodestoUPC/EANformat.Forthissettingto
workUPC/EANsymbologiesmustbeenabled.Acheckinthecheckboxindicatesthattheoptionisenabled.
ReaderParams
Allowstheconfigurationofparametersspecifictotheselectedbarcodereader.
BeamTimerSetsthemaximumamountoftimethatthereaderremainson(060,000msinincrementsof
100ms).Avalueof0setsthereadertostayonindefinitely(default15000).
LinearSecurityLevelSetsthenumberoftimesabarcodeisreadtoconfirmanaccuratedecode.
SecurityRedundancyandLengthTwotimesreadredundancybasedonredundancyflagsandcode
length.
SecurityShortorCodabarTwotimesreadredundancyifshortbarcodeorCodabar.
SecurityAllTwiceTwotimesreadredundancyforallbarcodes(default).
SecurityLongandShortTwotimesreadredundancyforlongbarcodes,threetimesforshortbar
codes.
SecurityAllThriceThreetimesreadredundancyforallbarcodes.
PicklistThisparameterallowstheimagertodecodeonlythebarcodethatisdirectlyunderthecross
hair/reticle(+)partofthepattern.Thisfeatureismostusefulinapplicationswheremultiplebarcodesmay
appearinthefieldofviewduringadecodesessionandonlyoneofthemistargetedfordecode.
DisableDisablesPicklistmode,soanybarcodewithinthefieldofviewcanbedecoded(default).
CenteredEnablesthePicklistmodesothatonlythebarcodeinthecenteroftheimageisdecoded.
Thisismostusefulwhenusedinconjunctionwiththestaticanddynamicreticleviewfindermodes.Note:
Thismodeisonlyvalidfordecodermodulesthatsupportsaviewfinder.Ifonetriestosetthisfora
unsupporteddecoderthenthedevicewouldissueanerror.(Camerascanneronly).
ReticleEnablesthePicklistmodesothatonlythebarcodethatisdirectlyunderthecrosshair(reticle)

isdecoded.Thisisusefulwhenusedinconjunctionwiththestaticanddynamicreticleviewfindermodes.
(ScanModuleOnly).
IlluminationmodeTurnsilluminationonandoff.
OnIlluminationison.
OffIlluminationisoff(default).
LCDModeEnablesordisablesLCDmode.LCDmodeenhancestheabilityoftheimagertoreadbarcodes
fromLCDdisplayssuchascellphones(ScanModuleOnly).
DisableDisablestheLCDmode
EnableEnablesLCDmode.

WhenusingtheLCDmode,adegradationinperformancemaybeobservedandthe
aimingcrosshairmayblinkuntilthebarcodeisdecoded.

Inverse1DModeAllowstheusertoselectdecodingoninverse1Dbarcodes.
DisabledDisablesdecodingofinverse1Dsymbologies(default).
EnabledEnablesdecodingofonlyinverse1Dsymbologies.
AutoAllowsdecodingofbothpositiveaswellasinverse1Dsymbologies.
ViewfinderModeThissettingdisplaystheViewfindermodessupportedforscanning.
ViewfinderEnabledEnablesonlytheviewfinder.
StaticReticleEnablestheviewfinderandaredreticleinthecenterofthescreenwhichhelpsselecting
thebarcode(default).
ScanParams
AllowstheconfigurationofCodeIdanddecodefeedbackoptions.
CodeIDTypeACodeIDcharacteridentifiesthecodetypeofascannedbarcode.Thisisusefulwhenthe
readerisdecodingmorethanonecodetype.SelectacodeIDcharactertoinsertbetweentheprefixandthe
decodedsymbol.

CodeIDTypeNoneNoprefix(default).
CodeIDTypeAimAstandardsbasedthreecharacterprefix.
CodeIDTypeSymbolASymboldefinedsinglecharacterprefix.
Notallringtonesarefullysupportedasdecodetones.Ringtonesoflongerlength
maybetruncatedwhenusedasadecodetone.Therecommendationistotestthe
selectedtoneforoperationbeforedeploymenttoacustomersite.
DecodeAudioFeedbackSelectanaudiotonetosounduponagooddecode.
DecodeHapticFeedbackEnablethemobilecomputertovibrateuponagooddecode(defaultenabled).

MSRInput
UseMSRInputoptionstoconfiguretheMSRInputPluginfortheprofile.
Enabled
Enablesordisablesthisplugin.Acheckinthecheckboxindicatesthatthepluginisenabled.

KeystrokeOutput
UsetoconfiguretheKeystrokeOutputPluginfortheprofile.
EnabledEnablesordisablesthisplugin.Acheckinthecheckboxindicatesthatthepluginisenabled.
ActionkeycharacterEnableddecodingaspecialcharactersembeddedwithinabarcodeorMSRdata.
Noneactionkeynotinjected
TabinjectactionkeyinplaceofaASCIITab(0x09)character
LinefeedinjectactionkeyinplaceofASCIILF(0x0A)character
CarriagereturninjectactionkeyinplaceofASCIICR(0x0D)character
Advanceddataformattingisawaytocustomizingdatabeforetransmission.Useadvanceddata

formatting(ADF)toeditscandatatosuitrequirements.
EnableEnablesordisablesADF.AcheckinthecheckboxindicatesthatADFisenabled(default
disabled).
RulesADFusesrulestocustomizedata.Theserulesperformdetailedactionswhenthedatameets
certaincriteria.Onerulemayconsistofsingleormultiplecriteriaappliedtosingleormultipleactions.
SeeGeneratingAdvancedDataFormattingRulesbelowformoreinformation.
BasicdataformattingallowsconfigurationofanydataformattingfortherelatedOutputPluginforthe
profile.Whenthepluginisdisabledanydataispassedonwithoutmodification.
EnabledEnablesordisablesBasicDataFormatting.Acheckinthecheckboxindicatesthatitisenabled
(defaultenabled).
PrefixtodataAddcharacterstothebeginningofthedatawhensent.
SuffixtodataAddcharacterstotheendofthedatawhensent.
SenddataSettotransferthecaptureddatatotheforegroundapplication.Disablingthisoption
preventstheactualdatafrombeingtransmitted.However,theprefixandsuffixstrings,ifpresent,arestill
transmittedevenwhenthisoptionisdisabled(defaultenabled).
SendashexSettosendthedatainhexadecimalformat.Acheckinthecheckboxindicatesthatthis
settingisenabled(defaultdisabled).
SendTABkeySettoappendatabcharactertotheendoftheprocesseddata.Acheckinthecheckbox
indicatesthatthissettingisenabled(defaultdisabled).
SendENTERkeySettoappendanEntercharactertotheendoftheprocesseddata.Acheckinthe
checkboxindicatesthatthissettingisenabled(defaultdisabled).

IntentOutput
AllowsconfigurationoftheIntentOutputPluginfortheprofile.TheIntentOutputPluginallowsthecaptureddata
tobesenttoanapplicationintheformofanimplicitIntent.RefertotheAndroidDeveloperwebsiteformore
information,http://developer.android.com.
EnabledEnablesordisablesthisplugin.Acheckinthecheckboxindicatesthatthepluginisenabled
(defaultdisabled).
IntentactionEntertheIntentActionname(required).

IntentcategoryEntertheIntentCategoryname(required).
IntentdeliverySelectthemethodbywhichtheintentisdelivered:
SendviaStartActivity
SendviastartService
Broadcastintent
Advanceddataformattingisawaytocustomizingdatabeforetransmission.Useadvanceddata
formatting(ADF)toeditscandatatosuitrequirements.
EnableEnablesordisablesADF.AcheckinthecheckboxindicatesthatADFisenabled(default
disabled).
RulesADFusesrulestocustomizedata.Theserulesperformdetailedactionswhenthedatameets
certaincriteria.Onerulemayconsistofsingleormultiplecriteriaappliedtosingleormultipleactions.
SeeGeneratingAdvancedDataFormattingRulesbelowformoreinformation.
BasicdataformattingallowsconfigurationofanydataformattingfortherelatedOutputPluginforthe
profile.Whenthepluginisdisabledanydataispassedonwithoutmodification.
EnabledEnablesordisablesBasicDataFormatting.Acheckinthecheckboxindicatesthatitisenabled
(defaultenabled).
PrefixtodataAddcharacterstothebeginningofthedatawhensent.
SuffixtodataAddcharacterstotheendofthedatawhensent.
SenddataSettotransferthecaptureddatatotheforegroundapplication.Disablingthisoption
preventstheactualdatafrombeingtransmitted.However,theprefixandsuffixstrings,ifpresent,arestill
transmittedevenwhenthisoptionisdisabled(defaultenabled).
SendashexSettosendthedatainhexadecimalformat.Acheckinthecheckboxindicatesthatthis
settingisenabled(defaultdisabled).
SendTABkeySettoappendatabcharactertotheendoftheprocesseddata.Acheckinthecheckbox
indicatesthatthissettingisenabled(defaultdisabled).
SendENTERkeySettoappendanEntercharactertotheendoftheprocesseddata.Acheckinthe
checkboxindicatesthatthissettingisenabled(defaultdisabled).
IntentOverview

Thecorecomponentsofanapplication(itsactivities,services,andbroadcastreceivers)areactivatedbyintents.An
intentisabundleofinformation(anIntentobject)describingadesiredactionincludingthedatatobeactedupon,
thecategoryofcomponentthatshouldperformtheaction,andotherpertinentinstructions.Androidlocatesan
appropriatecomponenttorespondtotheintent,launchesanewinstanceofthecomponentifoneisneeded,and
passesittheIntentobject.
Componentsadvertisetheircapabilities,thekindsofintentstheycanrespondto,throughintentfilters.Sincethe
Androidsystemmustlearnwhichintentsacomponentcanhandlebeforeitlaunchesthecomponent,intentfilters
arespecifiedinthemanifestas<intentfilter>elements.Acomponentmayhaveanynumberoffilters,eachone
describingadifferentcapability.
Forexample,ifthemanifestcontainsthefollowing:
<intentfilter...>
<actionandroid:name="android.intent.action.DEFAULT"/>
<categoryandroid:name="android.intent.category.MAIN"/>
...
</intentfilter>

IntheIntentoutputpluginconfiguration,theIntentactionwouldbe:
android.intent.category.DEFAULT

andtheIntentcategorywouldbe:
android.intent.category.MAIN

TheIntentdeliveryoptionallowsthemethodbywhichtheintentisdeliveredtobespecified.Thedelivery
mechanismsareSendviastartActivity,SendviastartServiceorBroadcastintent.
ThedecoderelateddataaddedtotheIntent'sbundlecanberetrievedusingtheIntent.geStringtExtra()and
Intent.getSerializableExtra()calls,usingthefollowingStringtags:
StringLABEL_TYPE_TAG="com.motorolasolutions.emdk.datawedge.label_type"
Stringcontainsthelabeltypeofthebarcode.

StringDATA_STRING_TAG="com.motorolasolutions.emdk.datawedge.data_string"
StringcontainstheoutputdataasaString.Inthecaseofconcatenatedbarcodes,thedecodedatais
concatenatedandsentoutasasinglestring.
StringDECODE_DATA_TAG="com.motorolasolutions.emdk.datawedge.decode_data"
Decodedataisreturnedasalistofbytearrays.Inmostcasestherewillbeonebytearrayperdecode.For
barcodesymbologiesthatsupportconcatenatione.g.Codabar,Code128,MicroPDF,etc.,thedecodeddatais
storedinmultiplebytearrays(onebytearrayperbarcode).Clientscangetdataineachbytearraybypassing
anindex.
TheMSRrelateddataaddedtotheIntentsbundlecanberetrievedusingtheIntent.getStringtExtra()and
Intent.getSerializableExtra()calls,usingthefollowingStringtags:
StringMSR_DATA_TAG="com.motorolasolutions.emdk.datawedge.msr_data"
ThedatafromtheMSRtracksisconcatenatedandsentoutasabytearray.TheStart/endsentinelsandtrack
separatorsareincludedasconfigured.
StringMSR_TRACK1_TAG="com.motorolasolutions.emdk.datawedge.msr_track1"
MSRtrack1dataisreturnedasabytearray.
StringMSR_TRACK2_TAG="com.motorolasolutions.emdk.datawedge.msr_track2"
MSRtrack2dataisreturnedasabytearray.
StringMSR_TRACK3_TAG="com.motorolasolutions.emdk.datawedge.msr_track3"
MSRtrack3dataisreturnedasabytearray.
StringMSR_TRACK1_STATUS_TAG="com.motorolasolutions.emdk.datawedge.msr_track1_status"
MSRtrack1decodestatusasanIntegerwhere0indicatesasuccessfuldecode.
StringMSR_TRACK2_STATUS_TAG="com.motorolasolutions.emdk.datawedge.msr_track2_status"
MSRtrack2decodestatusasanIntegerwhere0indicatesasuccessfuldecode.
StringMSR_TRACK3_STATUS_TAG="com.motorolasolutions.emdk.datawedge.msr_track3_status"
MSRtrack3decodestatusasanIntegerwhere0indicatesasuccessfuldecode.
Mostscanningapplicationsmightwanttheusertobeabletodecodedataandforthatdecodedatatobesenttothe
currentactivitybutnotnecessarilydisplayed.Ifthisisthecase,thentheactivityneedstobemarkedas"singleTop"
initsAndroidManifest.xmlfile.IfyouractivityisnotdefinedassingleTop,thenoneverydecode,thesystemwill
createanothercopyofyourActivityandsendthedecodedatatothissecondcopy.
Finallytherewillbeaconfigurationoptionforeachprocesspluginsothattheprocessplugincanbeconfigured

specificallyfortheintentoutput,whichinthiscaseisthebasicdataformattingprocessplugin.

IPOutput
UsetheIPOutputoptionstoconfiguretheIPOutputPluginfortheprofile.
EnabledEnablesordisablesthisplugin.Acheckinthecheckboxindicatesthatthepluginisenabled
(defaultdisabled).
RemoteWedgeEnablesthisplugintobeusedwithIPWedge.Makesurethisoptionisuncheckedwhennot
usingIPWedge.SeeIPWedgebelow.(defaultenabled).
ProtocolSelectthetransportprotocol(defaultTCP)
TCP
UDP
IPaddressEntertheIPaddressofthehost(default0.0.0.0)
PortEntertheportnumber(default58627)
IPWedge
IPWedgeisaPCapplicationthatcanbeeasilyconfiguredtoretrievedatasentoveranetworkbytheDataWedgeIP
OutputPluginonaMotoroladevice.
IfyouintendtouseIPoutputinconjunctionwithIPWedge,downloadtheIPWedgeinstallationpackagefrom
MotorolasEnterpriseMobilitysupportsiteathttp://support.symbol.com/support/product/DEV_SW_TOOLS.html
tothehostPC.
PleaseseetheIPWedgeusermanualonhowtoinstallandconfigureonaPC.
UsingIPoutputwithIPWedge
InordertogetIPoutputtosendcaptureddatatoaremotecomputerthatisinstalledwithIPWedgeconfigure
followingitems:
1.Touch

>DataWedge.

2.TouchaDataWedgeprofile.
3.InIPoutput,touchEnabled.

4.TouchProtocol.Selectthedesiredtransportprotocol.
5.TouchIPaddress.EntertheIPaddressofthehostcomputerandthentouchOK.
6.TouchPort.EntertheportnumberandthentouchOK.
UsingIPOutputPluginwithoutIPWedge
IPoutputplugincanbeusedtosendcaptureddatafromDataWedgeapplicationtoremotedeviceorPCwithout
IPWedge.Atthedatareceivingend,thePCorMobiledeviceshouldhaveaclientapplication,thatlistenstoTCPor
UDPdatacomesfromconfiguredportandIPaddressinIPOutputplugin.InordertogetIPoutputplugin
configuredtosendcaptureddatatoaremotecomputerordevice,followthesesteps.
1.Touch

>DataWedge.

2.TouchaDataWedgeprofile.
3.InIPoutput,touchEnabled.
4.TouchRemoteWedgetodisabletheRemoteWedgeoption.
5.TouchProtocol.Selectthedesiredtransportprotocol.
6.TouchIPaddress.EntertheIPaddressofthehostcomputerandthentouchOK.
7.TouchPort.EntertheportnumberandthentouchOK.

GeneratingAdvancedDataFormattingRules
TheADFpluginappliesrules(actionstobeperformedbasedondefinedcriteria)tothedatareceivedviatheInput
pluginbeforesendingittotheOutputplugin.
RulesTheADFprocesspluginconsistsofoneormorerules.DataWedgeformatstheoutputdataaccording
tothefirstmatchingrule.Aruleisacombinationofcriteriaandasetofactionstobeperformed,upon
fulfillmentofthecriteriasetintherule.
CriteriaCriteriacanbesetaccordingtoInputplugin,symbology,matchingstringwithinthedata(atthe
specifiedposition)and/ordatalength.Receiveddatamustmatchthedefinedcriteriainorderforthedatatobe
processed.
ActionsAsetofproceduresdefinedtoformatdata.Therearefourtypesofactionswhichareforformatting
cursormovement,datamodification,datasendinganddelayspecifications.Anactioncanbedefinedtosend

thefirstnumberofcharacterstotheOutputplugin,padtheoutputdatawithspacesorzeros,removespacesin
data,etc.

ConfiguringADFPlugin
ConfiguringtheADFpluginconsistsofcreatingarule,definingthecriteriaanddefiningtheactions.
1.Touch

>DataWedge.

2.TouchaDataWedgeprofile.
3.InKeystrokeoutput,touchAdvanceddataformatting.

Figure10.AdvancedDataFormattingScreen
4.TouchtheEnablecheckboxtoenableADF.

CreatingaRule
Bydefault,Rule0,istheonlyruleintheRuleslist.Toaddanewrule:
1.Touch

>Newrule.

2.TouchtheEnterrulenametextbox.Inthetextbox,enteranameforthenewruleandthentouchDone.
3.TouchOK.
Todefinetherule:
1.TouchthenewlycreatedruleintheRulesList.

Figure11.RuleScreen
2.TouchtheRuleenabledcheckboxtoenablethecurrentrule.

DefiningCriteria
Todefineacriteria:
1.TouchCriteria.TheCriteriascreenappears.

Figure12.CriteriaScreen
2.TouchStringtocheckforoptiontospecifythestringthatmustbepresentinthedata.
3.IntheEnterthestringtocheckfordialogbox,enterthestringandthentouchDone.
4.TouchOK.
5.TouchStringpositionoptiontospecifythepositionofthestringspecifiedintheStringtocheckfor
option.TheADFruleisonlyappliedifthespecificstringinStringtocheckforisfoundatthespecified
Stringpositionlocation.

6.Touchthe+ortochangethevalue.
7.TouchOK.
8.TouchStringlengthoptiontospecifyalengthforthereceiveddata.TheADFruleonlyappliestothebarcode
datawiththatspecifiedlength.
9.Touchthe+ortochangethevalue.
10.TouchOK.
11.TouchSourcecriteriaoptiontoassociateaninputdevicetoanADFrule.TheADFruleonlyappliestodata
receivedfromassociatedinputdevices.
12.TouchBarcodeinputorMSRinput.Optionsvarydependinguponthedeviceconfiguration.
13.TouchtheSourceenabledcheckboxtoacceptdatafromthissource.

Figure13.BarcodeInputScreen

14.ForBarcodeinputs,touchtheAlldecodersenabledcheckboxtoselectallbarcodesymbologies.Deselect
theAlldecodersenabledcheckboxandthenindividuallyselectthesymbologies.
15.Touch

untiltheRulescreenappears.

16.Ifrequired,repeatstepstocreateanotherrule.
17.Touch

untiltheRulescreenappears.

DefineanAction
BydefaulttheSendremainingactionisintheActionslist.Toaddanaction:
1.Touch

>Newaction.

2.IntheNewactionmenu,selectanactiontoaddtotheActionslist.ThetablebelowliststhesupportedADF
actions.
3.SomeActionsrequireadditionalinformation.TouchtheActiontodisplayadditionalinformationfields.
4.Repeatstepstocreatemoreactions.
5.Touch

6.Touch

DeleteaRule
Todeleteanexistingrule:
1.Touchandholdonaruleuntilthecontextmenuappears.
2.TouchDeletetodeletetherulefromtheRuleslist.

WhenthereisnoruleavailableforADFpluginorallrulesaredisabled,DataWedge
passesdecodeddatatotheoutputpluginwithoutprocessingthedata.

OrderRulesList
Rulesareprocessedintopdownorder.Therulesthatareontopofthelistareprocessedfirst.Usetheiconnextto
theruletomoveittoanotherpositioninthelist.

Table1.ADFSupportedActions
Type

Actions

Description

CursorMovement

Skipahead

Movesthecursorforwardbyaspecifiednumberofcharacters.
Enterthenumberofcharacterstomovethecursorahead.

Skipback

Movesthecursorbackbyaspecifiednumberofcharacters.
Enterthenumberofcharacterstomovethecursorback.

Skiptostart

Movesthecursortothebeginningofthedata.

Moveto

Movesthecursorforwarduntilthespecifiedstringisfound.
Enterthestringinthedatafield.

Movepast

DataModification

Movesthecursorforwardpastthespecifiedstring.Enterthe
stringinthedatafield.

Crunchspaces

Removespacesbetweenwordstooneandremoveallspacesat
thebeginningandendofthedata.

Stopspacecrunch

Stopsspacecrunching.ThisdisablesthelastCrunchspaces
action.

Removeallspaces

Removeallspacesinthedata.

Stopspaceremoval

Stopremovingspaces.ThisdisablesthelastRemoveall
spacesaction.

Removeleadingzeros

Removeallzerosatthebeginningofdata.

Stopzeroremoval

Stopremovingzerosatthebeginningofdata.Thisdisablesthe
previousRemoveleadingzerosaction.

Padwithzeros

Leftpaddatawithzerostomeetthespecifiedlength.Enterthe
numberzerostopad.

DataSending

Stoppadzeros

Stoppaddingwithzeros.ThisdisablesthepreviousPadwith
zerosaction.

Replacestring

Replacesaspecifiedstringwithanewstring.Enterthestring
toreplaceandthestringtoreplaceitwith.

Stopallreplacestring

StopallReplacestringactions.

Sendnext

Sendsthespecifiednumberofcharactersfromthecurrent
cursorposition.Enterthenumberofcharacterstosend.

Sendremaining

Sendsalldatathatremainsfromthecurrentcursorposition.

Sendupto

Sendsalldatauptoaspecifiedstring.Enterthestring.

Sendpause

Pausesthespecifiednumberofmillisecondsbeforecontinuing
thenextaction.Entertheamountoftimeinmilliseconds.

Sendstring

Sendsaspecifiedstring.Enterthestringtosend.

Sendchar

SendsaspecifiedASCII/Unicodecharacter.Enteracharacter
value.ThemaximumUnicodecharactervaluecanbeenteredis
U10FFFF(=1114111indecimal).

DeleteanAction
TodeleteanactionfromtheActionslist,touchandholdtheactionnameandselectDeleteactionfromthecontext
menu.
ADFExample
Thefollowingillustratesanexampleofcreatingadvanceddataformatting:
Whenauserscansabarcodewiththefollowingcriteria:
Code39barcode
lengthof12characters

contains129atthestartposition
DataWedgeformatthedata:
Padallsendswithzerostolength8
sendalldatauptocharacterX
sendaspacecharacter.
TocreateanADFrulefortheaboveexample:
1.Touch

>DataWedge>Profile0.

2.TouchAdvanceddataformatting.
3.TouchEnable.
4.TouchRule0.
5.TouchCriteria.
6.TouchStringtocheckfor.
7.IntheEnterthestringtocheckfortextbox,enter129andthentouchOK.
8.TouchStringposition.
9.Changevalueto0andthentouchOK.
10.TouchStringlength.
11.Changevalueto12andthentouchOK.
12.TouchSourcecriteria.
13.TouchBarcodeinput.
14.TouchAlldecodersenabledtodisablealldecoders.
15.TouchCode39.
16.Touch

threetimes.

17.TouchandholdontheSendremainingruleuntilamenuappears.
18.TouchDeleteaction.
19.Touch

>Newaction.

20.SelectPadwithzeros.ThePadwithzerosruleappearsintheActionslist.
21.TouchthePadwithzerosrule.
22.TouchHowmany.
23.Changevalueto8andthentouchOK.
24.Touch

25.Touch

>Newaction.

26.SelectSendupto.TheSenduptoruleappearsintheActionlist.
27.TouchSenduptorule.
28.TouchString.
29.IntheEnterastringtextbox,enterXandthentouchOK.
30.Touch

31.Touch

>Newaction.

32.SelectSendchar.TheSendchartoruleappearsintheActionlist.
33.TouchSendcharrule.
34.TouchCharactercode.
35.IntheEntercharactercodetextbox,enter32andthentouchOK.
36.Touch

Figure14.ADFSampleScreen
37.Ensurethatanapplicationisopenonthemobilecomputerandatextfieldisinfocus(textcursorintextfield).
38.Aimtheexitwindowatthebarcode.

Figure15.SampleBarcode
39.PressandholdtheRightScan/Actionbutton.Theredlaseraimingpatternturnsontoassistinaiming.Ensure

thatthebarcodeiswithintheareaformedbytheaimingpattern.TheLeftandRightLEDslightredtoindicate
thatdatacaptureisinprocess.
40.TheLeftandRightLEDslightgreen,abeepsoundsandthemobilecomputervibrates,bydefault,toindicate
thebarcodewasdecodedsuccessfully.Theformatteddata000129X<space>appearsinthetextfield.Scanning
aCode39barcodeof1299X15598doesnottransmitdata(ruleisignored)becausethebarcodedatadidnot
meetthelengthcriteria.

Figure16.FormattedData

DataWedgeSettings
TheDataWedgeSettingsscreenprovidesaccesstogeneral,nonprofilerelatedoptions.Touch

>Settings.

Figure17.DataWedgeSettingsWindow
DataWedgeenabledEnablesordisablesDataWedge.TodisableDataWedgeuncheckthisoption.
ImportallowsimportofaDataWedgeconfigurationfilefromtheOndeviceStorage.Theimported
configurationreplacesthecurrentconfiguration.
ExportallowsexportofthecurrentDataWedgeconfigurationtotheOndeviceStorage.
ImportProfileallowsimportofanindividualDataWedgeprofilefromtheOnDeviceStorage.Iftheprofile
alreadyexists,theimportedprofilereplacesit.
ExportProfileallowsexportofanindividualDataWedgeprofiletotheOndeviceStorage.
Restorereturnthecurrentconfigurationbacktofactorydefaults.

ImportConfigurationFile
ToimportaDataWedgeconfigurationfile:
1.CopytheconfigurationfiletotherootofthemobilecomputerOndeviceStorage.
2.Touch

>DataWedge.

3.Touch

>Settings>Import.

4.TouchSDCardandthenImport.Theconfigurationfile(datawedge.db)isimportedandreplacesthecurrent
configuration.

ExportConfigurationFile
ToexportaDataWedgeconfigurationfile:
1.Touch

>DataWedge.

2.Touch

>Settings>Export.

3.TouchSDCardandthenExport.Theconfigurationfile(datawedge.db)issavedtotherootofthemobile
computerOndeviceStorage.

RestoreDataWedge
TorestoreDataWedgetothefactorydefaultconfiguration:
1.Touch

>DataWedge>

>Settings>Restore.

2.TouchYes.

ConfigurationFileManagement
TheconfigurationsettingsforDataWedgecanbesavedtoafilefordistributiontoothermobilecomputers.
Aftermakingconfigurationchanges,exportthenewconfigurationtotherootoftheOndeviceStorage.Thefile

createdisautomaticallynameddatawedge.db.Thisdatawedge.dbfilecanthenthecopiedtotheOndeviceStorageof
otherdevicesandimportedintoDataWedgeonthosedevices.Importingaconfigurationreplacestheexisting
configuration.

EnterpriseFolder
InternalstoragecontainstheEnterprisefolder(/enterprise).TheEnterprisefolderispersistentandmaintainsdata
afteranEnterprisereset.AfteranEnterpriseReset,DataWedgechecksfolder
/enterprise/device/settings/datawedge/enterprisereset/foraconfigurationfile,datawedge.db.Ifthefileisfound,it
importsthefiletoreplaceanyexistingconfiguration.

AFactoryResetdeletesallfilesintheEnterprisefolder.

AutoImport
DataWedgesupportsremotedeploymentofaconfigurationtothemobilecomputer,usingtoolssuchasMSP.
DataWedgemonitorsthe/enterprise/device/settings/datawedge/autoimportfolderforthedatawedge.dbfile.When
DataWedgelaunchesitchecksthefolder.Ifadatawedge.dbfileisfound,itimportsthefiletoreplaceanyexisting
configuration.Oncethedatawedge.dbfilehasbeenimporteditisdeletedfromthefolder.
WhileDataWedgeisrunningitreceivesanotificationfromthesystemthatadatawedge.dbfileisplacedintothe
/enterprise/device/settings/datawedge/autoimportfolder.Whenthisoccurs,DataWedgeimportsthisnew
configuration,replacingtheexistingoneanddeletethedatawedge.dbfile.DataWedgebeginsusingtheimported
configurationimmediately.

ItisstronglyrecommendedthattheuserexitsDataWedgebeforeremotelydeployingany
configuration,andthatthedataWedge.dbfilepermissionsaresetto777.

ProgrammingNotes
OverridingTriggerKeyinanApplication
Tooverridethetriggerkeyinanapplication,createaprofilefortheapplicationthatdisablestheBarcodeinput.In
theapplication,usestandardAPIs,suchasonKeyDown()tolistenfortheKEYCODE_BUTTON_L1and
KEYCODE_BUTTON_R1presses.

CaptureDataandTakingaPhotointheSameApplication
Tobeabletocapturebarcodedataandtakeaphotointhesameapplication:
CreateaDatawedgeprofilepertainingtothepicturetakingActivityinyourapplicationthatdisablesscanningand
usestandardAndroidSDKAPIstocontroltheCamera.
ThedefaultDatawedgeprofiletakescareofthescanningintheapplication.Youmightwanttocreateanother
DataWedgeprofilethatcaterstoanyspecificscanningneeds,associatedtoyourApplicationsActivitypertainingto
scanning.

DisableDataWedgeonmobilecomputerandMassDeploy
TodisableDataWedgeanddeployontomultiplemobilecomputers:
1.Touch

>DataWedge>

>Settings.

2.UnselecttheDataWedgeenabledcheckbox.
3.ExporttheDataWedgeconfiguration.SeeExportConfigurationFileaboveforinstructions.
SeeConfigurationFileManagementaboveforinstructionsforusingtheautoimportfeature.

Version0.1
Lastupdated2013071715:09:13BST