Elemen ValidateScanTicketRequest

Elemen operasi ValidateScanTicketRequest yang diperlukan memungkinkan klien menentukan apakah pengaturan untuk operasi pemindaian di masa mendatang valid.

Penggunaan

<wscn:ValidateScanTicketRequest>
  child elements
</wscn:ValidateScanTicketRequest>

Atributs

Tidak ada atribut.

Elemen anak

Elemen
ScanTicket

Elemen induk

Tidak ada elemen induk.

Komentar

Klien dapat menggunakan elemen ValidateScanTicketRequest untuk memvalidasi berbagai perubahan pengaturan dan kombinasi.

ScanTicket berisi semua pengaturan yang ingin dikirim klien dalam operasi pemindaian di masa mendatang. ScanTicket hanya dapat berisi elemen pemrosesan yang ingin diambil alih klien di pemindai, atau dapat berisi setiap elemen yang mungkin didukung di WSD Scan Service.

Jika Layanan Pemindaian WSD berhasil memproses ValidateScanTicketRequest, layanan ini mengembalikan informasi validasinya dalam operasi ValidateScanTicketResponse . Jika tidak, Layanan Pemindaian harus mengembalikan kode kesalahan yang sesuai.

Operasi ini dapat mengembalikan semua kode kesalahan operasi WSD Scan Service umum. Untuk informasi selengkapnya tentang cara melaporkan kesalahan, lihat Pelaporan Kesalahan Operasi Layanan Pemindaian WSD.

Operasi ini mungkin juga mengembalikan kode kesalahan berikut:

• ClientErrorConflictingRequiredParameters

  Ada konflik antara dua atau beberapa elemen DocumentParameters yang masing-masing memiliki atribut MustHonor yang diatur ke true. Menggunakan semua pengaturan yang disediakan dengan MustHonor yang ditetapkan benar menyebabkan konflik di perangkat. Layanan Pemindaian tidak dapat mengatasi konflik ini sehingga ScanTicket dianggap tidak valid.

  Properti kesalahan	Definisi
  [Kode]	soap:Pengirim
  [Subkode]	wscn:ClientErrorConflictingRequiredParameters
  [Alasan]	Beberapa elemen dalam elemen DocumentParameters memiliki MustHonor yang diatur ke true, tetapi menerapkan semua pengaturan yang diatur ke true menyebabkan konflik di perangkat pemindai.
  [Detail]	Tidak ada

Contoh

Contoh kode berikut menunjukkan permintaan validasi untuk tiket pemindaian yang valid.

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

Contoh kode berikut menunjukkan permintaan validasi untuk tiket pemindaian yang tidak valid.

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

Lihat juga

ScanTicket