Changes in web services from RC to RTM


I will post tomorrow the originally scheduled topic of selecting attributes in an enumeration.  For now I thought it would be a better idea to post publically an answer we have given to a few customers who asked: What has changed in the web services between release candidate (RC) and release to manufacturing (RTM) versions of ILM “2”?

This list is a snapshot and is subject to change by RTM.  This list represents my complete view of changes as of today.  Additional changes will be in response to issues we may uncover.  Please use this list to help estimate the changes that will come.

I ask that you takeaway one key point: We value and respect standards on this team.  Most of the changes you see below are “cosmetic” changes that pull us into full compliance with standards.  There are no new operations or behaviors, but clients written for RC will not work with RTM.

In no particular order:

  1. We changed the port number to match our IANA registration (search for ILM on the list).  The new ports are 5725 and 5726.
  2. We removed inline schema from the protocol.  A client no longer has to tell the server what the data types are.
  3. We changed the children of the WS-Enumeration EnumerationContext.  Previously we had used an opaque string.  For RTM we will use an opaque complex type.
  4. We’ve changed the accessibility of the overwhelming majority of classes to something other than public.  All of your code that depends on ResourceManagement.dll should break.
  5. We updated how we handle faults.
    1. The Security Token Service now throws wst:RequestFailed upon an exception.  Previously it had been silent about failures.
    2. We removed faults from our WSDL which do not exist in WS-Transfer, WS-Enumeration, or our extensions.
    3. We moved the DataRequired fault to the ResourceManagement namespace.
  6. We moved elements to the correct namespaces so we now completely comply with WS-Transfer and WS-Enumeration specs.
    1. We now return wxf:ResourceCreated in a WS-Transfer CreateResponse.
    2. We new return EnumerationDetail in the ResourceManagement namespace instead of WS-Enumeration namespace.
    3. We moved ResourceReferenceProperty from WS-Addressing namespace to ResourceManagement namespace.
    4. We consolidated all references to WS-Addressing to the 2004 submission over the 2006 recommendation.  The reason is we use resource properties to identify individual resources.  The 2006 recommendation, however, says this approach is incompatible.
  7. We changed the string restriction regular expression to the correct .{0,448} instead of .{448}.
  8. We removed support for replacing multi-valued attributes.  We found it may be confusing for customers to configure ILM in a way to apply policy correctly.
  9. We removed XPathLevel1 and Level2 dialects from our filters.  We now only support our own dialect, which is functionally similar to XPath level 1: http://schemas.microsoft.com/2006/11/ResourceManagement/Dialect/IdentityAttributeType-20080602.

Tomorrow we’ll talk about the product and extensibility points as planned.

Comments (7)
  1. Mark Struck says:

    Joe,

    Regarding #4, won’t that affect the Sharepoint server controls that the ILM 2 portal is using?

    Mark

  2. Joe Schulman says:

    Mark,

    No, we made an effort to ensure that all customers and partners, internal and external to Microsoft, could work around the limitation.  The key reason for making those classes non-public is because we didn’t test those classes for developer consumption.

    If you believe you have been affected by this or any other change, please contact your Microsoft contact, and we will be happy to work with you towards resolution.

    Joe

  3. Mark Struck says:

    Joe,

    I was actually referring to Microsofts Sharepoint server controls in my post. And, yes this would affect my client. It would be nice to get more details on the change in the service. Would Microsoft be open to providing interim builds of the service that I could test my client with before RTM?

    Mark

  4. Thanks a bunch for this information. Great to know.

  5. Simon Veale says:

    Now that RTM has been postponed, I understand that what WAS going to be the RTM release is now going to be, in effect, the RC1 release in June/July. So I assume these changes will apply to RC1. Is that correct?

  6. Joe Schulman says:

    Re: Simon.

    Yes.  You will see all of the changes mentioned here in RC1.

Comments are closed.

Skip to main content