Udostępnij za pośrednictwem


ValidateScanTicketRequest, element

Wymagany element operacji ValidateScanTicketRequest umożliwia klientowi określenie, czy ustawienia przyszłych operacji skanowania są prawidłowe.

Zastosowanie

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

Atrybuty

Brak atrybutów.

Elementy podrzędne

Składnik
ScanTicket

Elementy nadrzędne

Brak elementów nadrzędnych.

Uwagi

Klient może użyć elementu ValidateScanTicketRequest , aby zweryfikować różne zmiany i kombinacje ustawień.

ScanTicket zawiera wszystkie ustawienia, które klient chce przesłać w przyszłej operacji skanowania. ScanTicket może zawierać tylko elementy przetwarzania, które klient chce zastąpić w skanerze lub może zawierać każdy możliwy element obsługiwany w usłudze skanowania WSD.

Jeśli usługa skanowania WSD pomyślnie przetworzy element ValidateScanTicketRequest, zwraca informacje o walidacji w operacji ValidateScanTicketResponse . W przeciwnym razie usługa skanowania powinna zwrócić odpowiednie kody błędów.

Ta operacja może zwrócić wszystkie typowe kody błędów operacji skanowania WSD. Aby uzyskać więcej informacji na temat zgłaszania błędów, zobacz Raportowanie błędów operacji usługi skanowania WSD.

Ta operacja może również zwrócić następujący kod błędu:

  • ClientErrorConflictingRequiredParameters

    Występuje konflikt między co najmniej dwoma elementami DocumentParameters, z których każdy ma atrybut MustHonor ustawiony na wartość true. Użycie wszystkich ustawień dostarczanych z zestawem MustHonor true powoduje konflikt w urządzeniu. Usługa skanowania nie może rozwiązać tego konfliktu, więc narzędzie ScanTicket jest uznawane za nieprawidłowe.

    Właściwość Fault Definicja
    [Kod] soap:Sender
    [Podkodowanie] wscn:ClientErrorConflictingRequiredParameters
    [Powód] Wiele elementów w elemektorze DocumentParameters ma właściwość MustHonor ustawioną na true, ale zastosowanie wszystkich ustawień ustawionych na wartość true powoduje konflikt na urządzeniu skanera.
    [Szczegóły] Żaden

Przykłady

Poniższy przykład kodu przedstawia żądanie weryfikacji prawidłowego biletu skanowania.

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

Poniższy przykład kodu przedstawia żądanie weryfikacji nieprawidłowego biletu skanowania.

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

Zobacz także

ScanTicket