jQuery Library for SharePoint Web Services (SPServices) v0.5.5 Released
Today I released the next version of the jQuery Library for SharePoint Web Services (aka SPServices) to Codeplex: v0.5.5. It’s been far too long since the last release, but I’ve been very busy working on client projects and helping to get the USPJ Academy up and running. Given that there have been 1668 downloads of v0.5.4 in less than two months, there’s clearly a lot of interest in the library and I don’t want to let it lie fallow for this long, believe me.
This release contains a couple of new things:
- I’ve “wrapped” the AddAttachment operation for the Lists Web Service Note that at this point I’m adding operations as requested or as I need them myself. If there’s an operation you’d like to use that you don’t see, please let me know.
- The SPAutocomplete function now allows a CAMLQuery option like several of the other functions so that you can filter the values from the sourceList easily, as needed.
The other enhancements fall into the “Bug Fixes and Efficiency” bucket, but several also provide additional functionality as well.
- SPArrangeChoices will now work appropriately if you are allowing fill-in choices. Before, the fill-in option was treated equally with the other options and would also be rearranged (or even have its position randomized if that option was set to true). Now the fill-in choice will always remain at the bottom of the controls for the choices.
- SPGetCurrentUser will now return any type of User Profile value. In earlier versions, only columns of type SPFieldText were returned correctly.
- In SPCascadeDropdowns there was an interesting “feature”, which I documented in a prior post as a potential bug in the GetListItems operation of the Lists Web Service. You can read that post if you’d like to understand the “bug”, but there’s a nice workaround in v0.5.5 for it.
- SPRequireUnique will now work appropriately with an EditForm. Previously, if you tried to use the function on an EditForm, it would give you an error for the current value of columnStaticName, even if the value for the current item was unique. The check for uniqueness now also takes into consideration the current item’s value, so the function will now work great on an EditForm as well as a NewForm.
- As barrylp pointed out in a comment on the documentation, somewhere along the way $().SPServices.defaults changed so that it was exposed as an object, not a function. (This may have changed when jQuery 1.4 was released?) I don’t think that very many people were using the $().SPServices.defaults function anyway, or I would have received a bug report earlier. So rather than trying to change the functionality, I simply matched the documentation to how things now work. In some ways, it’s a nicer way to interface with the capability, anyway.
As always, here are the release notes, copied from the Codeplex site:
New Operations
| Alpha | Web Service | Operation | Options | MSDN Documentation |
|---|---|---|---|---|
| ALPHA2 | Lists | AddAttachment | [WebURL], listName, listItemID, fileName, attachment | Lists.AddAttachment Method |
New Functionality
| Alpha | Issue Tracker Item | Function | Operation | Description |
|---|---|---|---|---|
| ALPHA4 | 5906 | $().SPServices.SPAutocomplete | NA | Add CAMLQuery Option to SPAutocomplete |
Bug Fixes and Efficiency
| Alpha | Issue Tracker Item | Function | Operation | Description |
|---|---|---|---|---|
| ALPHA1 | 5941 | $().SPServices.SPArrangeChoices | NA | SPArrangeChoices Using with a ‘Fill-in’ choice box |
| ALPHA1 | 5943 | listNameFromUrl() | NA | listNameFromUrl(): List GUID Not Found |
| ALPHA3 | 5755 | $().SPServices.SPGetCurrentUser | NA | SPGetCurrentUser Bug for Columns Which Aren’t ‘Single Line of Text’ |
| ALPHA4 | 5980 | $().SPServices.SPCascadeDropdowns | NA | SPCascadeDropdowns: Duplicate Values in Child Column |
| ALPHA5 | 5898 | $().SPServices.SPGetQueryString | NA | $().SPServices.SPGetQueryString drops RealSource QueryString |
| ALPHA5 | 5988 | $().SPServices.SPRequireUnique | NA | Issue with $().SPServices.SPRequireUnique and EditForm.aspx |
| ALPHA5 | 6199 | $().SPServices.defaults | NA | defaults is exposed as an object, not a function |
Hi,
I am new to this stuff, can you please provide some code about the adding an attachment to the list item..!!?
Thanks
Parth
Parth:
I see that you’ve posted to the SPServices site as well; I’ll answer you over there. No need for multiple posts!
M.