BindingDescription
Defines the relationship between a resource type and an attribute. It also specifies additional information and restrictions on the attribute when it is used with that resource type.
Schema
<?xml version="1.0"?><xs:schema xmlns:rm="https://schemas.microsoft.com/2006/11/ResourceManagement" targetNamespace="https://schemas.microsoft.com/2006/11/ResourceManagement" version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="BindingDescription">
<xs:sequence>
<xs:element minOccurs="0" name="ObjectID" type="rm:ReferenceType" />
<xs:element minOccurs="1" name="ObjectType">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value=".{0,448}" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="BoundAttributeType" type="rm:ReferenceType" />
<xs:element minOccurs="0" name="BoundObjectType" type="rm:ReferenceType" />
<xs:element minOccurs="1" name="CreatedTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="Creator" type="rm:ReferenceType" />
<xs:element minOccurs="0" name="MVObjectID">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value=".{0,448}" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeletedTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="Description">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value=".{0,448}" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DetectedRulesList" type="rm:ReferenceCollectionType" />
<xs:element minOccurs="0" name="DisplayName">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value=".{0,448}" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="ExpectedRulesList" type="rm:ReferenceCollectionType" />
<xs:element minOccurs="0" name="ExpirationTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="IntegerMaximum" type="xs:integer" />
<xs:element minOccurs="0" name="IntegerMinimum" type="xs:integer" />
<xs:element minOccurs="0" name="Localizable" type="xs:boolean" />
<xs:element minOccurs="0" name="Locale">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value=".{0,448}" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="Required" type="xs:boolean" />
<xs:element minOccurs="0" name="ResourceTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="StringRegex" type="xs:string" />
<xs:element minOccurs="0" name="UsageKeyword" type="rm:StringCollectionType" />
</xs:sequence>
</xs:complexType>
</xs:schema>
Properties
The following table lists the properties of the BindingDescription resource:
| Property | Description |
|---|---|
BoundAttributeType |
Required property. Reference to an AttributeTypeDescription resource that the binding's BoundObjectType maps to. |
BoundObjectType |
Required property. Reference to an ObjectTypeDescription resource that the binding's BoundAttributeType maps to. |
IntegerMaximum |
Optional integer that indicates the maximum value for the property referenced by BoundAttributeType when it is used in the context of resource type referenced by BoundObjectType specified on the bound attribute itself. It is only in effect if the property referenced by BoundObjectType is of Integer type. If this value is not present, the IntegerMaximum value for the BoundAttributeType property is used. |
IntegerMinimum |
Optional integer that indicates the minimum value for the property referenced by BoundAttributeBoundAttributeType when it is used in the context of the resource type referenced by BoundObjectType specified on the bound attribute itself. It is only in effect if the property referenced by BoundObjectType is of Integer type. If this value is not present, the IntegerMinimum value for the BoundAttributeType property is used. |
Localizable |
Optional Boolean. If true, the attribute resource binding defined by the BindingDescription resource can be localized. If the Localizable element is not defined in the BindingDescription resource, this BindingDescription is localizable based on the Localizable value for the BoundAttributeType property, if it exists. The default value is false. |
Required |
Optional Boolean. If true, the BoundAttributeType property is a required property of the BoundObjectType resource. |
StringRegex |
Optional string. The value of the string must be a .Net Framework Regular Expression. StringRegex indicates the regular expression used to validate the value stored in the BoundAttributeType property in the context of the BoundObjectType resource. If this value is not present, the StringRegex value for the BoundAttributeType property is used. StringRegex is only relevant if the property referenced by BoundObjectType is a String. |
UsageKeyword |
Optional StringCollection. See UsageKeyword. |
Parent Elements
None
Remarks
All of the resource types in FIM have the same attribute bindings as the Resource type by default. For more information, see Forefront Identity Manager Schema.
Example
Description
In this example we assume that the BindingDescription defines a relationship between a Person resource and a user-defined property named “EmailAlias.” The following BindingDescription specifies that “Alias” is a required property of a Person resource and must consist of 6 to 15 lowercase letters.
Code
<BindingDescription>
<BoundObject>1A1A1A1A-2B2B-3C3C-4D4D-5E5E5E5E5E5E</BoundObject>
<BoundAttribute>F1111111-G222-7777-1313-DE1231231231</BoundAttribute>
<Description>Email alias of the employee</Description>
<DisplayName>EmailAlias</DisplayName>
<Localizable>false</Localizable>
<ObjectID>CDCD000C-A00A-1001-878F-417779996622</ObjectID>
<ObjectType>AttributeTypeObjectTypeDescription</ObjectType>
<Required>true</Required>
<StringRegex>[a-z]{6,15}</StringRegEx>
</BindingDescription>
See Also
Concepts
Schema Data Types
AttributeTypeDescription
How to: Retrieve the FIM Service Schema Using WS-MetadataExchange