2.2.2.2.10.2 ComponentUpdatePolicy Object

  • Article

The following specifies the ComponentUpdatePolicy 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="ComponentUpdatePolicy">
      <xs:complexType>
       <xs:sequence>
       <xs:element name="PolicyItem" minOccurs="0" maxOccurs="unbounded">
        <xs:complexType>
        <xs:sequence>
         <xs:element name="ComponetPackageNameList" minOccurs="0"
                   maxOccurs="unbounded">
         <xs:complexType>
          <xs:sequence>
          <xs:element name="ComponentPackageNameItem" minOccurs="0"
                    maxOccurs="unbounded">
           <xs:complexType>
            <xs:attribute name="Flags" type="xs:int"/>
            <xs:attribute name="Name" type="xs:string"/>
            <xs:attribute name="Policy" type="xs:string"/>
            <xs:attribute name="Version" type="xs:string"/>
            <xs:attribute name="VersionComparison" type="xs:string"/>
           </xs:complexType>
          </xs:element>
          </xs:sequence>
         </xs:complexType>
         </xs:element>
        </xs:sequence>
        <xs:attribute name="DisplayName" type="xs:string"/>
        <xs:attribute name="Fingerprint" type="xs:string"/>
        <xs:attribute name="Policy" type="xs:string"/>
        <xs:attribute name="Type" type="xs:string"/>
        </xs:complexType>
       </xs:element>
       </xs:sequence>
       <xs:attribute name="Default" type="xs:string"/>
       <xs:attribute name="Policyversion" type="xs:string"/>
       <xs:attribute name="SelfSigned" type="xs:string"/>
      </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 the ObjectSignatureType are specified in sections 2.2.2.2.12 and 2.2.2.2.13.

The following table describes the elements and attributes:

XPath

Description

/fragment

Fragment element

/fragment/ManagedObject/@Version

The attribute value 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=ComponentUpdatePolicy"

/fragment/ManagedObject/Body/ComponentUpdatePolicy

Component update policy element

/fragment/ManagedObject/Body/ComponentUpdatePolicy/@Default

Policy default. The value MUST be one of the following values: "Allow", "Deny", or "Local".

/fragment/ManagedObject/Body/ComponentUpdatePolicy/@Policyversion

Policy version

/fragment/ManagedObject/Body/ComponentUpdatePolicy/@SelfSigned

The value MUST be one of the following values: "Allow" or "Deny".

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem

Policy item element. Omit if no policy items.

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/@DisplayName

Display name element

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/@Fingerprint

Fingerprint

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/@Policy

The value MUST be one of the following values: "Allow", "Deny", or "Local".

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/@Type

The value MUST be one of the following values: "Signer" or "Use".

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList

Component package name list element

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem

Component package name item element

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem/@Flags

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

0x00: do not apply any of the following options

0x01: no "missing tool" UI when usage is disallowed

0x02: delete tools data on disk when disallowed

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem/@Name

Package name

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem/@Policy

The value MUST be one of the following values: "Allow", "Deny", or "Local".

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem/@Version

Policy version

/fragment/ManagedObject/Body/ComponentUpdatePolicy/PolicyItem/ComponentPackageNameList/ComponentPackageNameItem/@VersionComparison

The value MUST be one of the following values:

"&gt"," &gt=", "&lt", "&lt=", or"=".

Where "&gt" represents the ">" character and "&lt" represents the "<" character.

/fragment/ManagedObject/Signatures

Signatures element

/fragment/ManagedObject/Signatures/Signature

Signature element