Entering content frame

Procedure documentation Modifying Device Properties Locate the document in its SAP Library structure

Use

To adapt the device properties for a specific mobile device to the layout guidelines of your enterprise, you must edit the associated XML file and then store the changed values in the XML document with the .cap extension.

The *.cap XML files for the device types are stored on the Java-enabled Web server in the sub-directory .../mobile.

Procedure

  1. In the XML Editor, open the XML document with the .cap extension containing the device properties of a specific device type. (You can also use the widely available Microsoft Notepad).
  2. 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.
  3. Save your entries.

Note

Note that you can also adapt the display of the Web application to the look and feel of your enterprise. To do this, change the values suggested by SAP returned by the methods of the ClientInfo interface – for example getDefaultActionDesign and getDefaultBullet – to the design laid down by your enterprise.

In some cases, you may also want to change the properties preset by 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.

Note

If you have deleted a property, its default value is returned to the Java application at runtime.

In any case, you must restart the Java Servlet Engine after changing the device properties.

Result

You have updated the XML document .cap, which provides the device properties for a specific mobile device.

Example

In the following example, the values delivered by SAP – "---" of the method getDefaultBlockSeparator and "»" of the method getDefaultBullet – are replaced by the string "***" and the "-" character (&#150 in the source code) in the .cap file.

<!-- edited with XML Spy v3.5 NT (http://www.xmlspy.com) by SAP AG (SAP AG) -->
<!DOCTYPE device SYSTEM "devcap.dtd">
<device>
<backHardWired>true</backHardWired>
<backLabel>false</backLabel>
<backToAnyUrlSupported>true</backToAnyUrlSupported>
<cacheEnabledByDefault>true</cacheEnabledByDefault>
<charHeight>4</charHeight>
<charWidth>16</charWidth>
<contentType>wml</contentType>
<contentTypeVersion>1.1</contentTypeVersion>
<deviceCategory>Phone</deviceCategory>
<deviceName>siemensGeneric</deviceName>
<formFactor>phone</formFactor>
......
<defaultActionDesign>softkey</defaultActionDesign>
<defaultBlockSeparator>***</defaultBlockSeparator>
<defaultBullet>&#150;</defaultBullet>
<defaultFormStyle>onePage</defaultFormStyle>
<defaultMenuStyle>linkList</defaultMenuStyle>
<defaultPageLayoutDesign>sequential</defaultPageLayoutDesign>
</device>

Leaving content frame