Managing Microsoft Custom Properties (OMA DM)

  • Article

4/8/2010

You can access Microsoft custom properties by using the following elements:

  • To set properties of newly created nodes, use the Meta element.
  • To query and update properties of existing nodes, use the Get and Replace commands over a LocURI element.

Setting a Microsoft custom property

To set a Microsoft custom property when creating a new node, use the Meta element. The syntax for setting a Microsoft custom property in the Meta element is:

     <namespace:property>value</namespace:property>

The following table describes the syntax.

Parameter Description

namespace

The namespace reference for Microsoft custom properties.

property

The name of the Microsoft custom property that is being accessed.

value

The setting applied to the property.

Note

The namespace URI is https://schemas.microsoft.com/MobileDevice/DM. However, you should use msft as the namespace reference in place of the URI. To do so, associate msft with the URI in the SyncML element at the beginning of your XML provisioning document, as illustrated in the following example: <SyncML xmlns='SYNCML:SYNCML 1.1' xmlns:msft='https://schemas.microsoft.com/MobileDevice/DM'>

In the following example, the Add command creates a new node. The AccessRole of the new node is specified in the Meta element. The namespace reference is "msft".

<Add>
 <CmdID>3</CmdID>
 <Item>
   <Meta>
      <Format xmlns="syncml:metinf">int</Format>
      <msft:AccessRole>64</msft:AccessRole>
   </Meta>
   <Target><LocURI>./Vendor/ABCCompany/Settings/A</LocURI></Target>
   <Data><!— actual data here --></Data>
 </Item>
</Add>

Querying or updating a Microsoft custom Property

You can query or update the properties of an existing node with the LocURI element. Use the following format.

     <LocURI>URI?prop=msft:property<LocURI>

Because the colon (:) is a reserved character, you must use the escape code for a colon (%3A).

In the following example a Get command is used to query a device for the current AccessRole setting for the LOCALE_IDIGITS parameter of the Locale configuration service provider.

<Get>
  <CmdID>5</CmdID>
  <Item>
    <Target>
      <LocURI>./Vendor/MSFT/Locale/LOCALE_IDIGITS?prop=AccessRole</LocURI>
    </Target>
  </Item>
</Get>

The following example shows the result that would be returned by the device in response to the query.

<Results>
   <MsgRef>1</MsgRef><CmdRef>5</CmdRef>
   <CmdID>6</CmdID>
   <Item>
      <Source>
        <LocURI>./Vendor/MSFT/Locale/LOCALE_IDIGITS?prop=AccessRole</LocURI>
      </Source>
<Data>16</Data>
</Item>
</Results>

Remarks

The LocURI for accessing the Uninstall root node is case sensitive.

See Also

Concepts

OMA DM Standards and Extensions

Other Resources

Provisioning Using OMA Device Management