CreateScanJobResponse 元素

项目
02/12/2024

所需的 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 操作元素中的扫描服务，使扫描设备能够验证扫描请求者是否确实创建了扫描作业。
ImageInformation，其中包含有关使用当前正在验证的 ScanTicket 进行的扫描所产生的图像数据的信息。
DocumentFinalParameters，其中包含扫描服务用于此扫描作业的实际 DocumentParameters 元素。

客户端必须通过发送一个或多个 RetrieveImageRequest 操作元素从扫描服务检索实际图像数据。扫描服务响应客户端的 CreateScanJobRequest 后，客户端有 60 秒的时间发送 RetrieveImageRequest 操作元素。如果扫描服务在这段时间内未收到 RetrieveImageRequest ，则它应中止作业，而 JobStateReason 为 JobTimedOut。如果作业包含多个文档，则每次连续 的 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>