w2 APPLICATION Configuration Service Provider

4/8/2010

An APPLICATION configuration service provider that has an APPID of w2 is used to configure browser favorites.

The w2 APPLICATION configuration service provider is managed over OMA Client Provisioning protocol.

Note

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. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode. The following table shows the default settings.

Access type	Read/Write
Roles allowed to query and update setting	Manager Operator Operator - TPS

The following image shows the configuration service provider management object in tree format as used by OMA Client Provisioning.

Characteristics

• RESOURCE
  A list of favorites, also known as bookmarks, each identified by an item tag.

  Access type	Read/Write
  Data type	node
  Occurs	OneOrMore

Parameters

• APPID
  Differentiates the types of available services and protocols. This parameter is used in the APPLICATION characteristic.

  The only valid value to configure the OMA Client Provisioning w2 APPID is:

  • w2

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	One

• NAME
  The NAME parameter is used in the APPLICATION characteristic to specify a user readable folder identity. This parameter is used to define part of the registry path.

  In Windows Mobile Version 5.0-based devices the NAME parameter under the APPLICATION characteristic is optional, but is highly recommended. It is used to specify the name of the folder in which the favorites should be placed. For example, if you are creating a favorite, this value would be the name of the folder where the favorite is created. You can specify only one folder for each APPLICATION section.

  Note

  Favorites only supports a folder structure one level deep. If this parameter is not provided, the favorite is created at the root level.

  The NAME parameter is used in the RESOURCE characteristic to specify the user readable name of the favorite. Under the RESOURCE characteristic the NAME parameter is required.

  Note

  The W2 APPLICATION configuration service provider cannot add a favorite with the same NAME as an existing favorite. A new favorite with the same name is ignored.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs in APPLICATION	ZeroOrOne
  Occurs in RESOURCE	OneOrMore

• Order
  The Order parameter is used in the RESOURCE characteristic to specify the order that the favorite should appear in the list. A value of 0 is the first position

  Note

  This parameter is only valid for Windows phones.

  The following table shows the default settings.

  Access type	Read/Write
  Data type	string
  Occurs	ZeroOrOne

• STARTPAGE
  The STARTPAGE parameter is used in the RESOURCE characteristic to set the browser start page. Use this parameter to indicate if a favorite is a start page. On Windows phones, the Start page is added to the list of favorites.

  Although there can be multiple resource characteristics under the w2 APPID, only one of them should have the STARTPAGE parameter set. If more than one start page is specified, the last one processed is set as the start page.

  Access type	Read/Write
  Data type	bool
  Occurs	ZeroOrOne

• URI
  The URI parameter is used in the RESOURCE characteristic to specify the absolute URI for the favorite.

  Access type	Read/Write
  Data type	URI
  Occurs	OneOrMore

See Also

Tasks

w2 APPLICATION Configuration Service Provider Examples for OMA Client Provisioning

Reference

APPLICATION Configuration Service Provider
w2 APPLICATION