Show TOC

Background documentationRFIDReader Locate this document in the navigation structure

 

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.

Note Note

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.

End of the note.

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

    read

    The RFIDReader reads data from the RFID tags

    write

    The RFIDReader writes data to the RFID tags

    kill

    The RFIDReader decommissions data of 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.