Modifying Device Properties (SAP Library - Administrator’s Guide to Device Recognition)

Modifying Device Properties

Use

To adapt the device properties for a specific mobile device to the layout guidelines of your enterprise, edit the associated XML files and then import the changed values into the appropriate R/3 table.

The XML files are stored (compressed) in the devices.zip file in the MIME Repository of the SAP Web Application Server.

You will find this file by choosing SAP ® Client_Info ® devices.zip.

Prerequisites

You are developing in an SAP System on the SAP Web Application Server 6.10 or later.

Procedure

Open the devices.zip file and save the unpacked XML files locally on your hard drive.

Choose a file for a device.

Note

Note that you can modify the .pfe file. This allows you to adapt the display of the Web application to the look and feel of your enterprise. In some cases, you may also want to change the properties stored in the .cap file for the device – for example, if a Web application is displayed in landscape format on a handheld device like a pocket PC. Normally, the getPixelHeight and getPixelWidth methods return values that display the application in portrait format.

Open the file in an appropriate Editor – either an XML Editor or Microsoft Notepad.

Change the appropriate data or add new values for a specific device type. (See the example for more details). For a summary of all available device properties, see the template file template.cap and the Document Type Definition (DTD) files devcap.dtd.

Note

If you have deleted a property, its default value is entered in the instance of ClientInfo at runtime.

Save your entries.

Open the R/3 System using the SAP GUI and launch the CI_IMPORT transaction, which imports the changed device recognition data.

A dialog box appears. To import the changed device recognition data into the R/3 tables enter the following in the appropriate fields:

The URL of the devices.xml configuration file, either as an HTTP address (such as http://.../devices.xml) or as a file address (such as file://c:\ ...\devices.xml).

The name of the proxy server (optional)

The name of the port (optional)

Note

If you choose the devices.xml file using an HTTP address, you need a Web server.

You need only enter the name of the proxy server and port if your system is protected by a firewall.

At the end of the import process, you will receive a list of all the imported device types and a confirmation message if the program has been executed successfully.

Result

You have updated the R/3 tables that provide the device properties for a specific mobile device.

Example

In the following example, the values delivered by SAP – "---" of the property Default_Block_Separator and "»" of the attribute Default_Bullet – are replaced by the string "***" and the "-" character (&#150 in the source code) in the dev.cap file.

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE device SYSTEM "devcap.dtd">
<device>
<CPU>Nokia</CPU>
<accept>.wml</accept>
<appLinkTypes></appLinkTypes>
<backIsHardWired>true</backIsHardWired >
<backMustNotHaveLabel>true</backMustNotHaveLabel>
<backToAnyURL>true</backToAnyURL>
<deviceName>siemensC35</deviceName>
......
<defaultActionDesign>softkey</defaultActionDesign>
<defaultBlockSeparator>***</defaultBlockSeparator>
<defaultBullet></defaultBullet>
<defaultFormStyle>onePage</defaultFormStyle>
<defaultMenuStyle>linkList</defaultMenuStyle>
<defaultPageLayoutDesign>sequential</defaultPageLayoutDesign>
</device>