wc.service.declare (initProperties)
The wc.service.declare function declares a new AJAX service with the specified ID. In WebSphere Commerce, a service is a server URL that performs a server object create, update, delete or other server processing. When needed, a WebSphere Commerce server URL is called using AJAX in the JavaScript code. When the service completes successfully, a JSON object containing all the response properties of the URL request is returned to successHandler (the success response) or failureHandler (the failure response) defined JavaScript function. In addition, a model changed event is sent to any subscribed listeners if the service completes successfully. In this case, the modelChanged and modelChanged/actionId Dojo events are published.
Example
wc.service.declare({
id: "AjaxAddOrderItem",
actionId: "AjaxAddOrderItem",
url: "AjaxOrderChangeServiceItemAdd",
formId: "",
successHandler: function(serviceResponse) {
alert("success");
},
failureHandler: function(serviceResponse) {
if (serviceResponse.errorMessage) {
alert(serviceResponse.errorMessage);
}
}
});
Parameters
- initProperties
- (Object) Contains any of the initialization parameters.
- id
- (String) The unique ID of this service.
- actionId
- (String) An identifier for the action performed by this service. This value is used in the construction of the topic name for the model changed event. The model changed event name is in the following form: modelChanged/actionId.
- url
- (String) The URL for this service.
- formId
- (String) The ID of the form element that is posted to the URL. It is not necessary, however, to associate a service with a form element.
- successHandler: function (serviceResponse)
- Summary: Performs processing after a successful service invocation.
- failureHandler: function (serviceResponse)
- Summary: Performs processing after a failed service invocation.