Condividi tramite

Elemento ValidateScanTicketRequest

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

Uso

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

Attributi

Non sono presenti attributi.

Elementi figli

Elemento
ScanTicket

Elementi principali

Non sono presenti elementi padre.

Osservazioni:

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 ogni possibile elemento supportato 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 di 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 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
    [Codice secondario] 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

Esempi

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>

L'esempio di codice seguente mostra 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>

Vedere anche

ScanTicket

  • Last updated on