Managing Microsoft Custom Properties (OMA DM)
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