다음을 통해 공유


CreateScanJobResponse 요소

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

사용량

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

특성

특성이 없습니다.

자식 요소

요소
DocumentFinalParameters
ImageInformation
JobId
JobToken

부모 요소

부모 요소가 없습니다.

설명

WSD Scan Service는 CreateScanJobResponse 작업 요소를 지원해야 합니다.

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

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

  • 작업을 식별하는 고유한 JobId 입니다. 스캐너는 정의된 범위 내에서 구현 정의 방식으로 JobId 를 생성합니다. Scan Service는 클라이언트가 작업을 이전 작업과 혼동하지 않도록 최근에 할당된 값을 다시 사용하지 않아야 합니다.

  • JobToken의 고유 식별자입니다. JobToken은 JobId와 페어링되어 스캔 작업을 고유하게 나타냅니다. Scan 디바이스가 검사 요청자가 실제로 검사 작업을 만들 수 있도록 하려면 JobToken이 RetrieveImageRequest 작업 요소의 Scan Service에 전달됩니다.

  • ImageInformation - 현재 유효성을 검사 중인 ScanTicket로 만든 검사의 결과 이미지 데이터에 대한 정보를 포함합니다.

  • DocumentFinalParameters - 스캔 서비스에서 이 검사 작업에 사용하는 실제 DocumentParameters 요소를 포함합니다.

클라이언트는 하나 이상의 RetrieveImageRequest 작업 요소를 전송하여 Scan Service에서 실제 이미지 데이터를 검색해야 합니다. 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