CreateScanJobResponse 요소

필요한 CreateScanJobResponse 요소에는 클라이언트의 검사 요청에 대한 WSD Scan Service의 응답이 포함됩니다.

사용량

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

특성

특성이 없습니다.

자식 요소

요소

DocumentFinalParameters

ImageInformation

JobId

JobToken

부모 요소

부모 요소가 없습니다.

설명

WSD 검사 서비스는 CreateScanJobResponse 작업 요소를 지원해야 합니다.

WSD 스캔 서비스는 클라이언트의 CreateScanJobRequest에 대한 응답으로 CreateScanJobResponse 작업 요소를 클라이언트에 보냅니다.

클라이언트가 유효한 검사 요청을 한 경우 WSD 검사 서비스는 다음 정보를 반환해야 합니다.

  • 작업을 식별하는 고유한 JobId 입니다. 스캐너는 정의된 범위 내에서 구현 정의 방식으로 JobId 를 생성합니다. Scan Service는 클라이언트가 이전 작업과 작업을 혼동하지 않도록 최근에 할당된 값을 다시 사용하지 않아야 합니다.
  • JobToken의 고유 식별자입니다. JobToken은 JobId와 페어링되어 검색 작업을 고유하게 나타냅니다. JobToken이 RetrieveImageRequest 작업 요소의 검색 서비스에 전달되어 검색 디바이스가 검사 요청자가 실제로 검사 작업을 생성했는지 확인할 수 있도록 합니다.
  • ImageInformation은 현재 유효성을 검사하고 있는 ScanTicket로 만든 검사의 결과 이미지 데이터에 대한 정보를 포함합니다.
  • DocumentFinalParameters- 검사 서비스에서 이 검사 작업에 사용하는 실제 DocumentParameters 요소를 포함합니다.

클라이언트는 하나 이상의 RetrieveImageRequest 작업 요소를 전송하여 Scan Service에서 실제 이미지 데이터를 검색해야 합니다. 검색 서비스가 클라이언트의 CreateScanJobRequest에 응답한 후 클라이언트에서 RetrieveImageRequest 작업 요소를 보내는 데 60초가 걸립니다. 이 시간 내에 Scan Service가 RetrieveImageRequest를 수신하지 않는 경우 JobTimedOutJobStateReason을 사용하여 작업을 중단해야 합니다. 작업이 여러 문서로 구성된 경우 이 제한 시간은 연속 적인 각 RetrieveImageRequest/Response 작업 간에 적용됩니다.

예제

다음 코드 예제에서는 CreateScanJobRequest에 대한 WSD Scan Service 응답을 보여 줍니다.

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

참고 항목

CreateScanJobRequest

DocumentFinalParameters

ImageInformation

JobId

JobStateReason

JobToken

RetrieveImageRequest