2.2.2.2.10.4 DevicePolicy Object

  • Article

The following specifies the DevicePolicy object schema:

 <xs:schema xmlns:g="urn:groove.net" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:groove.net" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  
 <xs:element name="fragment">
  <xs:complexType>
  <xs:sequence>
   <xs:element name="ManagedObject">
   <xs:complexType>
    <xs:sequence>
    <xs:element name="Header" type="ObjectHeaderType"/>
    <xs:element name="Body">
     <xs:complexType>
     <xs:sequence>
      <xs:element name="Policy">
      <xs:complexType>
       <xs:sequence>
       <xs:element name="Bandwidth" minOccurs="0" maxOccurs="unbounded">
        <xs:complexType>
        <xs:attribute name="DisplayMask" type="xs:string"/>
        <xs:attribute name="Value" type="xs:int"/>
        <xs:attribute name="Unit" type="xs:int"/>
        </xs:complexType>
       </xs:element>
       <xs:element name="Audit" minOccurs="0" maxOccurs="unbounded">
        <xs:complexType>
        <xs:sequence>
         <xs:element name="Client" minOccurs="0" maxOccurs="unbounded">
         <xs:complexType>
          <xs:attribute name="Flags" type="xs:int"/>
         </xs:complexType>
         </xs:element>
        </xs:sequence>
        </xs:complexType>
       </xs:element>
       <xs:element name="WebServices" minOccurs="0" maxOccurs="unbounded">
        <xs:complexType>
        <xs:attribute name="IsDirectEnabled" type="xs:int"/>
        </xs:complexType>
       </xs:element>
       <xs:element name="PKI" type="PKIPolicyType" minOccurs="0"
                 maxOccurs="unbounded"/>
       <xs:element name="AuditServer" minOccurs="0" maxOccurs="unbounded">
        <xs:complexType>
        <xs:sequence>
         <xs:element name="AuditItems" minOccurs="0" maxOccurs="unbounded">
         <xs:complexType>
          <xs:sequence>
          <xs:element name="AuditItem" minOccurs="0" maxOccurs="unbounded">
           <xs:complexType>
           <xs:attribute name="ComponentURL" type="xs:string"/>
           </xs:complexType>
          </xs:element>
          </xs:sequence>
         </xs:complexType>
         </xs:element>
        </xs:sequence>
        <xs:attribute name="Flags" type="xs:int"/>
        <xs:attribute name="ServerURL" type="xs:string"/>
        <xs:attribute name="UploadFrequency" type="xs:int"/>
        <xs:attribute name="UploadFrequency2" type="xs:int"/>
        </xs:complexType>
       </xs:element>
       </xs:sequence>
       <xs:attribute name="Flags" type="xs:int"/>
      </xs:complexType>
      </xs:element>
     </xs:sequence>
     <xs:attribute name="ComponentResourceURL" type="xs:string"
                 use="required"/>
     </xs:complexType>
    </xs:element>
    <xs:element name="Signatures">
     <xs:complexType>
     <xs:sequence>
      <xs:element name="Signature" type="ObjectSignatureType"/>
     </xs:sequence>
     </xs:complexType>
    </xs:element>
    </xs:sequence>
    <xs:attribute name="Version" type="xs:string" use="required"/>
   </xs:complexType>
   </xs:element>
  </xs:sequence>
  </xs:complexType>
 </xs:element>
  
 </xs:schema>

The ObjectHeaderType and ObjectSignatureType are specified in sections 2.2.2.2.12 and 2.2.2.2.13. The PKIPolicyType is specified in section 2.2.2.2.14.

The following table describes the elements and attributes:

XPath

Description

/fragment

Object data fragment element

/fragment/ManagedObject/@Version

The attribute MUST be "0,0,0,0"

/fragment/ManagedObject/Header

Object header element

/fragment/ManagedObject/Body

Object body element

/fragment/ManagedObject/Body/@ComponentResourceURL

The value MUST be  "http://components.groove.net/Groove/Components/Root.osd?Package=net.groove.Groove.SystemComponents.GrooveAccountMgr_DLL&amp;Version=0&amp;Factory=DevicePolicy"

/fragment/ManagedObject/Body/Policy

Policy element

/fragment/ManagedObject/Body/Policy/@Flags

The value MUST be one the following values or a value produced by using a bitwise OR operation on one or more of the following values:

0x04: Client cannot change communicator integration settings.

0x08: Disable public directory contact search.

/fragment/ManagedObject/Body/Policy/Bandwidth

Bandwidth element. Omit if no bandwidth policies.

/fragment/ManagedObject/Body/Policy/Bandwidth/@DisplayMask

Can define how to format the value/unit pair for display purpose.

Examples: "%d Percent", "%d Megabits per second"

/fragment/ManagedObject/Body/Policy/Bandwidth/@Value

MAY contain bandwidth value.

/fragment/ManagedObject/Body/Policy/Bandwidth/@Unit

The value can be one of the following values:

0: bits per second

1: kilobits per second

2: megabits per second

3: percent

/fragment/ManagedObject/Body/Policy/Audit

Audit element. Omit if no audit policies.

/fragment/ManagedObject/Body/Policy/Audit/Client

Audit client element. Omit if no client policies.

/fragment/ManagedObject/Body/Policy/Audit/Client/@Flags

The value can be one of the following values or a value produced by using a bitwise OR operation on two or more of the following values:

0x00000001: Enable non-telespace auditing. The term telespace is a synonym for shared space.

0x00000002: Enable telespace auditing.

/fragment/ManagedObject/Body/Policy/WebServices

MUST be ignored by the client. The server omits if no WebService policies.

/fragment/ManagedObject/Body/Policy/WebServices/@IsDirectEnabled

MUST be ignored by the client.

/fragment/ManagedObject/Body/Policy/PKI

public key infrastructure (PKI) policy element. Omit if no PKI policy.

/fragment/ManagedObject/Body/Policy/AuditServer

Audit server element. Omit if no audit server policies.

/fragment/ManagedObject/Body/Policy/AuditServer/@Flags

The value can be one of the following values or a value produced by using a bitwise OR operation on two or more of the following values:

0x01: Audit file content

0x02: Audit instant messages and invitations

0x04: Audit login and logoff

0x08: Audit contact addition and deletion

0x10: Audit dynamics

0x20: Client will not run until auditing can be enabled

0x40: Audit telespace

/fragment/ManagedObject/Body/Policy/AuditServer/@ServerURL

Can contain Audit Server URL

/fragment/ManagedObject/Body/Policy/AuditServer/@UploadFrequency

Can contain upload interval in days.

/fragment/ManagedObject/Body/Policy/AuditServer/@UploadFrequency2

MAY contain upload interval in milliseconds.

/fragment/ManagedObject/Body/Policy/AuditServer/AuditItems

Audit items element. Omit if no audit items.

/fragment/ManagedObject/Body/Policy/AuditServer/AuditItems/AuditItem

Audit item element. Omit if no audit item.

/fragment/ManagedObject/Body/Policy/AuditServer/AuditItems/AuditItem/@ComponentURL

Audit component URL.

/fragment/ManagedObject/Signatures

Contains signature data element

/fragment/ManagedObject/Signatures/Signature

Signature data element