다음을 통해 공유

CreateScanJobRequest 요소

  • 아티클

필요한 CreateScanJobRequest 작업은 스캔 디바이스를 검사할 준비를 합니다.

사용

<wscn:CreateScanJobRequest>
  child elements
</wscn:CreateScanJobRequest>

특성

특성이 없습니다.

텍스트 값

None

자식 요소

요소
DestinationToken
ScanIdentifier
ScanTicket

부모 요소

부모 요소가 없습니다.

설명

WSD 스캔 서비스는 CreateScanJobRequest 작업을 지원해야 합니다.

CreateScanJobRequest 작업은 사용할 수 있는 이미지를 검사하기 위해 스캔 디바이스를 준비하는 주요 메커니즘입니다. 이 작업은 두 가지 방법으로 시작할 수 있습니다. 각 메서드는 CreateScanJobRequest에 서로 다른 인수를 보냅니다. 두 가지 메서드와 인수는 다음과 같습니다.

  • 사용자가 대상을 선택하고 디바이스에서 스캔 단추를 누릅니다. 이 메서드에서 클라이언트는 다음 자식 요소를 사용하여 CreateScanJobRequest 를 보냅니다.

    • Scan Service가 ScanAvailableEvent를 통해 클라이언트로 반환하는 ScanIdentifier 요소입니다. 스캔 서비스는 사용자가 대상을 선택한 후 올바른 클라이언트가 검사를 요청하는지 확인하기 위해 이 식별자를 확인해야 합니다.

    • ScanAvailableEvent 이벤트를 수신하도록 구독할 때 WSD Scan Service가 클라이언트로 반환하는 DestinationToken 요소입니다. Scan Service는 이 토큰을 확인하여 올바른 클라이언트가 검사를 요청하는지 확인해야 합니다.

    • 검사 처리를 제어하는 ScanTicket 요소입니다. 스캔 티켓의 값은 사용자가 검색을 시작하기 위해 디바이스로 가기 전에 클라이언트에서 설정된 기본값입니다.

  • 사용자가 클라이언트에서 애플리케이션을 시작하고 이미지를 가져옵니다. 이 메서드에서 클라이언트는 ScanTicket 요소만 사용하여 CreateScanJobRequest를 보냅니다.

CreateScanJobRequest 계층 구조 내의 특정 요소에는 MustHonor 부울 특성이 포함될 수 있습니다. MustHonor가 있고 true인 경우 WSD Scan Service는 요청된 요소와 해당 값을 적용하거나 스캔 작업 요청을 거부해야 합니다. 지원되지 않는 요소에 MustHonor 특성이 없거나 MustHonor 특성이 false이면 WSD Scan Service에서 무시해야 합니다. 지원되는 요소의 MustHonor 특성이 false인 경우 WSD Scan Service는 요청된 값을 지원되는 값으로 대체해야 합니다.

클라이언트가 검색 작업 요청(예: InputSource 및 Resolution)에서 충돌하는 요소 조합을 제공하는 경우 충돌하는 요소에 True의 MustHonor 특성 값이 있는 경우 WSD Scan Service에서 검사 작업 요청을 거부해야 합니다.

다음 요소는 MustHonor 특성을 가질 수 있습니다. ColorProcessing, CompressionQualityFactor, ContentType, Exposure, FilmScanMode, ImagesToTransfer, InputSize, InputSource, MediaSides, Resolution, Rotation , Scaling, ScanRegionHeight, ScanRegionWidth, ScanRegionXOffset 및 ScanRegionYOffset.

이 작업은 일반적인 WSD Scan Service 작업 오류 코드를 모두 반환할 수 있습니다. 오류를 보고하는 방법에 대한 자세한 내용은 WSD 스캔 서비스 작업 오류 보고를 참조 하세요.

CreateScanJobRequest 는 다음 오류를 반환할 수도 있습니다.

  • ServerErrorNotAcceptingJobs 서버에서 새 검사 작업을 수락할 수 없습니다. 이 오류는 스캐너가 서비스 모드로 전환되었거나 사용자 개입 조건이 있고 모든 메모리 버퍼가 소진되었기 때문에 발생할 수 있습니다. 클라이언트는 서버가 차단 해제되고 스캐너가 작업을 다시 수락할 것으로 예상하여 나중에 수정되지 않은 요청을 다시 시도할 수 있습니다.

    Fault 속성 정의
    [코드] soap:Receiver
    [하위 코드] wscn:ServerErrorNotAcceptingJobs
    [이유] 서비스가 일시적으로 차단되어 새 작업 또는 문서 요청을 수락할 수 없습니다.
    [세부 정보] None

  • ClientErrorFormatNotSupported 스캐너는 제공된 형식 값을 지원하지 않습니다.

    Fault 속성 정의
    [코드] soap:Sender
    [하위 코드] wscn:ClientErrorFormatNotSupported
    [이유] 문서 형식 매개 변수 값은 지원되지 않습니다.
    [세부 정보] 선택 사항. Scan Service는 지원되는 형식 목록을 반환할 수 있습니다. 이 요소의 데이터는 wscn:FormatSupportedType> 형식<이어야 합니다.

  • ClientErrorInvalidScanIdentifier 제공된 ScanIdentifier 값이 현재 검사 디바이스 내에서 유효하지 않습니다.

    Fault 속성 정의
    [코드] soap:Sender
    [하위 코드] wscn:ClientErrorInvalidScanIdentifier
    [이유] ScanIdentifier 매개 변수 값이 현재 유효하지 않습니다.
    [세부 정보] None

  • ClientErrorInvalidDestinationToken 제공된 DestinationToken 값이 검사 디바이스에 유효하지 않습니다.

    Fault 속성 정의
    [코드] soap:Sender
    [하위 코드] wscn:ClientErrorInvalidDestinationToken
    [이유] DestinationToken 매개 변수 값이 현재 유효하지 않습니다.
    [세부 정보] None

  • ClientErrorNoImagesAvailable 검색할 미디어가 없으므로 서버에서 새 검사 작업을 수락할 수 없습니다. 예를 들어 이 오류는 스캐너에 연결된 자동 문서 피드에서 검사 작업이 실행되고 피더가 비어 있을 때 생성됩니다. 클라이언트는 나중에 수정되지 않은 요청을 다시 시도할 수 있으며, 조건이 수정되었고 스캐너에 이제 미디어를 스캔할 수 있다는 기대가 있습니다.

    Fault 속성 정의
    [코드] soap:Sender
    [하위 코드] wscn:ClientErrorNoImagesAvailable
    [이유] 서버에 획득할 수 있는 이미지가 없습니다.
    [세부 정보] None

