CreateScanJobResponse 元素
必要的 CreateScanJobResponse 元素包含對客戶端掃描要求的 WSD 掃描服務的回應。
使用方式
<wscn:CreateScanJobResponse>
child elements
</wscn:CreateScanJobResponse>
屬性
沒有屬性。
子元素
| 元素 |
|---|
| DocumentFinalParameters |
| ImageInformation |
| JobId |
| JobToken |
父元素
沒有父元素。
備註
WSD 掃描服務必須支援 CreateScanJobResponse 作業專案。
WSD 掃描服務會將 CreateScanJobResponse 作業元素傳送至用戶端，以回應用戶端的 CreateScanJobRequest。
如果用戶端已提出有效的掃描要求，WSD 掃描服務必須傳回下列資訊：
用來識別作業的唯一 JobId 。 掃描器會在定義的範圍內以實作定義的方式產生 JobId 。 掃描服務不得重複使用最近指派的值，讓用戶端不會將作業與較舊的作業混淆。
JobToken 中的唯一標識符。 JobToken 會與 JobId 配對，以唯一表示掃描作業。 JobToken 會傳遞至 RetrieveImageRequest 作業專案中的 Scan Service，讓掃描裝置能夠驗證掃描要求者是否已實際建立掃描作業。
ImageInformation，其中包含目前正在驗證之 ScanTicket 所進行掃描所產生的影像數據相關信息。
DocumentFinalParameters，其中包含掃描服務用於此掃描作業的實際 DocumentParameters 元素。
客戶端必須藉由傳送一或多個 RetrieveImageRequest 作業元素，從掃描服務擷取實際影像數據。 用戶端在掃描服務回應用戶端的 CreateScanJobRequest 之後，傳送 RetrieveImageRequest 作業元素的 60 秒。 如果掃描服務在此時間內未收到 RetrieveImageRequest，它應該中止作業，並具有 JobTimedOut 的 JobStateReason。 如果作業包含多個檔，則此逾時會在每個後續 的 RetrieveImageRequest/Response 作業之間套用。
範例
下列程式代碼範例說明 CreateScanJobRequest 的 WSD 掃描服務回應。
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2003/03/addressing"
xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan"
soap:encodingStyle='https://www.w3.org/2002/12/soap-encoding' >
<soap:Header>
<wsa:To>
https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous
</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/CreateScanJob
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheCreateScanJobRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wscn:CreateScanJobResponse>
<wscn:JobId>1</wscn:JobId>
<wscn:JobToken>Job9876TokenString</wscn:JobToken>
<wscn:ImageInformation>
<wscn:MediaFrontImageInfo>
<wscn:PixelsPerLine>900</wscn:PixelsPerLine>
<wscn:NumberOfLines>1500</wscn:NumberOfLines>
<wscn:BytesPerLine>113</wscn:BytesPerLine>
</wscn:MediaFrontImageInfo>
</wscn:ImageInformation>
<wscn:DocumentFinalParamters>
<wscn:Format>jfif</wscn:Format>
<wscn:CompressionQualityFactor>45</wscn:CompressionQualityFactor>
<wscn:ImagesToTransfer>0</wscn:ImagesToTransfer>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:InputMediaSize>
<wscn:Width wscn:Override="true">8500</wscn:Width>
<wscn:Height wscn:Override="true">11000</wscn:Height>
</wscn:InputMediaSize>
</wscn:InputSize>
<wscn:Exposure>
<wscn:ExposureSettings>
<wscn:Contrast wscn:UsedDefault="true">0</wscn:Contrast>
<wscn:Brightness wscn:UsedDefault="true">0</wscn:Brightness>
<wscn:Sharpness wscn:UsedDefault="true">0</wscn:Sharpness>
</wscn:ExposureSettings>
</wscn:Exposure>
<wscn:Scaling>
<wscn:ScalingWidth>125</wscn:ScalingWidth>
<wscn:ScalingHeight>125</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:Rotation wscn:UsedDefault="true">0</wscn:Rotation>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:ScanRegion>
<wscn:ScanRegionXOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionXOffset>
<wscn:ScanRegionYOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionYOffset>
<wscn:ScanRegionWidth wscn:UsedDefault="true">
8500
</wscn:ScanRegionWidth>
<wscn:ScanRegionHeight wscn:UsedDefault="true">
11000
</wscn:ScanRegionHeight>
</wscn:ScanRegion>
<wscn:ColorProcessing wscn:UsedDefault="true">
RGB24
</wscn:ColorProcessing>
<wscn:Resolution>
<wscn:Width>300</wscn:Width>
<wscn:Height>300</wscn:Height>
</wscn:Resolution>
</wscn:MediaFront>
</wscn:MediaSides>
</wscn:DocumentFinalParamters>
</wscn:CreateScanJobResponse>
</soap:Body>
</soap:Envelope>