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