예제

다음 코드 예제에서는 검색 디바이스에서 검사가 시작될 때의 검사 작업 요청을 보여 있습니다.

<?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>AddressofScannerService</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/CreateScanJob
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:CreateScanJobRequest>
      <wscn:ScanIdentifier>
        uuid:12e7a983-1034-5428-d298-0016f11097fa
      </wscn:ScanIdentifier>
      <wscn:DestinationToken>
        Dest1234TokenString
      </wscn:DestinationToken>
      <wscn:ScanTicket>
        <wscn:JobDescription>
          <wscn:JobName>Photo Scan</wscn:JobName>
          <wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
        </wscn:JobDescription>
        <wscn:DocumentParameters>
          <wscn:Format>jfif</wscn:Format>
          <wscn:CompressionQualityFactor>45</wscn:CompressionQualityFactor>
          <wscn:InputSource>Platen</wscn:InputSource>
          <wscn:ContentType>Auto</wscn:ContentType>
          <wscn:InputSize>
            <wscn:DocumentSizeAutoDetect>true</wscn:DocumentSizeAutoDetect>
          </wscn:InputSize>
          <wscn:Scaling wscn:MustHonor="1">
            <wscn:ScalingWidth>125</wscn:ScalingWidth>
            <wscn:ScalingHeight>125</wscn:ScalingHeight>
          </wscn:Scaling>
          <wscn:MediaSides>
            <wscn:MediaFront>
              <wscn:Resolution wscn:MustHonor="1">
                <wscn:Width>300</wscn:Width>
                <wscn:Height>300</wscn:Height>
              </wscn:Resolution>
            </wscn:MediaFront>
          </wscn:MediaSides>
        </wscn:DocumentParameters>
      </wscn:ScanTicket>
    </wscn:CreateScanJobRequest>
  </soap:Body>
</soap:Envelope>

다음 코드 예제에서는 클라이언트의 애플리케이션에서 검색이 시작될 때의 검사 작업 요청을 보여줍니다.

<?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>AddressofScannerService</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/CreateScanJob
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:CreateScanJobRequest>
      <wscn:ScanTicket>
        <wscn:JobDescription>
          <wscn:JobName>Application Scan</wscn:JobName>
          <wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
        </wscn:JobDescription>
        <wscn:DocumentParameters>
          <wscn:Format>xps</wscn:Format>
          <wscn:ImagesToTransfer>0</wscn:ImagesToTransfer>
          <wscn:InputSource>ADF</wscn:InputSource>
          <wscn:ContentType>Auto</wscn:ContentType>
          <wscn:InputSize>
            <wscn:DocumentSizeAutoDetect>true</wscn:DocumentSizeAutoDetect>
          </wscn:InputSize>
          <wscn:MediaSides>
            <wscn:MediaFront>
              <wscn:ColorProcessing>RGB48</wscn:ColorProcessing>
              <wscn:Resolution>
                <wscn:Width>1200</wscn:Width>
              </wscn:Resolution>
            </wscn:MediaFront>
          </wscn:MediaSides>
        </wscn:DocumentParameters>
        <wscn:DocumentDescription>
          <wscn:DocumentName>Scan001.jpg</DocumentName>
        </wscn:DocumentDescription>
      </wscn:ScanTicket>
    </wscn:CreateScanJobRequest>
  </soap:Body>
</soap:Envelope>

참고 항목

ColorProcessing

CompressionQualityFactor

ContentType

CreateScanJobResponse

DestinationToken

노출

FilmScanMode

ImagesToTransfer

InputSize

InputSource

MediaSides

해결 방법

회전

크기 조정

ScanAvailableEvent

ScanIdentifier

ScanRegionHeight

ScanRegionWidth

ScanRegionXOffset

ScanRegionYOffset

ScanTicket