Function
$().SPServices
Supported Web Services
The table below shows the Web Services for which we have implemented at least one operation (or have operations coming in planned releases) with a link to more detailed documentation, indicators for whether the Web Service is available in WSS 3.0 and/or MOSS, and links to the MSDN documentation pages. Note that there are some
general syntax instructions below the table.
General Syntax
$().SPServices({
operation: "operationname",
[webURL: "/sitepath",]
[option1: value1,]
[option2: value2,]
[async: false,]
completefunc: function (xData, Status) {
...do stuff...
}
});
The name of the Web Service operation (see the SDK documentation links above). Because the Web Services operations are named uniquely, you only need to specify the operation.
webURLFor Web Service operations where it makes sense, you can pass in a webURL to change the context for the AJAX call. By default, the current site (as determined by
$().SPServices.SPGetCurrentSite) is used.
optionsThe options vary based on which Web Service and operation you are calling. In all instances, the options will take the same names as those described in the SDK.
asyncBy default, all of the Web Service operations are called asynchronously with AJAX. Generally, this will be the desired approach, but to force synchronicity, add the async: false option.
completefuncA function to call on completion of the AJAX call to the Web Service:
completefunc: function(xData, Status) {
...do something...
},
Example
Example call for GetListItems. This example is taken directly from SPCascadeDropdowns:
$().SPServices({
operation: "GetListItems",
// Force sync so that we have the right values for the child column onchange trigger
async: false,
webURL: opt.relationshipWebURL,
listName: opt.relationshipList,
// Filter based on the currently selected parent column's value
CAMLQuery: camlQuery,
// Only get the parent and child columns
CAMLViewFields: "<ViewFields><FieldRef Name='" + opt.relationshipListParentColumn + "' /><FieldRef Name='" + opt.relationshipListChildColumn + "' /></ViewFields>",
// Override the default view rowlimit and get all appropriate rows
CAMLRowLimit: 0,
completefunc: function(xData, Status) {
...
}
Example call for GetUserInfo:
waitMessage = "<table width='100%' align='center'><tr><td align='center'><img src='/_layouts/images/gears_an.gif'/></td></tr></table>";
$("#WSOutput").html(waitMessage).SPServices({
operation: "GetUserInfo",
userLoginName: "SHARE1\\demouser",
completefunc: function (xData, Status) {
$("#WSOutput").html("").append("<b>This is the output from the GetUserInfo operation:</b>");
$(xData.responseXML).find("User").each(function() {
$("#WSOutput").append("<li>ID: " + $(this).attr("ID") + "</li>");
$("#WSOutput").append("<li>Sid: " + $(this).attr("Sid") + "</li>");
$("#WSOutput").append("<li>Name: " + $(this).attr("Name") + "</li>");
$("#WSOutput").append("<li>LoginName: " + $(this).attr("LoginName") + "</li>");
$("#WSOutput").append("<li>Email: " + $(this).attr("Email") + "</li>");
$("#WSOutput").append("<li>Notes: " + $(this).attr("Notes") + "</li>");
$("#WSOutput").append("<li>IsSiteAdmin: " + $(this).attr("IsSiteAdmin") + "</li>");
$("#WSOutput").append("<li>IsDomainGroup: " + $(this).attr("IsDomainGroup") + "</li>");
$("#WSOutput").append("<hr/>");
});
}
});