CreateScanJobResponse 要素
必要な CreateScanJobResponse 要素には、クライアントのスキャン要求に対する WSD スキャン サービスの応答が含まれています。
使用方法
<wscn:CreateScanJobResponse>
child elements
</wscn:CreateScanJobResponse>
属性
属性はありません。
子要素
| 要素 |
|---|
| DocumentFinalParameters |
| ImageInformation |
| JobId |
| JobToken |
親要素
親要素は存在しません。
解説
WSD スキャン サービスは、CreateScanJobResponse 操作要素に対応している必要があります。
WSD スキャン サービスは、クライアントの CreateScanJobRequest に応答して、CreateScanJobResponse 操作要素をクライアントに送信します。
クライアントが有効なスキャン要求を行った場合、WSD スキャン サービスは以下の情報を返す必要があります。
ジョブを識別する一意の JobId。 スキャナーは、定義された範囲内において、実装によって定義された方法で JobId を生成します。 スキャン サービスでは、クライアントがジョブを古いジョブと混同しないよう、最近割り当てられた値を再利用してはなりません。
JobToken の一意の識別子。 JobToken は、スキャン ジョブを一意に表すために JobId とペアになっています。 JobToken は RetrieveImageRequest 操作要素のスキャン サービスに渡され、スキャン要求者がスキャン ジョブを実際に作成したことをスキャン デバイスが確認できるようにします。
ImageInformation: 現在検証中の ScanTicket で行われたスキャンの結果の画像データに関する情報が含まれています。
DocumentFinalParameters: このスキャン ジョブにスキャン サービスが使用する実際の DocumentParameters 要素が含まれています。
クライアントは、1 つ以上の RetrieveImageRequest 操作要素を送信することにより、スキャン サービスから実際のイメージ データを取得する必要があります。 スキャン サービスがクライアントの CreateScanJobRequest に応答した後、クライアントは 60 秒で RetrieveImageRequest 操作要素を送信します。 スキャン サービスがこの時間内に 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>