The Resource Factory endpoint of Forefront Identity Manager (FIM) provides an operation by which client applications can request that individual objects be created. This Create operation is defined in WS-Transfer specification.

A client requests that an object be created by passing an XML representation of the object to FIM by way of the Create operation. FIM creates an instance of the object. Then it replies to the client with the information that the client needs in order to retrieve, modify or delete the newly-created object in subsequent requests. That information takes the form of an endpoint reference, as defined by the Web Services Addressing (WS-Addressing) specification. The endpoint reference consists of two parts. The first part is an address at which the newly-created object is available to the client for retrieval, modification or deletion. The second part is a reference property for uniquely identifying the object at that address.

The behavior of the Resource Factory endpoint is illustrated in the following diagram.


The Resource Factory endpoint implements the following operation:


The FIM web service only accepts UTF-8 encoding of strings and SOAP messages. Other encodings will be converted to UTF-8 if possible. If an encoding cannot be converted to UTF-8 then the web service will return wxf:InvalidRepresentationFault (see WS-Transfer Extensions for Identity Management Operations specification).

See Also