How to: Retrieve the FIM Service Schema Using WS-MetadataExchange

FIM lets you retrieve the schemas for FIM resource types, as well as schema metadata, from the FIM Service database.

How to Retrieve a Schema Using the Get Method

You can retrieve a schema using the WS-Transfer Get method defined in the Web Services Metadata Exchange specification, section 5.1. The schema is retrieved through an endpoint with the address https://Localhost:5725/ResourceManagementService/MEX.

The following is an example of a Get request message to request a schema:

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope 
  xmlns:a="http://www.w3.org/2005/08/addressing" 
  xmlns:s="http://www.w3.org/2003/05/soap-envelope">
  
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/Get</a:Action>
    <a:MessageID>urn:uuid:6eb17746-64d0-42fb-8206-af9c2470819b</a:MessageID>
    <a:ReplyTo>
      <a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address>
    </a:ReplyTo>
    <a:To s:mustUnderstand="1">https://localhost:5725/ResourceManagementService/MEX</a:To>
  </s:Header>
  <s:Body/>
</s:Envelope>

The following is an example response to a Get request message:

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse</a:Action>
        <a:RelatesTo>urn:uuid:6eb17746-64d0-42fb-8206-af9c2470819b</a:RelatesTo>
    </s:Header>
    <s:Body>
        <Metadata xmlns="https://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:wsx="https://schemas.xmlsoap.org/ws/2004/09/mex">
<wsx:MetadataSection Dialect="http://www.w3.org/2001/XMLSchema" Identifier=":" >
                <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="https://schemas.microsoft.com/2006/11/ResourceManagement" version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:rm="https://schemas.microsoft.com/2006/11/ResourceManagement">
                    <xs:simpleType name="ReferenceType">
                        <xs:restriction base="xs:string">
                            <xs:pattern value="([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}" />
                        </xs:restriction>
                    </xs:simpleType>
                    <xs:complexType name="BinaryCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:base64Binary" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="DateTimeCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:dateTime" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="IntegerCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:integer" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="ReferenceCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="rm:ReferenceType" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="StringCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item">
                                <xs:simpleType>
                                    <xs:annotation>
                                        <xs:appinfo>
                                            <rm:DataType>String</rm:DataType>
                                        </xs:appinfo>
                                    </xs:annotation>
                                    <xs:restriction base="xs:string">
                                        <xs:pattern value=".{0,448}" />
                                    </xs:restriction>
                                </xs:simpleType>
                            </xs:element>
<xs:element minOccurs="1" name="CreatedTime" type="xs:dateTime">
                                <xs:annotation>
                                    <xs:appinfo>
                                        <rm:DisplayName>Created Time</rm:DisplayName>
                                        <rm:Description>The time when the resource is created in the FIM service database. This attribute is assigned its value by the FIM service. It cannot be modified by any user.</rm:Description>
                                        <rm:Key>4</rm:Key>
                                    </xs:appinfo>
                                </xs:annotation>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
<xs:element name="mv-dataInstance" type="rm:mv-data" />
                </xs:schema>
            </wsx:MetadataSection>
        </Metadata>
    </s:Body>
</s:Envelope><?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse</a:Action>
        <a:RelatesTo>urn:uuid:6eb17746-64d0-42fb-8206-af9c2470819b</a:RelatesTo>
    </s:Header>
    <s:Body>
        <Metadata xmlns="https://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:wsx="https://schemas.xmlsoap.org/ws/2004/09/mex">
<wsx:MetadataSection Dialect="http://www.w3.org/2001/XMLSchema" Identifier=":" >
                <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="https://schemas.microsoft.com/2006/11/ResourceManagement" version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:rm="https://schemas.microsoft.com/2006/11/ResourceManagement">
                    <xs:simpleType name="ReferenceType">
                        <xs:restriction base="xs:string">
                            <xs:pattern value="([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}" />
                        </xs:restriction>
                    </xs:simpleType>
                    <xs:complexType name="BinaryCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:base64Binary" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="DateTimeCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:dateTime" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="IntegerCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="xs:integer" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="ReferenceCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item" type="rm:ReferenceType" />
                        </xs:sequence>
                    </xs:complexType>
                    <xs:complexType name="StringCollectionType">
                        <xs:sequence>
                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Item">
                                <xs:simpleType>
                                    <xs:annotation>
                                        <xs:appinfo>
                                            <rm:DataType>String</rm:DataType>
                                        </xs:appinfo>
                                    </xs:annotation>
                                    <xs:restriction base="xs:string">
                                        <xs:pattern value=".{0,448}" />
                                    </xs:restriction>
                                </xs:simpleType>
                            </xs:element>
<xs:element minOccurs="1" name="CreatedTime" type="xs:dateTime">
                                <xs:annotation>
                                    <xs:appinfo>
                                        <rm:DisplayName>Created Time</rm:DisplayName>
                                        <rm:Description>The time when the resource is created in the FIM service database. This attribute is assigned its value by the FIM service. It cannot be modified by any user.</rm:Description>
                                        <rm:Key>4</rm:Key>
                                    </xs:appinfo>
                                </xs:annotation>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
<xs:element name="mv-dataInstance" type="rm:mv-data" />
                </xs:schema>
            </wsx:MetadataSection>
        </Metadata>
    </s:Body>
</s:Envelope>

See Also

Concepts

Forefront Identity Manager Service Overview

Other Resources

Web Services Metadata Exchange
WS-Addressing 2004