CM_Mappings Configuration Service Provider

4/8/2010

The CM_Mappings Configuration Service Provider configures the URL mapping that is used by the ConnMgrMapURL function to determine the meta-network where the URL resides.

The meta-network GUID must be provisioned using the CM_Networks Configuration Service Provider before provisioning a URL mapping to the meta-network or anything that requires the meta-network GUID.

Note

This Configuration Service Provider is managed over the OMA Client Provisioning (formerly WAP Client Provisioning) protocol. To provision devices using the OMA DM protocol, use the ACCESS Configuration Service Provider instead. Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider.

The following table shows the default settings. The default security role maps to each subnode unless specific permission is granted to the subnode.

Permissions	Read/Write
Roles allowed to query and update setting	Manager

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Characteristics

• <MappingIndex>
  Specifies settings for the <MappingIndex> parameter. Entries in the mapping table are provisioned and ordered by their MappingIndex value. When mapping URLs, the ConnMgrMapURL searches the table, starting at the lowest MappingIndex and moving up the list of values from lowest to highest until the first matching pattern is found. Entries with a more specific pattern must be assigned a lower index number than the more general entries. Entries do not need to be contiguous.

  The first 500 index numbers (0-500) are reserved for internal use only. User defined exceptions start at 0x01000000 (16777216). By default, the index numbers 0x20000000 (536870912), 0x21000000 (553648128), 0x22000000 (570425344) and 0x23000000 (587202560), are used to map URL strings to the default meta-networks, as shown in the following table.

  Parameter pattern value	Index Number	Network name
  *://*.*/*	570425344	The Internet
  *://*/*	587202560	Work
  wsp://*/*	536870912	The WAP Network
  wsps://*/*	553648128	Secure WAP Network

Parameters

• Network
  Used in the <MappingIndex> characteristic to provide the Network GUID where the URL resides.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Network GUID
  Roles allowed to query and update setting	Manager

• Pattern
  Used in the <MappingIndex> characteristic to provide the URL pattern in a wildcard pattern that is used to match the URL string. The string must be in canonicalized URL format. For example, a blank space in the URL should be converted to the escape sequence %20.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	URL Pattern
  Semantic Type	url
  Roles allowed to query and update setting	Manager

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements	Available
noparm	No
nocharacteristic	Yes
characteristic-query	Yes recursive query: Yes
parm-query	Yes

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

CM_Mappings Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices

Other Resources

ConnMgrMapURL