RFIDReader 
Definition
The UI element RFIDReader represents a non-visible UI element used for developing mobile Web Dynpro applications. Despite its name the RFIDReader UI element supports also writing to RFID tags and decommissioning (“killing”) of RFID tags. With this UI element, you can use a Pocket PC equipped with an RFID reader for mobile data entry. To enable the RFID reading, writing and killing, an ActiveX control provided by the manufacturer must be installed on the Pocket PC. The writing and killing functions only are available if you use the Pie03Client.
To use this UI element, you must also install an ActiveX control provided by the vendor on your local mobile device. You can use the classID property to specify this ActiveX control.
The following UML class diagram illustrates the RFIDReader API.
Description of UI Element Properties
● classID
Specifies the name of the ActiveX control, that creates the RFIDReader object – for example, for var reader = new ActiveXObject("SAP.RfidG4"); the value SAP.RfidG4.
● data
Specifies the path to the context node to which you have to bind the RFIDReader element. Depending on the value set to triggerMode, the property contains the data as follows:
○ read: Data to be read from RFID tags
○ write: Data to be written to RFID tags
○ kill: Identifier of the RFID tags to be decommissioned.
● keyCode
Specifies the code of the device key with which the Web Dynpro action is to be triggered. The code is device- and browser-specific and corresponds with the value in the meta-tag <meta http-equiv="" content="">, for example <meta http-equiv="IBrowse_OnKey49" content="IBROWSE_HOME_SCREEN">. More information about the codes is available on the Web pages of the device manufacturer.
● triggerMode
Specifies the working mode of the trigger. triggerMode can take the following values and is represented by the enumeration type WDTriggerMode.
The RFIDReader reads data from the RFID tags |
|
Default value is read.
● visible
To enable you to debug the Web Dynpro application, the value of visible has to be set to visible. In productive applications, this value must be set to none.
Properties Overview
Name |
Interface |
Type |
Initial Value |
Bindable |
classId |
IWDRFIDReader |
String |
|
bindable |
data |
IWDRFIDReader |
Sting |
|
bindable_mandatory |
enabled |
IWDUIElement |
boolean |
true |
bindable |
keyCode |
IWDRFIDReader |
String |
|
bindable |
tooltip |
IWDUIElement |
String |
|
bindable |
triggerMode |
IWDRFIDReader |
WDTriggerMode |
read |
bindable |
visible |
IWDUIElement |
WDVisibility |
visible |
bindable |
Events
● onRead
This event is deprecated, use onTrigger instead.
● onTrigger (int status)
This event is triggered when the user performs an operation as defined in triggerMode. The parameter is the error status. The error status returns the following values:
triggerMode |
status value |
description |
read |
< 0 |
opening Active X control failed |
>= 0 |
success |
|
write |
< 0 |
failure |
>= 0 |
success |
|
kill |
< 0 |
failure |
>= 0 |
success |
Web Dynpro does not interpret the error status value.