Entering content frame

Procedure documentation Integrating Additional Mobile Devices Locate the document in its SAP Library structure

Use

To make device properties for additional mobile devices available, create a new XML file, then import the device recognition data for the new device type into the appropriate R/3 tables.

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

  1. Open the devices.zip file and save the unpacked XML files locally on your hard drive.
  1. To create a file for a new device type, choose the template.cap file provided for the purpose. This is stored with the other unpacked XML files. The template.cap file lists all the available device properties. They offer an overview of all available device properties, as well as providing help when you want to enter device-specific values for these properties. All available device properties are also stored in the DTD files devcap.dtd and devpfe.dtd.

Note

You only need to define properties for a specific device.

If you do not define properties, the default values are sent to the instance of the ClientInfo class at runtime.
  1. Open the template.cap file in an appropriate Editor – either an XML Editor or Microsoft Notepad.
  2. Enter the appropriate data – that is, the values you want to assign to the device properties.
  3. Save the new file with a meaningful name and the extension .cap – for example, siemensM35.cap. Then edit the configuration file devices.xml saved in the same directory in an XML Editor. You have to add another <device/> tag to this file. To do this, enter:
    1. The ID number
    2. The string contained in the HTTP header "userAgent"
    3. The priority (specifies the exactness with which the device can be identified). See Device Recognition
    4. The MIME type passed in the HTTP header "accept" by the requesting device
    5. The name of the device

Example

<device>
<id>Y_SiemensS35</id>
<userAgent>SIE-S35/1.0 UP/</userAgent>
<priority>1</priority>
<accept>text/vnd.wap.wml</accept>
<deviceName>SiemensS35</deviceName>
</device>

Caution

The device name <deviceName/> in the devices.xml file must match the name of the associated XML file, .cap. Choose a meaningful name for the name of the device in the configuration table. The ID number must begin with an upper case Y or Z, followed by an underscore, and then by a meaningful string representing the name of the device. The ID numbers should begin with a Y or Z; otherwise they will be overwritten during updating.

Caution

Pay attention to upper and lower case.
  1. Open the R/3 System using the SAP GUI and launch the CI_IMPORT transaction, which imports the device recognition data for the new device type.
    A dialog box appears.
  2. To import the new device recognition data into the R/3 tables enter the following in the appropriate fields:

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 modified 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 an additional mobile device.

 Leaving content frame