SI Message Format

4/8/2010

SI notifications use the UTF-8 encoded character set that is described in the WAP Wireless Markup Language Specification Version 19 February 2000, and the SI document type definition (DTD), as it is described in the WAP Service Indication Specification Version 08-Nov-1999. Both WAP specifications are available from this external web site.

The following sample code is an example SI message. Descriptions of each element follow the example SI message. For more information about creating SI messages, see the WAP Service Indication Specification (WAP-167-ServiceInd-20010731-a)

<?xml version="1.0"?>
   <!DOCTYPE si PUBLIC "-//WAPFORUM//DTD SI 1.0//EN"
      "https://www.wapforum.org/DTD/si.dtd">
<si>
   <indication href = "https://www.northwindtraders.com/markets/bchip/nwt.wml"
      created = "2007-12-19T06.32.00Z"
      si-expires = "2007-12-24T00.00.00Z"
      action = "signal-low">
      NorthWindTraders stock report
   </indication>
</si>

Windows Mobile discards the message without notifying the user if the body of the SI XML file is empty (that is, the information between <indication> and </indication>).

Parameters

• href
  Specifies the Uniform Resource Identifier (URI) for accessing the update or the new service. In this case, the URI is https://www.northwindtraders.com/markets/bchip/nwt.wml.

• created
  Specifies the date and time that the message is created. In this case, the date is October 22, 2001, and the time is 09:01:00. If the created attribute does not exist, the system time of the device at the time that the message was received is used as the created time.

  The date and time must always be expressed in coordinated universal time (UTC), a 24-hour timekeeping system (indicated by the "Z" in the SI message). The format is YYYY-MM-DDThh:mm:ssZ.

• si-expires
  Specifies the date and time that the SI notification expires, resulting in deletion from the device. In this case, the date is October 23, 2001, and the time is 08:59:00.

  The date and time must always be expressed in UTC, as described in the previous section.

• action
  Specifies the action that the device must execute when the message is received. The device ignores and discards an SI notification if the action attribute value is signal-none.

See Also

Concepts

SI and SL Message Creation
Over the Air Provisioning with SI and SL Messages