Elemento ValidateScanTicketRequest

Articolo
05/04/2023

L'elemento dell'operazione ValidateScanTicketRequest richiesto consente a un client di determinare se le impostazioni per le operazioni di analisi future sono valide.

Utilizzo

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

Attributi

Non ci sono attributi.

Elementi figlio

Elemento
ScanTicket

Elementi padre

Non ci sono elementi padre.

Commenti

Un client può usare l'elemento ValidateScanTicketRequest per convalidare varie modifiche e combinazioni di impostazioni.

ScanTicket contiene tutte le impostazioni che il client vuole inviare in un'operazione di analisi futura. ScanTicket può contenere solo gli elementi di elaborazione di cui il client vuole eseguire l'override nello scanner oppure può contenere tutti gli elementi possibili supportati nel servizio di analisi WSD.

Se il servizio di analisi WSD elabora correttamente ValidateScanTicketRequest, restituisce le informazioni di convalida in un'operazione ValidateScanTicketResponse . In caso contrario, il servizio di analisi deve restituire i codici di errore appropriati.

Questa operazione può restituire tutti i codici di errore comuni del servizio analisi WSD. Per altre informazioni su come segnalare gli errori, vedere Segnalazione errori del servizio di analisi WSD.

Questa operazione potrebbe restituire anche il codice di errore seguente:

ClientErrorConflictingRequiredParameters

Esiste un conflitto tra due o più elementi DocumentParameters ognuno con l'attributo MustHonor impostato su true. L'uso di tutte le impostazioni fornite con MustHonor impostato true causa un conflitto nel dispositivo. Il servizio di analisi non è in grado di risolvere il conflitto in modo che ScanTicket sia considerato non valido.

Proprietà fault	Definizione
[Codice]	soap:Sender
[Subcode]	wscn:ClientErrorConflictingRequiredParameters
[Motivo]	Più elementi nell'elemento DocumentParameters hanno MustHonor impostato su true, ma l'applicazione di tutte le impostazioni impostate su true causa un conflitto nel dispositivo scanner.
[Dettaglio]	Nessuno

Esempio

Nell'esempio di codice seguente viene illustrata una richiesta di convalida per un ticket di analisi valido.

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

Nell'esempio di codice seguente viene illustrata una richiesta di convalida per un ticket di analisi non valido.

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

Vedi anche

ScanTicket

ValidateScanTicketRequest

Condividi tramite