Delen via


Het element ValidateScanTicketRequest

Met het vereiste bewerkingselement ValidateScanTicketRequest kan een client bepalen of de instellingen voor toekomstige scanbewerkingen geldig zijn.

Gebruik

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

Kenmerken

Er zijn geen kenmerken.

Kind-elementen

Onderdeel
ScanTicket

Ouder-elementen

Er zijn geen bovenliggende elementen.

Opmerkingen

Een client kan het element ValidateScanTicketRequest gebruiken om verschillende instellingswijzigingen en combinaties te valideren.

ScanTicket bevat alle instellingen die de client in een toekomstige scanbewerking wil indienen. ScanTicket kan alleen de verwerkingselementen bevatten die de client in de scanner wil overschrijven, of kan elk mogelijk element bevatten dat wordt ondersteund in de WSD-scanservice.

Als de WSD Scan-service validateScanTicketRequest verwerkt, retourneert deze de validatiegegevens in een ValidateScanTicketResponse-bewerking . Anders moet de scanservice de juiste foutcodes retourneren.

Met deze bewerking kunnen alle veelvoorkomende WSD Scan Service-foutcodes worden geretourneerd. Zie WSD Scan Service Error Reporting voor meer informatie over het rapporteren van fouten.

Deze bewerking retourneert mogelijk ook de volgende foutcode:

  • ClientErrorConflictingRequiredParameters

    Er is een conflict tussen twee of meer DocumentParameters-elementen waarvoor elk het MustHonor-kenmerk is ingesteld op true. Als u alle instellingen gebruikt die worden geleverd bij MustHonor set waar, veroorzaakt een conflict in het apparaat. De scanservice kan dit conflict niet oplossen, zodat scanticket ongeldig wordt geacht.

    Eigenschap Fout Definitie
    [Code] soap:Sender
    [Subcode] wscn:ClientErrorConflictingRequiredParameters
    [Reden] Voor meerdere elementen in het element DocumentParameters is MustHonor ingesteld op waar, maar alle instellingen worden toegepast die zijn ingesteld op waar, veroorzaakt een conflict in het scannerapparaat.
    [Detail] Geen

Voorbeelden

In het volgende codevoorbeeld ziet u een validatieaanvraag voor een geldig scanticket.

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

In het volgende codevoorbeeld ziet u een validatieaanvraag voor een ongeldig scanticket.

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

Zie ook

ScanTicket