2.3.5 XML Schema of msDS-ClaimPossibleValues

  • Article

AD Property Definitions with msDs-ValueTypeReferences set to MS-DS-OrderedList or MS-DS-MultivaluedChoice can have the msDS-ClaimPossibleValues attribute set. This attribute specifies a list of values, names, display names, and descriptions that can be used for the associated AD Property Definition. A collection consisting of name, display name, and description is referred to as an AD Possible Value.

Following is the XML schema for representing the AD Possible Values of an AD Property Definition.

 <?xml version="1.0" encoding="utf-8"?>
 <xs:schema targetNamespace="http://schemas.microsoft.com/2010/08/ActiveDirectory/PossibleValues"
     elementFormDefault="qualified"
     xmlns="http://schemas.microsoft.com/2010/08/ActiveDirectory/PossibleValues"
     xmlns:mstns="http://schemas.microsoft.com/2010/08/ActiveDirectory/PossibleValues"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
 > 
   <xs:complexType name="ClaimValueItemBaseType" abstract="true">
     <xs:sequence minOccurs ="1" maxOccurs="1">
       <xs:element name="ValueDisplayName" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
       <xs:element name="ValueDescription" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
       <xs:element name="ValueGUID" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
     </xs:sequence>
   </xs:complexType>
  
   <xs:complexType name="IntegerItemType">
     <xs:complexContent>
       <xs:extension base="ClaimValueItemBaseType">
         <xs:sequence>
           <xs:element name="Value" type="xs:int" />
         </xs:sequence>
       </xs:extension>
     </xs:complexContent>
   </xs:complexType>
   <xs:complexType name="IntegerListType">
     <xs:sequence minOccurs ="1" maxOccurs="1">
       <xs:element name="Item" type="IntegerItemType" minOccurs="1" maxOccurs="unbounded"/>
     </xs:sequence>
   </xs:complexType>
  
   <xs:complexType name="StringItemType">
     <xs:complexContent>
       <xs:extension base="ClaimValueItemBaseType">
         <xs:sequence>
           <xs:element name="Value" type="xs:string" />
         </xs:sequence>
       </xs:extension>
     </xs:complexContent>
   </xs:complexType>
   <xs:complexType name="StringListType">
     <xs:sequence minOccurs ="1" maxOccurs="1">
       <xs:element name="Item" type="StringItemType" minOccurs="1" maxOccurs="unbounded"/>
     </xs:sequence>
   </xs:complexType>
  
   <xs:complexType name="PossibleClaimValuesType">
     <xs:choice minOccurs="1" maxOccurs="1">
       <xs:element name="StringList" type="StringListType" />
       <xs:element name="IntegerList" type="IntegerListType" />
     </xs:choice>
   </xs:complexType>
   <xs:element name="PossibleClaimValues" type="mstns:PossibleClaimValuesType" />
 </xs:schema>
 

A single AD Possible Value consists of three elements:

ValueDisplayName: Specifies the possible display name value for the AD Property Definition.

ValueDescription: Specifies the possible value description for the AD Property Definition.

Value: If the msDs-ValueTypeReferences attribute of the AD Property Definition is MS-DS-OrderedList, this holds an integer value. If the msDs-ValueTypeReferences attribute of the AD Property Definition is set to MS-DS-MultivaluedChoice, this holds a string specifying the possible name of the AD Property Definition.