Mobile Web Dynpro Applications Are Not Rendered Properly 

Scenario Type:	Error analysis
NetWeaver Component:	BC-WD-JAV-MOB
Validity:	SAP Web AS 6.40

Symptom

●      A requested Mobile Web Dynpro is not rendered properly.

●      The browser on the Mobile device reports the error message: Sorry, your browser / program is not supported by Web Dynpro!

●      The Mobile Web Dynpro application uses some UI elements or properties or events of UI elements which are not working properly in the Mobile clients.

●      Mobile add-on controls are not working properly in the application.

Potential Problem Causes

●      The Mobile Web Dynpro application is used on a device that is not supported by the Mobile clients.

●      The device recognition for the mobile device is not working correctly.

●      The Mobile Web Dynpro application uses controls and properties/event which are not supported by the Mobile Web Dynpro clients.

●      Mobile add-on controls are used on devices not supported by Mobile Web Dynpro.

●      The required Mobile Scanner control installable is not available on the device.

Preparation

You need to log on to the J2EE Engine as an administrator, so make sure you have a valid administrator user and password.

Architecture

 

Analysis

 

...

       1.      Start the requested Mobile Web Dynpro application in the mobile browser on the device.

       2.      If the browser on the mobile device reports the error message Sorry, your browser / program is not supported by Web Dynpro!, check Mobile Clients and Supported devices.

       3.      If the application is displayed but not rendered properly, check Rendering Problems on Mobile Clients.

       4.      If the application is using Mobile Scanner controls, check Using Mobile Scanner Controls on Mobile Clients.

Mobile Clients and Supported Devices

The Mobile Web Dynpro client supports developing mobile Web Dynpro applications for Pocket PCs as well as for BlackBerry Wireless Handhelds and Nokia Series 80 devices.

If the browser on the mobile device reports the error message Sorry, your browser / program is not supported by Web Dynpro!, you need to check if the Mobile device used is one of the supported device platforms. The list of supported devices is release dependent, for the complete list check the Product Availability Matrix at http://service.sap.com/pam.

If you are using a supported mobile device and you still get the error, then the Device and browser recognition is not working correctly. In such a case, you can force the device recognition by appending the following URL parameter to the Mobile Web Dynpro application.

●      sap-wd-client=PieClient                for Pocket PC in general

●      sap-wd-client=Pie03Client                  for Pocket PC2003 and above

●      sap-wd-client=WmlClient                      for RIM BlackBerry

●      sap-wd-client=NokiaS80Client            for Nokia Communicator 9300/9500

Rendering Problems on Mobile Clients

Mobile Web Dynpro client supports the development of Mobile Web Dynpro applications for Pocket PCs as well as for BlackBerry Wireless Handhelds and Nokia Series 80 devices. Due to the limitations of the small screen and the rendering power of most handheld devices, only a portion of the defined elements are supported.

If your Mobile Web Dynpro application has rendering problems, check if the controls used in the application are supported by Mobile Web Dynpro. The list of controls supported by Mobile Web Dynpro and the specialities for each device can be found in SAP NetWeaver Developer’s Guide. See Mobile Web Dynpro.

Using Mobile Scanner Controls on Mobile Clients

In addition to the standard user interface elements, Mobile Web Dynpro provides a range of interface elements that support the development of mobile Web Dynpro applications using scanners (barcode & RFID). These controls are part of the Mobile add-on library, and consist of

●      FunctionKey

●      BarcodeReader

●      RFIDReader

These UI elements can only be used in a Web Dynpro application that runs on a Pocket PC with special equipment for scanning or an RFID read function. The BarCodeReader, FunctionKey and RFIDReader controls of Mobile Web Dynpro require a special browser to run in. Only reading-enabled browsers from the device manufacturers allow barcode scanning and RFID reading. Scanning and reading is initiated by special content in the HTML pages that has to be recognized by an enabled browser.

If the Mobile Scanner controls are not working in the application, check the following

●      Check for the scanner device

Note that not all vendor devices and device models are supported. Check the Mobile Web Dynpro documentation for the list of supported vendor devices (SAP NetWeaver Developer Studio Documentation, chapter "Development Manual", section "Mobile Web Dynpro", section “Mobile Add-on Library”).

●      Use vendor specific browser to run your application.

●      Mobile Scanner controls require a special browser to run:

¡        On INTERMEC devices use the IBrowse browser.

¡        On SYMBOL devices use the PocketBrowser browser.

●      Check if the required ActiveX control is installed for RFIDReader. To use the RFIDReader control, a vendor specific ActiveX control needs to be installed on the device. Consult your vendor for the ActiveX control installation.

Further information

CSN components and notes

Further information can be found in the CSN system. The notes for Mobile Web Dynpro Client are under component BC-WD-JAV-MOB.