DISTRIBUTED SCAN DEVICE WEB SERVICE PROTOCOL SUMMARY
The Distributed Scan Device Web Service (WS-DSD) protocol uses a subset of the elements of the WS-Scan Service schema for its request, response, and event messages. For more information about this schema, see Web Services on Devices Scan Service Schema.
A client and a service host use the WS-DSD protocol to communicate over a network connection. The client sends the host messages that contain service requests, and the host sends messages that contain responses to the requests. In addition, the host sends messages to the client that contain notifications of events that have occurred on the host.
The client is a control point (typically, a desktop computer) that runs a DSM administration application like the scan-management console (SMC). The service host is a DSM device (typically, a standalone scanner or a scanner function in a copier or multifunction printer) that implements the host side of the Distributed Scan Device Web Service protocol.
The Distributed Scan Device Web Service protocol supports the following operations:
Get a summary of all currently active scan jobs in the DSM device.
Get a set of elements that contain parameter values for a scan job.
Get the history of a recently completed scan jobs.
Get a set of elements that contain configuration settings for a DSM device.
Validate a scan ticket.
The Distributed Scan Device Web Service schema defines the following event elements:
Notify a client that a scan job has completed.
Uses WS-DSD schema element JobEndStateEvent, and WS-Scan Service schema element JobStatusType.
Notify a client that the status of a scan job has changed.
Uses WS-DSD schema element JobStatusEvent, and WS-Scan Service schema element JobStatusType.
Uses WS-DSD schema element ScannerElementsChangeEvent, and WS-Scan Service schema element ElementChangesType.
Notify a client that a previously reported scanner status condition has been cleared at the scanner.
Uses WS-DSD schema element ScannerStatusConditionClearedEvent, and WS-Scan Service schema element DeviceConditionClearedType.
Provide the client with detailed information about a single status change (described by a DeviceCondition element) in the DSM device.
Uses WS-DSD schema element ScannerStatusConditionEvent.
Inform the client that the status of the DSM device has changed.
Uses WS-DSD schema element ScannerStatusSummaryEvent, and WS-Scan Service schema element StatusSummaryType.