Today I had the chance to get back to some code for CreateFolder which creates a public folder within our Exchange 2007 environment support by Microsoft’s Hosted Messaging and Collaboration frame work. I’ve been highly critical of Microsoft’s code before, and today has taken that to a new level.
Here is what I’m dealing with. First, let’s go to the documentation on TechNet:
Pretty clear that we have a few required parameters and a few optional ones to set some quotas. These optional parameters are what will soon drive me to uncontrollable rage.
Next, let’s look at the example directly from the web service. Here’s what it states we can pass:
POST /mpsws/ManagedEmail2007/Service.asmx HTTP/1.1
Host: prov01.bacon.lightedge.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://provisioning.microsoft.com/webservice/managedemail2007/CreateFolder"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CreateFolder xmlns="http://provisioning.microsoft.com/webservice/managedemail2007">
<CreateFolderRequest xmlns="http://provisioning.microsoft.com/managedemail2007">
<Data>
<organization>string</organization>
<preferredDomainController>string</preferredDomainController>
<name>string</name>
<path>string</path>
<server>string</server>
<maxItemSize>string</maxItemSize>
<postStorageQuota>string</postStorageQuota>
<storageQuota>string</storageQuota>
</Data>
</CreateFolderRequest>
<sendCredentials>boolean</sendCredentials>
</CreateFolder>
</soap:Body>
</soap:Envelope>
Again, everything looks great. postStorageQuota and storageQuota are both there and seem perfectly reasonable.
So let’s actually SEND that command to the web service. Here’s the error I get back:
The element 'CreateFolder_Request' in namespace 'http://provisioning.microsoft.com/exchange2007provider' has invalid child
element 'postStorageQuota' in namespace 'http://provisioning.microsoft.com/exchange2007provider'. List of possible elements expected: 'prohibitPostQuota, server, issueWarningQuota' in namespace 'http://provisioning.microsoft.com/exchange2007provider'.The element 'CreateFolder_Request' has invalid child element 'postStorageQuota' . List of possible elements expected: 'prohibitPostQuota, server, issueWarningQuota' .
You get this is you change PostStorageQuota to prohibitPostQuota.
The element 'CreateFolder_Request' in namespace 'http://provisioning.microsoft.com/exchange2007provider' has invalid child element 'storageQuota' in namespace 'http://provisioning.microsoft.com/exchange2007provider'. List of possible elements expected: 'prohibitPostQuota, server, issueWarningQuota' in namespace 'http://provisioning.microsoft.com/exchange2007provider'.The element 'CreateFolder_Request' has invalid child element 'storageQuota' . List of possible elements expected: 'prohibitPostQuota, server, issueWarningQuota' .
In case you missed it, they changed the variable with in the back end server code, and failed to tell anyone that they made this change. Awesome!
This appeared only after we made the jump up to HMC 4.5 rollup 9. Before the PostStorageQuota and StorageQuota worked as expected. Needless to say, I’m less than impressed that they changed properties on me and failed to update the documentation OR the web service example. I guess figuring this out with trial by fire is the way that Microsoft expects you to learn. Thanks Microsoft!