Share via


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

Other Resources

Forefront Identity Manager Schema