ValidateScanTicketRequest 요소
필요한 ValidateScanTicketRequest 작업 요소를 사용하면 클라이언트가 향후 검사 작업에 대한 설정이 유효한지 확인할 수 있습니다.
사용량
<wscn:ValidateScanTicketRequest>
child elements
</wscn:ValidateScanTicketRequest>
특성
특성이 없습니다.
자식 요소
| 요소 |
|---|
| ScanTicket |
부모 요소
부모 요소가 없습니다.
설명
클라이언트는 ValidateScanTicketRequest 요소를 사용하여 다양한 설정 변경 내용과 조합의 유효성을 검사할 수 있습니다.
ScanTicket 에는 클라이언트가 향후 검사 작업에서 제출하려는 모든 설정이 포함되어 있습니다. ScanTicket 는 클라이언트가 스캐너에서 재정의하려는 처리 요소만 포함하거나 WSD Scan Service에서 지원되는 가능한 모든 요소를 포함할 수 있습니다.
WSD Scan Service가 ValidateScanTicketRequest를 성공적으로 처리하면 ValidateScanTicketResponse 작업에서 유효성 검사 정보를 반환합니다. 그렇지 않으면 Scan Service에서 적절한 오류 코드를 반환해야 합니다.
이 작업은 일반적인 WSD Scan Service 작업 오류 코드를 모두 반환할 수 있습니다. 오류를 보고하는 방법에 대한 자세한 내용은 WSD 스캔 서비스 작업 오류 보고를 참조하세요.
이 작업은 다음 오류 코드를 반환할 수도 있습니다.
ClientErrorConflictingRequiredParameters
각각 MustHonor 특성이 true로 설정된 두 개 이상의 DocumentParameters 요소 간에 충돌이 있습니다. MustHonor set true와 함께 제공되는 모든 설정을 사용하면 디바이스에서 충돌이 발생합니다. Scan Service는 이 충돌을 resolve 수 없으므로 ScanTicket가 잘못된 것으로 간주됩니다.
Fault 속성 정의 [코드] soap:Sender [하위 코드] wscn:ClientErrorConflictingRequiredParameters [이유] DocumentParameters 요소의 여러 요소에는 MustHonor가 true로 설정되어 있지만 true로 설정된 모든 설정을 적용하면 스캐너 디바이스에서 충돌이 발생합니다. [세부 정보] 없음
예제
다음 코드 예제에서는 유효한 검사 티켓에 대한 유효성 검사 요청을 보여줍니다.
<?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/ValidateScanTicket
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:ValidateScanTicketRequest>
<wscn:ScanTicket>
<wscn:JobDescription>
<wscn:JobName>Photo Scan</wscn:JobName>
<wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
</wscn:JobDescription>
<wscn:DocumentParameters>
<wscn:Format>dib</wscn:Format>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:InputMediaSize>
<wscn:Width>3000</wscn:Width>
<wscn:Height>5000</wscn:Height>
</wscn:InputMediaSize>
</wscn:InputSize>
<wscn:Scaling>
<wscn:ScalingWidth>125</wscn:ScalingWidth>
<wscn:ScalingHeight>125</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:ColorProcessing>GrayScale4</wscn:ColorProcessing>
<wscn:Resolution>
<wscn:Width>300</wscn:Width>
<wscn:Height>300</wscn:Height>
</wscn:Resolution>
</wscn:MediaFront>
</wscn:MediaSides>
</wscn:DocumentParameters>
</wscn:ScanTicket>
</wscn:ValidateScanTicketRequest>
</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/ValidateScanTicket
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:ValidateScanTicketRequest>
<wscn:ScanTicket>
<wscn:JobDescription>
<wscn:JobName>Photo Scan</wscn:JobName>
<wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
</wscn:JobDescription>
<wscn:DocumentParameters>
<wscn:Format>jfif</wscn:Format>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:DocumentSizeAutoDetect>true</wscn:DocumentSizeAutoDetect>
</wscn:InputSize>
<wscn:Scaling>
<wscn:ScalingWidth>1250</wscn:ScalingWidth>
<wscn:ScalingHeight>1250</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:Resolution>
<wscn:Width>350</wscn:Width>
<wscn:Height>350</wscn:Height>
</wscn:Resolution>
<wscn:MediaFront>
<wscn:MediaSides>
</wscn:DocumentParameters>
</wscn:ScanTicket>
</wscn:ValidateScanTicketRequest>
</soap:Body>
</soap:Envelope>