Элемент CreateScanJobResponse

Статья
02/02/2024

Обязательный элемент CreateScanJobResponse содержит ответ службы сканирования WSD на запрос клиента.

Использование

<wscn:CreateScanJobResponse>
  child elements
</wscn:CreateScanJobResponse>

Атрибуты

Атрибуты отсутствуют.

Дочерние элементы

Элемент
DocumentFinalParameters
ImageInformation
JobId
JobToken

Родительские элементы

Родительские элементы отсутствуют.

Уникальный идентификатор JobId для идентификации задания. Средство проверки создает JobId в определенной реализацией форме в пределах определенных диапазонов. Служба сканирования не должна повторно использовать недавно назначенные значения, чтобы клиенты не путали задания с более старыми заданиями.
Уникальный идентификатор в JobToken. JobToken связан с JobId для уникального представления задания сканирования. JobToken передается в службу сканирования в элементе операции RetrieveImageRequest, чтобы позволить устройству сканирования проверить, действительно ли инициатор сканирования создал задание сканирования.
ImageInformation, который содержит сведения о результирующей информации об изображениях, полученных в результате сканирования, выполненного с помощью ScanTicket, который в настоящее время проверяется.
DocumentFinalParameters, содержащий фактический элемент DocumentParameters, используемый службой сканирования для этого задания сканирования.

Клиент должен получить фактические данные изображения из службы сканирования, отправив один или несколько элементов операции RetrieveImageRequest . У клиента есть 60 секунд для отправки элемента операции RetrieveImageRequest после того, как служба сканирования ответила на запрос CreateScanJobRequest клиента. Если служба сканирования не получает RetrieveImageRequest в течение этого времени, она должна прервать задание с jobStateReasonjobTimedOut. Если задание состоит из нескольких документов, это время ожидания применяется между каждой последующей операцией RetrieveImageRequest/Response .

Примеры

В следующем примере кода показан ответ службы сканирования WSD на запрос CreateScanJobRequest.

<?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>